🤝Onramp Aggregator Partners

Need help with your integration? Click here to chat with our custom GPT for instant answers.

Onramp aggregators skip the widget’s index & confirmation pages. Below are the various flows, depending on iframe URL parameters.

Flow Summary:

  1. Onramp Flow – If all required parameters (see below for more info) are supplied in the URL, the first two screens will be skipped, and the user will go straight to the summary screen.

  2. Onramp Flow with Manual Entry XRP/TON – If the wallet address is provided but the destination tag isn't provided, the user will be offered the choice to enter the unprovided destination tag if they wish to do so.

  3. Onramp Flow with wallet manual entry – If the wallet address isn't provided, the user will be prompted to enter it.

  4. Widget Flow – If any required parameters aren't provided (see below for more info), the user will be shown the standard flow. In this flow, the user will need to provide any details that haven't been provided.

The first two pages will be skipped & users will land on the order summary page shown on the right.

Handling Unprovided Parameters

If any of the following parameters aren't provided in the URL, the user will be shown the standard flow & will need to provide the unprovided details.

  • cryptoCurrencyCode

  • fiatCurrencyCode

  • method

  • baseCurrencyAmount

Optional parameters:

  • walletAddress

  • destinationTag (Applies only to XRP/TON)

Unprovided wallet address:

If the walletAddress isn't provided in the URL, the user will be shown the Enter Wallet Address page, where they have to enter the required wallet address. In the case of XRP or TON, if the DestinationTag isn't provided, the user will be shown the Enter Wallet Address page, with the wallet address pre-filled, but the destination tag blank.

Example images of the wallet entry pages.

Please note that the "deposit on Merchant" page will always be skipped for on-ramp aggregator merchants.

Last updated