Name Enquiry

⚠️ Important Notes

• Name enquiry is required for every transaction. Before initiating any payout, you must perform a name enquiry on the destination account.

• Use the returned account name The name returned from the enquiry should be passed as the account_name field when initiating a payout request.

Retrieve account holder information

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

bank_codestringRequired

The bank code of the bank. You can use either the bank_code or the cbn_code.

Example: 101

account_numberstringRequired

The account number to verify.

Example: 1700263070

Header parameters

X-CLIENTIDstringRequired

Client identifier for the API.

Example: sdfgfd-sdfgf4d-sdfgfdsd-sdfgfds

Responses

200

Account information retrieved successfully.

application/json

account_namestringOptional

Name of the account holder.

Example: John Doe

account_numberstringOptional

The queried account number.

Example: 1700263070

400

Bad Request - Missing or invalid query parameters.

application/json

401

Unauthorized - Invalid or missing credentials.

application/json

500

Server error

application/json

get

/v1/payment/name-enquiry/NGN/

HTTPcURLJavaScriptPython

GET /v1/payment/name-enquiry/NGN/?bank_code=text&account_number=text HTTP/1.1
Host: disbuzapi.celergate.net
Authorization: Bearer YOUR_SECRET_TOKEN
X-CLIENTID: text
Accept: */*

{
  "account_name": "John Doe",
  "account_number": "1700263070"
}