Off-Ramp Integration • Busha Developer Documentation

This example shows you how to integrate the Busha Off-Ramp widget to let users sell cryptocurrency and receive fiat directly in your application.

Use Cases

Wallet app letting users cash out crypto
Marketplace vendor payouts
P2P trading platform
Gaming platform withdrawals to local currency

Basic Integration

Simple Button Integration

The quickest way to integrate the Off-Ramp widget is with a button that opens the widget in a new window:

<button
  onclick="window.open('https://sandbox.sell.busha.io/?publicKey=YOUR_PUBLIC_KEY&side=sell&redirectUrl=https://your-app.com/handle-deposit', '_blank')"
>
  Sell Crypto with Busha
</button>

Iframe Integration

For a more embedded experience, use an iframe:

<iframe
  src="https://sandbox.sell.busha.io/?publicKey=YOUR_PUBLIC_KEY&side=sell&redirectUrl=https://your-app.com/handle-deposit"
  width="100%"
  height="700px"
  style="border: 1px solid #e5e7eb; border-radius: 8px;"
  title="Busha Off-Ramp Widget"
></iframe>

Pre-filled Integration Examples

Nigeria (NGN)
Kenya (KES)

Sell 0.005 ETH for NGN

    <button
      onclick="window.open('https://sandbox.sell.busha.io/?publicKey=YOUR_PUBLIC_KEY&side=sell&cryptoAsset=ETH&network=ETH&fiatCurrency=NGN&cryptoAmount=0.005&redirectUrl=https://your-app.com/handle-deposit', '_blank')"
    >
      Sell ETH for Naira
    </button>

Sell USDT for NGN Bank Payout

<button
  onclick="window.open('https://sandbox.sell.busha.io/?publicKey=YOUR_PUBLIC_KEY&side=sell&cryptoAsset=USDT&network=TRX&fiatCurrency=NGN&cryptoAmount=100&redirectUrl=https://your-app.com/handle-deposit', '_blank')"
>
  Cash Out USDT to Bank
</button>

Sell Bitcoin for KES

    <button
      onclick="window.open('https://sandbox.sell.busha.io/?publicKey=YOUR_PUBLIC_KEY&side=sell&cryptoAsset=BTC&network=BTC&fiatCurrency=KES&cryptoAmount=0.001&redirectUrl=https://your-app.com/handle-deposit', '_blank')"
    >
      Sell Bitcoin for KES
    </button>

Sell USDT for M-Pesa Payout

<button
  onclick="window.open('https://sandbox.sell.busha.io/?publicKey=YOUR_PUBLIC_KEY&side=sell&cryptoAsset=USDT&network=TRX&fiatCurrency=KES&cryptoAmount=50&redirectUrl=https://your-app.com/handle-deposit', '_blank')"
>
  Cash Out to M-Pesa
</button>

Configuration Parameters

Parameter	Required	Description
publicKey	Yes	Your Busha Public API Key
side	Yes	Must be “sell” for off-ramp
redirectUrl	Yes	URL to redirect after transaction setup
cryptoAsset	No	Cryptocurrency to sell (e.g., BTC, ETH, USDT)
network	No	Blockchain network (e.g., BTC, ETH, POLYGON)
fiatCurrency	No	Target fiat currency (NGN for Nigeria, KES for Kenya)
cryptoAmount	No	Amount of crypto to sell
fiatAmount	No	Target fiat amount (ignores cryptoAmount if set)

React Component Examples

Nigeria (NGN)
Kenya (KES)

    import React from "react";

    function SellEthereumButton() {
      const openOffRamp = () => {
        const params = new URLSearchParams({
          publicKey: "YOUR_PUBLIC_KEY",
          side: "sell",
          cryptoAsset: "ETH",
          network: "ETH",
          fiatCurrency: "NGN",
          cryptoAmount: "0.005",
          redirectUrl: "https://your-app.com/handle-deposit",
        });

        window.open(
          `https://sandbox.sell.busha.io/?${params.toString()}`,
          "_blank"
        );
      };

      return <button onClick={openOffRamp}>Sell Ethereum for Naira</button>;
    }

    export default SellEthereumButton;

    import React from "react";

    function SellBitcoinButton() {
      const openOffRamp = () => {
        const params = new URLSearchParams({
          publicKey: "YOUR_PUBLIC_KEY",
          side: "sell",
          cryptoAsset: "BTC",
          network: "BTC",
          fiatCurrency: "KES",
          cryptoAmount: "0.001",
          redirectUrl: "https://your-app.com/handle-deposit",
        });

        window.open(
          `https://sandbox.sell.busha.io/?${params.toString()}`,
          "_blank"
        );
      };

      return <button onClick={openOffRamp}>Sell Bitcoin for KES</button>;
    }

    export default SellBitcoinButton;

Complete Integration Flow

User Initiates Sell

User clicks “Sell Crypto” button in your app

Redirect to Off-Ramp Widget

Your app opens the Busha Off-Ramp widget with pre-filled parameters

User Configures Payout

User logs in to Busha, completes KYC if needed, and selects their payout method: - Nigeria: Bank account - Kenya: M-Pesa or bank account

Redirect Back with Deposit Instructions

Busha redirects user back to your app with deposit address and amount

User Confirms and Sends Crypto

Your app displays the deposit instructions. User confirms and sends crypto to the provided address

Busha Processes Payout

Once crypto is received, Busha processes the payout to the user’s selected method

Learn More

Off-Ramp Widget Overview - Understand how the widget works
Integration Guide - Detailed integration steps
Supported Currencies - See all supported assets
Webhooks Setup - Monitor transactions in real-time
Test Addresses - Get test crypto addresses for sandbox testing

Examples

​Use Cases

​Basic Integration

​Simple Button Integration

​Iframe Integration

​Pre-filled Integration Examples

​Sell 0.005 ETH for NGN

​Sell USDT for NGN Bank Payout

​Sell Bitcoin for KES

​Sell USDT for M-Pesa Payout

​Configuration Parameters

​React Component Examples

​Complete Integration Flow

​Learn More