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. |
Phone declined reasons
| Declined reason | Description |
|---|---|
| wrong_verification_code | Indicates the verification code provided does not match the one sent to the phone. |
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. |