Skip to main content
This document is a stage-by-stage reference of every event recorded in the session journey. For the concept of the session journey and how to interpret it, see the Session Journey overview first.

How to read the tables

  • SourceFE: an action observed on the user’s screen · BE: a verification or decision executed on the server
  • User impactNONE no impact · BLOCKED blocked · RETAKE recapture / retry · PENDING hold · REJECTED rejected · APPROVED approved · COMPLETED stage completed
The tables are organized by stage, but events within a single stage may run concurrently. Keep in mind that the display order does not necessarily imply causality.

Session start · entry

EventSourceMeaningUser impact
SESSION_CREATEDBENew LiveForm session created, Session ID issuedNONE
SESSION_REUSEDBEExisting in-progress session reused within 20 minutesNONE
FRONT_SESSION_STARTFESession start signal from the screen (paired with SESSION_CREATED)NONE
FRONT_SESSION_RESUMEDFESession resume signal from the screen (paired with SESSION_REUSED)NONE
PROJECT_OPTIONS_FETCHEDBEProject verification options retrievedNONE
NATIONALITY_INFO_LOOKUPBEIP-based country information lookupNONE
FLOW_ID_ISSUEDBEFlow identifier (Flow ID) issuedNONE
LIVEFORM_HASH_CREATEDBEHash created for mid-flow resumptionNONE
CHECKPOINT_HASH_CHECKBEVerification of whether mid-flow resumption is allowedBLOCKED
STEP_VIEWFEGeneral screen entry (which screen is identified by the path)NONE

Pre-checks · blocking (Guard / policy)

EventSourceMeaningUser impact
TOKEN_VALIDATION_CHECKBEPrivate-mode token validity and expiration checkBLOCKED
PRIVATE_TOKEN_USAGE_RECORDEDBEFirst use of a private token recordedNONE
PERIOD_CHECKBEDuplicate-submission policy check for approved/rejected/heldBLOCKED
PACKET_ABUSE_CHECKBEStep1 packet and Flow ID reuse checkBLOCKED
TURNSTILE_TOKEN_CHECKBEBot-protection (Turnstile) token checkBLOCKED
IP_RISK_CHECKBEIP risk and blocklist checkBLOCKED
RATE_LIMIT_CHECKBESubmission frequency limit (Rate Limit) checkBLOCKED
DEVICE_VERIFICATIONFEDevice anti-spoofing verification result (observed on screen)NONE
DEVICE_VALIDATION_RECORDEDBEDevice verification result recordedBLOCKED
FINGERPRINT_CHECKBEDevice fingerprint duplication and device checkBLOCKED
FINGERPRINT_SUBMISSION_LINKEDBEDevice fingerprint verification linked to the submissionBLOCKED

Observing API calls from the screen (FE)

These events record the moment the screen called a specific API. The server-side result of the same action is logged separately in the corresponding BE event (marked with below). If the call itself fails, it is logged as API_ERROR.
EventSourceMeaningUser impact
CREATE_FLOWFEVerification flow creation request (↔ FLOW_ID_ISSUED)NONE
GET_PROJECTFERequest for the full project configurationNONE
QUERY_PROJECT_OPTIONSFERequest for individual project options (↔ PROJECT_OPTIONS_FETCHED)NONE
GET_NATIONALITY_LISTFERequest for the country information list (↔ NATIONALITY_INFO_LOOKUP)NONE
CHECKPOINT_HASHFEMid-flow resumption hash creation/verification request (↔ CHECKPOINT_HASH_CHECK)NONE
HANDLE_LINK_TOKENFEPrivate-mode token handling request (↔ TOKEN_VALIDATION_CHECK)NONE
CHECK_TURNSTILEFEBot-protection (Turnstile) verification request (↔ TURNSTILE_TOKEN_CHECK)NONE
CHECK_IP_RISKFEIP risk verification request (↔ IP_RISK_CHECK)NONE
CHECK_RATE_LIMITFESubmission frequency limit verification request (↔ RATE_LIMIT_CHECK)NONE
CHECK_FINGERPRINT_DUPLICATIONFEDevice fingerprint duplication verification request (↔ FINGERPRINT_CHECK)NONE
POST_DEVICE_VALIDATIONFEDevice verification result transmission (↔ DEVICE_VALIDATION_RECORDED)NONE
CHECK_APPROVEDFEApproval and duplicate-history check requestNONE
SEND_AUXID_SMSFESMS verification code send request (↔ AUXID_PHONE_VERIFICATION_STARTED)NONE
VERIFY_AUXID_SMSFESMS verification code verification request (↔ AUXID_PHONE_VERIFICATION_COMPLETED)NONE
KB_STAGE2_SEND_SMSFEKnowledge-Base verification SMS send requestNONE
KB_STAGE2_VERIFY_SMSFEKnowledge-Base verification SMS verification requestNONE
API_CALLFEGeneral API call not classified into the above itemsNONE

