BVN iGree

Verify a customer’s identity using their Bank Verification Number (BVN) through the Nigeria Inter-Bank Settlement System (NIBSS) consent management framework, powered by iGree.

Introduction

To strengthen the protection of personal data for individuals enrolled in the BVN program, the Central Bank of Nigeria (CBN) introduced a mandatory consent layer for all BVN-based verification services. In response, NIBSS—custodian of the BVN database—launched iGree, a secure, standardized consent management platform designed to put users in control of how their BVN information is shared.

What is iGree?

iGree is a centralized, user-driven consent platform that authenticates BVN holders and manages their approval across web and mobile applications. It brings a unified identity experience to merchants, service providers, and digital platforms by enabling NIBSS to capture real-time, regulatory-compliant consent directly from the customer before their data is released. In practice, iGree becomes part of your onboarding flow, ensuring transparency, compliance, and a seamless user journey.


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

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

Path Parameter

Parameter

Type

Description

idNumber (REQUIRED)

string

Bank 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 secure link to the NIBSS consent management form. 2️⃣ The user authenticates and grants permission for their BVN information to be shared. 3️⃣ Once end-user consent is received, the BVN information for the user is returned.