개요
KYC 검증은 결과에 따라 거절(Reject) / 재시도(Retry) / 경고(Warning) 로 분기됩니다. 이 중 Warning 은 해당 검증만 Skip 한 뒤 후속 KYC 프로세스를 이어가는 분기로, 차단·재촬영 없이 기록만 남깁니다.남은 Warning 기록은 GET Submission API 응답의warning[] 배열에 누적되어, 각 원소는 userDataType·relatedEngine·occurrenceTime 필드를 포함합니다. 고객사는 이 값을 Custom Policy 의 “경고 발생(Warning)” 트리거 로 받아 ARGOS Score 감점·Pending(보류)·Reject 등 후처리를 정책대로 적용할 수 있습니다.본 문서는 라이브폼이 발생시키는 WarningOccurred 값 11종을 발생 메커니즘별로 그룹화하여, 각 값이 warning[] 의 어떤 필드 조합으로 노출되는지, 그리고 어떤 대시보드 옵션과 연결되는지 정리합니다.warning[] 필드 스키마
응답 필드의 전체 정의는 GET Submission 응답 필드 정의 문서를 참고하세요.
그룹 A — ID Liveness 업로드 모드 Warning
ID Liveness 정책의 파이프라인(화면 재생 / 종이 출력물 / 초상화 교체) 각각에서 Retry + “업로드 시 Warning 적용(Apply Warning on Upload)” 체크박스를 ON 으로 설정하면, 사용자가 업로드(Upload) 모드 로 신분증을 제출한 경우에 한해 Retry → Warning 으로 전환됩니다. 업로드 모드에서는 재촬영이 불가능하므로 Warning 으로 처리해 프로세스를 이어가는 구조입니다.그룹 B — 만료 검증 Warning
신분증 만료일 / 여권 체류기간 만료 검증에서 대시보드 옵션을 Warning 으로 설정하면, 자동 거절·차단 대신 통과(Approved) + Warning 기록으로 처리됩니다.그룹 C — 엔진 오류 Warning 전환
신분증 라이브니스 · 셀피 Passive 라이브니스 · 한국 정부 진위확인 엔진이 오류로 처리되는 상황에서, 대시보드 Error Handling Method 를 Warning 으로 설정한 경우 전용 에러 페이지(SE-5002x / SE-5003x) 로 이동하지 않고 해당 검증만 Skip 한 뒤 Warning 으로 기록됩니다.얼굴 비교(Face Compare,
SE-50022) 엔진 오류는 Error 전용으로 처리되며, Warning 전환 옵션이 제공되지 않습니다. 셀피와 신분증 사진 일치 여부는 KYC 정합성의 핵심 검증이므로 Skip 분기를 제공하지 않습니다.Custom Policy 활용
warning[] 에 기록된 항목은 KYC 프로세스 대시보드 의 Custom Policy → Trigger → “경고 발생(Warning)” 조건으로 받아 후속 액션을 적용할 수 있습니다.트리거 매칭 조건
userDataType 와 relatedEngine 값의 조합으로 매칭합니다. 예시:적용 가능한 후속 액션
- ARGOS Score 감점 (예: -10 ~ -30)
- 결과를 Pending(보류) 으로 전환 → 관리자 수동 검토
- Reject(거절) 처리
- 기본 통과 (정책 미적용 시)
Custom Policy 의 Trigger 목록·연산자·액션 구성은 KYC 프로세스 대시보드 가이드에서 확인할 수 있습니다.
참고 문서
- GET Submission 응답 필드 정의 —
warning[]스키마와 다른 응답 필드 - 에러 코드와 에러 페이지 — Error Handling Method 가 Error 일 때 이동하는 SE 에러 페이지
- 거절 코드 및 재시도 코드 — Reject·Retry 분기 코드 목록
- 2026년 4월 업데이트 안내 — Expired ID·ID Liveness 업로드 모드 Warning 도입
- 2026년 5월 업데이트 안내 — 엔진 오류 Warning 전환 도입