Screen · environment observation (FE)

EventSourceMeaningUser impact
ALERT_SHOWNFENotification popup shownNONE
API_ERRORFEAPI request failure observed on the screenBLOCKED
JS_ERRORFEGlobal JS runtime errorNONE
PAGE_HIDDENFETab switched to the background (drop-off signal)NONE
PAGE_VISIBLEFETab returned to the foregroundNONE
NETWORK_ONLINEFENetwork returned onlineNONE
NETWORK_OFFLINEFENetwork switched offlineNONE
ERROR_PAGE_VIEWEDFEError page entered (forced drop-off point)BLOCKED
WEBSOCKET_CONNECTEDFEResult-receiving WebSocket connected successfullyNONE
WEBSOCKET_DISCONNECTEDFEResult-receiving WebSocket terminated abnormally → fell back to pollingNONE
WEBSOCKET_ERRORFEResult-receiving WebSocket error occurredNONE

Camera · capture (FE)

EventSourceMeaningUser impact
CAMERA_REQUESTEDFECamera permission request startedNONE
CAMERA_ACTIVATEDFECamera stream activatedNONE
CAMERA_PERMISSION_DENIEDFEUser denied camera permission → capture not possibleBLOCKED
CAMERA_ERRORFECamera failed to start for a reason other than permissionBLOCKED
TIP_DIALOG_SHOWNFEID capture tips / recapture guidance shownNONE
ID_DOCUMENT_RETRYFEUser recaptured the ID documentRETAKE
UPLOAD_IMAGEFEID document / face image uploadNONE

Auxiliary authentication (SMS · email · address · account)

EventSourceMeaningUser impact
AUXID_PHONE_VERIFICATION_STARTEDBESMS verification code sentNONE
AUXID_PHONE_VERIFICATION_COMPLETEDBESMS verification code verifiedCOMPLETED
VERIFY_EMAILFEEmail verification code verificationNONE
SEARCH_ADDRESSFEAddress autocomplete lookupNONE
GET_ADDRESS_DETAILFEDetail lookup of the selected addressNONE
VERIFY_ACCOUNTFEAccount verification (1-won transfer, etc.)NONE

STEP1 — ID document

EventSourceMeaningUser impact
STEP1_ENTEREDBEStep1 (ID document) enteredNONE
REGIONAL_VALIDATIONBEConsistency check between IP country ↔ issuing countryBLOCKED
DUPLICATE_SUBMISSION_PERIOD_CHECKBEDuplicate check for the same email/IP within a periodBLOCKED
ID_RECOGNITIONBEID document OCR recognitionRETAKE
ID_LIVENESS_VERIFICATIONBEID document liveness (non-physical) verificationRETAKE
RECOGNITION_SCORE_EVALUATIONBERecognition score threshold evaluationRETAKE
AGE_VERIFICATIONBEAge extraction and verification (common to Step1/Step2)RETAKE
MRZ_VALIDATIONBEPassport MRZ validationRETAKE
BARCODE_VALIDATIONBEPDF417 barcode validationRETAKE
BLACKLIST_COUNTRY_EVALUATIONBEIssuing-country blocklist consistency checkBLOCKED
EXPIRED_ID_CHECKBEID document expiration date checkRETAKE
SUBMISSION_CREATEDBE★ Submission created — the core point of Step1NONE
STEP1_COMPLETEDBEStep1 completed successfully (Step2 entry possible)COMPLETED
SUBMIT_STEP1FEID document submission (observed on screen)NONE
STEP1_RESULTFEStep1 result received (pass / recapture / fail)NONE

Pre-STEP2 (account verification)

EventSourceMeaningUser impact
VALIDATION_ACCOUNT_ENTEREDBEPre-STEP2 stage enteredNONE
TRANSFER_FREQUENCY_LIMIT_CHECKBEDaily transfer limit checkREJECTED
BANK_OCCUPANCY_REQUESTBE1-won occupancy code transfer requestRETAKE
BANK_NAMECHECK_REQUESTBEAccount holder name lookupRETAKE
PRE_STEP2_COMPLETEDBEPre-STEP2 verification passedCOMPLETED

STEP2 — selfie · face

