For every user verification, we run a series of validations. One or more warnings may be generated if the validation fails to pass.
| Warning Code | Meaning | Default Decision |
|---|
| DOCUMENT_BACK_MISSING | Back of document is missing | DECLINED |
| DOCUMENT_CROPPED | Document appears cropped | REVIEW |
| DOCUMENT_DAMAGED | Document appears damaged | REVIEW |
| DOCUMENT_EXPIRED | Document has expired | DECLINED |
| DOCUMENT_FACE_NOT_FOUND | No face found on document | REVIEW |
| DOCUMENT_FOUND_ON_INTERNET | Document found on the internet | REVIEW |
| DOCUMENT_FRONT_BACK_MISMATCH | Front and back of document do not match | REVIEW |
| DOCUMENT_FRONT_MISSING | Front of document is missing | DECLINED |
| DOCUMENT_FRONT_OR_BACK_MISSING | Front or back of document is missing | DECLINED |
| DOCUMENT_MINOR_DIGITAL_ARTIFACTS | Minor digital artifacts detected on document | APPROVED |
| DOCUMENT_NOT_FOUND | Document not found | DECLINED |
| DOCUMENT_PHOTO_OF_PHOTO | Document appears to be a photo of a photo | REVIEW |
| DOCUMENT_REQUIRES_REVIEW | Document requires manual review | REVIEW |
| DOCUMENT_TAMPERED | Document shows signs of tampering | DECLINED |
| DOCUMENT_TOO_FAR | Document is too far from camera | APPROVED |
| DOCUMENT_TYPE_MISMATCH | Uploaded document type does not match expected category | REVIEW |
| UNREADABLE_DOCUMENT | Document is unreadable | REVIEW |
| UNRECOGNIZED_DOCUMENT | Document type is unrecognized | REVIEW |
| UNABLE_TO_EXTRACT_DATA | Unable to extract data from document | REVIEW |
| UNABLE_TO_EXTRACT_DOCUMENT_METADATA | Unable to extract document metadata | APPROVED |
| INVALID_DOCUMENT_DETAILS | Document details are invalid | REVIEW |
| MISSING_DOCUMENT_DETAILS | Document details are missing | APPROVED |
| MISSING_DOCUMENT_NUMBER | Document number is missing | REVIEW |
| MISSING_EXPIRY_DATE | Expiry date is missing | REVIEW |
| MISSING_ISSUE_DATE | Issue date is missing | REVIEW |
| EXPIRY_AND_ISSUE_DATE_MISSING | Expiry and issue date are both missing | APPROVED |
| EXPIRY_DATE_MISSING_USING_ISSUE_DATE | Expiry date missing, using issue date instead | APPROVED |
| CHECK_DIGIT_FAILED | Document check digit validation failed | REVIEW |
| MRZ_DATA_MISMATCH | MRZ data does not match visual data on document | APPROVED |
| BLACK_WHITE_DOCUMENT | Document submitted is black and white | REVIEW |
| FAKE_ID | Document appears to be a fake ID | REVIEW |
| FEATURE_VERIFICATION_FAILED | Document feature verification failed | REVIEW |
| TEXT_FORGERY | Text forgery detected on document | REVIEW |
| IMAGE_FORGED_EDITED | Image appears forged or edited | REVIEW |
| ARTIFICIAL_IMAGE | Image appears artificially generated | REVIEW |
| ARTIFICIAL_TEXT | Text appears artificially generated | REVIEW |
| PRINTOUT_DETECTED | Document appears to be a printout | REVIEW |
| SCREEN_DETECTED | Document appears to be captured from a screen | REVIEW |
| GLARE_DETECTED | Glare detected on document image | REVIEW |
| IMAGE_TOO_BLURRY | Image is too blurry | REVIEW |
| IMAGE_TOO_SMALL | Image resolution is too small | REVIEW |
Document Insights checks the supporting documents a user uploads (for example proof of address, utility bills, or bank statements) for authenticity and validates their extracted content against the supplied data. The warnings it can raise are listed below.
Each warning has a default decision. On any template you can configure the decision applied to each warning code, so the values shown are defaults rather than fixed outcomes.
| Warning Code | Meaning | Default Decision |
|---|
| DOCUMENT_TAMPERED | Document shows signs of tampering or recreation | DECLINED |
| DOCUMENT_CONVERTED_TO_IMAGE | The original PDF was converted into an image (no longer the original digital file) | REVIEW |
| SCREEN_DETECTED | Document is a screen capture / photo of a screen, not an original file | REVIEW |
| DOCUMENT_REQUIRES_REVIEW | Document flagged for manual review | REVIEW |
| UNABLE_TO_EXTRACT_DOCUMENT_METADATA | Could not read the document's metadata | REVIEW |
| Warning Code | Meaning | Default Decision |
|---|
| UNABLE_TO_EXTRACT_DATA | Could not extract data from the document | REVIEW |
| DOCUMENT_TYPE_MISMATCH | Uploaded document type doesn't match the expected type | REVIEW |
| VALIDATION_RULES_DECLINED | Document was declined by the template's validation rules | DECLINED |
| VALIDATION_RULES_REVIEW | Document was marked for review by the template's validation rules | REVIEW |
| NAME_VERIFICATION_FAILED | Extracted name doesn't match the supplied user name | APPROVED* |
| BIRTH_DATE_MISMATCH | Extracted date of birth doesn't match supplied data | APPROVED* |
| EMAIL_ADDRESS_MISMATCH | Extracted email doesn't match supplied data | APPROVED* |
| PHONE_NUMBER_MISMATCH | Extracted phone number doesn't match supplied data | APPROVED* |
| ADDRESS_MISMATCH | Extracted address doesn't match supplied data | APPROVED* |
| ID_DATA_MISMATCH | Extracted identity data doesn't match supplied/government data | APPROVED* |
| ADDRESS_DOCUMENT_DOCUMENT_NOT_ISSUED_RECENTLY | Document is older than the configured recency threshold | REVIEW |
* These field-mismatch defaults are commonly APPROVED, but are template-configurable.
| Warning Code | Meaning | Default Decision |
|---|
| ID_COUNTRY_MISMATCH | ID country does not match expected country | DECLINED |
| ID_DATA_MISMATCH | ID data does not match supplied data | APPROVED |
| ID_NOT_ALLOWED | ID type is not allowed | DECLINED |
| ID_NUMBER_NOT_VERIFIED | ID number could not be verified | DECLINED |
| ID_PREVIOUSLY_ATTEMPTED | ID has been used in a previous attempt | APPROVED |
| ID_PREVIOUSLY_SEEN | ID has been seen before | APPROVED |
| ID_TYPE_MISMATCH | ID type does not match expected type | APPROVED |
| INVALID_ID_NUMBER_SUPPLIED | Supplied ID number is invalid | DECLINED |
| MISSING_NAME | Name is missing | REVIEW |
| MISSING_BIRTH_DATE | Birth date is missing | APPROVED |
| MISSING_GENDER | Gender field is missing | APPROVED |
| MISSING_NATIONALITY | Nationality is missing | APPROVED |
| MISSING_PERSONAL_NUMBER | Personal number is missing | APPROVED |
| BIRTH_DATE_MISMATCH | Mismatch between supplied and extracted birth date | APPROVED |
| NAME_VERIFICATION_FAILED | Name verification failed | APPROVED |
| Warning Code | Meaning | Default Decision |
|---|
| FACE_AGE_MISMATCH | Face age does not match document age | APPROVED |
| FACE_ANGLE_TOO_LARGE | Face angle is too large | DECLINED |
| FACE_BLUR | Face image is blurred | DECLINED |
| FACE_COVERED | Face is covered or obstructed | DECLINED |
| FACE_CROPPED | Face is cropped out of image | DECLINED |
| FACE_DEEPFAKE | Deepfake face detected | REVIEW |
| FACE_EDITED | Face image has been edited | DECLINED |
| FACE_IDENTICAL | Face is identical to a previously seen face | REVIEW |
| FACE_LIVENESS_REVIEW_REQUIRED | Face liveness check requires manual review | REVIEW |
| FACE_LIVENESS_TOO_FAR_FROM_CAMERA | Face is too far from camera during liveness check | REVIEW |
| FACE_MISMATCH | Face does not match document photo | DECLINED |
| FACE_NOT_FOUND | No face detected in image | DECLINED |
| FACE_NOT_LIVE | Face does not pass liveness check | DECLINED |
| FACE_PHOTO_OF_PHOTO | Face image appears to be a photo of a photo | DECLINED |
| FACE_PREVIOUSLY_ONBOARDED | Face has been previously onboarded | APPROVED |
| FACE_TOO_CLOSE | Face is too close to camera | DECLINED |
| FACE_TOO_SMALL | Face is too small in image | DECLINED |
| MULTIPLE_FACES | Multiple faces detected in image | DECLINED |
| SELFIE_VIDEO_FRAUD | Fraud detected in selfie video | DECLINED |
| SELFIE_VIDEO_MISSING | Selfie video is missing | APPROVED |
| LOOKUP_FACE_NOT_FOUND | Face not found during lookup | DECLINED |
| LOW_FACE_SIMILARITY | Face similarity score is too low | REVIEW |
| Warning Code | Meaning | Default Decision |
|---|
| ADDRESS_DOCUMENTS_NOT_SAME | Documents not same | APPROVED |
| ADDRESS_DOCUMENT_ADDRESS_MISMATCH | Mismatch between address on document and supplied address | REVIEW |
| ADDRESS_DOCUMENT_DOCUMENT_EXPIRED | Address document has expired | REVIEW |
| ADDRESS_DOCUMENT_DOCUMENT_NOT_ISSUED_RECENTLY | Address document not issued recently | REVIEW |
| ADDRESS_DOCUMENT_MISSING_ADDRESS | Address missing from address document | REVIEW |
| ADDRESS_DOCUMENT_MISSING_NAME | Name missing from address document | REVIEW |
| ADDRESS_DOCUMENT_NAME_VERIFICATION_FAILED | Name verification failed on address document | REVIEW |
| ADDRESS_DOCUMENT_UNRECOGNIZED_DOCUMENT | Address document is unrecognized | DECLINED |
| ADDRESS_MISMATCH | Mismatch between supplied and extracted address | APPROVED |
| MISSING_ADDRESS | Address is missing | APPROVED |
| MISSING_POSTCODE | Postcode is missing | APPROVED |
| PO_BOX_DETECTED | PO Box detected in address | APPROVED |
| GEOLOCATION_MISMATCH | User geolocation does not match document | APPROVED |
| Warning Code | Meaning | Default Decision |
|---|
| EMAIL_ADDRESS_MISMATCH | Mismatch between supplied and extracted email address | APPROVED |
| EMAIL_NOT_FOUND | Email address not found | DECLINED |
| PHONE_NUMBER_MISMATCH | Mismatch between supplied and extracted phone number | APPROVED |
| PHONE_NUMBER_NOT_FOUND | Phone number not found | DECLINED |
| Warning Code | Meaning | Default Decision |
|---|
| AML_MATCH | AML screening returned a match | REVIEW |
| BACKGROUND_CHECK_ALERT | Background check returned an alert | REVIEW |
| AGE_UNDER_18 | User is under 18 years of age | REVIEW |
| Warning Code | Meaning | Default Decision |
|---|
| BOT_DETECTED | Bot activity detected | APPROVED |
| BROWSER_PREVIOUSLY_ATTEMPTED | Browser has been used in a previous attempt | APPROVED |
| IP_ADDRESS_PREVIOUSLY_ATTEMPTED | IP address used in a previous attempt | APPROVED |
| IP_ADDRESS_SUSPICIOUS | IP address is flagged as suspicious | REVIEW |
| TOR_DETECTED | TOR network usage detected | APPROVED |
| VPN_DETECTED | VPN usage detected | APPROVED |
| VIDEO_INJECTION_DETECTED | Video injection or tampering detected | DECLINED |
| VIRTUAL_CAMERA_DETECTED | Virtual camera or screen capture device detected | DECLINED |
| PRIVACY_SETTINGS_BLOCKED | Privacy settings prevented verification | APPROVED |
| SUSPICIOUS_USER_BEHAVIOUR | Suspicious user behaviour detected | REVIEW |
| Warning Code | Meaning | Default Decision |
|---|
| API_DATA_REQUIREMENTS_NOT_MET | Required API data not provided | DECLINED |
| CUSTOM_ERROR_CODE | Custom error code triggered | REVIEW |
| DATABASE_LOOKUP_ISSUE | Issue encountered during database lookup | REVIEW |
| LOOKUP_SOURCE_DOWN | Lookup source is unavailable | DECLINED |
