> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 거절 코드 및 재시도 코드

> KYC 과정에서 생성된 거절 코드와 코멘트, 그리고 재시도 코드 목록을 제공합니다

<div style={{paddingLeft: '2rem', paddingRight: '2rem'}}>
  ## 거절 코드와 코멘트

  <div style={{overflowX: 'auto', width: '100%'}}>
    | 거절 코드                          | 거절 코멘트                                                                                |
    | ------------------------------ | ------------------------------------------------------------------------------------- |
    | `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`                        | 검수자가 수동 검토 중 추가한 코멘트입니다.                                                              |
  </div>

  ## 재시도 코드

  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, 얼굴 비교, 얼굴 가림 감지 등) 범위를 따릅니다.

  <div style={{overflowX: 'auto', width: '100%'}}>
    | 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        | 인증 코드가 입력한 코드와 불일치함                      |
  </div>
</div>
