거절 코드 및 재시도 코드 - ARGOS Identity

New ID_Check v2.6.11 — a new ID recognition engine improves OCR for Korean documents, PII masking is now set from the dashboard, and submissions can be searched by custom fields (cf1–cf3). See what's new →

환영합니다

웹훅 이벤트

참조 테이블

통신과 보안

제품 업데이트

거절 코드와 코멘트

거절 코드	거절 코멘트
`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 미발생).

표의 O / X 는 각 retry code 가 해당 검증 흐름에서 발생 가능한지 여부를 의미합니다. FaceAuth 컬럼은 셀피(selfie) 프로세스에 적용되는 옵션(Active/Passive Liveness, 얼굴 비교, 얼굴 가림 감지 등) 범위를 따릅니다.

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	X	Passive Liveness 점수가 기준 미달인 경우
liveness_fail_active	O	O	X	Active Liveness 점수가 기준 미달인 경우
too_many_retry	O	O	X	재시도 회수를 초과한 경우
VERIFICATION_CODE_MISS_MATCH	X	O	X	인증 코드가 입력한 코드와 불일치함

FaceAuth 컬럼과 실제 fail_code 표기위 표의 코드명은 ID Check 본 프로세스의 재시도 코드 기준입니다. FaceAuth가 반환하는 fail_code는 표기가 다를 수 있으므로, FaceAuth의 정확한 코드 목록과 사용자 노출 문구는 Face Auth URL 검증 및 에러 처리를 참고하세요.특히 라이브니스 실패는 FaceAuth에서 passive_liveness_fail / active_liveness_fail로 반환되며, 위 표의 liveness_fail · liveness_fail_active와는 별개 값입니다.

⌘I