Bank List

Recommendation on Usage

We recommend that you pull and store the bank list locally rather than fetching it on every request. The bank list is rarely updated, and caching it reduces latency and load on your application.

If there is any update to the list (e.g., new banks added or metadata changes), Payceler will notify all integrated clients promptly.

Get a list of banks for NGN currency

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

X-CLIENTIDstringRequired

Client identifier for the API.

Example: sdfgfd-sdfgf4d-sdfgfdsd-sdfgfds

Responses

200

A list of banks for NGN currency.

application/json

namestringOptional

The name of the bank.

Example: UBA

codestringOptional

The code of the bank.

Example: 4

cbn_codestringOptional

The CBN code of the bank.

Example: 101

currency_codestringOptional

The currency code for the bank.

Example: NGN

401

Unauthorized - Missing or invalid X-CLIENTID header.

application/json

500

Server error

application/json

get

/v1/payment/banks/ngn/

HTTPcURLJavaScriptPython

GET /v1/payment/banks/ngn/ HTTP/1.1
Host: disbuzapi.celergate.net
Authorization: Bearer YOUR_SECRET_TOKEN
X-CLIENTID: text
Accept: */*

[
  {
    "name": "UBA",
    "code": "000004",
    "cbn_code": "101",
    "currency_code": "NGN"
  },
  {
    "name": "Access Bank",
    "code": "000014",
    "cbn_code": "102",
    "currency_code": "NGN"
  }
]