Bank Account Verification Service

Verifying Account Number

Bank Account verification service (BAVS) is a service that allows you to verify if a person is indeed the holder of a specific bank account, and this is done by verifying the person’s account number with the bank in question. A true or false response will be obtained on successful verification and you will get the dataset returned for a valid account number verified.

This service is currently only available for Nigerian Banks.

Banks are grouped by their response status

S/N

Bank’s Name

Response Status

1

FCMB, First bank, GTB, Stanbic Bank, Unity Bank, Wema, Zenith

Full Data Returned

2

Access, Diamond, Ecobank, Skye, Sterling, Union Bank

Limited Data Returned: Account Name and Account Currency

3

UBA

Limited Data Returned: Account Name, Account Currency, Phone Number, and Country code

4

Heritage Bank

Limited Data Returned: Account Name, Account type, Account Currency, Phone Number, and Country code

Sample JSON Response Returned

"FullData": {
"Account": "Jane Anne Doe",
"FirstName": " Jane",
"MiddleName": " Anne",
"LastName": " Doe",
"AccountType": "10",
"AccountCurrency": "NAIRA",
"Address": "10, OJORA CLOSE, VITORIA ISLAND",
"Address2": "LAGOS",
"City": "Lagos",
"Phone": "07000000000",
"PostalCode": "00234",
"StateCode": "LG",
"CountryCode": "NG",
"BVNNumber": "00000000000",
"Nationality": "Nigeria",
"CountryOfBirth": "Nigeria",
"CountryOfIssue": "Nigeria",
"DOB": "21/01/2000",
"Expiry": "",
"success": true,
"message": "Results Found"
}

To perform an Account Verification and Return Personal Info, kindly follow the steps below:

  1. Generate the list of bank codes from the endpoint below using a GET Request

2. Copy the code of the bank account you want to verify from the response returned

3. Verify an Account Number from the endpoint below using a POST Request

Example of JSON Request Payload

{
"partner_id": "023",
"timestamp": 1556307484476,
"sec_key": "...",
"country": "NG",
"id_type": "BANK_ACCOUNT",
"id_number": "0000000000",
"bank_code": "032",
"first_name": "Jane",
"middle_name": "Anne",
"last_name": "Doe",
"phone_number": "1234567890",
"dob": "1980-05-04",
"partner_params": {
"job_id": "3ba0e15e-1a56-4799-a94d-b0e084f50256",
"user_id": "4cb0f26-2b567-5800-b05e-c0f095g6036",
"job_type": 5
}
}