Selfie Matching With BVN (Not Available)

Search…

Verify the identity of a person using a Selfie Photo and a BVN

Appruve makes it easy to implement a selfie photo verification flow using a Nigeria BVN. There are three steps involved.
1. Verify the BVN
The first step is to verify the BVN. An OTP will be sent to the phone number of the BVN owner to confirm. See Verify BVN With OTP​
Example request:
curl --location --request POST 'https://api.appruve.co/v1/verifications/bvn/verify' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
	"bvn": "22000000000"
}'
Example response:
{
    "success": true,
    "transaction_reference": "93ca2d74-e11e-4044-82d9-da7db4225045"
}
2. Validate the OTP
Verify the OTP confirmed by the BVN owner. See Validate BVN OTP.
Example request:
curl --location --request POST 'https://api.appruve.co/v1/verifications/bvn/validate' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
	"transaction_reference": "93ca2d74-e11e-4044-82d9-da7db4225045",
	"otp": "186522"
}'
Example response:
{
    "success": true,
    "message": "BVN successfully verified!"
}
3. Upload the selfie photo
Upload the selfie photo taken by the user. Appruve will match the face on the selfie photo against the face on the matched BVN record.
Example request:
curl --location --request POST 'https://api.appruve.co/v1/verifications/selfie_image/upload' \
--header 'Authorization: Bearer ' \
--form '[email protected]/Users/img.jpg' \
--form 'transaction_reference=93ca2d74-e11e-4044-82d9-da7db4225045'
Example response:
{
  "success": true,
  "id": "93ca2d74-e11e-4044-82d9-da7db4225045",
  "confidence_score": 100,
  "id_type": "bvn",
  "country_code": "ng",
  "status": "success",
  "face_on_id_document": "url",
  "face_match_percent": 100,
  "id_match_percent": 100,
  "selfie_face_url": "url",
  "selfie_image_submitted": "url",
  "id_face_sharpness": 87,
  "id_face_brightness": 96,
  "selfie_face_sharpness": 88,
  "selfie_face_brightness": 90,
  "id_details": {},
  "created_at": "2020-05-10",
  "custom_params": {}
}

Appruve Agency - Previous

Validate BVN OTP (Unavailable)

Next - Guides

Webhooks

Last modified 8mo ago

Copy link

On this page

1. Verify the BVN

2. Validate the OTP

3. Upload the selfie photo