v1

latestOpenAPI 3.0.0Proprietary2026-07-2233792.6 KB

Banks

Add Bank

This adds a validated NGN or GHS bank to your integration

post/payments/banks/add

Request body

idstring required

The bank ID from the Fetch Bank List endpoint.

accountNumberstring required

The bank account number to add.

currencystring

Optional. The bank account currency (ngn or ghs) should match the currency of the selected bank ID. If omitted, defaults to your business's operating country currency.

narrationstring

Optional narration that appears on the bank statement for withdrawals (max 32 characters).

Example request

{
  "id": "39",
  "accountNumber": "3154021148",
  "currency": "ngn",
  "narration": "Breet withdrawal"
}

Response

Bank added successfully