Meld Checkout Integration Quickstart
Time required: 5 minutes. Difficulty: No coding requiredBefore you begin
- Access to the Meld dashboard (sandbox and production are separate)
- A page in your app where you can render a link or trigger a redirect
Sandbox vs production: Each environment has its own Meld Checkout URL. Sandbox URLs only work with test data; production URLs handle real money. Always finish testing in sandbox first.
Step 1: Get Your Meld Checkout URL
1
Open the dashboard
Check your email for the Meld dashboard invitation, click the link, and log in at https://dashboard.meld.io.
2
Generate Meld Checkout URL
Go to Developer → API Keys. Press the Generate Meld Checkout URL button.
You will need to mint the URL per session in full integration. Generate Meld Checkout URL button serves integration testing purposes only. Please refer to the Full Integration Guide.
Step 2: Send the customer to the URL
Mint on demand, when the customer clicks your buy button, then redirect, open a tab, or embed:camera, microphone, and payment permissions so KYC and payment flows work.
How long is the URL good for? A minted URL keeps working until Meld’s retention sweep removes its stored configuration, 30 days after minting by default.
Step 3: Test in sandbox
1
Open the minted URL
Paste it into your browser. The checkout should load with no values prefilled, the customer picks everything.
2
Complete a test transaction
Follow the sandbox test credentials.
3
Verify in the dashboard
Check the Transactions tab for the test transaction.
Step 4: Go live
1
Swap keys and base URL
Use your production secret and public keys against
https://api.meld.io.2
Test with a small real transaction
Confirm the full flow end to end before directing traffic.
3
Send customers to the minted URL
Mint per checkout from your backend and redirect.
Next steps
- Full Integration Guide, mint Meld Widget URL per customer’s visit, prefill and lock values, fix the flow to buy or sell, redirect handling, mobile, and migration from query-string parameters
- Customization, styling and advanced options