Skip to main content
Use this endpoint to compare a customer’s face image against an existing identity record (e.g. BVN, NIN, or document photo). Base paths:
  • Sandbox: https://sandbox.payvessel.com/kyc
  • Production: https://api.payvessel.com/kyc
All paths below are relative to the base URL.

​
Face comparison

POST /api/v1/merchant/face/compare Typical request body fields:
  • A reference to the identity record to compare against (for example a BVN/NIN/document reference)
  • A face image or face template captured from your app (sent as a URL, base64 string, or provider-specific handle)
  • reference – unique verification reference
The response indicates whether the faces match within an acceptable threshold and may include a similarity score. Use it to prevent impersonation and account takeover.

​
Example

curl -X POST "https://sandbox.payvessel.com/kyc/api/v1/merchant/face/compare" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_reference": "BVN_ENH_2026_001",
    "face_image": "BASE64_ENCODED_IMAGE",
    "reference": "FACE_COMPARE_2026_001"
  }'