Skip to main content
The ramps flow lets your users buy, sell, or transfer crypto. The actual transaction is completed within the onramp’s UI, where the user will have to complete KYC and enter payment information. This page helps developers and product teams pick between the two main ways to integrate that flow.

​
Choose your integration method

The first decision is whether you want to use Meld’s UI or build your own UI to collect what the user wants to do. Choose the approach that best fits your needs.

​
🚀 Widget Integration (Meld UI)

Perfect for: Quick launch, minimal development effort

​
How it works

  1. Get your Meld Widget URL from the Meld Dashboard (Developer tab) — looks like https://meldcrypto.com/?publicKey=yourPublicKey
  2. Redirect users or embed via iframe using your Meld Widget URL
  3. The user starts the transaction in Meld’s interface
  4. Meld redirects the user to the onramp’s UI, where they complete the transaction
  5. Done ✅

​
Key benefits

  • ✅ Fastest setup — launch in minutes, not weeks
  • ✅ No development required — just use the URL
  • ✅ Simple integration — no API knowledge needed
  • ✅ Built-in compliance — KYC/AML handled for you
  • ✅ Mobile optimized — works on all devices

​
Limitations

  • ❌ Limited customization — uses Meld’s UI/branding
  • ❌ Less control over user experience
  • ❌ Standard flow — can’t modify steps
  • ❌ Transfer not available — only buy and sell are supported

​
Widget URLs

Sandbox: 
https://meldcrypto.com/?publicKey=YOUR_SANDBOX_PUBLIC_KEY
Production: 
https://meldcrypto.com/?publicKey=YOUR_PRODUCTION_PUBLIC_KEY
Get your complete Widget URL from the Meld Dashboard → Developer tab. Sandbox and production each have their own key.

​
When to choose Widget Integration

  • ⭐ You want to launch crypto features quickly
  • ⭐ You have limited development resources
  • ⭐ You’re testing the market before full integration
  • ⭐ You’re okay with Meld’s standard UI/UX
Example: QuickSwap uses Widget Integration — they redirect users directly to Meld’s widget for fast crypto purchases with zero development overhead. To see an example, go to meldcrypto.com. ➡️ Get started with Meld Checkout

​
🎨 White-Label API Integration (your UI)

Perfect for: Custom design, complete flexibility over user experience

​
How it works

  1. Build your own UI with complete design control
  2. Use Meld APIs to fetch supported assets (countries, fiat currencies, tokens, payment methods)
  3. Use Meld’s API to fetch quotes
  4. Collect user information in your custom interface
  5. Get an onramp URL with your collected data
  6. Launch an onramp widget for the user to complete the transaction
  7. Track transactions via webhooks or API polling

​
Key benefits

  • ✅ Complete design flexibility — build any UX you want
  • ✅ Full branding control — looks 100% like your app
  • ✅ Custom user flows — optimize for your specific users
  • ✅ Advanced features — analytics, A/B testing, custom logic
  • ✅ All transaction types — buy, sell, transfer (transfer is only available in White-Label API)

​
Requirements

  • ⚠️ More development work — 2–4 weeks typical implementation
  • ⚠️ API integration knowledge — REST APIs, webhooks, error handling
  • ⚠️ Custom UI development — build your own interface

​
When to choose White-Label API

  • ⭐ You want complete control over user experience
  • ⭐ Custom branding is critical for your product
  • ⭐ You need flexible user flows and advanced features
  • ⭐ You have development resources for API integration
  • ⭐ You want to optimize conversion with custom UX
Example: MetaMask uses White-Label API — they built a completely custom interface that matches their brand, with Meld APIs powering the backend crypto functionality. See it at MetaMask Portfolio. ➡️ Get started with White-Label API

​
🔄 Comparison table

FeatureWidget IntegrationWhite-Label API
Setup timeMinutes2–4 weeks
Development requiredNoneSignificant
UI customization❌ Limited✅ Complete
Branding control❌ Meld’s branding✅ Your branding
User flow control❌ Standard flow✅ Custom flows
Transaction types✅ Buy, Sell✅ Buy, Sell, Transfer
Mobile support✅ Built-in✅ Your implementation
Analytics/tracking❌ Basic✅ Full control
A/B testing❌ Not available✅ Your implementation

​
🚀 Ready to get started?

​
Widget Integration

  1. Quickstart — get your Meld Widget URL and start redirecting users
  2. URL parameters — customize widget behavior
  3. Sandbox testing — validate your integration

​
White-Label API

  1. Overview — understand the architecture
  2. Build custom UI — step-by-step implementation
  3. Sandbox testing — validate your integration
Remember: there are exactly two integration options. Choose the one that matches your development resources and customization needs. You can always start with Widget Integration for speed, then upgrade to White-Label API later for more control.