For every user verification, we run a series of validations. One or more warnings may be generated if the validation fails to pass.
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_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. (only applicable to PDFs)
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
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
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 digit.
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
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
API_DATA_REQUIREMENTS_NOT_MET
Missing required fields to run the API.
DECLINED
Fraud Warnings
Warning Code
Description
Decision
SUSPICIOUS_USER_BEHAVIOUR
This warning code is used for various kinds of suspicious behaviours: The ID issue country does not match with the geolocation country of user.
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
Proof of Address Warnings
Warning Code
Description
Decision
ADDRESS_DOCUMENT_MISSING_ADDRESS
Address is missing or cannot be read from the document.
REVIEW
ADDRESS_DOCUMENT_ADDRESS_MISMATCH
Mismatch between supplied address and extracted address.
REVIEW
ADDRESS_DOCUMENT_MISSING_NAME
Given name or family name is missing or cannot be read from the document.
REVIEW
ADDRESS_DOCUMENT_NAME_VERIFICATION_FAILED
Mismatch between supplied user name and extracted name.
REVIEW
ADDRESS_DOCUMENT_MISSING_ISSUE_DATE
Document issue date is missing or cannot be read from the document.
REVIEW
ADDRESS_DOCUMENT_DOCUMENT_EXPIRED
Provided document is expired.
REVIEW
ADDRESS_DOCUMENT_UNRECOGNIZED_DOCUMENT
Given document is not recognized.
DECLINED
Phone & Email Warnings
Warning Code
Description
Decision
EMAIL_NOT_FOUND
No email address found.
DECLINED
PHONE_NUMBER_NOT_FOUND
No phone number found.
DECLINED
Custom 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.
