The Flutterwave Developer Documentation

We have put together comprehensive guidelines and documentation to help you get right into integrating any of our products quickly. You can also get support when you need help!

API Documentation    API Reference

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 --location --request GET 'https://api.flutterwave.com/v3/kyc/bvns/12345678019' \
    --header 'Authorization: Bearer {{SEC_KEY}}'
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

{
  "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.

Updated about a year ago



BVN verification


This page describes the process for BVN verification

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.