> ## 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.

# 세션 여정 이벤트 레퍼런스

> 세션 여정에 기록되는 전체 이벤트의 의미와, 거절·보류 사유 코드를 단계별로 정리했습니다.

이 문서는 세션 여정에 기록되는 모든 이벤트를 단계별로 정리한 레퍼런스입니다. 세션 여정의 개념과 해석 방법은 [세션 여정 개요](/dashboard/ko/session-journey/overview)를 먼저 참고하세요.

## 표 보는 법

* **출처** — `FE`: 사용자 화면에서 관측된 동작 · `BE`: 서버에서 실행된 검증·판정
* **사용자 영향** — `NONE` 영향 없음 · `BLOCKED` 차단 · `RETAKE` 재촬영·재시도 · `PENDING` 보류 · `REJECTED` 거절 · `APPROVED` 승인 · `COMPLETED` 단계 완료

<Warning>
  표는 단계별로 정리돼 있지만, **한 단계 안의 이벤트들은 동시에 실행**될 수 있습니다. 표시 순서가 곧 인과 관계는 아니라는 점을 유념하세요.
</Warning>

## 세션 시작 · 진입

| 이벤트                       | 출처 | 의미                                   | 사용자 영향  |
| ------------------------- | -- | ------------------------------------ | ------- |
| `SESSION_CREATED`         | BE | 라이브폼 신규 세션 생성, Session ID 발급         | NONE    |
| `SESSION_REUSED`          | BE | 20분 내 진행 중이던 기존 세션 재사용               | NONE    |
| `FRONT_SESSION_START`     | FE | 화면에서 세션 시작 신호 (`SESSION_CREATED`와 짝) | NONE    |
| `FRONT_SESSION_RESUMED`   | FE | 화면에서 세션 재개 신호 (`SESSION_REUSED`와 짝)  | NONE    |
| `PROJECT_OPTIONS_FETCHED` | BE | 프로젝트 검증 옵션 조회                        | NONE    |
| `NATIONALITY_INFO_LOOKUP` | BE | IP 기반 국가 정보 조회                       | NONE    |
| `FLOW_ID_ISSUED`          | BE | 흐름 식별자(Flow ID) 발급                   | NONE    |
| `LIVEFORM_HASH_CREATED`   | BE | 중도 재진행용 해시 생성                        | NONE    |
| `CHECKPOINT_HASH_CHECK`   | BE | 중도 재진행 가능 여부 검증                      | BLOCKED |
| `STEP_VIEW`               | FE | 일반 화면 진입 (어느 화면인지 경로로 구분)            | NONE    |

## 사전 점검 · 차단 (Guard / 정책)

| 이벤트                             | 출처 | 의미                            | 사용자 영향  |
| ------------------------------- | -- | ----------------------------- | ------- |
| `TOKEN_VALIDATION_CHECK`        | BE | 프라이빗 모드 토큰 유효성·만료 검증          | BLOCKED |
| `PRIVATE_TOKEN_USAGE_RECORDED`  | BE | 프라이빗 토큰 최초 사용 기록              | NONE    |
| `PERIOD_CHECK`                  | BE | 승인/거절/보류 중복 제출 정책 검사          | BLOCKED |
| `PACKET_ABUSE_CHECK`            | BE | Step1 패킷·Flow ID 재사용 검증       | BLOCKED |
| `TURNSTILE_TOKEN_CHECK`         | BE | 봇 차단(Turnstile) 토큰 검증         | BLOCKED |
| `IP_RISK_CHECK`                 | BE | IP 위험도·블랙리스트 검증               | BLOCKED |
| `RATE_LIMIT_CHECK`              | BE | 제출 빈도 한도(Rate Limit) 검증       | BLOCKED |
| `DEVICE_VERIFICATION`           | FE | 기기 안티스푸핑 검증 결과(화면 관측)         | NONE    |
| `DEVICE_VALIDATION_RECORDED`    | BE | 기기 검증 결과 기록                   | BLOCKED |
| `FINGERPRINT_CHECK`             | BE | 기기 지문(Fingerprint) 중복·디바이스 검증 | BLOCKED |
| `FINGERPRINT_SUBMISSION_LINKED` | BE | 기기 지문 검증과 제출건 연결              | BLOCKED |

## 화면의 API 호출 관측 (FE)

