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
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
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
IP Warnings
Warning Code
Description
Decision
IP_ADDRESS_SUSPICIOUS
Client request originated from a suspicious IP address.
REVIEW
User Behaviour
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. or User is using TOR or on the TOR network. or User using VPN. or User using BOTs to complete the request. or Can't get geolocation of user, privacy settings blocked the request. or Detected suspicious user behaviour.
REVIEW
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.