Document Validation Declined Reasons

Whenever a Document Validation fails due to inconsistencies in the document data or presentation, a declined reason is provided to indicate the specific reason. Here’s a list of declined reasons by country:

Brazil

Declined reason Description
portrait_photo_illegible is used when the portrait photo is illegible
perforations_illegible is used when the perforations are illegible
missing_issue_state is used when issuing state is illegible
missing_issue_agency is used when issuing agency is illegible
missing_issue_deparment is used when deparment is illegible
missing_coat_of_arms is used when coat of arms is illegible
missing_registration_number is used when registration number is illegible
inconsistent_parent_names is used when initials separating the mother's and father's names is illegible
missing_cpf is used when CPF number is illegible
missing_origin_document is used when the origin where the document has been issued is illegible
date_of_birth_does_not_match_with_photo is used when date of birth does not match the age
inconsistent_delegate_signature is used when delegate's signature does not meet standard conditions
blurry_image is used when the document is illegible
portrait_photo_is_fake is used when the face picture is modified or fake
incomplete_document is used when document is incomplete or could not be viewed completely
irregular_alignments is used the data contained in the document do not match the standards
missing_accents is used when the document lacks accents or other minor characteristics
missing_security_elements is used when the ID card is missing security elements
irregular_fonts is used when the fonts used in the document are irregular
traces_of_tampering is used when the photo have evidence of tampering
missing_legal_institute_perforation is used when the document has irregular perforations
invalid_format_for_naturally_field is used when the naturally field is different from the standard
invalid_ministry is used when the ministry on the CNH does not match the active ministry at the time

Other countries (Chile, Colombia, Costa Rica, Mexico, and Peru)

Declined reason Description
age_above_threshold is used when the person is older than 100 years.
invalid_inputs_to_create_check is used when check inputs are invalid
front_side_document_is_a_photocopy is used when document is a photocopy
document_has_expired is used when the document has expired.
document_is_a_photocopy is used when document is a photocopy
document_not_recognized is used when a document is not recognized in the picture.
reverse_side_document_is_a_photocopy is used when document is a photocopy
face_not_detected is used when the face was not found in the document.
front_document_not_found when the detection model couldnt identify the front document on image
data_not_match_with_government_database is used when the government database check fails.
document_unregistered is used when the person was not found in the government databases.
government_database_unavailable is used when the government database is unavailable.
identity_belongs_to_dead_person is used when the government validation found identity is of a dead person.
image_face_validation_not_passed is used when the image analysis doesn't pass.
image_text_validation_not_passed is used when the image analysis doesn't pass.
invalid_curp is used when the curp does not match with the one generated by us.
invalid_issue_date is used when it is an invalid issue date.
invalid_mrz is used when the MRZ does not match with the info in the labels.
invalid_mrz_format is used when the MRZ format is invalid.
manual_review_failed is a manual review failed wildcard
missing_date_of_birth is used when date of birth wasn't found
missing_document_number is used when doc number is missing
missing_expiration_date is used when the expiration date is not found.
missing_gender is used when gender wasn't found.
missing_inputs_to_create_check is used when inputs are missing
missing_issue_date is used when issue date is missing
missing_mrz is used when mrz wasn't found.
missing_names is used when names weren't found.
missing_nationality is used when mrz wasn't found.
missing_national_registrar is used when national registrar wasn't found.
missing_production_data is used when production data wasn't found.
missing_text is used when some field needed in validation cannot be found.
national_registrar_inconsistency is used when national registrar has inconsistency with document issue date.
ocr_failed is used when the OCR fails.
production_data_inconsistency is used when production data has inconsistency between document data.
production_data_invalid_format is used when production data has invalid format.
reverse_document_not_found when the detection model couldnt identify the reverse document on image
underage is used when the person is under the legal age.
validations_failed is used when one or more declined reasons fails.

Front-end only declined reasons

Declined reason Description
canceled The user decides to cancel the process
unwanted_camera_permissions The user does not accept camera permissions, which does not allow to continue with the process.
unknown_how_activate_camera_permissions The user does not know how to activate the camera permissions of the device.
camera_permission_option_no_appear The option to activate camera permissions does not appear on the screen.