Face Match Warnings and Errors
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:
- 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
- Risks:
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:
| Type | Description |
|---|---|
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 |