Retry/Error/Reject Codes
STEP 1
Step 1 - Retry Codes (200 ok)
'mrz_protocol_fail', 'barcode_protocol_fail'을 제외한 리트라이 코드는 대시보드의 'ID CARD: Validation' 옵션 적용에 따라 신분증 유효성을 확인할 때만 반환될 수 있습니다.
Retry Code | Message | Description |
---|---|---|
mrz_protocol_fail | Failed to detect full MRZ | MRZ 인식에 실패 했을 경우 |
barcode_protocol_fail | Failed to read PDF417 Barcode | 바코드 인식에 실패했을 경우 |
invalid_back_document | Front and back side image mismatch. Please retry with one ID | 신분증 앞면과 뒷면의 이미지가 매칭되지 않음 |
document_country_mismatch | Front and back side image mismatch. Please retry with one ID | 신분증 앞면과 뒷면의 발급 국가가 일치하지 않음 |
document_expired | Your ID is expired already. Please retry with valid ID | 신분증의 만료 일자가 이미 지남 |
document_name_mismatch | Front and back side name mismatch. Please retry with one ID | 신분증 앞면과 뒷면의 이름이 일치하지 않음 |
document_dob_mismatch | Front and back side birthdate mismatch. Please retry with one ID | 신분증 앞면과 뒷면의 생년월일이 일치하지 않음 |
missing_expiry_date | Expiry date not detected. Please take clear picture | 만료 일자 감지 실패 혹은 만료 일자가 신분증에서 인위적으로 지워짐 |
missing_issue_date | Issue date not detected. Please take clear picture | 발급 일자 감지 실패 혹은 발급 일자가 신분증에서 인위적으로 지워짐 |
missing_birth_date | Birth date not detected. Please take clear picture | 생년월일 감지 실패 혹은 생년월일이 신분증에서 인위적으로 지워짐 |
missing_document_number | Document number not detected. Please take clear picture | 문서번호 감지 실패 혹은 문서번호가 신분증에서 인위적으로 지워짐 |
missing_personal_number | Identity number not detected. Please take clear picture | 주민등록번호 감지 실패 혹은 신분증 상에서 인위적으로 지워짐 |
missing_name | Name not detected. Please take clear picture | 이름 감지 실패 혹은 신분증 상에서 인위적으로 지워짐 |
glare_detected | Please retake ID image without light smudging | 빛 반사(번짐)로 인해 신분증 인식 불가 |
recaptured_document | Retry with physical ID. recaptured screen not allowed | 모니터 혹은 핸드폰 등에 띄워둔 이미지가 감지됨 |
screen_detected | Retry with physical ID. recaptured screen not allowed | 모니터 혹은 핸드폰 등의 화면을 캡처한 이미지가 감지됨 |
image_forgery | Please retry with original ID | 신분증 이미지에서 위조가 감지됨 |
feature_verification_failed | Please retry with original ID | 제출된 이미지가 데이터베이스에 등록되어 있는 신분증 이미지와 일치하지 않음 |
image_edited | Please retry with original ID | 이미지 편집 툴에 의해 수정된 사항이 감지됨 |
fake_id | Please retry with original ID | 온라인에서 구할 수 있는 샘플 신분증 이미지가 감지됨 |
artificial_image | Please retry with original ID | 인위적으로 생성된 신분증이 감지됨 |
artificial_text | Please retry with original ID | 텍스트 위조가 감지됨 |
text_forgery | Please retry with original ID | 텍스트 위조가 감지됨 |
check_digit_failed | Please retry with original ID | MRZ 영역 위조가 감지됨 |
image_too_blurry | Please retake ID image clearly | 이미지가 흐릿해 데이터 인식이 불가능 |
black_white_document | Please retry with original ID | 흑백으로 된 신분증(복사본)이 감지됨 |
physical_document_missing | Please take ID image in the right direction | 카메라 각도가 틀어져 신분증 인식 실패 |
expired_id | Expired ID document, please use unexpired ID card. | 신분증의 만료 일자가 지났을 경우 |
Id_livness_fail | Liveness validation of Id image failed. Failed for: {#pipelines} | 공격 방지 옵션 사용 시, ID Card Liveness Score 가 1개 이상의 파이프라인에서 50점 미만 일 경우. #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. | 이미지 파일 없음 |
invalid_id_image | Invalid ID image. Please retry with another ID image. | 이미지 파일의 경로가 잘못되었음 |
invalid_request | Failed to find the project. Please check the project ID. | 프로젝트가 삭제되어 없을 경우 |
invalid_project | This project is not available. | 프로젝트의 상태가 ‘close’ 상태일 경우 |
missing_parameters | Missing required parameters. | Input Data 필수 값이 들어오지 않았을 경우(Step1 - Input Data 참고) |
invalid_id_type | Invalid id type: Id type must be passport, government_id or drivers_license. | 지정된 ID type이 아닐 때(Step1 - Input Data 참고) |
invalid_input_format | Invalid input type: {parameters} | 입력 값의 포맷 맞지 않는 경우 |
invalid_email | Invalid email address format. | 잘못된 이메일 형식 |
id_image_error | ID image processing error. Please retry. | ID 이미지 처리 에러 |
data_processing_error | Data processing error. Please retry. | 데이터 저장 에러 |
save_image_error | ID image save error. Please retry. | ID 이미지 처리 혹은 저장 에러 |
processed_submission |
|
|
rejected_submission | {email} has an existing rejected submission. Not available to submit due to ‘rejected period’ option to prevent duplication. | Rejected Period 옵션에 의해 다시 KYC를 제출할 수 없을 때 |
reviewing | {email}’s KYC is currently reviewing. Please wait. | 해당 이메일 계정에 아직 결과가 나오지 않아 'Pending' 상태에 있는 KYC가 있어 추가 제출을 받지 않음 |
not_an_id | Please take a picture of an ID card. | 제출된 ID 이미지가 신분증이 아니라고 판단 될 경우 |
id_detection_error | ID detection error. Please retry. | 제출된 ID 이미지가 신분증인지 여부 판단 중 오류가 발생 할 경우 |
ocr_fail | OCR not supported ID. Please retry with another ID. | 'AI Supported Only'옵션과 연동되어 있으며, OCR 엔진이 지원하지 않는 신분증이 제출됨 |
invalid_id | Invalid ID. Please resubmit with another ID. | 해당 국가의 정책으로 더 이상 유효하지 않은 신분증이 제출되었을 경우(Uzbekistan) |
id_validation_error | ID validation server error. Please, retry. | ID validation 서버 오류 |
invalid_idType | This project is not using the Universal option. | Universal 옵션이 Off 인 상태인데, idType 에 ‘universal’ 로 제출한 경우. - Universal 옵션 사용 시에만 idType ‘universal’ 제출 가능. 그 이외엔 정확한 idType 입력 필수. |
invalid_idType | ID Card issued from Korea cannot use universal id type. | 한국 신분증인데, idType 에 ‘universal’ 로 제출한 경우. - issuingCountry 가 ‘KOR’ 인 경우, Universal 옵션 사용 여부와 관계없이 Universal 모드 사용 불가 |
invalid_idType | Cannot input specific idType in using universal option | Universal 옵션을 사용중인데, idType 에 특정 신분증 타입을 제출한 경우 |
missing_parameters | IdCard Back Image is required in using universal option | Universal 옵션을 사용하며 idType을 ‘universal’ 로 제출했으나, 신분증 뒷면 사진을 제출하지 않은 경우 - Universal 모드 사용시에는 신분증 뒷면 사진을 필수로 제출해야함. |
id_liveness_error | ID liveness error. | 공격 방지 옵션 사용 시, ID Card Liveness 검증 중 에러 발생. |
STEP 2
Step 2 - Retry Codes (200 ok)
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. | 제출된 이미지에 얼굴이 감지되지 않음 |
face_compare_underscore | The face doesn’t match. Please retry with another face image. | 얼굴 비교 점수가 85점 이하 |
face_compare_fail | Failed to find a matching face. Please retry with another face image. | 얼굴 비교를 하기 위한 유사 얼굴을 찾는데 실패(일치하는 얼굴이 없음) |
face_detect_error | Failed to detect a face. | 서버 에러 |
liveness_fail | Liveness fail. Please retry with another face image. | 라이브니스 점수가 50점 이하 |
liveness_error |
| 라이브니스 통과 조건에 맞지 않음 |
bank_authentication_fail | The authentication code and account holder doesn't match. | 1원 인증 코드 및 예금주명이 모두 일치하지 않는 경우 |
bank_authentication_code_fail | 1 won authentication fail. The authentication code doesn't match. | 1원 인증 코드가 일치하지 않는 경우 |
bank_authentication_name_fail | 1 won authentication fail. The account holder doesn't match. | 1원 인증 예금주명이 일치하지 않는 경우 |
Step 2 - Error Codes (400 error)
Error Code | Message | Description |
---|---|---|
invalid_payload | Failed to parse the input data. | api call 할 때 발생하는 문제로 대부분 이미지가 없을 때 잘못 입력하였을 때 발생 |
invalid_request | Failed to find the project. Please check the project ID. | 더 이상 제출이 유효한 프로젝트가 아님 |
invalid_face_image | Invalid face image. Please retry with another face image. | Selfie 이미지 파일의 경로가 잘못되었음 |
missing_parameters | Missing required parameters. | Input Data 필수 값이 들어오지 않았을 경우(Step2 - Input Data 참고) |
invalid_address_image | Invalid address image. Please retry with another address image. | 주소지 증명 이미지가 없거나 잘못된 경우 |
invalid_submission_id | Invalid submission ID error. Please check the submission ID. | Step 1에서 생성된 submission ID가 올바르게 입력되지 않음 |
no_submission | Fail to find the submission data. Please contact CS center. | DB 에서 submission 가져오기 실패 |
processed_submission |
|
|
rejected_submission | {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication. | Rejected Period 옵션에 의해 다시 KYC를 제출할 수 없을 때 |
unauthorized | Invalid API key. Please check. | API키가 올바르지 않은 경우 |
missing_address | Missing address data information. | 주소지 정보 없음(주소지 수집 옵션이 켜져 있을 때) |
unexpected_error | Failed to submit KYC. | DB 저장 , webhook, email 전송 등의 최종 작업 실패 할 경우 |
verify_kor_error | The ID card you submitted is currently unable to proceed due to an error in the authenticity verification server. Please proceed with a different ID card or try again later. | 한국 신분증 진위확인 서버 에러 |
invalid_bank_authentication | Failed to read bank authentication's data. | 1원 송금 절차(PreStep2) 이 정상적으로 완료되지 않은 경우 |
missing_required_field | The account holder's name and the 1 won authentication code are required fields. | 1원 인증 코드검증을 위한 필수 입력값 누락 (userOccupancyName, userOccupancyCode) |
missing_required_field | 1 won authentication fail. The account holder's name doesn't match. | 1원 인증시 입력한 예금주명과 Step2 파라미터로 제출한 ‘userOccupancyName’ 이 일치하지 않는 경우 |
exceeded_72hour_limit | The submission is invalid because it has been more than 72 hours since Step1. | Step1 제출로부터 유효시간인 72시간이 경과한 경우(createTime 기준) |
invalid_idType | The idType is required. This submission id failed to define idType in step1. | Universal 모드 사용하고 Step1 에서 idType 정의에 실패했는데, Step2 에 idType 파라미터 누락된 경우 |
face_validation_error | Fail to search face to validate duplicated user | 얼굴중복 검증 옵션을 활성화했으나, 동일한 얼굴을 조회하는 과정에서 실패한 경우입니다. |
face_validation_error | Fail to add face image to collection | 얼굴 중복 검증 옵션을 활성화했으나, 얼굴 인덱스를 저장하는 과정에서 실패한 경우입니다. |
Reject Comment Code
Reject Comment Code | Message | Description |
---|---|---|
too_many_retry | Multiple invalid KYC attempts | Retry count가 3회로 올라갔지만 KYC가 승인되지 못함 |
timeout | KYC rejected due to timeout | Retry count가 1 이상이며 KYC Status가 'Incomplete'인 제출 건이 일정 시간 후 'Rejected'로 변경됨 |
duplicate_user | Identity has been determined to be the same duplicate as the previously approved one. | 옵션 적용에 따라 중복된 사용자로 판명되어 신규 제출된 KYC를 거절 |
blacklistCountry | According to the policy, we do not accept KYC from {country}. | 'Blacklist Country' 옵션이 적용되어 해당 국가에서 발급한 신분증으로 제출한 KYC를 거절 |
under_ageLimit | We do not accept KYC anyone under {age} years old. | 'Age Limit' 옵션에 따라 설정된 연령 이하의 사용자가 제출한 KYC를 거절 |
invalid_acceptedID | Inacceptable ID type. Please resubmit with another ID, check the valid ID on the submission page. | 'ID Type' 옵션에 따라 제출 받지 않기로 한 종류의 신분증을 거절함 |
id_image_invalidImage | ID document not detected. Please take a picture of your ID document. | 제출된 신분증 이미지가 신분증이 아님 |
id_image_invalidId | Invalid ID document. Please resubmit with another ID document. | 제출된 신분증이 유효하지 않음. 예) 생년만 나와있는 신분증 |
id_image_error | Fail to upload the ID image. Please resubmit the KYC process. | 이미지 업로드 에러로 보이지 않음 |
id_image_badImage | Fail to read the ID image. Please take a clear picture of your ID document. | 신분증 이미지 화질이 나빠 검수할 수 없음 |
id_info_dataMismatch | The entered information does not match with your ID document. | 정보 수정이 불가능한 언어(한자, 키릴문자 등)이면서 신분증과 사용자 입력값이 다름 |
id_info_blacklist | According to the policy, we do not accept KYC from {country}. | 매뉴얼 검수 단계에서 신분증의 발급 국가를 수정했고, 수정된 발급 국가가 Blacklist Country로 설정되어 있음 |
id_info_notOfAge | We do not accept KYC anyone under {age} years old. | 매뉴얼 검수 단계에서 생년월일을 수정했고, 수정된 연령이 'Age Limit'에 설정된 값보다 낮음 |
address_image_invalidImage | Invalid proof of address. Proof of address must include your full name and address. | 사용자의 이름과 주소가 다 나와있지 않아 유효한 주소지 문서가 아님 |
address_image_error | Fail to upload proof of address image. Please retry. | 이미지 업로드 에러로 보이지 않음 |
address_image_badImage | Fail to read the image. Please take a clear picture of your proof of address. | 주소지 증명 서류 이미지 화질이 나빠 검수할 수 없음 |
address_info_expiredDocument | Expired proof of address. The proof of address should be issued within 6 months. | 주소지 증명 서류가 만료됨 |
address_info_dataMismatch | Entered information does not match with your proof of address. | 정보 수정이 불가능한 언어(한자, 키릴문자 등)이면서 주소지 증명 서류와 사용자 입력값이 다름 |
other | other | 매뉴얼 검수 단계에서 Agent가 입력한 안내 메세지 |
duplicated_face | Duplicate face image, the user has already approved | 얼굴 중복 검증 옵션을 사용 중, 제출된 얼굴이 사전에 승인된 얼굴 목록 중 두 개 이상의 얼굴과 일치하여 중복으로 간주되어 거절된 경우입니다. |
Last updated