BVN verification

This page describes the process for BVN verification

Bank verification number (BVN) is only available for Nigerian customers. This is a means of verifying a customer and can be used for KYC. Customer supplies their BVN and you call our Resolve bvn details endpoint. This service costs N50 per call.

Below is a sample request:

cURL

curl --location --request GET 'https://api.flutterwave.com/v3/kyc/bvns/12345678019' \
    --header 'Authorization: Bearer {{SEC_KEY}}'

Node

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://rave-api-v2.herokuapp.com/v3/kyc/bvns/12345678019',
  'headers': {
    'Authorization': 'Bearer {{SEC_KEY}}'
  }
};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

HEADERS

---

Authorization
Bearer {{SEC_KEY}}

---

Path Variables
bvn
123456789

---

Sample Response

JSON

{
  "status": "success",
  "message": "BVN details fetched",
  "data": {
    "bvn": "123456789",
    "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",
    "image_base_64": null,
    "address": null,
    "gender": "Male",
    "email": null,
    "watch_listed": null,
    "nationality": "Nigerian",
    "marital_status": null,
    "state_of_residence": null,
    "lga_of_residence": null,
    "image": null
  }
}

❗️

Do Not Store Customer BVN

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