BVN and Account Name Match

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.

This 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/v1/vas/bvn-account-match

HTTP Method: POST

Scenario 1: BVN is not valid.

Sample Request:

{
	"bankCode":"057",
	"accountNumber":"2191802645",
	"bvn":"22222222226"
}

Sample Response:

{
    "requestSuccessful": false,
    "responseMessage": "Unable to process request. Invalid BVN provided",
    "responseCode": "99"
}

Scenario 2: Supplied account number is not valid.

Sample Request:

{
	"bankCode":"044",
	"accountNumber":"0103284195",
	"bvn":"22228765899"
}

Sample Response:

Scenario 3: BVN, Bank Code, and Account Number is valid

Sample Request:

Sample Response:

Field Reference:

Field	Description	Comment

Field	Description	Comment
bvn	11 digit bank verification number expected to belong to the account holder.	Required
bankCode	CBN bank code for the bank where the account number is domiciled. Click here to get a full list of all supported banks.	Required
accountNumber	10 digit bank account number.	Required