Skip to main content
Our biometric authentication process combines liveness detection and face matching. 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 portrait_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:
  • FACE_IN_BLOCKLIST - The face matches an entry in your face blocklist
  • 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.
FACE_IN_BLOCKLIST
The face has been identified as matching an entry in your face blocklist. This occurs when the biometric data matches a previously blocklisted individual.

​
Warning Types

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