White-Label API Integration

White-Label API Integration gives you maximum control over the user experience while leveraging Meld's crypto infrastructure. You build your own custom UI for the entire flow, then use provider payment interfaces for the final transaction step.

⚠️

Note: This is NOT the same as Widget Integration (Public Key URL). White-Label API requires custom development and API integration.

When to Use White-Label API Integration

✅ Choose White-Label API if you want:

• Complete control over quote display and comparison
• Custom UI that matches your brand perfectly
• Advanced features like transaction analytics
• Support for all flows: Buy, Sell, Transfer

❌ Consider Widget Integration instead if you want:

• Fastest time-to-market with minimal development
• All-in-one solution with less customization

💡

See White-Label API in Action: MetaMask uses Meld's White-Label API Integration to provide seamless crypto purchases with their custom UI.

White-Label API Integration Process

Here is a common integration approach using this three-step process:

1. Create Complete User Journey

Build your own custom UI to collect user preferences:

• Amount they want to spend/receive
• Fiat currency selection
• Cryptocurrency selection
• Payment method preferences
• Wallet address for receiving crypto
• Country (can be auto-detected from user's device/browser instead of prompting)

2. Fetch Quotes

Use Meld API to get real-time quotes from multiple onramp/offramp providers:

• Send user preferences to Meld quote API
• Receive quotes from available service providers
• Display quotes in your custom interface for user selection

3. Launch Service Provider Widget

Call Meld widget API to launch the selected provider's widget:

• User completes KYC and payment in provider's secure interface
• Provider handles compliance and transaction processing
• Receive webhook notifications for transaction status updates

4. Show Transaction Details (Optional)

Process webhooks and display transaction information to users:

• Set up webhook endpoints to receive transaction status updates
• Fetch detailed transaction data from Meld API when webhooks arrive
• Display transaction progress, completion status, and details in your UI

➡️ Start Building Your Integration

How White-Label API Integration Works

High-Level Flow:

1. Your UI: Collect user preferences (amount, crypto, payment method)
2. Meld API: Get real-time quotes from multiple providers
3. Your UI: Display quotes and let user choose
4. Meld API: Get URL from Meld to launch provider UI for selected provider
5. Provider Interface: User completes payment in provider's interface
6. Webhooks: Receive real-time transaction updates

Technical Architecture:

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Your UI   │◄──►│  Meld APIs  │◄──►│ Provider UI │───►│   Your UI   │
│             │    │             │    │  (Widget)   │    │             │
├─────────────┤    ├─────────────┤    ├─────────────┤    ├─────────────┤
│ • Quotes    │    │ • Pricing   │    │ • Payment   │    │ • Status    │
│ • Selection │    │ • Sessions  │    │ • KYC       │    │ • Results   │  
│ • Launch    │    │ • Webhooks  │    │ • Compliance│    │ • Tracking  │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

Prerequisites:

• API Key from Meld Dashboard
• Webhook endpoint for transaction updates
• Domain whitelisting for redirect URLs (some providers require this)

Widget Features & Capabilities

Supported Transaction Types:

• ✅ Buy Crypto (On-ramp)
• ✅ Sell Crypto (Off-ramp)
• ✅ Transfer Crypto (Between wallets)

Key Benefits:

• Multi-provider quotes with recommendations - Compare rates from multiple providers and get Meld's data-driven recommendations on which provider to use
• Real-time pricing - Always current exchange rates
• Compliance handled - KYC/AML managed by providers
• Global coverage - 100+ countries supported
• Mobile optimized - Works on all devices

Getting Started

Follow the complete implementation guide to build your White-Label API integration:

➡️ Complete Implementation Guide - Step-by-step White-Label API integration

This guide covers:

• Building your custom UI
• Fetching quotes from Meld API
• Launching service provider widgets
• Testing your integration