Fiat Deposit

Fiat deposit represents a deposit into any of your Fiat Balances (e.g. NGN, KES)

Fiat Deposits are powered by Quotes specifying the same source and target currency with a pay_in object.

Initialize a Deposit Quote

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

Observe the pay_in type: temporary_bank_account

This means that, upon finalizing this deposit transfer, you will get a temporary bank account that you can make a bank transfer into and automatically get the amount you send, deposited to your fiat balance. In the example above, the NGN balance will get a NGN10,000 deposit after finalizing this transfer.

Finalize the Deposit Transfer (Generating the Temporary Bank Account)

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"
  }'

Sample response with generated temporary account number

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_LJB2GQb55Cs98LbpqgRMx",
    "profile_id": "BUS_tg6yujbZ1nMu5BLQkPGGO",
    "quote_id": "QUO_vxcF2svmjMbxDp4T5dcD8",
    "source_currency": "NGN",
    "target_currency": "NGN",
    "source_amount": "10000",
    "target_amount": "9900",
    "rate": {
      "rate": "1",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "NGN"
    },
    "fees": [
      {
        "amount": {
          "amount": "100",
          "currency": "NGN"
        },
        "name": "payment gateway fee",
        "type": "FIXED"
      }
    ],
    "pay_in": {
      "expires_at": "2025-02-21T10:46:56.232278869Z",
      "recipient_details": {
        "account_name": "Payaza(Business 1 Business)",
        "account_number": "7000384620",
        "bank_name": "78 FINANCE COMPANY LIMITED",
        "email": "dickson@busha.co"
      },
      "type": "temporary_bank_account"
    },
    "status": "pending",
    "created_at": "2025-02-21T10:16:54.40130914Z",
    "updated_at": "2025-02-21T10:16:54.401309215Z"
  }
}

The generated temporary account number is always in the response’s data.pay_in.recipient_details object.