Initiate BVN Consent

curl --request POST \
  --url https://api.flutterwave.com/v3/bvn/verifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bvn": "22222222280",
  "firstname": "Nibby",
  "lastname": "Certifier",
  "redirect_url": "https://example-url.company.com"
}
'

import requests

url = "https://api.flutterwave.com/v3/bvn/verifications"

payload = {
    "bvn": "22222222280",
    "firstname": "Nibby",
    "lastname": "Certifier",
    "redirect_url": "https://example-url.company.com"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    bvn: '22222222280',
    firstname: 'Nibby',
    lastname: 'Certifier',
    redirect_url: 'https://example-url.company.com'
  })
};

fetch('https://api.flutterwave.com/v3/bvn/verifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/bvn/verifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'bvn' => '22222222280',
    'firstname' => 'Nibby',
    'lastname' => 'Certifier',
    'redirect_url' => 'https://example-url.company.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/bvn/verifications"

	payload := strings.NewReader("{\n  \"bvn\": \"22222222280\",\n  \"firstname\": \"Nibby\",\n  \"lastname\": \"Certifier\",\n  \"redirect_url\": \"https://example-url.company.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flutterwave.com/v3/bvn/verifications")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bvn\": \"22222222280\",\n  \"firstname\": \"Nibby\",\n  \"lastname\": \"Certifier\",\n  \"redirect_url\": \"https://example-url.company.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bvn/verifications")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"bvn\": \"22222222280\",\n  \"firstname\": \"Nibby\",\n  \"lastname\": \"Certifier\",\n  \"redirect_url\": \"https://example-url.company.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Bvn verification initiated",
  "data": {
    "url": "https://nibss-bvn-consent-management.dev-flutterwave.com/cms/BvnConsent?session=ZDdiYjVjODMtYWE0My00NjI0LTllMjAtYTQyODBmMzI1NmQ5",
    "reference": "FLWA968D23A3D2BE31F5D63D0"
  }
}

{
  "status": "error",
  "message": "lastname is required",
  "data": null
}

POST

bvn

verifications

Initiate BVN Consent

curl --request POST \
  --url https://api.flutterwave.com/v3/bvn/verifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bvn": "22222222280",
  "firstname": "Nibby",
  "lastname": "Certifier",
  "redirect_url": "https://example-url.company.com"
}
'

import requests

url = "https://api.flutterwave.com/v3/bvn/verifications"

payload = {
    "bvn": "22222222280",
    "firstname": "Nibby",
    "lastname": "Certifier",
    "redirect_url": "https://example-url.company.com"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    bvn: '22222222280',
    firstname: 'Nibby',
    lastname: 'Certifier',
    redirect_url: 'https://example-url.company.com'
  })
};

fetch('https://api.flutterwave.com/v3/bvn/verifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/bvn/verifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'bvn' => '22222222280',
    'firstname' => 'Nibby',
    'lastname' => 'Certifier',
    'redirect_url' => 'https://example-url.company.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/bvn/verifications"

	payload := strings.NewReader("{\n  \"bvn\": \"22222222280\",\n  \"firstname\": \"Nibby\",\n  \"lastname\": \"Certifier\",\n  \"redirect_url\": \"https://example-url.company.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flutterwave.com/v3/bvn/verifications")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bvn\": \"22222222280\",\n  \"firstname\": \"Nibby\",\n  \"lastname\": \"Certifier\",\n  \"redirect_url\": \"https://example-url.company.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bvn/verifications")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"bvn\": \"22222222280\",\n  \"firstname\": \"Nibby\",\n  \"lastname\": \"Certifier\",\n  \"redirect_url\": \"https://example-url.company.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Bvn verification initiated",
  "data": {
    "url": "https://nibss-bvn-consent-management.dev-flutterwave.com/cms/BvnConsent?session=ZDdiYjVjODMtYWE0My00NjI0LTllMjAtYTQyODBmMzI1NmQ5",
    "reference": "FLWA968D23A3D2BE31F5D63D0"
  }
}

{
  "status": "error",
  "message": "lastname is required",
  "data": null
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

bvn

string

required

firstname

string

required

lastname

string

required

redirect_url

string

required

Response

status

string

required

message

string

required

data

Data89 · object

required

Show child attributes

Example:

{
  "url": "https://nibss-bvn-consent-management.dev-flutterwave.com/cms/BvnConsent?session=ZDdiYjVjODMtYWE0My00NjI0LTllMjAtYTQyODBmMzI1NmQ5",
  "reference": "FLWA968D23A3D2BE31F5D63D0"
}

API Documentation

Charges

Tokenized Charges

Preauthorization

Transactions

Transfers

Beneficiaries

Virtual Cards

Virtual Account Numbers

Collection Subaccounts

Payout Subaccounts

Subscriptions

Payment Plans

Bill Payments

Banks

Misc

Settlements

Otps

Chargebacks

Initiate BVN Consent

Authorizations

Body

Response