Declined Reasons Details

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:

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

Generic document decline reasons

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.
invalid_image_format is used when image format is invalid.
invalid_image_format is used when image format is invalid.
invoice_illegible is used when the invoice is illegible.
missing_colony_name is used when colony name weren't found.
missing_pay_limit_date is used when pay limit date weren't found.
missing_postal_code is used when postal code weren't found.
missing_street is used when street weren't found.

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.
process_started_late When there are 15 seconds left for a token to expire, we do a validation if the process started with 3 min left for the token to expire, if that happened when the process expires, this decline reason will be indicated.
no_media_uploaded When a process expires because the user did not upload the file for the step (other than the document and face step).
no_document_media_uploaded When a process expires because the user did not upload the document files for the document validation step.
no_face_media_uploaded When a process expires because the user did not upload the the selfie or video for the face validation step.
no_answered_question When a process expires because the user did not answer a question in the WhatsApp conversation.

Facial recognition declined reasons

Declined reason Description
liveness_verification_not_passed Indicates liveness actions were not detected.
similarity_threshold_not_passed Indicates the similarity between the face in the video and the one in the picture is less than the defined threshold.
no_face_detected Indicates no faces were detected in the video.
actions_not_in_expected_order Indicates the liveness actions were not performed in the expected order.
photo_of_photo Indicates that validation was performed with a photo on other device or it is a document picture.
invalid_file_format Indicates the file uploaded has an invalid format.

Email declined reasons

Declined reason Description
wrong_verification_code Indicates the verification code provided does not match the one sent to the email.
email_not_valid_verdict Indicates the email provided is considered risky.

Phone declined reasons

Declined reason Description
wrong_verification_code Indicates the verification code provided does not match the one sent to the phone.
phone_number_out_of_coverage Indicates the phone number provided is out of coverage of carrier.

TruFace declined reasons

Declined reason Description
fraudster_face_match_in_client_collection Indicates the face match with client fraudster collection.
fraudster_face_match_in_global_collection Indicates the face match with global fraudster collection.
user_face_match_in_client_collection Indicates the face match with client user collection.