This API allows you to verify that the Bank verification number and the account number supplied by a user match the BVN and account number linked to that account.
| Info |
|---|
Endpoint: POSTThis endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here |
Endpoint URL: https://api.monnify.com/api
...
/vas/bvn-account-match
This endpoint is protected by OAuth 2.0 Bearer Token
HTTP Method: POST
Scenario 1: BVN is not valid.
Sample Request:
| Code Block | ||
|---|---|---|
| ||
{
"bankCode":"057",
"accountNumber":"2191802645",
"bvn":"22222222226"
} |
Sample Response:
| Code Block | ||
|---|---|---|
| ||
{
"requestSuccessful": false,
"responseMessage": "Unable to process request. Invalid BVN provided",
"responseCode": "99"
} |
...
Sample Response:
| Code Block | ||
|---|---|---|
| ||
{
"requestSuccessful": false,
"responseMessage": "Unable to process request. Name inquiry failed. Account 0103284195 Bank 044. Invalid Account",
"responseCode": "99"
} |
...