이 이벤트들은 **화면이 특정 API를 호출한 시점**을 기록합니다. 같은 동작의 서버 처리 결과는 대응하는 BE 이벤트(아래 `↔` 표시)에 별도로 남습니다. 호출 자체가 실패하면 `API_ERROR`로 기록됩니다.

| 이벤트                             | 출처 | 의미                                                      | 사용자 영향 |
| ------------------------------- | -- | ------------------------------------------------------- | ------ |
| `CREATE_FLOW`                   | FE | 검증 흐름(Flow) 생성 요청 (↔ `FLOW_ID_ISSUED`)                  | NONE   |
| `GET_PROJECT`                   | FE | 프로젝트 전체 설정 조회 요청                                        | NONE   |
| `QUERY_PROJECT_OPTIONS`         | FE | 프로젝트 개별 옵션 조회 요청 (↔ `PROJECT_OPTIONS_FETCHED`)          | NONE   |
| `GET_NATIONALITY_LIST`          | FE | 국가 정보 목록 조회 요청 (↔ `NATIONALITY_INFO_LOOKUP`)            | NONE   |
| `CHECKPOINT_HASH`               | FE | 중도 재진행 해시 생성·검증 요청 (↔ `CHECKPOINT_HASH_CHECK`)          | NONE   |
| `HANDLE_LINK_TOKEN`             | FE | 프라이빗 모드 토큰 처리 요청 (↔ `TOKEN_VALIDATION_CHECK`)           | NONE   |
| `CHECK_TURNSTILE`               | FE | 봇 차단(Turnstile) 검증 요청 (↔ `TURNSTILE_TOKEN_CHECK`)       | NONE   |
| `CHECK_IP_RISK`                 | FE | IP 위험도 검증 요청 (↔ `IP_RISK_CHECK`)                        | NONE   |
| `CHECK_RATE_LIMIT`              | FE | 제출 빈도 한도 검증 요청 (↔ `RATE_LIMIT_CHECK`)                   | NONE   |
| `CHECK_FINGERPRINT_DUPLICATION` | FE | 기기 지문 중복 검증 요청 (↔ `FINGERPRINT_CHECK`)                  | NONE   |
| `POST_DEVICE_VALIDATION`        | FE | 기기 검증 결과 전송 (↔ `DEVICE_VALIDATION_RECORDED`)            | NONE   |
| `CHECK_APPROVED`                | FE | 승인·중복 이력 확인 요청                                          | NONE   |
| `SEND_AUXID_SMS`                | FE | SMS 인증코드 발송 요청 (↔ `AUXID_PHONE_VERIFICATION_STARTED`)   | NONE   |
| `VERIFY_AUXID_SMS`              | FE | SMS 인증코드 검증 요청 (↔ `AUXID_PHONE_VERIFICATION_COMPLETED`) | NONE   |
| `KB_STAGE2_SEND_SMS`            | FE | 지식기반 인증 SMS 발송 요청                                       | NONE   |
| `KB_STAGE2_VERIFY_SMS`          | FE | 지식기반 인증 SMS 검증 요청                                       | NONE   |
| `API_CALL`                      | FE | 위 항목으로 분류되지 않은 일반 API 호출                                | NONE   |

## 화면 · 환경 관측 (FE)

| 이벤트                      | 출처 | 의미                             | 사용자 영향  |
| ------------------------ | -- | ------------------------------ | ------- |
| `ALERT_SHOWN`            | FE | 알림 팝업 노출                       | NONE    |
| `API_ERROR`              | FE | 화면에서 관측한 API 요청 실패             | BLOCKED |
| `JS_ERROR`               | FE | 전역 JS 런타임 오류                   | NONE    |
| `PAGE_HIDDEN`            | FE | 탭이 백그라운드로 전환 (이탈 신호)           | NONE    |
| `PAGE_VISIBLE`           | FE | 탭이 다시 포그라운드로 복귀                | NONE    |
| `NETWORK_ONLINE`         | FE | 네트워크 온라인 복귀                    | NONE    |
| `NETWORK_OFFLINE`        | FE | 네트워크 오프라인 전환                   | NONE    |
| `ERROR_PAGE_VIEWED`      | FE | 에러 페이지 진입 (강제 이탈 지점)           | BLOCKED |
| `WEBSOCKET_CONNECTED`    | FE | 결과 수신 WebSocket 연결 성공          | NONE    |
| `WEBSOCKET_DISCONNECTED` | FE | 결과 수신 WebSocket 비정상 종료 → 폴링 대체 | NONE    |
| `WEBSOCKET_ERROR`        | FE | 결과 수신 WebSocket 오류 발생          | NONE    |

