General Status Screens
These are the primary messages displayed to the user at the end of a verification session.| Status | User Message (Title / Subtitle) | Meaning |
|---|---|---|
| Success | **“Verification successful”**Your identity has been confirmed. | The user passed all checks. |
| (This is the standard message when no issues are found). | ||
| Failed | **“Your verification was unsuccessful”**Unfortunately, we could not confirm your identity. Something went wrong. | The verification was denied due to a critical error or policy violation. |
| ** Suspected** | **“Thank you. Verification may be further investigated.”**Your information has been submitted. Some discrepancies were identified. | The system flagged potential issues. The session is likely sent for manual review. |
| ** Unverified** | **“Verification time expired”**The verification process was not performed within the allocated time. | The user abandoned the session or the time limit ran out. |
Face Denial Reasons
These errors occur during the selfie capture or liveness check.| Error Tag | Message to User / Description |
|---|---|
| FAKE_FACE | The face appears covered, not visible, or spoofed. |
| FACE_TOO_BLURRY | The face appears too blurry. Device may be shaking. |
| FACE_MISMATCH | Mismatch between the selfie and the document photo. |
| NO_FACE_FOUND | Face could not be found in the selfie. |
| TOO_MANY_FACES | More than one face was detected in the photo. |
| AUTO_UNVERIFIABLE | Automatic verification of face was not possible. |
Document Denial Reasons
These errors occur during document analysis. They are grouped by category for easier debugging.Visibility & Image Quality
| Error Tag | Message to User / Description |
|---|---|
| DOC_NOT_FOUND | Cannot find the document in the photo provided. |
| DOC_NOT_FULLY_VISIBLE | Parts of the document are hidden or cut off. |
| DOC_TOO_BLURRY | Document is too blurry to read (focus/lighting issue). |
| DOC_GLARED | Too much glare/reflection on the document. |
| DOC_FACE_GLARED | Too much glare specifically on the face photo. |
| DOC_FACE_NOT_FOUND | Face photo could not be located on the document. |
| DOC_DAMAGED | Document appears physically damaged. |
Data Mismatches & Validity
| Error Tag | Message to User / Description |
|---|---|
| DOC_INFO_MISMATCH | Information from document does not match client input. |
| DOC_EXPIRED | The document is expired and cannot be used. |
| DOC_SPOOF_DETECTED | Potential spoof or fake detected. |
| DOC_FAKE | Issue reading document authenticity (suspected fake). |
| DOC_PERSONAL_CODE_INVALID | Personal code found but could not be verified/invalid format. |
User Selection Errors
| Error Tag | Message to User / Description |
|---|---|
| DOC_TYPE_MISMATCH | Uploaded document does not match selected type (e.g. Passport vs DL). |
| DOC_SUBTYPE_MISMATCH | Issue recognizing the specific document subtype. |
| DOC_SIDE_MISMATCH | Provided side does not match (e.g. Front instead of Back). |
| COUNTRY_MISMATCH | Document country does not match selected country. |
| DOC_NOT_SUPPORTED | Document type is not supported. |
| DOC_NOT_ALLOWED | Document type is valid but not allowed by your configuration. |
| COUNTRY_NOT_SUPPORTED | The specified country is not supported. |
Data Extraction Failures (Specific Fields)
| Error Tag | Message to User / Description |
|---|---|
| DOC_NAME_ERROR | Name not found or differs too much from input. |
| DOC_SURNAME_ERROR | Surname not found or differs too much from input. |
| DOC_EXPIRY_ERROR | Unable to find expiry date. |
| DOC_DOB_ERROR | Unable to find date of birth. |
| DOC_PERSONAL_NUMBER_ERROR | Unable to find personal code. |
| DOC_NUMBER_ERROR | Unable to find document number. |
| DOC_DATE_OF_ISSUE_ERROR | Date of issue could not be read. |
| DOC_SEX_ERROR | Sex/Gender could not be read. |
| DOC_NATIONALITY_ERROR | Nationality could not be read. |
Technical Reading Errors (MRZ, Barcode, NFC)
| Error Tag | Message to User / Description |
|---|---|
| MRZ_NOT_FOUND | Machine Readable Zone (MRZ) area cannot be located. |
| MRZ_INVALID | MRZ code appears to be invalid. |
| MRZ_OCR_READING_ERROR | Trouble reading the MRZ text characters. |
| BARCODE_NOT_FOUND | Barcode could not be located. |
| NFC_FAILED | Issue reading the document NFC chip. |
| NFC_INIT_FAILED | Could not initialize NFC reading. |
| NFC_TIMEOUT | NFC reading timed out. |
System Errors
| Error Tag | Message to User / Description |
|---|---|
| DOC_ERROR | An error occurred while analyzing the document. |
| DOC_NOT_ANALYSED | The document was not analyzed. |