Bank Account Verification

This endpoint allows you return bank account verification. This is the first version payload

POST

{{baseurl}}/v1/identities/banks/verify_account

Permission: resolve Bank Account Number

Header

Field	Type	Description
token	String	Secret API token

Parameter

Field	Type	Description
account_number	String	user account number
bank_code	String	user bank code Get bank List
subject_consent	Boolean	Indicate subject has given consent. Must be true

Sample Request

{
    "account_number": "0141xxxxxx",
    "bank_code": "058",
    "subject_consent": true
}

Found Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "6201e981793b002b32130094",
            "reference_id": "6201e981793b002b32130094",
            "subject_consent": true,
            "candidate": {
                "id": "6201e981793b002b32130094",
                "reference_id": "6201e981793b002b32130094",
                "full_name": "EHICHIOYA FAMOUS PRIOR",
                "bank_name": "Guaranty Trust Bank",
                "account_number": "0141xxxxxx",
                "bank_code": "058"
            },
            "status": "completed",
            "identity_status": "VERIFIED",
            "identity_number": "0141xxxxxx",
            "package": "identity",
            "package_name": "Identity",
            "type": "bank_account_verification",
            "business": "Youcheck Online Services Limited",
            "task_created_by": "Youcheck Online Services Limited",
            "end_time": null,
            "created_at": "2022-02-08T03:54:42.909Z",
            "images": {
                "data": []
            }
        },
        "status_code": 200
    }

Not Found Response

HTTP/1.1 200 OK
    {
        "message": "Could not resolve account name. Check parameters or try again.",
        "name": "LegacyAPIError",
        "status_code": 400
    }

Service Unavailability

HTTP/1.1 503 Internal Server Error
{
    "message": "Third-party provider not reacheable",
    "name": "LegacyAPIError",
    "status_code": 503
}

HTTP/1.1 400 Bad Request
{
  "message": "Could not resolve account name. Check parameters or try again.",
  "name": "LegacyAPIError",
  "status_code": 400
}