Service Provider Setup

Service providers (onramps) are 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.

📋

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

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.

4. 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

5. 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

2023-10-16

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