Basic Bank Account Verification

Bank Account Verification

POST {{baseurl}}/v2/api/identity/ng/bank-account-number/resolve

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Name	Type	Description
accountNumber*	String	Valid account number
bankCode*	String	Bank code gotten from list of banks
isSubjectConsent*	Boolean	Indicate subject has given consent. Must be true

Bank Account Verification

Bank Account Verification is used to verify the owner of a bank account.

Sample Request

{
    "accountNumber": "1000000000",
    "bankCode": "058",
    "isSubjectConsent": true
}

Note: To get the list of banks in Nigeria, click here

Found Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6284b245c1f36651d41dc6f3",
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": false,
        "selfieValidation": false,
        "isConsent": true,
        "idNumber": "1000000000",
        "businessId": "6222a5ed3e7a41c29c031ecc",
        "bankDetails": {
            "accountName": "MICHAEL JOHN DOE",
            "accountNumber": "1000000000",
            "bankName": "Guaranty Trust Bank"
        },
        "type": "bav",
        "requestedAt": "2022-05-18T08:45:58.066Z",
        "requestedById": "6222a5ed3e7a41c29c031ece",
        "country": "NG",
        "createdAt": "2022-05-18T08:45:58.079Z",
        "lastModifiedAt": "2022-05-18T08:45:58.079Z",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "6222a5ed3e7a41c29c031ece"
        }
    },
    "links": []
}

Not Found Response

HTTP/1.1 200 OK
{
         "success": true,
         "statusCode": 200,
         "message": "success",
         "data": {
             "parentId": null,
             "status": "not_found",
             "dataValidation": false,
             "selfieValidation": false,
             "isConsent": true,
             "idNumber": "0141258801",
             "businessId": "61d880f1e8e15aaf24558f1a",
             "bankDetails": {
                 "accountName": null,
                 "accountNumber": null,
                 "bankName": null
             },
             "type": "bav",
             "requestedAt": "2022-02-08T01:51:10.746Z",
             "country": "NG",
             "createdAt": "2022-02-08T01:51:10.917Z",
             "lastModifiedAt": "2022-02-08T01:51:10.917Z",
             "id": "6201cc85dce3f50214956971",
             "requestedBy": {
                 "firstName": "Famous",
                 "lastName": "Ehichioya",
                 "middleName": "Prior",
                 "id": "61d880f2e8e15aaf24558f9b"
             }
         },
         "links": []
     }