Didit Docs

ID Verification Warnings and Errors

Our ID Verification process includes a series of automated checks to ensure the quality and validity of submitted documents. This page outlines the potential warnings and errors you might encounter during the verification process.

Automatic Decline Conditions

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

DOCUMENT_NOT_SUPPORTED_FOR_APPLICATION - The submitted document type isn't accepted
DOCUMENT_EXPIRED - The document's expiration date has passed
MINIMUM_AGE_NOT_MET - The user is below the required minimum age
PORTRAIT_IMAGE_NOT_DETECTED - No portrait image detected on the document
ID_DOCUMENT_IN_BLOCKLIST - The document matches an entry in your document blocklist

Configurable Verification Settings

Applications can configure how the system handles various verification issues by setting actions for different risk categories:

Duplicated User
- Risks: POSSIBLE_DUPLICATED_USER
- Configurable action: Decline, Review, or Approve
Invalid Code
- Risks: QR_NOT_DETECTED, BARCODE_NOT_DETECTED
- Configurable action: Decline, Review, or Approve
Invalid MRZ
- Risks: MRZ_VALIDATION_FAILED, MRZ_NOT_DETECTED
- Configurable action: Decline, Review, or Approve
Data Inconsistency
- Risks: DATA_INCONSISTENT, MRZ_AND_DATA_EXTRACTED_FROM_OCR_NOT_SAME, DOCUMENT_NAME_DIFFERENT_FROM_OTHER_APPROVED_DOCUMENTS
- Configurable action: Decline, Review, or Approve
Invalid Validation
- Risks: INVALID_DATE, COULD_NOT_RECOGNIZE_DOCUMENT, DOCUMENT_NUMBER_NOT_DETECTED, COULD_NOT_DETECT_DOCUMENT_TYPE, NAME_NOT_DETECTED, DATE_OF_BIRTH_NOT_DETECTED or any of the risks coming related to the expected details
- Configurable action: Decline, Review, or Approve
Document Liveness
- Risks: SCREEN_CAPTURE_DETECTED, PRINTED_COPY_DETECTED, PORTRAIT_MANIPULATION_DETECTED
- Configurable action: Decline, Review, or Approve
Minimum Age
- Risks: MINIMUM_AGE_NOT_MET
- Configurable action: Decline, Review, or Approve

ID Verification Warnings

Tag	Description
`ID_DOCUMENT_IN_BLOCKLIST`	The document has been identified as matching an entry in your document blocklist. This occurs when the document has previously been marked as fraudulent, stolen, or otherwise problematic.
`BARCODE_NOT_DETECTED`	The system couldn't find or read the barcode on the document, which is necessary for ID Verification. This could be due to poor image quality or an unsupported document type.
`QR_NOT_DETECTED`	The system couldn't find or read the QR code on the document, which is necessary for ID Verification. This could be due to poor image quality or an unsupported document type.
`MRZ_NOT_DETECTED`	The system couldn't find or read the Machine Readable Zone (MRZ) on the document, which is essential for ID Verification.
`MINIMUM_AGE_NOT_MET`	The user's age is below the minimum required for the application, which is necessary for ID Verification.
`DATA_INCONSISTENT`	The Optical Character Recognition (OCR) data and the NFC chip data don't match, indicating potential document tampering or data inconsistency.
`COULD_NOT_RECOGNIZE_DOCUMENT`	The system was unable to confirm the authenticity or validity of the provided document, which may be due to poor image quality or an unsupported document type.
`PORTRAIT_IMAGE_NOT_DETECTED`	The system couldn't identify or process the portrait image of the document, possibly due to image quality issues or incorrect document positioning.
`DOCUMENT_NUMBER_NOT_DETECTED`	The system was unable to locate or read the document number, which is crucial for ID Verification.
`DATE_OF_BIRTH_NOT_DETECTED`	The system couldn't identify or process the date of birth on the document, possibly due to image quality issues or incorrect document positioning.
`EXPIRATION_DATE_NOT_DETECTED`	The system couldn't identify or process the expiration date on the document, possibly due to image quality issues or incorrect document positioning.
`NAME_NOT_DETECTED`	The system couldn't identify or process the first name and/or last name on the document, possibly due to image quality issues or improper full name processing.
`MRZ_AND_DATA_EXTRACTED_FROM_OCR_NOT_SAME`	There are differences between the information in the Machine Readable Zone (MRZ) and the data extracted through Optical Character Recognition (OCR), suggesting possible document alteration.
`MRZ_VALIDATION_FAILED`	The Machine Readable Zone (MRZ) on the document doesn't meet the expected format or contains invalid data, indicating a potentially fraudulent or improperly issued document. This can also be caused by a low quality image that prevents proper reading of the MRZ.
`INVALID_DATE`	One or more dates on the document (such as date of birth or expiry date) are not valid or don't match expected formats.
`DOCUMENT_EXPIRED`	The document's expiration date has passed, rendering it no longer valid for use.
`DOCUMENT_NOT_SUPPORTED_FOR_APPLICATION`	The type of document provided is not accepted or compatible with the current verification process.
`COULD_NOT_DETECT_DOCUMENT_TYPE`	The system was unable to determine what kind of document was submitted, which may be due to image quality issues or an unsupported document type.
`DOCUMENT_NAME_DIFFERENT_FROM_OTHER_APPROVED_DOCUMENTS`	The name on this document doesn't match the name found on other documents previously verified for this user, suggesting a potential identity mismatch.
`POSSIBLE_DUPLICATED_USER`	The system identified a potential duplicate user with previously approved documents from another session, requiring further investigation.
`FULL_NAME_MISMATCH_WITH_PROVIDED`	The provided full name (first name and last name) in `expected_details` doesn't match the data extracted from the document.
`DOB_MISMATCH_WITH_PROVIDED`	The provided date of birth in `expected_details` doesn't match the date extracted from the document.
`GENDER_MISMATCH_WITH_PROVIDED`	The provided gender in `expected_details` doesn't match the gender extracted from the document.
`COUNTRY_MISMATCH_WITH_PROVIDED`	The provided country in `expected_details` doesn't match the country extracted from the document.
`NATIONALITY_MISMATCH_WITH_PROVIDED`	The provided nationality in `expected_details` doesn't match the nationality extracted from the document.
`SCREEN_CAPTURE_DETECTED`	Our document liveness detection has identified that the submitted document appears to be either a screen capture of a digital document or a photo of a document displayed on a screen rather than a physical document.
`PRINTED_COPY_DETECTED`	Our document liveness detection has identified that the submitted document appears to be a printed copy rather than an original official document.
`PORTRAIT_MANIPULATION_DETECTED`	Our document liveness detection has identified potential manipulation of the portrait area of the document, suggesting the photo may have been altered or replaced.

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

Report How it Works