HomeAPI ReferenceAPI Documentation
Dashboard

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 rave 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.

❗️

Storing BVN Information

Merchants are strongly advised against storing the BVN information in your database or any storage format. Please do not do this.

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