## 카메라 · 촬영 (FE)

| 이벤트                        | 출처 | 의미                     | 사용자 영향  |
| -------------------------- | -- | ---------------------- | ------- |
| `CAMERA_REQUESTED`         | FE | 카메라 권한 요청 시작           | NONE    |
| `CAMERA_ACTIVATED`         | FE | 카메라 스트림 활성화            | NONE    |
| `CAMERA_PERMISSION_DENIED` | FE | 사용자가 카메라 권한 거부 → 촬영 불가 | BLOCKED |
| `CAMERA_ERROR`             | FE | 권한 외 사유로 카메라 시작 실패     | BLOCKED |
| `TIP_DIALOG_SHOWN`         | FE | 신분증 촬영 팁·재촬영 안내 노출     | NONE    |
| `ID_DOCUMENT_RETRY`        | FE | 사용자가 신분증 재촬영           | RETAKE  |
| `UPLOAD_IMAGE`             | FE | 신분증·얼굴 이미지 업로드         | NONE    |

## 보조 인증 (SMS · 이메일 · 주소 · 계좌)

| 이벤트                                  | 출처 | 의미             | 사용자 영향    |
| ------------------------------------ | -- | -------------- | --------- |
| `AUXID_PHONE_VERIFICATION_STARTED`   | BE | SMS 인증코드 발송    | NONE      |
| `AUXID_PHONE_VERIFICATION_COMPLETED` | BE | SMS 인증코드 검증    | COMPLETED |
| `VERIFY_EMAIL`                       | FE | 이메일 인증코드 검증    | NONE      |
| `SEARCH_ADDRESS`                     | FE | 주소 자동완성 조회     | NONE      |
| `GET_ADDRESS_DETAIL`                 | FE | 선택 주소 상세 조회    | NONE      |
| `VERIFY_ACCOUNT`                     | FE | 계좌 인증(1원 송금 등) | NONE      |

## STEP1 — 신분증

| 이벤트                                 | 출처 | 의미                                 | 사용자 영향    |
| ----------------------------------- | -- | ---------------------------------- | --------- |
| `STEP1_ENTERED`                     | BE | Step1(신분증) 진입                      | NONE      |
| `REGIONAL_VALIDATION`               | BE | IP 국가 ↔ 발급국 정합 검증                  | BLOCKED   |
| `DUPLICATE_SUBMISSION_PERIOD_CHECK` | BE | 동일 email/IP 기간 중복 검증               | BLOCKED   |
| `ID_RECOGNITION`                    | BE | 신분증 OCR 인식                         | RETAKE    |
| `ID_LIVENESS_VERIFICATION`          | BE | 신분증 라이브니스(비실물) 검증                  | RETAKE    |
| `RECOGNITION_SCORE_EVALUATION`      | BE | 인식 점수 임계값 평가                       | RETAKE    |
| `AGE_VERIFICATION`                  | BE | 연령 추출·검증 (Step1/Step2 공통)          | RETAKE    |
| `MRZ_VALIDATION`                    | BE | 여권 MRZ 검증                          | RETAKE    |
| `BARCODE_VALIDATION`                | BE | PDF417 바코드 검증                      | RETAKE    |
| `BLACKLIST_COUNTRY_EVALUATION`      | BE | 발급국 블랙리스트 정합 검증                    | BLOCKED   |
| `EXPIRED_ID_CHECK`                  | BE | 신분증 만료일 검증                         | RETAKE    |
| `SUBMISSION_CREATED`                | BE | ★ 제출건(Submission) 생성 — Step1 핵심 지점 | NONE      |
| `STEP1_COMPLETED`                   | BE | Step1 정상 완료 (Step2 진입 가능)          | COMPLETED |
| `SUBMIT_STEP1`                      | FE | 신분증 제출 (화면 관측)                     | NONE      |
| `STEP1_RESULT`                      | FE | Step1 결과 수신 (통과/재촬영/실패)            | NONE      |

## Pre-STEP2 (계좌 검증)

