거절 코드와 코멘트
| 거절 코드 | 거절 코멘트 |
|---|---|
id_image_invalidImage | ID 문서를 감지할 수 없습니다. ID 문서를 명확하게 촬영하여 제출해 주세요. |
id_image_invalidId | 유효하지 않은 ID 문서입니다. 유효한 ID 문서를 다시 제출해 주세요. |
id_image_error | ID 문서 이미지를 업로드하지 못했습니다. KYC 과정을 다시 시도해 주세요. |
id_image_badImage | ID 문서를 읽을 수 없습니다. 명확한 이미지로 다시 제출해 주세요. |
id_info_dataMismatch | 입력된 정보가 ID 문서와 일치하지 않습니다. |
id_info_blacklist | 정책에 따라 country 출신의 KYC는 승인되지 않습니다. |
id_info_notOfAge | 정책에 따라 13세 미만의 개인은 KYC를 진행할 수 없습니다. |
duplicate_user | 신원정보 기반으로 중복된 유저입니다. |
duplicated_user_PII_exact | 사용자의 개인 신원 정보가 신원 확인 결과로 중복되었습니다. |
duplicated_face | 제출 건이 얼굴 중복으로 감지되었습니다. |
too_many_retry | 여러 차례 잘못된 KYC 시도가 감지되었습니다. |
blacklistCountry | 정책에 따라 country 출신의 KYC는 승인되지 않습니다. |
under_ageLimit | 정책에 따라 13세 미만의 개인은 KYC를 진행할 수 없습니다. |
invalid_acceptedID | 유효하지 않은 ID 유형입니다. 유효한 ID 문서를 제출해 주세요. 승인 가능한 ID 목록은 제출 페이지를 참조하세요. |
no-date-of-birth | 생년월일 정보가 누락되어 있습니다. |
expired_id | 유효기간이 지난 ID 입니다. |
automatic_verification_fail | 검증 실패 - 제출한 정보가 품질 기준에 부합하지 않습니다. 조명이 밝고 선명한 사진으로 다시 시도해 주세요. 문제가 지속되면 고객센터로 문의 바랍니다. |
address_image_invalidImage | 유효하지 않은 주소 증명 문서입니다. 이름과 주소가 포함된 명확한 문서를 제출해 주세요. 예: 공과금 청구서, 은행 명세서, 거주 증명서. |
address_image_error | 주소 증명 문서 이미지를 업로드하지 못했습니다. 다시 시도해 주세요. |
address_image_badImage | 주소 증명 문서를 읽을 수 없습니다. 이미지를 선명하게 다시 제출해 주세요. |
address_info_expiredDocument | 주소 증명 문서가 만료되었습니다. 최근 6개월 이내에 발급된 문서여야 합니다. |
address_info_dataMismatch | 입력된 정보가 주소 증명 문서와 일치하지 않습니다. |
applied_custom_policy | 내부 서비스 정책으로 인해 거절 되었습니다. 지속적으로 발생할 경우 관리자에게 문의해주세요. |
other | 검수자가 수동 검토 중 추가한 코멘트입니다. |
재시도 코드
KYC 진행 중 동일 검증 단계에서 실패가 발생하면 재시도(retry)가 트리거 됩니다. 각 검증 흐름별 재시도 한도는 아래와 같습니다.- ID Document: 3회 재시도 허용. 한도 초과 시
too_many_retry거절 코드로 종료됩니다. - Knowledge Based: 5회 재시도 허용. 한도 초과 시
too_many_retry거절 코드로 종료됩니다. - FaceAuth: 재시도 없이 1회 실패 시 즉시 거절 처리됩니다 (
too_many_retry미발생).
| retryCode | ID Document | Knowledge Based | FaceAuth | Description |
|---|---|---|---|---|
| recognition_fail | O | X | X | 시스템이 신분증 인식에 실패한 경우 |
| expired_id | O | X | X | 만료일자가 지난 ID |
| document_expired | O | X | X | 제출 서류가 만료된 경우 |
| invalid_back_document | O | X | X | 앞면과 뒷면의 이미지 정보가 불일치 |
| invalid_dual_side | O | X | X | 양면의 이미지가 잘못 인식된 경우 |
| document_country_mismatch | O | X | X | 문서의 국가 불일치 |
| glare_detected | O | X | X | 빛반사 감지 |
| image_too_blurry | O | X | X | 이미지가 흐릿함 |
| recaptured_document | O | X | X | 문서 이미지를 재촬영함 |
| screen_detected | O | X | X | 화면이 감지됨 |
| black_white_document | O | X | X | 문서가 흑백인 경우 |
| missing_birth_date | O | X | X | 생년월일이 누락됨 |
| document_name_mismatch | O | X | X | 문서상의 이름 불일치 |
| document_dob_mismatch | O | X | X | 문서상의 생년월일 불일치 |
| image_forgery | O | X | X | 위조된 이미지 |
| text_forgery | O | X | X | 위조된 텍스트 |
| feature_verification_failed | O | X | X | 특징 확인에 실패함 |
| image_edited | O | X | X | 수정된 이미지인 경우 |
| fake_id | O | X | X | 가짜 ID |
| artificial_image | O | X | X | 인위로 바꾼 이미지 |
| artificial_text | O | X | X | 인위로 바뀐 텍스트 |
| check_digit_failed | O | X | X | 숫자 확인에 실패함 |
| physicial_document_missing | O | X | X | 실물 문서가 누락됨 |
| missing_expiry_date | O | X | X | 만료일자 정보가 누락됨 |
| missing_issue_date | O | X | X | 발생일자 정보가 누락됨 |
| missing_document_number | O | X | X | 문서번호 정보가 누락됨 |
| missing_personal_number | O | X | X | 주민번호 정보가 누락됨 |
| missing_name | O | X | X | 이름 정보가 누락됨 |
| bank_authentication_fail | O | X | X | 인증번호, 이름 모두 확인에 실패함 |
| bank_authentication_code_fail | O | X | X | 인증번호 확인에 실패함 |
| bank_authentication_name_fail | O | X | X | 이름 확인에 실패함 |
| blacklist_country | O | O | X | 발급국가 기준으로 blacklist country 의 국가가 제출된 경우 |
| mrz_protocol_fail | O | X | X | MRZ 프로토콜 인식이 불가한 경우 |
| Identity_verification_fail | O | X | X | ID 신원 인증에 실패한 경우 |
| barcode_protocol_fail | O | X | X | 바코드 프로토콜 인식에 실패한 경우 |
| no_face | O | O | O | 셀피 촬영에 얼굴이 없는 경우 |
| face_compare_underscore | O | O | O | 얼굴 비교 점수가 기준 미달인 경우 |
| face_compare_fail | O | O | O | 얼굴 비교를 진행할 수 없는 경우 |
| face_occluded | O | O | O | 얼굴이 가려져 식별이 불가한 경우 |
| Id_livness_fail | O | X | X | ID 의 Liveness 검사에 실패한 경우 |
| liveness_error | O | O | O | Liveness 검사에 오류가 발생된 경우 |
| liveness_fail | O | O | O | Passive Liveness 점수가 기준 미달인 경우 |
| liveness_fail_active | O | O | O | Active Liveness 점수가 기준 미달인 경우 |
| too_many_retry | O | O | X | 재시도 회수를 초과한 경우 |
| VERIFICATION_CODE_MISS_MATCH | X | O | X | 인증 코드가 입력한 코드와 불일치함 |