EventSourceMeaningUser impact
STEP2_ENTEREDBEStep2 (selfie) enteredNONE
PII_DUPLICATE_PERIOD_CHECKBEDuplicate check for the same personal information within a periodREJECTED
ACTIVE_LIVENESS_VERIFICATIONBEActive liveness verificationRETAKE
LIVENESS_VERIFICATIONBEPassive liveness verificationRETAKE
FACE_COMPAREBESelfie ↔ ID document face comparisonRETAKE
SELFIE_DUPLICATE_CHECKBESelfie (face) duplication checkREJECTED
CODEF_VERIFICATIONBEKorean government authenticity check (CODEF)RETAKE
MEX_CURP_VERIFICATIONBEMexico CURP verificationRETAKE
BANK_AUTHENTICATIONBE1-won occupancy code verification (Step2)RETAKE
EXPIRY_DATE_OF_STAY_CHECKBEStay expiration date checkRETAKE
COUNTRY_CODE_MATCH_CHECKBEConsistency check across 4 country codesPENDING
CUSTOM_POLICY_EVALUATIONBECustom policy evaluation and applicationNONE
DUPLICATE_APPROVED_USER_CHECKBEDuplicate check for approved usersREJECTED
AML_CHECKBEAML / sanctions-list check (asynchronous)NONE
FACE_COLLECTION_ADDBERegistration into the approved-face collectionNONE
ADDRESS_COLLECTIONBEAddress information collectionNONE
CREATE_LIVENESS_SESSIONFELiveness session creationNONE
GET_LIVENESS_RESULTFELiveness result lookupNONE
SUBMIT_STEP2FEFace submission (observed on screen)NONE
STEP2_RESULTFEStep2 result receivedNONE

Face Auth (add-on)

EventSourceMeaningUser impact
GET_FACEAUTH_PRELOADFEFace Auth configuration / status preloadNONE
SUBMIT_FACEAUTHFEFace Auth main authenticationNONE

Knowledge-Base verification

EventSourceMeaningUser impact
KB_STAGE1_INITFEKnowledge-Base verification stage 1 initializationNONE
KB_STAGE3_VERIFY_IDENTITYFEKnowledge-Base identity verification (stage 3)NONE
KB_STAGE4_VERIFY_FACEFEKnowledge-Base face verification (stage 4)NONE

Final decision · notification

EventSourceMeaningUser impact
PENDINGBE★ Final hold confirmed (reason distinguished by reason)PENDING
REJECTEDBE★ Final rejection confirmed (reason distinguished by reason)REJECTED
APPROVEDBE★ Final approval confirmedAPPROVED
STEP2_COMPLETEDBEStep2 completed successfully (main flow ends)COMPLETED
KYC_RESULT_WEBHOOK_SENTBEKYC result webhook sentNONE
KYC_RESULT_EMAIL_SENTBEKYC result email sentNONE

Post-process

EventSourceMeaningUser impact
INJECT_VALIDATIONFEAddress verification result injected (addveri separate entry)APPROVED
FINAL_PAGE_VIEWFEFinal result page entered (journey ends)COMPLETED

Final decision reasons

Use the reason value of the final decision events (REJECTED · PENDING) to determine the exact reason.

Rejection (REJECTED) reasons

reasonStageMeaning
RETRY_EXHAUSTEDSTEP1 / STEP2 / Pre-STEP2The same verification failed repeatedly, exceeding the retry limit
AGE_VERIFICATIONSTEP1 / STEP2Age verification failed
AGE_LIMITSTEP2Policy age restriction not met
BLACKLIST_COUNTRYSTEP2The issuing country is a blocked (blocklisted) country
INVALID_ACCEPTED_IDSTEP2Disallowed ID document type / issuing country
PII_DUPLICATESTEP2Duplicate submission of the same personal information (within the policy period)
SELFIE_DUPLICATESTEP2Duplicate of the same selfie (face)
SUPERSEDED_PASSPORTSTEP2Voided / reissued passport
DUPLICATE_USERSTEP2Duplicate of an already-approved same user
CUSTOM_POLICYSTEP2Rejection by a custom policy
AUTOMATIC_VERIFICATIONSTEP2Rejection by an automatic verification policy
BANK_TRANSFER_LIMITPre-STEP2Account transfer frequency limit exceeded
REGIONAL_VALIDATIONSTEP1Mismatch between IP country and issuing country
ID_IMAGE_INVALIDKnowledge-BaseID document image quality / validity not met
ID_INFO_MISMATCHKnowledge-BaseID document information mismatch
FACE_NOT_DETECTEDKnowledge-BaseFace not detected
LIVENESS_FAILKnowledge-BaseLiveness failed

Hold (PENDING) reasons

reasonStageMeaning
COUNTRY_MISMATCHSTEP2Held for manual review due to a country code mismatch
FACE_AGENT_REVIEWSTEP2Manual (agent) face review required
ADDRESS_COLLECTIONSTEP2Additional address image collection required
CUSTOM_POLICYSTEP2Hold by a custom policy
ARGOS_SCORE_BELOW_THRESHOLDSTEP2ARGOS Score below the threshold
For the mapping between rejection/hold reasons and the error codes / error pages shown to the user, also see the Error codes and pages document.