🛂ID Verification

Our ID Verification API allows you to validate user identities using Nigeria’s major national identifiers: BVN and NIN.

Enpoint POST https://api.xixapay.com/api/identity/verify

🔐 Request Header^s

{
  "Authorization": "Bearer YOUR_API_SECRET",
  "Content-Type": "application/json",
  "api-key": "YOUR_API_KEY"
}

📦 Request Body

Field	Type	Required	Description
id_number	string	✅	string,
businessId	string	✅	Your registered business ID (max 255 characters).
id_type	string	✅	Must be either "nin" or "bvn".

Example

{
  "businessId": "xixapay_7890",
  "id_number": "1234567890",
  "id_type": "bvn"
}

✅ Success Response:

{
    "status": "success",
    "message": "NIN verification successful",
    "data": {
        "verification_type": "nin",
        "identity_number": "444******@*@*@@",
        "personal_details": {
            "first_name": "Godwin",
            "middle_name": "ADEKUNLE",
            "last_name": "Godpower",
            "full_name": null,
            "date_of_birth": "1910-10-30",
            "gender": "Male",
            "nationality": "Nigerian"
        },
        "contact_details": {
            "phone_number": "070***97088",
            "phone_number2": null,
            "email": null
        },
        "biometric_data": {
        "photo" : "uufufufufufufufufu"
          "photo_available": true
        },
        "verification_metadata": {
            "request_id": "6fad7fd9a154eb0d7b7b4beaaf2a06821a1b523f",
            "timestamp": "2025-05-17T23:42:24.868743Z",
            "cost_charged": 30
        }
    }
}