Resolve BVN
Learn how to get a Know Your Customer (KYC) profile from a customer's Bank Verification Number (BVN)
Introduction
The Resolve BVN service helps you build a KYC profile for a Nigeria-based customer using their BVN.
This service has two tiers: Standard and Premium. The Premium tier provides all the information in the Standard tier, as well as more granular information for a more detailed KYC profile.
Pricing
BVN Resolve Standard costs N10 per successful call while BVN Resolve Premium costs N15 per successful call.
Information Provided
Here's a side by side comparison of the information provided by both tiers.
BVN Resolve Standard | BVN Resolve Premium |
---|---|
First name | First name |
Last name | Last name |
Phone number | Phone number |
Date of birth | Date of birth |
– | Image |
– | Marital Status |
– | Gender |
– | Nationality |
– | State and LGA of origin |
– | Residential Address |
– | Enrollment Bank |
– | Name on card |
BVN Resolve Standard
The BVN Resolve Standard is useful for when you need basic KYC information from a customer's BVN.
1curl https://api.paystack.co/bank/resolve_bvn/:BVN2-H "Authorization: Bearer YOUR_SECRET_KEY"3-X GET
1{2 "status": true,3 "message": "BVN resolved",4 "data": {5 "first_name": "LARRY",6 "last_name": "JAMES",7 "dob": "30-Jan-60",8 "formatted_dob": "1960-01-30",9 "mobile": "08012345678",10 "bvn": "xxxxxxxxxxx"11 },12 "meta": {13 "calls_this_month": 1,14 "free_calls_left": 915 }16}
Pricing
BVN Resolve Standard costs N10 per successful call. You get 10 free requests per month. After exhausting the 10 free requests, registered businesses will have to top up your Paystack balance.
BVN Resolve Premium
BVN Resolve Premium is best suited for when your business needs a more detailed profile from a customer's BVN.
1curl https://api.paystack.co/identity/bvn/resolve/:BVN2-H "Authorization: Bearer YOUR_SECRET_KEY"3-X GET
1{2 "status": true,3 "message": "BVN resolved",4 "data": {5 "title": "Mr",6 "first_name": "JOHN",7 "middle_name": "MUKITE",8 "last_name": "NAMEME",9 "name_on_card": "MUKITE NAMEME",10 "marital_status": "Married",11 "dob": "17-Jun-80",12 "formatted_dob": "1980-06-17", // YYYY-MM-DD13 "mobile": "08091111111",14 "mobile2": "08090000000",15 "registration_date": "24-Dec-16",16 "formatted_registration_date": "2016-12-24",17 "bvn": "00000000000",18 "gender": "Male",19 "lga_of_origin": "Ilesa West",20 "state_of_origin": "Osun State",21 "residential_address": "126 Joel Ogunnaike St Ikeja GRA, Lagos",22 "lga_of_residence": "Ikeja",23 "nationality": "Nigeria",25 "is_blacklisted": false,26 "enrollment_bank": {27 "name": "First Bank of Nigeria",28 "code": "011",29 "enrollment_branch": "IKEJA BRANCH"30 },31 "level_of_account": "Level 2 - Medium Level Accounts",32 "nin": "",33 "base_64_image": "Base_64_Encoded_Image=="34 },35 "meta": {36 "calls_this_month": 12,37 "free_calls_left": 038 }39}
This is best suited for businesses in these industries:
- Lending
- Savings
- Betting
- Remittance and other financial services
Pricing
BVN Resolve Premium costs N15 per successful call. You'll get 10 free requests per month. After exhausting the 10 free requests, registered businesses will have to top up your Paystack balance.