> ## 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. # Warning 코드와 필드 > WarningOccurred 값별 발생 조건, warning[] 필드 매핑, Custom Policy 활용 방법을 안내합니다.
## 개요 KYC 검증은 결과에 따라 **거절(Reject) / 재시도(Retry) / 경고(Warning)** 로 분기됩니다. 이 중 **Warning** 은 해당 검증만 Skip 한 뒤 후속 KYC 프로세스를 이어가는 분기로, 차단·재촬영 없이 기록만 남깁니다. 남은 Warning 기록은 [GET Submission API](/ko/idcheck/api-reference/api-reference-guide/get-submission) 응답의 `warning[]` 배열에 누적되어, 각 원소는 `userDataType`·`relatedEngine`·`occurrenceTime` 필드를 포함합니다. 고객사는 이 값을 [Custom Policy](/dashboard/ko/project-management/policy-and-authentication/kyc-process) 의 **"경고 발생(Warning)" 트리거** 로 받아 ARGOS Score 감점·Pending(보류)·Reject 등 후처리를 정책대로 적용할 수 있습니다. 본 문서는 라이브폼이 발생시키는 `WarningOccurred` 값 11종을 발생 메커니즘별로 그룹화하여, 각 값이 `warning[]` 의 어떤 필드 조합으로 노출되는지, 그리고 어떤 대시보드 옵션과 연결되는지 정리합니다. ## warning\[] 필드 스키마
| 필드 | 타입 | 설명 | | --------------------------- | ------ | ------------------------------------------------------------------ | | `warning[i].userDataType` | String | 경고를 유발한 입력 데이터 유형 (예: `ID Card`, `ID_card_uploaded`, `User Input`) | | `warning[i].relatedEngine` | String | 경고가 발생한 엔진·검증 단계 명칭 | | `warning[i].occurrenceTime` | String | 경고 발생 시각 (ISO 8601) |
응답 필드의 전체 정의는 [GET Submission 응답 필드 정의](/ko/idcheck/api-reference/api-reference-guide/get-submission-response-fields) 문서를 참고하세요. ## 그룹 A — ID Liveness 업로드 모드 Warning ID Liveness 정책의 파이프라인(**화면 재생 / 종이 출력물 / 초상화 교체**) 각각에서 **Retry + "업로드 시 Warning 적용(Apply Warning on Upload)"** 체크박스를 ON 으로 설정하면, 사용자가 **업로드(Upload) 모드** 로 신분증을 제출한 경우에 한해 Retry → Warning 으로 전환됩니다. 업로드 모드에서는 재촬영이 불가능하므로 Warning 으로 처리해 프로세스를 이어가는 구조입니다.
| WarningOccurred | 파이프라인 | 발생 조건 | userDataType | relatedEngine | | ------------------------------- | ------ | -------------------------------- | ------------------ | ------------------------------- | | `id_liveness_screen_replay` | 화면 재생 | 화면 재생 파이프라인 Retry 적중, 업로드 모드 제출 | `ID_card_uploaded` | `ID Liveness Screen replay` | | `id_liveness_paper_printed` | 종이 출력물 | 종이 출력물 파이프라인 Retry 적중, 업로드 모드 제출 | `ID_card_uploaded` | `ID Liveness Paper printed` | | `id_liveness_replace_portraits` | 초상화 교체 | 초상화 교체 파이프라인 Retry 적중, 업로드 모드 제출 | `ID_card_uploaded` | `ID Liveness Replace portraits` |
파이프라인별 설정 방법은 2026년 4월 업데이트의 [ID Liveness 업로드 모드 Warning 자동 전환](/ko/idcheck/notices/2026-04-update) 항목과 [인증강화 및 위조방지](/dashboard/ko/project-management/policy-and-authentication/anti-fraud-and-forgery-prevention) 대시보드 가이드를 참고하세요. ## 그룹 B — 만료 검증 Warning 신분증 만료일 / 여권 체류기간 만료 검증에서 대시보드 옵션을 **Warning** 으로 설정하면, 자동 거절·차단 대신 통과(Approved) + Warning 기록으로 처리됩니다.
| WarningOccurred | 발생 조건 | userDataType | relatedEngine | | ---------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------ | ------------------------------ | | `expired_id` | **Expired ID** 옵션이 Warning 일 때, 신분증 OCR 만료일이 현재 일자 이전이거나 사용자 입력값이 만료된 경우 Step 1·2 만료 차단을 우회 | `ID Card` / `User Input` | `Expiry validation` | | `gov_verification_passport_expired_stay` | 한국 정부 진위확인 결과 여권의 체류기간(`expiryDateOfStayKor`, 법무부 등록 만료일) 이 현재 일자 이전인 경우 | `User Input` | `KOR Gov Passport stay expiry` |
Expired ID 옵션의 Retry / Warning 선택과 동작은 2026년 4월 업데이트의 [만료된 신분증(Expired ID) 후속 처리 옵션 추가](/ko/idcheck/notices/2026-04-update) 항목을 참고하세요. 한국 법무부 체류만료일 필드는 [`expiryDateOfStayKor`](/ko/idcheck/api-reference/api-reference-guide/get-submission-response-fields) 항목을 참고하세요. ## 그룹 C — 엔진 오류 Warning 전환 **신분증 라이브니스 · 셀피 Passive 라이브니스 · 한국 정부 진위확인** 엔진이 오류로 처리되는 상황에서, 대시보드 **Error Handling Method** 를 **Warning** 으로 설정한 경우 전용 에러 페이지(`SE-5002x` / `SE-5003x`) 로 이동하지 않고 해당 검증만 Skip 한 뒤 Warning 으로 기록됩니다.
| WarningOccurred | 매핑 에러 코드 | 엔진 | | -------------------------------------- | ---------- | ----------------------- | | `id_liveness_engine_error_warning` | `SE-50020` | 신분증 라이브니스 (ID Liveness) | | `selfie_liveness_engine_error_warning` | `SE-50021` | 셀피 Passive 라이브니스 | | `kor_gov_rrc_error_warning` | `SE-50030` | 한국 정부 진위확인 — 주민등록증 | | `kor_gov_drvlic_error_warning` | `SE-50031` | 한국 정부 진위확인 — 운전면허증 | | `kor_gov_passport_error_warning` | `SE-50032` | 한국 정부 진위확인 — 여권 | | `kor_gov_foreign_error_warning` | `SE-50033` | 한국 정부 진위확인 — 외국인등록증 |
얼굴 비교(Face Compare, `SE-50022`) 엔진 오류는 **Error 전용**으로 처리되며, Warning 전환 옵션이 제공되지 않습니다. 셀피와 신분증 사진 일치 여부는 KYC 정합성의 핵심 검증이므로 Skip 분기를 제공하지 않습니다. Error Handling Method 설정 방법은 2026년 5월 업데이트의 [Error Handling Method — Warning 전환 & Custom Policy 연계](/ko/idcheck/notices/2026-05-update) 항목과 [인증강화 및 위조방지](/dashboard/ko/project-management/policy-and-authentication/anti-fraud-and-forgery-prevention) 대시보드 가이드를, 전체 SE 에러 코드 매핑은 [에러 코드와 에러 페이지](/ko/idcheck/reference_tables/Error-codes-and-pages) 문서를 참고하세요. ## Custom Policy 활용 `warning[]` 에 기록된 항목은 [KYC 프로세스 대시보드](/dashboard/ko/project-management/policy-and-authentication/kyc-process) 의 **Custom Policy → Trigger → "경고 발생(Warning)"** 조건으로 받아 후속 액션을 적용할 수 있습니다. ### 트리거 매칭 조건 `userDataType` 와 `relatedEngine` 값의 조합으로 매칭합니다. 예시:
| 매칭 대상 | 의미 | | ------------------------------------------------------------------------------ | -------------------------------- | | `userDataType = ID Card`, `relatedEngine = Expiry validation` | 신분증 OCR 만료일 기반 Warning | | `userDataType = ID_card_uploaded`, `relatedEngine = ID Liveness Screen replay` | 업로드 모드에서 발생한 화면 재생 라이브니스 Warning | | `relatedEngine = SE-50020` (또는 엔진명 `ID Liveness`) | 신분증 라이브니스 엔진 오류 Warning 전환건 |
### 적용 가능한 후속 액션 * ARGOS Score 감점 (예: -10 \~ -30) * 결과를 **Pending(보류)** 으로 전환 → 관리자 수동 검토 * **Reject(거절)** 처리 * 기본 통과 (정책 미적용 시) Custom Policy 의 Trigger 목록·연산자·액션 구성은 [KYC 프로세스](/dashboard/ko/project-management/policy-and-authentication/kyc-process) 대시보드 가이드에서 확인할 수 있습니다. ## 참고 문서 * [GET Submission 응답 필드 정의](/ko/idcheck/api-reference/api-reference-guide/get-submission-response-fields) — `warning[]` 스키마와 다른 응답 필드 * [에러 코드와 에러 페이지](/ko/idcheck/reference_tables/Error-codes-and-pages) — Error Handling Method 가 Error 일 때 이동하는 SE 에러 페이지 * [거절 코드 및 재시도 코드](/ko/idcheck/reference_tables/reject-codes-and-comments) — Reject·Retry 분기 코드 목록 * [2026년 4월 업데이트 안내](/ko/idcheck/notices/2026-04-update) — Expired ID·ID Liveness 업로드 모드 Warning 도입 * [2026년 5월 업데이트 안내](/ko/idcheck/notices/2026-05-update) — 엔진 오류 Warning 전환 도입