Verify Nigeria vNIN with selfie

Verify a Nigeria virtual NIN (vNIN) together with a selfie photo

The Virtual NIN (vNIN) is a tokenized version of a user's actual NIN which is given to third parties like Appruve for verification purposes. This tokenized version means the user's actual NIN is kept private. The vNIN is a 16-digit set of alphanumeric characters which expires 72 hours after being generated.

How to generate vNIN via USSD

To generate a Virtual NIN via USSD, dial *346*3*Your NIN*Agent Code#

An SMS message will be sent back to you containing the Virtual NIN generated for you. Contact [email protected] for the Agent Code.

How to generate vNIN via the NIMC app

1. Download the NIMC App

2. Click on "Get Virtual NIN"

3. Select "Input Enterprise short-code" and type Agent Code

4. Click "Submit" and your virtual NIN will be generated.

Verify vNIN with selfie

POST https://api.appruve.co/v1/verifications/ng/virtual_nin_with_selfie

This endpoint allows you to verify a vNIN together with a selfie photo

Headers

Name	Type	Description
Authorization*	String	Bearer <token>

Request Body

Name	Type	Description
vnin*	String	The vNIN
selfie_image*	Object	The selfie photo file object

200: OK

{
  "confidence_score": 95,
  "id_type": "national_id",
  "country_code": "ng",
  "status": "success",
  "face_on_id_document": "url",
  "face_match_percent": 90,
  "id_match_percent": 100,
  "selfie_face_url": "url",
  "selfie_image_submitted": "url",
  "id_face_sharpness": 99,
  "id_face_brightness": 89,
  "selfie_face_sharpness": 97,
  "selfie_face_brightness": 91,
  "id_details": {},
  "created_at": "2020-05-11",
  "transaction_reference": "0e2e59cf-2c96-4cc9-b0c2-c8922429b379"
}