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
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
get
/v1/payment/name-enquiry/NGN/
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"
}
PreviousBank ListNextInitiate Payout

Last updated