| 이벤트                              | 출처 | 의미              | 사용자 영향    |
| -------------------------------- | -- | --------------- | --------- |
| `VALIDATION_ACCOUNT_ENTERED`     | BE | Pre-STEP2 단계 진입 | NONE      |
| `TRANSFER_FREQUENCY_LIMIT_CHECK` | BE | 일일 송금 한도 검증     | REJECTED  |
| `BANK_OCCUPANCY_REQUEST`         | BE | 1원 점유코드 송금 요청   | RETAKE    |
| `BANK_NAMECHECK_REQUEST`         | BE | 예금주명 조회         | RETAKE    |
| `PRE_STEP2_COMPLETED`            | BE | Pre-STEP2 검증 통과 | COMPLETED |

## STEP2 — 셀피 · 얼굴

| 이벤트                             | 출처 | 의미                 | 사용자 영향   |
| ------------------------------- | -- | ------------------ | -------- |
| `STEP2_ENTERED`                 | BE | Step2(셀피) 진입       | NONE     |
| `PII_DUPLICATE_PERIOD_CHECK`    | BE | 동일 개인정보 기간 중복 검증   | REJECTED |
| `ACTIVE_LIVENESS_VERIFICATION`  | BE | 액티브 라이브니스 검증       | RETAKE   |
| `LIVENESS_VERIFICATION`         | BE | 패시브 라이브니스 검증       | RETAKE   |
| `FACE_COMPARE`                  | BE | 셀피 ↔ 신분증 얼굴 비교     | RETAKE   |
| `SELFIE_DUPLICATE_CHECK`        | BE | 셀피(얼굴) 중복 검증       | REJECTED |
| `CODEF_VERIFICATION`            | BE | 한국 정부 진위확인(CODEF)  | RETAKE   |
| `MEX_CURP_VERIFICATION`         | BE | 멕시코 CURP 검증        | RETAKE   |
| `BANK_AUTHENTICATION`           | BE | 1원 점유코드 검증 (Step2) | RETAKE   |
| `EXPIRY_DATE_OF_STAY_CHECK`     | BE | 체류 만료일 검증          | RETAKE   |
| `COUNTRY_CODE_MATCH_CHECK`      | BE | 4종 국가 코드 정합 검증     | PENDING  |
| `CUSTOM_POLICY_EVALUATION`      | BE | 커스텀 정책 평가·적용       | NONE     |
| `DUPLICATE_APPROVED_USER_CHECK` | BE | 승인 사용자 중복 검증       | REJECTED |
| `AML_CHECK`                     | BE | AML·제재명단 검증 (비동기)  | NONE     |
| `FACE_COLLECTION_ADD`           | BE | 승인 얼굴 컬렉션 등록       | NONE     |
| `ADDRESS_COLLECTION`            | BE | 주소지 정보 수집          | NONE     |
| `CREATE_LIVENESS_SESSION`       | FE | 라이브니스 세션 생성        | NONE     |
| `GET_LIVENESS_RESULT`           | FE | 라이브니스 결과 조회        | NONE     |
| `SUBMIT_STEP2`                  | FE | 얼굴 제출 (화면 관측)      | NONE     |
| `STEP2_RESULT`                  | FE | Step2 결과 수신        | NONE     |

## Face Auth (애드온)

| 이벤트                    | 출처 | 의미                    | 사용자 영향 |
| ---------------------- | -- | --------------------- | ------ |
| `GET_FACEAUTH_PRELOAD` | FE | Face Auth 설정·상태 사전 로드 | NONE   |
| `SUBMIT_FACEAUTH`      | FE | Face Auth 본 인증        | NONE   |

## 지식기반 인증 (Knowledge-Base)

| 이벤트                         | 출처 | 의미               | 사용자 영향 |
| --------------------------- | -- | ---------------- | ------ |
| `KB_STAGE1_INIT`            | FE | 지식기반 인증 1단계 초기화  | NONE   |
| `KB_STAGE3_VERIFY_IDENTITY` | FE | 지식기반 신원 검증 (3단계) | NONE   |
| `KB_STAGE4_VERIFY_FACE`     | FE | 지식기반 얼굴 검증 (4단계) | NONE   |

## 최종 결정 · 통보

