Skip to main content
Our face matching process includes automated checks to verify that the person presenting the ID document is the same person shown in the document photo. This page outlines the potential warnings and errors you might encounter during the face matching process.

​
Verification Process

When performing face matching, the system attempts to:
  • Compare the verified face from liveness detection against the reference document
  • Generate a similarity score
  • Apply 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_REFERENCE_IMAGE - No reference image is available for comparison

​
Configurable Verification Settings

Applications can configure how the system handles various verification issues:
  1. 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

​
Face Match Warnings

Tag
Description
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 or face 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: