Selfie Verification vNIN

Lookup and Verify Users vNIN with their Selfie Image.

To ensure that your customer is who they say they are, you can allow them take a selfie photo which you can pass on to the Dojah for verification process

This helps to significantly reduce the possibility of fraud by confirming the person using your product is the account owner at the validated bank.

Note that; Confidence value is used to verify match and values below 80 are considered false.

• The NIN holder can generate their virtual NIN via the NIMC Mobile App or the NIMC USSD code - _346_3_NIN_EnterpriseCode#.
• Dojah’s Enterprise code - 1138183
• The generated VNIN is valid for only 72 hours
• The vNIN is designed to replace the 11-digit NIN for everyday usage. It is a unique 16-character alphanumeric token comprising 12 digits, sandwiched between 4 alphabets, two on each end, with no correlation to the issuer’s Raw NIN. An example of a vNIN is: AB012345678910YZ.
• According to NIMC, The VNIN is not to be stored in any database but only used for verifying the NIN holder.

Request

[POST]

{{baseUrl}}/api/v1/kyc/vnin/verify

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Body Parameter

Parameter	Type	Description	Required
vnin *	string	A uniquely generated virtual nin	required
selfie_image *	string	Base64 value of the selfie image	required

Response

Response

{
    "entity": {
        "firstname": "John",
        "middlename": "Asake",
        "surname": "Doe",
        "userid": "WXLLUK-1011",
        "gender": "M",
        "photo": "/9j/4AA....",
        "vnin": "EE848965768582SO",
        "telephoneno": "2348012345678",
        "birthdate": "18-05-1992",
        "selfie_verification": {
            "confidence_value": 0,
            "match": false
        }
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the vNIN verification response data
entity.firstname	string	First name of the NIN holder
entity.middlename	string	Middle name of the NIN holder
entity.surname	string	Surname of the NIN holder
entity.userid	string	Unique user identifier assigned by NIMC
entity.gender	string	Gender of the NIN holder (M or F)
entity.photo	string	Base64-encoded photo from the NIN record
entity.vnin	string	The virtual NIN used for the verification request
entity.telephoneno	string	Phone number associated with the NIN record
entity.birthdate	string	Date of birth of the NIN holder
entity.selfie_verification	object	Selfie verification result comparing the submitted selfie to the NIN photo
entity.selfie_verification.confidence_value	number	Confidence score of the selfie match (0–100). Values below 80 indicate no match
entity.selfie_verification.match	boolean	Whether the selfie matches the NIN photo (true if confidence ≥ 80)