| 이벤트                       | 출처 | 의미                            | 사용자 영향    |
| ------------------------- | -- | ----------------------------- | --------- |
| `PENDING`                 | BE | ★ 최종 보류 확정 (`reason`으로 사유 구분) | PENDING   |
| `REJECTED`                | BE | ★ 최종 거절 확정 (`reason`으로 사유 구분) | REJECTED  |
| `APPROVED`                | BE | ★ 최종 승인 확정                    | APPROVED  |
| `STEP2_COMPLETED`         | BE | Step2 정상 완료 (메인 종료)           | COMPLETED |
| `KYC_RESULT_WEBHOOK_SENT` | BE | KYC 결과 웹훅 발송                  | NONE      |
| `KYC_RESULT_EMAIL_SENT`   | BE | KYC 결과 이메일 발송                 | NONE      |

## 사후

| 이벤트                 | 출처 | 의미                          | 사용자 영향    |
| ------------------- | -- | --------------------------- | --------- |
| `INJECT_VALIDATION` | FE | 주소 검증 결과 주입 (addveri 별도 진입) | APPROVED  |
| `FINAL_PAGE_VIEW`   | FE | 최종 결과 페이지 진입 (여정 종료)        | COMPLETED |

## 최종 결정 사유

최종 결정 이벤트(`REJECTED`·`PENDING`)의 `reason` 값으로 정확한 사유를 확인합니다.

### 거절(REJECTED) 사유

| reason                   | 단계                        | 의미                       |
| ------------------------ | ------------------------- | ------------------------ |
| `RETRY_EXHAUSTED`        | STEP1 / STEP2 / Pre-STEP2 | 동일 검증 실패가 반복되어 재시도 한도 초과 |
| `AGE_VERIFICATION`       | STEP1 / STEP2             | 연령 검증 실패                 |
| `AGE_LIMIT`              | STEP2                     | 정책 연령 제한 미충족             |
| `BLACKLIST_COUNTRY`      | STEP2                     | 발급국이 차단(블랙리스트) 국가        |
| `INVALID_ACCEPTED_ID`    | STEP2                     | 허용되지 않은 신분증 종류·발급국       |
| `PII_DUPLICATE`          | STEP2                     | 동일 개인정보 중복 제출 (정책 기간 내)  |
| `SELFIE_DUPLICATE`       | STEP2                     | 동일 셀피(얼굴) 중복             |
| `SUPERSEDED_PASSPORT`    | STEP2                     | 폐기·재발급된 여권               |
| `DUPLICATE_USER`         | STEP2                     | 이미 승인된 동일 사용자 중복         |
| `CUSTOM_POLICY`          | STEP2                     | 커스텀 정책에 의한 거절            |
| `AUTOMATIC_VERIFICATION` | STEP2                     | 자동 검증 정책에 의한 거절          |
| `BANK_TRANSFER_LIMIT`    | Pre-STEP2                 | 계좌 송금 빈도 한도 초과           |
| `REGIONAL_VALIDATION`    | STEP1                     | IP 국가와 발급국 불일치           |
| `ID_IMAGE_INVALID`       | 지식기반                      | 신분증 이미지 품질·유효성 미충족       |
| `ID_INFO_MISMATCH`       | 지식기반                      | 신분증 정보 불일치               |
| `FACE_NOT_DETECTED`      | 지식기반                      | 얼굴 미검출                   |
| `LIVENESS_FAIL`          | 지식기반                      | 라이브니스 실패                 |

### 보류(PENDING) 사유

| reason                        | 단계    | 의미                  |
| ----------------------------- | ----- | ------------------- |
| `COUNTRY_MISMATCH`            | STEP2 | 국가 코드 불일치로 수동 검토 보류 |
| `FACE_AGENT_REVIEW`           | STEP2 | 얼굴 수동(상담원) 검토 필요    |
| `ADDRESS_COLLECTION`          | STEP2 | 주소 이미지 추가 수집 필요     |
| `CUSTOM_POLICY`               | STEP2 | 커스텀 정책에 의한 보류       |
| `ARGOS_SCORE_BELOW_THRESHOLD` | STEP2 | ARGOS Score가 임계값 미만 |

<Tip>
  거절·보류 사유와 사용자에게 노출되는 에러 코드·에러 페이지의 매핑은 [에러 코드와 에러 페이지](/ko/idcheck/reference_tables/Error-codes-and-pages) 문서를 함께 참고하세요.
</Tip>