Skip to main content
HomeIntegration BuilderAPI ReferenceGuidesChangelog
View Mirror World on Github
Join the Discord server

How to Use Token On-Ramp Aggregator

By Le Li

In this article, you’re going to learn how to integrate a service that enables your users to buy cryptocurrencies using the method they are already used to such as credit and debit cards. Token On-Ramp is the process of buying crypto with fiat currency using a credit, debit card or even by making a transfer. This is a game changer in web3 right now because it reduces the friction of onboarding web3 native into web3.

Getting Started

Before getting started, you want to make sure that you already have a Mirror World developer account and an already created project. If you're yet to create one, head over to to get started or go through this guide for a proper explanation.

Create UI Widget URL

Base URL:

Now let’s get straight into building! The only thing you need to do is to add the base URL to your iframe or webview on mobile, the on-ramp provider will guide you on how to complete your purchase.

URL ParamRequired?Sample


You can also modify the URL with custom data using any of the above parameters, for example, Let's say I want the initial fiat amount on the widget to be 500 then you can modify the URL to like this:

If you want to redirect to a custom page after a successful purchase. You can modify the URL to like this:

You can find the full list of parameters in this notion doc: Full list

How to test the integration

To test the integration, you can use our staging environment and get test cards from our current providers below and then run some test transactions.


By implementing these steps, you'll seamlessly bridge the gap between traditional currencies and the exciting realm of cryptocurrencies.

Dashboard Activity

You can view your projects in the Activity module of the Dashboard. Here, you can see data regarding Total Volume, Order Number & Data, as well as New Customers.


Edit this page on GitHub

Copyright © Mirror World, Inc. 2023
On this page




API Reference