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.

1. Sign-up for a test account here, and for a live account here .

2. 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"
    }
}