Design your integration

This guide will take you through the steps you should follow to create a smooth and secure integration with the Busha Off-Ramp widget.

Requirement

Description

Multiple entry points

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

  • Home screen

  • Main app navigation

  • Individual cryptocurrency screens

Amount input

Partner apps with an amount input screen should show:

  • Add a max button and estimate network fees

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

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

Payout method selection screen

Partner apps with a payout 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 correct pay_out type.

  • Estimated transaction completion times

Handle crypto deposits

Partner apps with send functionality should handle crypto deposits for users to ensure high transaction success rates.

  • Get the deposit instructions by passing the redirectUrl widget parameter

  • Show a screen or bottom sheet with the deposit details for the user to confirm the transaction

Transaction tracking

All partner apps should display a toast message after the user completes their transaction and use the ramp transfers API to display the transfer event timeline.

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

Off Ramp Journey DemoCopied!

Explore the demo below for an end-to-end showcase of a well-designed off-ramp integration.

A well designed Off-Ramp flow example