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.
| Authentication | Required | Value |
|---|---|---|
| Bearer Token | Yes | APILXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXUI07V2 |
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Merchant API Key as a Bearer token. |
x-merchant-ref | Yes | Your unique merchant reference. |
Content-Type | Yes | Must be set to application/json. |
Request Body
{
"bank_code": "090551",
"account_number": "0316839265"
}Request Fields
| Field | Type | Required | Description |
|---|---|---|---|
bank_code | String | Yes | Unique code identifying the Nigerian bank or financial institution. |
account_number | String | Yes | Nigerian 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
200 OK{
"status": "success",
"message": "Account resolved",
"data": {
"status_code": 200,
"account_name": "James Harry",
"bank_code": "090851",
"bank_name": "First Bank"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
status | String | Indicates whether the request was successful. |
message | String | Response message. |
data | Object | Contains the resolved bank account information. |
data.status_code | Integer | Status code returned for the account verification. |
data.account_name | String | Name registered to the bank account. |
data.bank_code | String | Bank code associated with the account. |
data.bank_name | String | Name of the bank or financial institution. |
Updated about 1 month ago
Did this page help you?
