GuideReference

On-Ramp

Let your users securely purchase crypto directly from your platform.

Going On-Ramp means making a fresh crypto purchase with Fiat from an external bank account or Busha Fiat Wallet. For this guide, we will be focusing on buying crypto with an external bank account.

For a guide on exchanging Fiat balance to Crypto Balance, see the Trades guide under Currency Conversion.

On-Ramp Steps: Copied!

Plan the destination and source

For a successful on-ramp transaction, the source_currency must be a fiat currency in which you intend to pay, and the target_currency is the crypto currency you wish to own.

Initiate the Buy quote

Next, create the Quote specifying the pay_in type as temporary_bank_account.

Request Body

curl -i -X POST \
  https://api.busha.co/v1/quotes \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_currency": "NGN",
    "target_currency": "BTC",
    "source_amount": "5000",
    "pay_in": {
      "type": "temporary_bank_account"
    }
  }'

You set either the target_amount or the source_amount. In the example above we are requesting to buy NGN 5000 worth of BTC.

Response

{
    "status": "success",
    "message": "Created quote successfully",
    "data": {
        "id": "QUO_TJ3wixSPtHX1IvJFqwYjf",
        "profile_id": "ee8b9070-e44f-4adb-baea-f22233e63863",
        "source_currency": "NGN",
        "target_currency": "BTC",
        "source_amount": "5000",
        "target_amount": "0.00003355",
        "rate": {
            "product": "BTCNGN",
            "rate": "146036047.79",
            "side": "buy",
            "type": "FIXED",
            "source_currency": "NGN",
            "target_currency": "BTC"
        },
        "fees": [
            {
                "amount": {
                    "amount": "100",
                    "currency": "NGN"
                },
                "name": "payment gateway fee",
                "type": "FIXED"
            }
        ],
        "pay_in": {
            "type": "temporary_bank_account"
        },
        "reference": "QUO_VrvnLvGyLRliFatnHa5Tv",
        "status": "pending",
        "expires_at": "2025-03-04T17:33:03.297388509Z",
        "created_at": "2025-03-04T17:03:03.297367061Z",
        "updated_at": "2025-03-04T17:03:03.297367061Z"
    }
}

Finalize the transfer with the Quote ID:

curl -i -X POST \
  https://api.busha.co/v1/transfers \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "quote_id": "QUO_vxcF2svmjMbxDp4T5dcD8"
  }'

Upon finalizing the transfer, the response includes a temporary account number generated to facilitate this specific trade. See an example below:

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_oi2mJghEa5S8mhhr00CGg",
    "profile_id": "BUS_tg6yujbZ1nMu5BLQkPGGO",
    "quote_id": "QUO_1tmszhX47ylPK7S6Vkxcq",
    "source_currency": "NGN",
    "target_currency": "BTC",
    "source_amount": "5000",
    "target_amount": "0.00003144",
    "rate": {
      "product": "BTCNGN",
      "rate": "155826825.9",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "BTC"
    },
    "fees": [
      {
        "amount": {
          "amount": "100",
          "currency": "NGN"
        },
        "name": "payment gateway fee",
        "type": "FIXED"
      }
    ],
    "pay_in": {
      "expires_at": "2025-02-25T12:47:53.37786349Z",
      "recipient_details": {
        "account_name": "Business Name",
        "account_number": "1010101010",
        "bank_name": "78 FINANCE COMPANY LIMITED",
        "email": "test-email@busha.co"
      },
      "type": "temporary_bank_account"
    },
    "status": "pending",
    "created_at": "2025-02-25T12:17:51.809975463Z",
    "updated_at": "2025-02-25T12:17:51.809975525Z"
  }
}

Upon making a payment into the account number from the response, its equivalent worth in BTC is deposited into your Busha Crypto Balance.

a