BVN Information Verification

This API allows you to verify that the BVN information supplied by a user matches what is configured on the BVN.

The input to this API is the BVN, expected name on the BVN, date of birth, and mobile number. The API then compares what is supplied to what is actually linked to the BVN and tells you if the supplied input matches or not.

For the date of birth and mobile number fields, an exact comparison is done so you get one of two statuses: a FULL_MATCH or NO_MATCH as the case may be.

For name, a slightly advanced comparison is done and you can get one of three statuses: FULL_MATCH, PARTIAL_MATCH, NO_MATCH.

Price

This service costs N10 for each successful request.

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-details-match

HTTP Method: POST

Please note that the BVN samples used in this documentation are not real and are just indicative of how the API should be used

Scenario 1: Bank Verification Number is not valid

Sample Request:

{
	"bvn":"22222222226",
    "name": "Benjamin Ranae RT",
    "dateOfBirth": "03-Oct-1993",
    "mobileNo": "08016857829"
}

Sample Response:

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

Scenario 2: Valid Bank Verification Number and Invalid Account Name

Sample Request:

{
	"bvn":"22222222226",
    "name": "Benjamin Ranae RT",
    "dateOfBirth": "03-Oct-1993",
    "mobileNo": "08016857829"
}

Sample Response:

Scenario 3: Specified name partially matches what is on the supplied BVN.

Sample Request:

Sample Response:

Scenario 4: Full Match for the Mobile number on the account

Sample Request:

Sample Response:

100% Full Match On Mobile Number:

Field Reference

Field	Description	Status

Field	Description	Status
bvn	11 digit bank verification number expected to belong to the account holder.	Required
mobileNo	11 - 13 digit number expected to belong to the account holder	Required
dateOfBirth	Date of birth of the account holder. The expected format is `dd-MMM-yyyy`	Required

Name matching Rules:

	Description of Scenario	Sample BVN Names	Sample Account Name	Match Status

	Description of Scenario	Sample BVN Names	Sample Account Name	Match Status
1.	Name on BVN contains all of names on account number	ABC	CBA	FULL_MATCH
2..	There are at least two matches in BVN or account names	ABC, BC, CD	BCD, AB, AC	PARTIAL_MATCH
3.	There is one match in BVN or account names, or no match at all	ABC	CDE, FGH	NO_MATCH