BVN

BVN is available by default on the Basic KYC product. To use BVN on Enhanced KYC or Biometric KYC products, you need to be integrated via our Mobile SDKs or Web Integration (Beta) and display our user consent screen or contact [e-mail]

Required Inputs

Input	Value
country	NG
id_type	BVN
id_number	Bank verification number

Response Fields

Response Field	Value Returned
Country	YES
IDType	YES
IDNumber	YES
IssuanceDate	YES
ExpirationDate	N/A
FullName	YES
DOB	YES
Photo	YES
PhoneNumber	YES
PhoneNumber2	IF AVAILABLE
Document	NO
Gender	YES
Address	YES

All fields are returned as string

ID Number Regular Expression (Regex)

To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regex below:

• /^[0-9]{11}$/

Supported Products

The Nigeria BVN can be used on any of the following products:

• Basic KYC
• Enhanced KYC
• Biometric KYC

For the supported integration options, you can check the integration options supported by each product here.

⚠ Important: For Basic KYC, we can only match the following fields: first_name, middle_name, last_name, gender, dob, phone_number.

Sample ID Numbers

To test the Nigeria BVN in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.

ID Number	Result	Result Code
00000000000	Success with PII return	1012
00000000001	Failure, no record found	1013
00000000002	Invalid ID number format	1014
00000000003	Database unavailable/unknown network issue	1015
00000000004*	Success with custom PII return	1012

* to get a successful Biometric KYC, you will need to pass a custom photo. You can read more about customising the PII response in sandbox in our documentation here.