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 검증은 결과에 따라 거절(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[] 필드 스키마
| 필드 | 타입 | 설명 |
|---|---|---|
warning[i].userDataType | String | 경고를 유발한 입력 데이터 유형 (예: ID Card, ID_card_uploaded, User Input) |
warning[i].relatedEngine | String | 경고가 발생한 엔진·검증 단계 명칭 |
warning[i].occurrenceTime | String | 경고 발생 시각 (ISO 8601) |
응답 필드의 전체 정의는 GET Submission 응답 필드 정의 문서를 참고하세요.
그룹 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 |
그룹 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 |
그룹 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 분기를 제공하지 않습니다.Custom Policy 활용
warning[] 에 기록된 항목은 KYC 프로세스 대시보드 의 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 프로세스 대시보드 가이드에서 확인할 수 있습니다.
참고 문서
- GET Submission 응답 필드 정의 —
warning[]스키마와 다른 응답 필드 - 에러 코드와 에러 페이지 — Error Handling Method 가 Error 일 때 이동하는 SE 에러 페이지
- 거절 코드 및 재시도 코드 — Reject·Retry 분기 코드 목록
- 2026년 4월 업데이트 안내 — Expired ID·ID Liveness 업로드 모드 Warning 도입
- 2026년 5월 업데이트 안내 — 엔진 오류 Warning 전환 도입