Introduction

This page contains guide to BVN verification on Inlomax.

Basic BVN Verification

Send a post request to the below endpoint, You can use the PHP integration code below....




curl --request POST 'https://inlomax.com/api/kyc/bvn/basic' \
  --header 'Authorization: Token YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "bvn": "22123456789",
  "first_name": "John",
  "middle_name": "Adebayo",
  "last_name": "Doe",
  "gender": "MALE",
  "birthday": "1992-08-14",
  "phone_number": "08012345678"
}' 

Sample Response

Send a post request to the below endpoint.


{
    "status": "success",
  "message": "BVN verification completed successfully",
  "data": {
    "name_match_rlt": "MATCH",
    "names_match_percentage": "96",
    "birthday_match_rlt": "MATCH",
    "gender_match_rlt": "MATCH",
    "phone_number_match_rlt": "MATCH",
    "charged_amount": "20"
  }
}

 

Enhance BVN Verification

Send a post request to the below endpoint, You can use the PHP integration code below....




curl --request POST 'https://inlomax.com/api/kyc/bvn/enhanced' \
  --header 'Authorization-Token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "bvn": "22123456789"
}' 

Sample Response

Send a post request to the below endpoint.


{
    "status": "success",
  "message": "BVN verification completed successfully",
  "data": {
    "bvn": "22123456789",
    "first_name": "John",
    "middle_name": "Adebayo",
    "last_name": "Doe",
    "gender": "MALE",
    "name_on_card": "JOHN A DOE",
    "birthday": "1992-08-14",
    "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "phone_number": "08012345678",
    "phone_number_2": "08087654321",
    "charged_amount": "35"
  }
}