Mercuryo Widget — Partner Integration Guide
Mercuryo Widget is a ready-made On-Ramp and Off-Ramp solution. Your users can buy and sell 50+ cryptocurrencies across 40+ fiat currencies — paying with Visa, Mastercard, Apple Pay, Google Pay, or local alternative payment methods (APMs) — all within a Mercuryo-hosted interface that can be embedded directly into your product. KYC is handled by Mercuryo via SumSub, with a light-KYC option (no documents required) available for transactions up to €699. Themes and colors can be fully customized via Figma.
What You Can Build
- On-Ramp (Buy) — let users purchase crypto with a card, Apple Pay, Google Pay, or local APMs.
- Off-Ramp (Sell) — let users sell crypto and receive fiat to their card (EUR and USD).
- Spend Card — let users issue a virtual EUR Mastercard, fund it with crypto, and use it for payments worldwide.
Note: Off-Ramp and Spend Card are disabled by default. Contact your integration manager to enable them for your widget.
Integration Methods
| Method | Description |
|---|---|
| Redirect | A link opens the widget in a new tab or as a full-page redirect. The simplest setup — no embedding required. |
| iFrame | The widget is embedded directly on your page inside an iFrame. Users complete the transaction without navigating away. |
| Mobile (iOS / Android) | The widget is loaded inside a WebView in your native iOS or Android app. |
Key URLs
| Service | Production | Sandbox |
|---|---|---|
| Dashboard | https://dashboard.mercuryo.io |
https://sandbox-dashboard.mrcr.io |
| Widget (Redirect / Custom Tab) | https://exchange.mercuryo.io |
https://sandbox-exchange.mrcr.io |
| Widget (for iFrame embedding) | https://widget.mercuryo.io |
https://sandbox-widget.mrcr.io |
| API | https://api.mercuryo.io |
https://sandbox-api.mrcr.io |
Quick Links
- Quick Start — go live in 4 steps
- Sandbox & Testing — test without real funds
- Widget Parameters — full URL parameter reference
- Callbacks & Webhooks — receive transaction status updates
Support
Contact your integration manager or email sales@mercuryo.io.