Sign in

v1

latestOpenAPI 3.1.02026-07-2656114159.7 KB
Identity Verification

Enhanced NIN Verification

Verify a NIN and retrieve enriched identity information such as names, gender, birth date, photo, and telephone number tied to the NIN.

post/api/v1/merchant/nin/enhanced

Headers

api-keystring required

Your Payvessel public API key

api-secretstring required

Your Payvessel secret

Content-Type'application/json' required

Request content type

Request body

ninstring required

Customer NIN

Example request

{
  "nin": "12345678901"
}

Response

Enhanced NIN verification response

successboolean required

Whether the request completed successfully

messagestring required

Response message

Example response

{
  "success": true,
  "message": "NIN verification completed successfully",
  "data": {
    "nin": "12345678901",
    "first_name": "John",
    "middle_name": "Adebayo",
    "surname": "Doe",
    "gender": "MALE",
    "birth_date": "1992-08-14",
    "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "telephone_no": "08012345678"
  },
  "charges": {
    "charged_amount": "0.00"
  }
}