Retry/Error/Reject Codes
STEP 1
Step 1 - Retry Codes (200 ok)
'mrz_protocol_fail', 'barcode_protocol_fail'을 제외한 리트라이 코드는 대시보드의 'ID CARD: Validation' 옵션 적용에 따라 신분증 유효성을 확인할 때만 반환될 수 있습니다.
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)
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.
invalid_id_type
Invalid id type: Id type must be passport, government_id or drivers_license.
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
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제출이 완료된 Submission ID에 대해 Step 1 retry를 시도함
Approved Period 옵션에 의해 다시 KYC를 제출할 수 없을 때
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)
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
한국 신분증 진위 확인 실패
USA, CAN, MEX 운전면허증 바코드와 정보 불일치
불가리아 신분증 정보 불일치
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
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.
라이브니스 통과 조건에 맞지 않음
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)
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.
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
This submission is already processed.
{email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.
Step2가 이미 진행된 submission(처리 완료 후 재시도 시)
Approved Period 옵션에 의해 다시 KYC를 제출할 수 없을 때
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
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