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

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.

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.

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.

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.

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.

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

Guide comment from agent.

Last updated 3 months ago