v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Add Bank Account Offramp

This endpoint adds a bank account to the offramp transaction. After the customer’s crypto deposit is confirmed, the money will be sent to this bank account.

post/custodial/off_ramp_transactions/{merchant_reference}/bank_account

Path parameters

merchant_referencestring required

Request body

bank_codestring

Customer's bank code. You can use the banks endpoint to get a list of available banks and their codes.

account_numberstring

Customer's account number. The name on this account must match the name used when initiating the transaction.

currency_code'ngn' | 'ghs'

Response

200

statusstring

messagestring

Example response

{
  "status": "ok",
  "message": "Bank account successfully created and attached to off-ramp transaction",
  "data": {
    "public_id": "670553c3-8150-44f4-8524-188b6516363b",
    "metadata": {
      "account_number": "8012345678",
      "bank_code": "100004",
      "account_name": "TEST USER APP"
    },
    "status": "active",
    "created_at": "2025-06-25T09:00:02.974Z",
    "updated_at": "2025-06-25T09:00:02.974Z"
  }
}