🎉 Unlimited Free KYC - Forever!!

Identity Verification
Biometric Authentication
Warnings

Biometric Authentication Warnings and Errors

Our biometric authentication process combines liveness detection and face matching to verify returning users. This page outlines the potential warnings and errors you might encounter during the biometric authentication process.

Verification Process

When performing biometric authentication, the system:

  • Captures a liveness session with one of our active liveness methods
  • Extracts a face image from the liveness session
  • Compares the face image to the reference image
  • Generates separate scores for liveness and face matching
  • Applies configured thresholds to determine the verification result

Automatic Decline Conditions

The following conditions will always result in an automatic decline regardless of application settings:

  • NO_FACE_DETECTED - No face was detected during the liveness check
  • LIVENESS_FACE_ATTACK - The system detected a potential spoofing attempt
  • NO_REFERENCE_IMAGE - No reference image is available for comparison

Configurable Verification Settings

Applications can configure how the system handles various verification issues:

  1. Low Liveness Score

    • Risks: LOW_LIVENESS_SCORE
    • Configurable thresholds:
      • Review threshold: Sessions with scores below this threshold are set to "In Review"
      • Decline threshold: Sessions with scores below this threshold are automatically declined

  2. Low Face Match Score

    • Risks: LOW_FACE_MATCH_SIMILARITY
    • Configurable thresholds:
      • Review threshold: Sessions with scores below this threshold are set to "In Review"
      • Decline threshold: Sessions with scores below this threshold are automatically declined

Biometric Authentication Warnings

Tag
Description
LOW_LIVENESS_SCORE
The liveness check resulted in a low score, indicating potential use of non-live facial representations or poor-quality biometric data.
NO_FACE_DETECTED
The system couldn't identify a face during the liveness check, which may be due to poor image quality, improper positioning, or technical issues.
LIVENESS_FACE_ATTACK
The system detected a potential attempt to bypass the liveness check.
LOW_FACE_MATCH_SIMILARITY
The facial features of the provided image don't closely match the reference image, suggesting a potential identity mismatch.
NO_REFERENCE_IMAGE
A reference image for facial comparison is missing, preventing the system from completing the face matching process.

Warning Types

Each risk is assigned a warning type based on your application's configuration settings. Warnings fall into three severity categories:


TypeDescription
ERROR
Critical issues that resulted in setting the session to `Declined`
WARNING
Issues that require attention that resulted in setting the session to `In Review`
INFORMATION
Informational messages that don't affect verification outcome
ReportHow it Works