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
ParameterTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Body Parameter

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