세션 여정 이벤트 레퍼런스

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

표 보는 법

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

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

세션 시작 · 진입

이벤트	출처	의미	사용자 영향
`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가 임계값 미만

거절·보류 사유와 사용자에게 노출되는 에러 코드·에러 페이지의 매핑은 에러 코드와 에러 페이지 문서를 함께 참고하세요.

대시보드 개요

통계

사전 검증 목록

사용자 제출건

세션 여정

AML 데이터

이벤트 로그

애드온

프로젝트 관리

프로필 옵션

산업별 KYC 설정 가이드

세션 여정 이벤트 레퍼런스

표 보는 법

세션 시작 · 진입

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

화면의 API 호출 관측 (FE)

화면 · 환경 관측 (FE)

카메라 · 촬영 (FE)

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

STEP1 — 신분증

Pre-STEP2 (계좌 검증)

STEP2 — 셀피 · 얼굴

Face Auth (애드온)

지식기반 인증 (Knowledge-Base)

최종 결정 · 통보

사후

최종 결정 사유

거절(REJECTED) 사유

보류(PENDING) 사유

​표 보는 법

​세션 시작 · 진입

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

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

​화면 · 환경 관측 (FE)

​카메라 · 촬영 (FE)

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

​STEP1 — 신분증

​Pre-STEP2 (계좌 검증)

​STEP2 — 셀피 · 얼굴

​Face Auth (애드온)

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

​최종 결정 · 통보

​사후

​최종 결정 사유

​거절(REJECTED) 사유

​보류(PENDING) 사유

표 보는 법

세션 시작 · 진입

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

화면의 API 호출 관측 (FE)

화면 · 환경 관측 (FE)

카메라 · 촬영 (FE)

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

STEP1 — 신분증

Pre-STEP2 (계좌 검증)

STEP2 — 셀피 · 얼굴

Face Auth (애드온)

지식기반 인증 (Knowledge-Base)

최종 결정 · 통보

사후

최종 결정 사유

거절(REJECTED) 사유

보류(PENDING) 사유