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.
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)
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
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)
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)
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
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
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.
Last updated