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
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

Body Parameter

ParameterTypeDescriptionRequired
vnin *stringA uniquely generated virtual ninrequired
selfie_image *stringBase64 value of the selfie imagerequired

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
        }
    }
}