Design your integration

Multiple entry points

All partner apps should add multiple entry points to the on-ramp.

• Home screen

• Main app navigation

• Individual cryptocurrency screens

Amount input

Partner apps with an amount input screen should show:

• When opening the widget, pre-fill the fiat / crypto amount by using cryptoAsset with cryptoAmount

• Show minimum and maximum buy limits set according to our API

Payment method selection screen

Partner apps with a payment method selection screen should show:

• All supported payment methods

• Payment method logos

• Estimated transaction completion times

Provider selection screen

Partner apps with multiple providers should show:

• Quotes from our Quote Endpoint, using the right pay_in/pay_out method

• Estimated transaction completion times

Pre-fill the customer's wallet address

Partner apps that know the customer's wallet address(es) should pre-fill this to skip the wallet address screen in the user journey.

• Pass widget parameter address

• If using address, pass the widget parameter cryptoAsset

Transaction tracking

All partner apps should display a toast message after the user completes their transaction with a link to the MoonPay transaction tracker.

Alternatively, display a toast message with a link to your app's own transaction history page.

Mobile app configuration

All partner mobile apps, configure app and browser so KYC and payment methods in the widget work correctly.

• Use a fullscreen in-app browser and remove the navigation bar for a more native and seamless user experience

• Configure your app and in-app browser so that users can complete KYC

• Allow pop-ups at the in-app browser level so all payment methods work