Main API Docs
Search…
Appruve Identity
Appruve Business
Appruve Agency
Appruve Financial
Mobile Sdks
Selfie Matching With BVN (Not Available)
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:
1
curl --location --request POST 'https://api.appruve.co/v1/verifications/bvn/verify' \
2
--header 'Authorization: Bearer ' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"bvn": "22000000000"
6
}'
Copied!
Example response:
1
{
2
"success": true,
3
"transaction_reference": "93ca2d74-e11e-4044-82d9-da7db4225045"
4
}
Copied!
2. Validate the OTP
Example request:
1
curl --location --request POST 'https://api.appruve.co/v1/verifications/bvn/validate' \
2
--header 'Authorization: Bearer ' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"transaction_reference": "93ca2d74-e11e-4044-82d9-da7db4225045",
6
"otp": "186522"
7
}'
Copied!
Example response:
1
{
2
"success": true,
3
"message": "BVN successfully verified!"
4
}
Copied!
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:
1
curl --location --request POST 'https://api.appruve.co/v1/verifications/selfie_image/upload' \
2
--header 'Authorization: Bearer ' \
3
--form '[email protected]/Users/img.jpg' \
4
--form 'transaction_reference=93ca2d74-e11e-4044-82d9-da7db4225045'
Copied!
Example response:
1
{
2
"success": true,
3
"id": "93ca2d74-e11e-4044-82d9-da7db4225045",
4
"confidence_score": 100,
5
"id_type": "bvn",
6
"country_code": "ng",
7
"status": "success",
8
"face_on_id_document": "url",
9
"face_match_percent": 100,
10
"id_match_percent": 100,
11
"selfie_face_url": "url",
12
"selfie_image_submitted": "url",
13
"id_face_sharpness": 87,
14
"id_face_brightness": 96,
15
"selfie_face_sharpness": 88,
16
"selfie_face_brightness": 90,
17
"id_details": {},
18
"created_at": "2020-05-10",
19
"custom_params": {}
20
}
Copied!
Last modified 3mo ago
Copy link