Retry/Error/Reject Codes
Retry codes other than 'mrz_protocol_fail', 'barcode_protocol_fail' can be returned only when the option on dashboard - 'ID CARD:Validation' is on.
Retry Code | Message | Description |
---|---|---|
mrz_protocol_fail | Failed to detect full MRZ | No MRZ detected |
barcode_protocol_fail | Failed to read PDF417 Barcode | No barcode detected |
invalid_back_document | Front and back side image mismatch. Please retry with one ID | ID image: front and back mismatch |
document_country_mismatch | Front and back side image mismatch. Please retry with one ID | ID image: front and back issuing country mismatch |
document_expired | Your ID is expired already. Please retry with valid ID | ID image: already expired |
document_name_mismatch | Front and back side name mismatch. Please retry with one ID | ID image: front and back name mismatch |
document_dob_mismatch | Front and back side birthdate mismatch. Please retry with one ID | ID image: front and back birth date mismatch |
missing_expiry_date | Expiry date not detected. Please take clear picture | Failed to detect expiry date or it's been artificially erased |
missing_issue_date | Issue date not detected. Please take clear picture | Failed to detect issued date or it's been artificially erased |
missing_birth_date | Birth date not detected. Please take clear picture | Failed to detect birth date or it's been artificially erased |
missing_document_number | Document number not detected. Please take clear picture | Failed to detect document number or it's been artificially erased |
missing_personal_number | Identity number not detected. Please take clear picture | Failed to detect identity number or it's been artificially erased |
missing_name | Name not detected. Please take clear picture | Failed to detect name or it's been artificially erased |
glare_detected | Please retake ID image without light smudging | Failed to detect ID due to light reflection(smudging) |
recaptured_document | Retry with physical ID. recaptured screen not allowed | Image on monitor or other device is detected |
screen_detected | Retry with physical ID. recaptured screen not allowed | Image captured from monitor or other device is detected |
image_forgery | Please retry with original ID | Image forgery detected |
feature_verification_failed | Please retry with original ID | The submitted ID image doesn't match with the one of database |
image_edited | Please retry with original ID | Trace of image editing detected |
fake_id | Please retry with original ID | Sample ID image available online has been detected |
artificial_image | Please retry with original ID | Artificially generated ID detected |
artificial_text | Please retry with original ID | Text forgery detected |
text_forgery | Please retry with original ID | Text forgery detected |
check_digit_failed | Please retry with original ID | MRZ forgery detected |
image_too_blurry | Please retake ID image clearly | Failed to scan the ID due to blurry image |
black_white_document | Please retry with original ID | Black and white ID(copied ID) detected |
physical_document_missing | Please take ID image in the right direction | Failed to scan the ID due to abnormal angle |
Error Code | Message | Description |
---|---|---|
invalid_payload | Failed to parse the input data. | No image file |
invalid_id_image | Invalid ID image. Please retry with another ID image. | Incorrect image path |
invalid_request | Failed to find the project. Please check the project ID. | This KYC does not exist. It's been deleted or the project ID is wrong. |
invalid_project | This project is not available. | This KYC project is not valid anymore, it has the status of 'Closed'. |
missing_parameters | Missing required parameters. | |
invalid_id_type | Invalid id type: Id type must be passport, government_id or drivers_license. | |
invalid_input_format | Invalid input type: {parameters} | Input value format incorrect |
invalid_email | Invalid email address format. | Incorrect email address |
id_image_error | ID image processing error. Please retry. | ID image processing error |
data_processing_error | Data processing error. Please retry. | Data processing error |
save_image_error | ID image save error. Please retry. | ID image saving error |
processed_submission |
|
|
rejected_submission | {email} has an existing rejected submission. Not available to submit due to ‘rejected period’ option to prevent duplication. | Further submission banned due to 'Rejected Period' option |
reviewing | {email}’s KYC is currently reviewing. Please wait. | The email account has a submitted KYC which is in 'Pending' status waiting for the result, thus no further submission accepted. |
not_an_id | Please take a picture of an ID card. | Submitted ID image is not an ID. |
id_detection_error | ID detection error. Please retry. | Error occurred while detecting an ID. |
ocr_fail | OCR not supported ID. Please retry with another ID. | Affected by 'AI Supported Option', returned when submitted an ID which the OCR engine does not support. |
invalid_id | Invalid ID. Please resubmit with another ID. | This ID is not valid anymore in accordance with local regulation. |
expired_id | Expired ID document, please use unexpired ID card. | When submitted expired ID. |
id_validation_error | ID validation server error. Please, retry. | ID validation server error |
Retry Code | Message | Description |
---|---|---|
identity_verification_fail |
|
|
no_face | Detect face failed: No face detected. At least one face must be detected in both selfie and ID image. Please retry. | No face detected on submitted selfie image. |
face_compare_underscore | The face doesn’t match. Please retry with another face image. | Face similarity score under 85. |
face_compare_fail | Failed to find a matching face. Please retry with another face image. | Failed to find a similar face to process face compare. |
face_detect_error | Failed to detect a face. | Server error |
liveness_fail | Liveness fail. Please retry with another face image. | Liveness score less than 50. |
liveness_error |
| Failed to meet liveness detection condition. |
bank_authentication_fail | The authentication code and account holder doesn't match. | Both verification code and holoder name don't match. |
bank_authentication_code_fail | 1 won authentication fail. The authentication code doesn't match. | The verification code for 'Account Occupancy' doesn't match. |
bank_authentication_name_fail | 1 won authentication fail. The account holder doesn't match. | The account holder name for 'Account Occupancy' doesn't match. |
Error Code | Message | Description |
---|---|---|
invalid_payload | Failed to parse the input data. | No image file |
invalid_request | Failed to find the project. Please check the project ID. | This KYC does not exist. It's been deleted or the project ID is wrong. |
invalid_face_image | Invalid face image. Please retry with another face image. | Incorrect path of selfie image |
missing_parameters | Missing required parameters. | |
invalid_address_image | Invalid address image. Please retry with another address image. | Incorrect path of proof of address image |
invalid_submission_id | Invalid submission ID error. Please check the submission ID. | Incorrect submission ID |
no_submission | Fail to find the submission data. Please contact CS center. | Failed to load submission data. |
processed_submission |
|
|
rejected_submission | {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication. | Further submission banned due to 'Rejected Period' option |
unauthorized | Invalid API key. Please check. | Incorrect API key |
missing_address | Missing address data information. | No address data(When address collection option on ) |
unexpected_error | Failed to submit KYC. | When failed at DB saving, sending webhook or email |
verify_kor_error | The ID card you submitted is currently unable to proceed due to Korean ID authentication server errorn error in the authenticity verification server. Please proceed with a different ID card or try again later. | Korean ID authentication server error |
invalid_bank_authentication | Failed to read bank authentication's data. | PreStep2 was not properly completed. |
missing_required_field | The account holder's name and the 1 won authentication code are required fields.R | Required parameter for PreStep2 is missing(userOccupancyName, userOccupancyCode) |
bank_authentication_fail | 1 won authentication fail. The account holder's name doesn't match | ‘userOccupancyName’ from PreStep2 and name from Step2 parameter don't match. |
exceeded_72hour_limit | The submission is invalid because it has been more than 72 hours since step1. | Submission ID is expired. A submission ID is valid for 72 hours from the createTime. |
Reject Comment Code | Message | Description |
---|---|---|
too_many_retry | Multiple invalid KYC attempts | Retry count went up to 3 but KYC not approved |
timeout | KYC rejected due to timeout | 'Incomplete' KYC with retry count higher than 1 or more, will turn into 'Rejected' after certain period of time. |
duplicate_user | Identity has been determined to be the same duplicate as the previously approved one. | When the option is on, KYC from duplicate user is rejected. |
blacklistCountry | According to the policy, we do not accept KYC from {country}. | As the 'Blacklist Country' option applied, KYC submitted with blacklist-country-issued is rejected |
under_ageLimit | We do not accept KYC anyone under {age} years old. | As the 'Age Limit' option applied, KYC submitted from user below the specified age is rejected |
invalid_acceptedID | Inacceptable ID type. Please resubmit with another ID, check the valid ID on the submission page. | As the 'ID Type' option applied, KYC submitted with undesignated ID is rejected. |
id_image_invalidImage | ID document not detected. Please take a picture of your ID document. | Submitted ID image is not an image of ID. |
id_image_invalidId | Invalid ID document. Please resubmit with another ID document. | Submitted ID is not valid. ex)ID with only birth year. |
id_image_error | Fail to upload the ID image. Please resubmit the KYC process. | Unable to verify ID image due to upload error. |
id_image_badImage | Fail to read the ID image. Please take a clear picture of your ID document. | Unable to verify ID image due to poor image quality |
id_info_dataMismatch | The entered information does not match with your ID document. | The ID is written in languages we can't correct(such as Chinese Character, Cyrillic alphabet etc...) and the user input data is not matching with the ID. |
id_info_blacklist | According to the policy, we do not accept KYC from {country}. | The issuing country has been modified while manual review, the modified country is on the blacklist. |
id_info_notOfAge | We do not accept KYC anyone under {age} years old. | The date of birth has been modified while manual review, age of the user is under 'Age Limit'. |
address_image_invalidImage | Invalid proof of address. Proof of address must include your full name and address. | The proof of address is not valid since it doesn't contain users name and address. |
address_image_error | Fail to upload proof of address image. Please retry. | Unable to verify proof of address image due to upload error. |
address_image_badImage | Fail to read the image. Please take a clear picture of your proof of address. | Unable to verify proof of address image due to poor image quality |
address_info_expiredDocument | Expired proof of address. The proof of address should be issued within 6 months. | The proof of address document is expired. |
address_info_dataMismatch | Entered information does not match with your proof of address. | The proof of address is written in languages we can't correct(such as Chinese Character, Cyrillic alphabet etc...) and the user input data is not matching with the document. |
other | other | Guide comment from agent. |
Last modified 19d ago