Nigeria Bank Account Verification

Verifies a Nigerian bank account using the provided bank code and account number. The endpoint resolves the account and returns the registered account name and bank details when the account is successfully verified.

Endpoint

POST {{base_url}}/api/v1/payout/bank-list/verify

Authentication

Important: Merchant API Key Required

This endpoint uses your Merchant API Key for authentication.

Use the Merchant API Key provided when your merchant account was created.

AuthenticationRequiredValue
Bearer TokenYesAPILXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXUI07V2

Headers

HeaderRequiredDescription
AuthorizationYesMerchant API Key as a Bearer token.
x-merchant-refYesYour unique merchant reference.
Content-TypeYesMust be set to application/json.

Request Body

{
  "bank_code": "090551",
  "account_number": "0316839265"
}

Request Fields

FieldTypeRequiredDescription
bank_codeStringYesUnique code identifying the Nigerian bank or financial institution.
account_numberStringYesNigerian bank account number to be verified.

Example Request

curl --location -g '{{base_url}}/api/v1/payout/bank-list/verify' \
--header 'Authorization: Bearer APILXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXUI07V2' \
--header 'x-merchant-ref: {{x-merchant-ref}}' \
--header 'Content-Type: application/json' \
--data '{
  "bank_code": "090551",
  "account_number": "0316839265"
}'

Response

200 OK

{
  "status": "success",
  "message": "Account resolved",
  "data": {
    "status_code": 200,
    "account_name": "James Harry",
    "bank_code": "090851",
    "bank_name": "First Bank"
  }
}

Response Fields

FieldTypeDescription
statusStringIndicates whether the request was successful.
messageStringResponse message.
dataObjectContains the resolved bank account information.
data.status_codeIntegerStatus code returned for the account verification.
data.account_nameStringName registered to the bank account.
data.bank_codeStringBank code associated with the account.
data.bank_nameStringName of the bank or financial institution.

Did this page help you?