BVN Validation
This shows how to validate your customer's BVN
BVN Validation is only available for Nigerian customers. It allows you verify BVN supplied by a customer and can also be used for customer KYC methods such as; validating date of birth
supplied by the customer, validating the mobile number, first name & last name etc.
BVN API calls cost N50 per call. To use this service, you would need to fund your quidpay balance, by navigating to transfers on the dashboard and using the top up balance option. To top up use the access bank account payment option and use this test account
0690000031
.
Pre-requisites for using the BVN validation service.
-
Sign-up for a test account here, and for a live account here .
-
Retrieve your secret key to make authenticated calls to the BVN API.
Step 1: Collect BVN from customer
In this step, you only need to collect BVN from the customer, and pass to us using the sample request below:
Sandbox Endpoint: https://ravesandboxapi.flutterwave.com/v2/kyc/bvn
Live Enpoint: https://api.ravepay.co/v2/kyc/bvn
Sample Request:
curl --request GET \
--url https://ravesandboxapi.flutterwave.com/v2/kyc/bvn/12345678901?seckey=FLWSECK-e6db11d1f8a6208de8cb2f94e293450e-X \
--header 'content-type: application/json'
What happened in the request above?
We passed the bvn of the customer as a path to the endpoint and added our secret key as a query parameter e.g. https://ravesandboxapi.flutterwave.com/v2/kyc/bvn/:bvnnumber?seckey=FLWSECK-e6db11d1f8a6208de8cb2f94e293450e-X
Sample Response:
{
"status": "success",
"message": "BVN-DETAILS",
"data": {
"bvn": "12345678901",
"first_name": "Wendy",
"middle_name": "Chucky",
"last_name": "Rhoades",
"date_of_birth": "01-01-1905",
"phone_number": "08012345678",
"registration_date": "01-01-1921",
"enrollment_bank": "044",
"enrollment_branch": "Idejo"
}
}
Updated almost 6 years ago