Skip to main content
This page is for developers and operators connecting additional onramp providers (Stripe, Transak, Mercuryo, etc.) to their Meld account. Onramps are the payment processors that handle the actual crypto transactions. To enable transactions through specific providers, you need to set up credentials and webhooks in your Meld dashboard. For each onramp you would like to enable, either Meld can set it up for you, or you can set it up yourself using the Meld dashboard. When testing in sandbox, Meld will automatically enable several onramps for you for testing purposes. In production, the Meld team will work with you to select which onramps to enable to best suit your needs, based on coverage, conversion, and pricing.
Sandbox vs production webhooks: Webhook URLs differ between sandbox and production — generate each from the corresponding Meld dashboard’s Integrations → [Provider] screen, and configure them separately in each provider’s developer dashboard.

​
Note: If Meld is handling service provider setup for you, you can skip this page.

​
Service Provider Setup

​
Prerequisites

Before starting, ensure you have:
  • Meld Dashboard Access: Admin access to your Meld account
  • Provider Account: Active account with the service provider
  • API Credentials: From the provider’s developer dashboard or account manager
  • Password Manager: To securely store credentials

​
What You’ll Need from Each Provider

Different providers require different credentials, one example is:
  • API Key: Your unique identifier
  • API Secret: Private key for authentication
  • Webhook Secret: For securing webhook communications
  • Client ID: Additional identifier (some providers)
Where to Find Credentials:
  • Provider’s dashboard → Developer section or API settings
  • Contact your provider’s account manager
  • Check provider’s documentation for credential location

​
Setup Process

​
Step 1: Obtain Provider Credentials

  1. Log into your service provider’s dashboard
  2. Navigate to the Developer or API section
  3. Generate or locate your API credentials
  4. Save credentials securely in your password manager

​
Step 2: Add Credentials to Meld Dashboard

  1. Log into your Meld dashboard
  2. Go to Integrations section
  3. Find the provider you want to configure
  4. Click Add next to the provider name
  5. Enter your credentials in the form
  6. Click Add Integration to save

​
Step 3: Configure Webhooks

Skip for: Coinbase, Robinhood, and PayPal (webhook setup not required)
  1. After adding credentials, the page will refresh
  2. Click the gear icon next to your newly configured provider
  3. Copy the webhook URL that appears

​
Note: Sometimes there may be a delay before the webhook URL appears after adding credentials. If you don’t see it immediately, wait a few minutes and refresh the page.

  1. In your provider’s dashboard, configure webhooks:
    • Set the webhook URL to the copied Meld URL
    • Event Selection: Choose all available events
    • Webhook Version: Select the latest version available
  2. Save your webhook configuration

​
Validation

Verify your setup is working:
  1. Quote Testing: Try fetching quotes for the configured provider
  2. Monitor Logs: Check for any error messages in both dashboards

​
Common Issues

​
Credential Problems

  • Invalid API Key: Verify credentials are copied correctly
  • Expired Credentials: Check if credentials need renewal
  • Wrong Environment: Ensure using production (not sandbox) credentials

​
Webhook Issues

  • URL Not Reachable: Verify the webhook URL was copied correctly
  • Authentication Errors: Confirm webhook secret matches
  • Missing Events: Ensure all webhook events are enabled

​
Security Best Practices

  • Store Securely: Use password managers, never commit credentials to code
  • Regular Rotation: Update credentials periodically
  • Monitor Access: Review provider access logs regularly

​
Service Provider–Specific Configuration

​
Stripe

Recommended Stripe API Version:
2023-10-16
Recommended Webhook Event:
crypto.onramp_session.updated

​
Next Steps

Once setup is complete, you can:
  • Fetch quotes including your configured provider
  • Create widget sessions using the provider
  • Receive real-time transaction updates via webhooks
  • Monitor transaction performance in your dashboard