Retry/Error/Reject Codes

STEP 1

Step 1 - Retry Codes (200 ok)

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
expired_id	Expired ID document, please use unexpired ID card.	When submitted expired ID.
id_liveness_fail	Liveness validation of Id image failed. Failed for: {#pipelines}	When using the attack prevention option, the ID Card Liveness Score is less than 50 points in one or more pipelines. #pipeline : Screen replay, Paper printed, Replace portraits

Step 1 -Error Codes(400 Error)

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.	Required input data missing. (Refer to Step1 - Input Data)
invalid_id_type	Invalid id type: Id type must be passport, government_id or drivers_license.	ID type incorrect. (Refer to Step1 - Input Data)
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	This submission is already processed. {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.	Step 1 process for the submission ID has been already completed Further submission banned due to 'Approved Period' option
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.
id_validation_error	ID validation server error. Please, retry.	ID validation server error
invalid_idType	This project is not using the Universal option.	When the Universal option is Off, but ‘universal’ is submitted as idType. - idType ‘universal’ can be submitted only when using the Universal option. Other than that, entering the correct idType is required.
invalid_idType	ID Card issued from Korea cannot use universal id type.	If it is a Korean ID card and ‘universal’ is submitted as idType. - If issuingCountry is ‘KOR’, Universal mode cannot be used regardless of whether the Universal option is used.
invalid_idType	Cannot input specific idType in using universal option	If you are using the Universal option and a specific ID type is submitted in idType
missing_parameters	IdCard Back Image is required in using universal option	If you used the Universal option and submitted idType as ‘universal’, but did not submit a photo of the back of your ID card. - When using universal mode, you must submit a photo of the back of your ID card.
id_liveness_error	ID liveness error.	When using the attack prevention option, an error occurred while verifying ID Card Liveness.

STEP 2

Step 2 - Retry Codes (200 ok)

Retry Code	Message	Description
identity_verification_fail	ID verification failed: {message}. Please check the ID data. ID verification failed: Barcode information does not match. {message}. Please check the ID data. ID verification failed: EGN information does not match. {message}. Please check the ID data	Korean ID authentication failed. USA, CAN, MEX drivers license, input data and barcode data mismatch. BGR ID data mismatch.
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	Liveness fail: Face size is too small to be detected. Please retry Liveness fail: Face is too close to one or more borders. Please retry. Liveness fail: Interpupillary distance is too small. Please retry. Liveness fail: Absolute face size is too small. Please retry. Liveness fail: Face is cropped. Please retry. Liveness fail: Facial out-of-plane rotation angle is extremely large. Please retry Liveness fail: Relative face size is too small. Please retry.	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.

Step 2 - Error Codes (400 errors)

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.	Required input data missing. (Refer to Step2 - Input Data)
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	This submission is already processed. {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.	Step 2 process for the submission ID has been already completed. Further submission banned due to 'Approved Period' option
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.
invalid_idType	The idType is required. This submission id failed to define idType in step1.	When using Universal mode and failing to define idType in Step 1, the idType parameter is missing in Step 2.
face_validation_error	Fail to search face to validate duplicated user	This error occurs when the Face Duplicate Verification option is enabled and the search for a matching face in the database fails.
face_validation_error	Fail to add face image to collection.	This error occurs when the sFace Duplicate Verification option is enabled and the process of adding a face to the index fails.

Reject Comment Code

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.
duplicated_face	Duplicate face image, the user has already approved	This error occurs when the Face Duplicate Verification option is enabled, and the submitted face matches two or more faces in the approved list, resulting in a rejection due to duplication.