Document and OCR Warnings
| Warning Code | Description | Decision |
|---|---|---|
| UNRECOGNIZED_DOCUMENT | Document not recognized. | REVIEW |
| UNREADABLE_DOCUMENT | Document not readable. | REVIEW |
| DOCUMENT_NOT_FOUND | Document is not found in the uploaded image. | DECLINED |
| DOCUMENT_EXPIRED | Document is expired. | DECLINED |
| DOCUMENT_FRONT_BACK_MISMATCH | Document front and back does not belong to same person. | REVIEW |
| DOCUMENT_DAMAGED | The document is damaged. | REVIEW |
| DOCUMENT_FRONT_MISSING | Document front not detected in the document image. | DECLINED |
| DOCUMENT_BACK_MISSING | Document back not detected in the document image. | DECLINED |
| DOCUMENT_FRONT_OR_BACK_MISSING | Document front or back is missing or cannot be read. | DECLINED |
| DOCUMENT_CROPPED | Document not fully in frame / cropped. | REVIEW |
| DOCUMENT_FACE_NOT_FOUND | Could not detect face in document image. | REVIEW |
| DOCUMENT_TOO_FAR | The document is too far from the camera. | APPROVED |
| DOCUMENT_TAMPERED | Document patterns hint at tampering or recreation. | REVIEW |
| AGE_UNDER_18 | User is under 18 years old. | REVIEW |
| INVALID_DOCUMENT_DETAILS | Document data is invalid or not as per the standards. | REVIEW |
| ID_PREVIOUSLY_SEEN | The given identity document/number has been previously verified. | APPROVED |
| DATABASE_LOOKUP_ISSUE | The data could not be verified with a third-party/government database. | REVIEW |
| MRZ_DATA_MISMATCH | Data from MRZ / Barcode / QR code does not match with the extracted data | APPROVED |
Document - Missing Fields
| Warning Code | Description | Decision |
|---|---|---|
| MISSING_EXPIRY_DATE | Document expiry date is missing or cannot be read. | REVIEW |
| MISSING_ISSUE_DATE | Document issue date is missing or cannot be read. | REVIEW |
| MISSING_BIRTH_DATE | Birthday information is missing or cannot be read. | APPROVED |
| MISSING_DOCUMENT_NUMBER | Document number is missing or cannot be read. | REVIEW |
| MISSING_PERSONAL_NUMBER | Personal number or national ID number is missing or cannot be read. | APPROVED |
| MISSING_ADDRESS | Address is missing or cannot be read. | APPROVED |
| MISSING_POSTCODE | Postcode is missing or cannot be read. | APPROVED |
| MISSING_NAME | Given name or family name is missing or cannot be read. | REVIEW |
| MISSING_GENDER | Gender is missing or cannot be read | APPROVED |
| MISSING_NATIONALITY | Nationality is missing or cannot be read. | APPROVED |
| MISSING_DOCUMENT_DETAILS | Document data is missing or cannot be read. | APPROVED |
Document - Mismatch between supplied fields and extracted/lookup data.
| Warning Code | Description | Decision |
|---|---|---|
| NAME_VERIFICATION_FAILED | Mismatch between supplied user name and extracted/looked up name. | APPROVED |
| BIRTH_DATE_MISMATCH | Mismatch between supplied birthday and extracted/looked up birthday. | APPROVED |
| ID_DATA_MISMATCH | Mismatch between supplied user data and data from third-party/government database. | APPROVED |
| ID_TYPE_MISMATCH | The ID type does not match with the input identity type. | APPROVED |
| ID_COUNTRY_MISMATCH | The ID issue country does not match with the input country. | DECLINED |
| ADDRESS_MISMATCH | Mismatch between supplied address and extracted/looked up address. | APPROVED |
| ID_NOT_ALLOWED | Identity type is not enabled in the template. | APPROVED |
| EMAIL_ADDRESS_MISMATCH | Mismatch between supplied email address and extracted/looked up email address. | APPROVED |
| PHONE_NUMBER_MISMATCH | Mismatch between supplied phone number and extracted/looked up phone number. | APPROVED |
Document Anti-forgery Warnings.
| Warning Code | Description | Decision |
|---|---|---|
| DOCUMENT_PHOTO_OF_PHOTO | Document appears to be a photo of a photo. | REVIEW |
| SCREEN_DETECTED | The document image contains a screen, monitor or mobile device therefore is possibly a photo of a photo | REVIEW |
| IMAGE_FORGED_EDITED | The document image possibly contains forged elements which warrants a manual review or rejection. | REVIEW |
| FEATURE_VERIFICATION_FAILED | Document features does not match with official document, the document could be fake, blurry or low resolution. | REVIEW |
| FAKE_ID | The document uploaded is a fake or sample document, not an authentic document. | REVIEW |
| DOCUMENT_FOUND_ON_INTERNET | The document image is found on the internet. | REVIEW |
| ARTIFICIAL_IMAGE | Document appears to be created artificially, not a naturally taken photo. | REVIEW |
| ARTIFICIAL_TEXT | Most texts within the image appears to be created artificially. | REVIEW |
| TEXT_FORGERY | Possible artificial text modification detected. | REVIEW |
| IMAGE_TOO_SMALL | The image resolution did not meet the standards. | REVIEW |
| GLARE_DETECTED | The document image contains possible glare. | REVIEW |
| IMAGE_TOO_BLURRY | The document image is blurry. | REVIEW |
| CHECK_DIGIT_FAILED | The document is not a valid document because it contains invalid check dig | REVIEW |
| PRINTOUT_DETECTED | The document image is a print out / photocopy of the original. | REVIEW |
| BLACK_WHITE_DOCUMENT | The document appears to be black & white photocopy. | REVIEW |
Biometric Warnings
| Warning Code | Description | Decision |
|---|---|---|
| FACE_NOT_FOUND | Could not detect face in selfie image. | DECLINED |
| MULTIPLE_FACES | Multiple faces detected in selfie image. | DECLINED |
| FACE_MISMATCH | Face mismatch between document/government photo and selfie photo. | DECLINED |
| LOW_FACE_SIMILARITY | Low face similarity between document/government photo and selfie photo. | REVIEW |
| FACE_IDENTICAL | Selfie photo appears to be the exact same photo as document photo. | REVIEW |
| FACE_NOT_LIVE | Selfie photo is not live. | DECLINED |
| FACE_PHOTO_OF_PHOTO | Selfie photo appears to be a photo of a photo. | DECLINED |
| FACE_COVERED | Selfie photo appears to have hat or mask or glasses. | DECLINED |
| FACE_EDITED | Selfie photo edited using filters. | DECLINED |
| FACE_BLUR | Selfie photo is too blurry and should be retaken for improved accuracy. | DECLINED |
| FACE_TOO_CLOSE | Selfie photo is too close to the camera. | DECLINED |
| FACE_CROPPED | Selfie photo cropped / not completely visible. | DECLINED |
| FACE_TOO_SMALL | The relative proportion of face size in the image is too low. | DECLINED |
| FACE_ANGLE_TOO_LARGE | Facial out-of-plane rotation angle is extremely large. | DECLINED |
| FACE_LIVENESS_REVIEW_REQUIRED | Selfie photo liveness manual review required. | REVIEW |
| FACE_DEEPFAKE | Selfie photo appears to be a deepfake | REVIEW |
| SELFIE_VIDEO_FRAUD | Selfie video appears to be fraudulent. | DECLINED |
| FACE_AGE_MISMATCH | Given age doesn’t match with age predicated via facial analysis. | APPROVED |
| FACE_LIVENESS_TOO_FAR_FROM_CAMERA | Face is too far from the camera. | REVIEW |
ID Number Warnings
| Warning Code | Description | Decision |
|---|---|---|
| ID_NUMBER_NOT_VERIFIED | The given identity number could not be verified against a database. | DECLINED |
| INVALID_ID_NUMBER_SUPPLIED | The given identity number is not in correct format. | DECLINED |
| LOOKUP_SOURCE_DOWN | The government/third-party lookup source is not available. | DECLINED |
| LOOKUP_FACE_NOT_FOUND | Could not find face image in government/third-party database. | DECLINED |
AML/PEP Warnings
| Warning Code | Description | Decision |
|---|---|---|
| AML_MATCH | Potential match from AML database. | REVIEW |
Fraud Warnings
| Warning Code | Description | Decision |
|---|---|---|
| GEOLOCATION_MISMATCH | The ID issue country does not match with the geolocation country of user. | REVIEW |
| SUSPICIOUS_USER_BEHAVIOUR | Detected suspicious user behaviour. | REVIEW |
| IP_ADDRESS_SUSPICIOUS | Client request originated from a suspicious IP address. | REVIEW |
| TOR_DETECTED | User is using TOR or on the TOR network. | APPROVED |
| VPN_DETECTED | User is using VPN. | APPROVED |
| BOT_DETECTED | User is using BOTs to complete the request. | APPROVED |
| BROWSER_PREVIOUSLY_ATTEMPTED | Multiple requests attempted from the same browser. | APPROVED |
| IP_ADDRESS_PREVIOUSLY_ATTEMPTED | Multiple attempts detected from the same IP address. | APPROVED |
| ID_PREVIOUSLY_ATTEMPTED | Multiple attempts detected using the same ID document / number. | APPROVED |
| FACE_PREVIOUSLY_ONBOARDED | Person (Face Image) has attempted to onboard before. | APPROVED |
| PRIVACY_SETTINGS_BLOCKED | Can’t get geolocation of user, privacy settings blocked the request. | APPROVED |
Phone & Email Warnings
| Warning Code | Description | Decision |
|---|---|---|
| EMAIL_NOT_FOUND | No email address found. | DECLINED |
| PHONE_NUMBER_NOT_FOUND | No phone number found. | DECLINED |
Background check
| Warning Code | Description | Decision |
|---|---|---|
| BACKGROUND_CHECK_ALERT | Background search completed and records were found. | REVIEW |
Generic Error Code
| Warning Code | Description | Decision |
|---|---|---|
| CUSTOM_ERROR_CODE | In this case, a custom error message is returned explaining more details about the warning. This is used in case a warning happened which is not one of the above. | REVIEW |
| API_DATA_REQUIREMENTS_NOT_MET | Missing required fields to run the API. | UNKNOWN |