BVN Verification is only available for Nigerian customers. It allows you to 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 are paid for

BVN API calls cost N50 per call. To use this service, you would need to ensure your Flutterwave wallet balance is funded.

Prerequisites

• A Flutterwave account, you can create a free account here
• Your API keys - Once you've created an account, navigate to settings > API to get your keys

Verify BVN

With your API secret key, you can make an API call to our BVN verification endpoint like so

curl --request GET \
  --url https://api.ravepay.co/v2/kyc/bvn/12345678901?seckey=FLWSECK-e6db11d1f8a6208de8cb2f94e293450e-X \
  --header 'content-type: application/json'

var request = require("request");

request.post(
  "https://api.ravepay.co/v2/kyc/bvn/12345678901",{
  "seckey": "FLWSECK-e6db11d1f8a6208de8cb2f94e293450e-X"},
  (error, response, body) => {
    if (error) {
      console.error(error);
      return;
    }
    console.log(`statusCode: ${response.statusCode}`);
    console.log(body);
  }
);

What happened in the request above?

We passed the customer's BVN as a path to the endpoint and added our secret key as a query parameter.

Sample Response

If the BVN supplied by the customer is valid and you handled your API call correctly, you should get a response in the following format:

{
    "status": "success",
    "message": "BVN-DETAILS",
    "data": {
        "bvn": "12345678901",
        "first_name": "John",
        "middle_name": "Cyril",
        "last_name": "Madakin",
        "date_of_birth": "01-01-1905",
        "phone_number": "08012345678",
        "registration_date": "01-01-1921",
        "enrollment_bank": "044",
        "enrollment_branch": "Lekki"
    }
}

❗️

Do Not Store Customer BVN

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