BVN iGree

Verify a customer's identity using their Bank Verification Number (BVN) through the new Nigeria Inter-Bank Settlement System (NIBSS) consent management system.

Introduction

The Central Bank of Nigeria (CBN) has introduced a consent management layer to ensure the protection of the personal data of Nigerians with registered BVNs. As a result, the Inter-Bank Settlement System (NIBSS), which manages and maintains the BVN database, has created a consent management platform known as iGree.

What is iGree?

iGree is a centralized platform that allows for authentication and consent management for web and mobile applications. It unifies identity across services, service providers, and use cases. Essentially, it's a user interface integrated into a merchant's end-user onboarding process that enables NIBSS to collect consent directly from the BVN holder.

For more information on the BVN iGree Verification process. Click here

https://api.qoreid.com/v1/ng/identities/bvn-consent/{bvn}

Path Parameter

ParameterTypeDescription
idNumber
(REQUIRED)
stringBank Verification Number

This endpoint will return a link to the consent management screen from NIBSS. To conduct an actual test

Response Sample

{
  "bvn": "22222222222",
  "consentUrl": "https://id.nibss-plc.com.ng/oxauth/restv1/authorize?response_type=code&client_id=b21f9880-0aa1-4671-9795-6161a1e8d871&state=2de34b39f50ed9c12812f9be2adc61b4bd9c8d3c&scope=profile%20email_address%20address%20banking_data%20phone_number&redirect_uri=https://api-apps.vfdbank.systems/vfd-bvn-consent/v1.0/bvn2/get-consent",
  "consentStatus": false
}

Steps to accessing BVN data using iGree

1️⃣ Use the endpoint to generate a link to the consent management form.
2️⃣ End-user grants access to their BVN information following the consent management process.
3️⃣ Once end-user consent is received, the BVN information for the user is returned.