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
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
1.This submission is already processed.
2.{email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.
1.Step 1 process for the submission ID has been already completed
2.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.
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
STEP 2
Step 2 - Retry Codes (200 ok)
Retry Code
Message
Description
identity_verification_fail
1.ID verification failed: {message}. Please check the ID data.
2.ID verification failed: Barcode information does not match. {message}. Please check the ID data.
3.ID verification failed: EGN information does not match. {message}. Please check the ID data
1.Korean ID authentication failed.
2.USA, CAN, MEX drivers license, input data and barcode data mismatch.
3.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
1.Liveness fail: Face size is too small to be detected. Please retry
2.Liveness fail: Face is too close to one or more borders. Please retry.
3.Liveness fail: Interpupillary distance is too small. Please retry.
4.Liveness fail: Absolute face size is too small. Please retry.
5.Liveness fail: Face is cropped. Please retry.
6.Liveness fail: Facial out-of-plane rotation angle is extremely large. Please retry
7.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
1.This submission is already processed. 
2.{email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.
1.Step 2 process for the submission ID has been already completed.
2.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. 
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.

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.	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	1. This submission is already processed. 2. {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.	1. Step 1 process for the submission ID has been already completed 2. 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.
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	1. ID verification failed: {message}. Please check the ID data. 2. ID verification failed: Barcode information does not match. {message}. Please check the ID data. 3. ID verification failed: EGN information does not match. {message}. Please check the ID data	1. Korean ID authentication failed. 2. USA, CAN, MEX drivers license, input data and barcode data mismatch. 3. 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	1. Liveness fail: Face size is too small to be detected. Please retry 2. Liveness fail: Face is too close to one or more borders. Please retry. 3. Liveness fail: Interpupillary distance is too small. Please retry. 4. Liveness fail: Absolute face size is too small. Please retry. 5. Liveness fail: Face is cropped. Please retry. 6. Liveness fail: Facial out-of-plane rotation angle is extremely large. Please retry 7. 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.

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	1. This submission is already processed. 2. {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.	1. Step 2 process for the submission ID has been already completed. 2. 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.

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