에러 코드와 에러 페이지

개요

이 문서는 라이브폼 모바일 여정에서 노출되는 에러 페이지를 유형별로 분류해 에러 코드, URL 경로, 사용자 메시지를 제공합니다. 최종 사용자가 만나는 에러 메시지에 대해 실제 라우팅 경로와 발생 조건을 정확하게 확인하고 업무나 고객 지원에 활용할 수 있습니다.

모든 에러 페이지는 다음의 4 유형으로 구분됩니다.

/error-page/:errorType
/error-page/token-*
/face-retry/:faceErrorCode
Error Boundary

에러 코드 카테고리 체계

에러 코드 형식: 접두사-숫자 (예: NF-10000). 숫자 자릿수는 카테고리마다 다릅니다.

카테고리	접두사	풀네임	번호 대역	의미
General	개발자 코드	Legacy	—	각 오류 유형별로 개발자 코드에 정의
Not Found	`NF`	Not Found	10000번대	존재하지 않는 경로로 직접 접근
Quality Score	`QS`	Quality Score	10000~30000	IP 조회 시 발생한 에러 케이스
Queueing Error	`QE`	Queueing Error	20000번대	엔진 대기열 과부하 관련 에러
Error Reference	`ER`	Error Reference	001번대	Rate limit·lockout 등 API·상수와 매핑되는 식별 코드
Parameter Validation	`PV`	Parameter Validation	40000번대	쿼리스트링 파라미터 누락 / 잘못된 값 / 옵션 충돌
Server Error	`SE`	Server Error	50000번대	API 호출 실패 또는 서버 에러
Runtime	`RT`	Runtime Error	60000번대	프론트엔드 런타임 에러 (React ErrorBoundary, try/catch 예외)
Token	`TK`	Token	10000번대	토큰 검증 실패 (누락·만료·승인·검토·거부)
Device Error	`DE`	Device Error	20000~52030	Device Info 사전 검증(진입) 단계 차단(Static check · Fingerprint · Duplicate) 및 신분증·셀피 촬영 단계 지점 간 검증 차단
Loop Error	`LO`	Loop Error	30000번대	신분증 촬영·단계 재시도 루프에서 오류 3회 누적 시 전용 페이지로 이동
Turnstile	`TS`	Turnstile	Cloudflare 원본 번호	봇·자동화 차단(Cloudflare Turnstile) 챌린지 실패

에러와 검증 실패 구분

모든 화면이 ‘에러 페이지’로 보이지만, 발생 원인은 크게 세 가지로 나뉩니다. 아래 구분은 고객 지원·모니터링 시 ‘실제 장애’와 ‘정상 거절/설정 문제’를 빠르게 판별하는 데 사용합니다.

🔧 시스템 오류 (System Error)

ARGOS · 엔진 · 3rd party 측의 일시적 장애. 잠시 후 재시도하면 해결되는 경우가 대부분입니다.

SE-50000~SE-50015 (프로젝트 로드 · 토큰 확인 · 검증 API · 얼굴 인증 초기화 등 서버 오류)
SE-50020~~SE-50022 · SE-50030~~SE-50033 (라이브니스 · 얼굴 비교 · 정부 진위확인 엔진 서버 오류)
RT-60000 · RT-60001 (프론트엔드 런타임 예외)
QE-20000 (엔진 대기열 과부하)
QS-30000 (IP 체커 시스템 오류)
DE-30001 · DE-30002 · DE-30003 (기기 인증 초기화 · 응답 · 네트워크 오류)
LO-30001 · LO-30002 · LO-30004 · LO-99999 (OCR · 데이터 처리 · requestId 누락 · 알 수 없는 루프 오류)

🚫 검증 실패 · 차단 (Verification Rejected / Blocked)

제출 정보·행동·리스크를 기준으로 한 정상 판정. ARGOS가 의도대로 동작한 결과이며 장애가 아닙니다.

위조 의심 (suspected-forgery), 얼굴 중복 (face_validation_error), 비정상 행동 (abnormal_action)
IP 리스크 (ipRisk_failCategory · distanceChecks_ipGeo · blackliskCountries · ipRisk_durationHours)
QS-10000 · QS-20000 (비정상 검증 거부 · 즉시 거부)
DE-20000 · DE-30000 · DE-40000 (기기 환경 차단 · 핑거프린트 이상 · 기기 중복)
TS-300*** · TS-600*** (Turnstile 챌린지 실패 — 봇·자동화 의심)
제출·IP·이메일 상태 중복 (already_* · processed_* · ip_already_* · email_already_rejected)
토큰 상태 (TK-10002 · TK-10003 · TK-10004 — 이미 승인·검토 중·거부)
이미지 품질 미달 (LO-30005), 얼굴 재촬영 (face-retry)
요청 한도·잠금 (ER-001 · ER-002 · rate_limit_exceeded · locked_out · traffic_overload)

⚙️ 요청 · 환경 · 설정 오류 (Request / Environment / Configuration)

고객사의 링크·파라미터·프로젝트 설정 문제이거나, 사용자 기기·브라우저·접근 방식 문제. 해당 설정/환경을 바로잡아야 해결됩니다.

파라미터·옵션 오류 (PV-40000~PV-40018)
경로 오류 (NF-10000 · NF-10001 · bad-path · page-not-found)
암호화 전용 접근 (encrypted_only)
미지원 브라우저·기기 (invalid-browser = RT-60002)
Turnstile 환경 문제 (TS-110500 · TS-110510 · TS-11060* · TS-11062* · TS-200010 · TS-200100)
프로젝트 상태 (project-closed · period · submission-number-limit · service-blocked)
토큰 누락·만료 (TK-10000 · TK-10001)
필수 파라미터 누락 (LO-30003)
세션 꼬임 (refresh · hash_problem)
업로드 권한 차단 (not-allow-file-upload)

일부 코드는 상황에 따라 분류가 달라질 수 있습니다. 위 구분은 1차 트리아지 기준이며, 정확한 발생 조건은 아래 각 표의 ‘발생 상황’ 열을 확인하세요.

일반 에러 페이지 (`/error-page/:errorType`)

🔒 인증·권한 오류

유형	개발자 코드	URL	사용자 메시지	발생 상황
페이지 없음	`page-not-found`	`/error-page/page-not-found`	”페이지를 찾을 수 없습니다”	존재하지 않는 URL을 직접 입력하거나 만료된 즐겨찾기 링크를 열었을 때 나타납니다.
서비스 차단	`service-blocked`	`/error-page/service-blocked`	”제출이 일시 중단 되었습니다”	운영자가 제출을 잠시 막아둔 시간대에 사용자가 계속 접속할 때 안내됩니다.
유효하지 않은 경로	`bad-path`	`/error-page/bad-path`	”잘못된 URL 경로”	공유받은 링크를 임의로 수정하거나 허용되지 않은 경로로 이동했을 때 발생합니다.
새로고침 감지	`refresh`	`/error-page/refresh`	”새로고침 감지”	진행 중 새로고침·뒤로가기를 눌러 세션이 끊기면 처음부터 다시 시작하도록 표시됩니다.
미지원 브라우저	`invalid-browser`	`/error-page/invalid-browser`	”지원하지 않는 브라우저”	구형 브라우저나 WebAssembly를 지원하지 않는 환경에서 접속하면 최신 브라우저로 변경해야 합니다. (에러 코드 `RT-60002`)
해시 검증 실패	`hash_problem`	`/error-page/hash_problem`	”해시 검증 문제”	여러 탭을 열거나 단계를 건너뛰어 데이터가 꼬였을 때 처음 단계로 돌아가야 합니다.
암호화 전용 모드	`encrypted_only`	`/error-page/encrypted_only`	”암호화되지 않은 접근”	`option_encryptedOnly=true`인 프로젝트에서 암호화되지 않은 쿼리스트링으로 접근하거나 `pid`, `lang`, `encrypted` 외 허용되지 않은 파라미터가 포함된 경우 발생합니다.

📅 프로젝트 상태 오류

유형	개발자 코드	URL	사용자 메시지	발생 상황
프로젝트 종료	`project-closed`	`/error-page/project-closed`	”현재 프로젝트는 종료되어 접근이 제한되었습니다”	이미 종료된 캠페인 링크를 다시 열면 더 이상 진행할 수 없다는 메시지가 표시됩니다.
기간 만료	`period`	`/error-page/period`	”프로젝트 기간 만료”	제출 가능 기간이 끝난 뒤 늦게 접속하면 기간이 지났다는 안내가 나옵니다.
제출 횟수 제한	`submission-number-limit`	`/error-page/submission-number-limit`	”제출건이 15개를 초과하였습니다”	체험용(trial) 프로젝트에서 허용 횟수(15회)를 넘겨 계속 제출하면 제한 안내와 함께 중단됩니다.

📤 제출 상태 오류

유형	개발자 코드	URL	사용자 메시지	발생 상황
이미 승인됨	`already_approved`	`/error-page/already_approved`	”이미 검증 완료된 모바일입니다”	같은 기기·브라우저에서 이미 승인받았는데 다시 시도하면 남은 대기 시간과 함께 차단됩니다.
이미 거부됨	`already_rejected`	`/error-page/already_rejected`	”이미 거부된 제출”	거부된 뒤 대기 시간이 끝나기 전에 재시도하면 기다리라는 메시지가 나타납니다.
승인 대기 중	`already_pending`	`/error-page/already_pending`	”현재 검토 중입니다”	이전 제출이 아직 심사 중인데 추가 제출을 시도할 때 더 이상 진행하지 못합니다.
처리 완료(승인)	`processed_submission-approved`	`/error-page/processed_submission-approved`	”이미 처리된 제출 (승인됨)“	승인된 결과 화면을 다시 열어도 추가 조치가 필요 없다고 안내합니다.
처리 완료(거부)	`processed_submission-rejected`	`/error-page/processed_submission-rejected`	”검증이 거부되었습니다”	거부된 제출을 동일하게 다시 열면 잔여 대기 시간과 함께 재시도 시점을 알려 줍니다.
IP 승인 이력	`ip_already_approved`	`/error-page/ip_already_approved`	”해당 IP로 이미 승인됨”	같은 네트워크(IP)에서 이미 완료된 검증이 있을 때 다른 사람이 다시 시도하면 제한됩니다.
IP 거부 이력	`ip_already_rejected`	`/error-page/ip_already_rejected`	”해당 IP로 이미 거부됨”	동일 IP로 여러 번 실패하거나 거부된 상태에서 다시 접속하면 다른 네트워크를 사용하라는 안내가 나옵니다.

📧 이메일 관련 오류

유형	개발자 코드	URL	사용자 메시지	발생 상황
이메일 거부 이력	`email_already_rejected`	`/error-page/email_already_rejected`	”검증이 거부되었습니다 / 해당 이메일로 이미 거부됨”	이미 거부된 이메일 주소로 다시 제출하면 대기 시간과 함께 재시도 불가 안내가 표시됩니다.

🛡️ 보안·사기 탐지 오류

유형	개발자 코드	URL	사용자 메시지	발생 상황
위조 의심	`suspected-forgery`	`/error-page/suspected-forgery`	”위조 의심 감지”	촬영한 신분증이 흐릿하거나 조작 흔적이 있어 진품으로 확인되지 않을 때 다시 촬영해야 합니다.
파일 업로드 불가	`not-allow-file-upload`	`/error-page/not-allow-file-upload`	”파일 업로드가 허용되지 않습니다”	시크릿 모드나 보안 브라우저처럼 카메라·파일 권한이 막힌 환경에서 업로드를 시도하면 권한을 허용하거나 다른 기기를 사용해야 합니다.
얼굴 중복 감지	`face_validation_error`	`/error-page/face_validation_error`	”중복된 얼굴이 탐지되었습니다”	이전 제출과 동일한 얼굴이 감지되어 한 사람이 여러 번 시도하는 것으로 판단될 때 고객 지원 안내가 뜹니다.
비정상 행동	`abnormal_action`	`/error-page/abnormal_action`	”비정상적인 행동이 감지되었습니다”	캡처 화면 업로드, 과도한 색상 보정, 동일 셀카 복사 등 비정상 촬영 방식이 감지되면 정상적인 절차로 다시 진행해야 합니다.

🌍 IP 리스크 오류

유형	개발자 코드	URL	사용자 메시지	발생 상황
카테고리 실패	`ipRisk_failCategory`	`/error-page/ipRisk_failCategory`	”IP 리스크 카테고리 실패”	VPN, Tor, 데이터센터 등 고위험 네트워크에서 접속하면 다른 네트워크로 전환해야 합니다.
거리 검증 실패	`distanceChecks_ipGeo`	`/error-page/distanceChecks_ipGeo`	”IP 위치 거리 체크 실패”	GPS 위치와 IP 위치가 멀리 떨어져 있을 때(예: 국내 GPS + 해외 VPN) VPN을 끄고 실제 위치에서 접속해야 합니다.
블랙리스트 국가	`blackliskCountries`	`/error-page/blackliskCountries`	”블랙리스트 국가”	차단된 국가에서 접속하면 해당 국가에서는 서비스를 이용할 수 없다는 안내가 표시됩니다.
시간 제한	`ipRisk_durationHours`	`/error-page/ipRisk_durationHours`	”IP 리스크 기간 제한”	위험한 네트워크에서 반복 시도해 IP가 일정 시간 잠기면 남은 시간이 끝난 뒤에만 재시도할 수 있습니다.

⏱️ Rate Limit · Lockout

유형	개발자 코드	URL	사용자 메시지	발생 상황
요청 횟수 초과	`rate_limit_exceeded`	`/error-page/rate_limit_exceeded`	”요청 횟수 제한 초과”	짧은 시간에 반복으로 새로고침하거나 제출해 요청 한도를 넘기면 잠시 대기해야 합니다.
계정 잠금	`locked_out`	`/error-page/locked_out`	”계정 잠김”	여러 차례 실패나 의심되는 활동으로 계정이 잠기면 표시된 시간이 지나야 자동 해제됩니다.
트래픽 과부하	`traffic_overload`	`/error-page/traffic_overload`	”트래픽 과부하”	제출 상태 폴링 시도가 32회를 초과하면 서버 부하 상태로 판단되어 잠시 후 다시 시도하도록 안내됩니다.

ER — Rate limit · Lockout

아래 코드는 Rate limit·lockout과 연관된 API·상수 식별자(RATE_LIMIT_EXCEEDED, LOCKED_OUT)와 동일한 화면으로 연결됩니다. 위 Rate Limit · Lockout 표의 rate_limit_exceeded, locked_out 개발자 코드와 대응합니다.

에러 코드	식별자	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`ER-001`	`RATE_LIMIT_EXCEEDED`	`/error-page/rate_limit_exceeded`	”요청 횟수 제한 초과"	"Request limit exceeded”	짧은 시간에 반복으로 새로고침하거나 제출해 요청 한도를 넘기면 잠시 대기해야 합니다.
`ER-002`	`LOCKED_OUT`	`/error-page/locked_out`	”계정 잠김"	"Account locked”	여러 차례 실패나 의심되는 활동으로 계정이 잠기면 표시된 시간이 지나야 자동 해제됩니다.

📍 NF — Not Found

경로를 찾을 수 없을 때 발생하는 에러 코드입니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`NF-10000`	`/error-page/not-found`	”페이지를 찾을 수 없습니다” 요청하신 페이지가 존재하지 않습니다. URL을 다시 확인해 주세요.	”Page not found” The page you requested does not exist. Please check the URL and try again.	라우터에 정의되지 않은 경로로 직접 접근했을 때 발생합니다. Mobile/PC 모두 와일드카드(`*`)에 걸려 이 페이지로 이동합니다.
`NF-10001`	`/error-page/invalid-path`	”잘못된 접근 경로입니다” 허용되지 않은 경로로 접근하셨습니다. 올바른 URL로 다시 시도해 주세요.	”Invalid access path” You accessed an unauthorized path. Please try again with the correct URL.	URL 경로 자체는 존재하지만 허용된 초기 진입 경로 목록(`VALID_INITIAL_PATH`)에 없는 경로로 접근한 경우 발생합니다.

⚠️ QS — Quality Score

IP 조회 시 발생하는 에러 코드입니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`QS-10000`	`/error-page/abnormal_verification_denied`	”비정상 검증 거부” 짧은 시간에 위험 행동을 반복해 신뢰 점수가 낮아졌습니다. 안내된 시간이 지날 때까지 기다려야 합니다.	”Abnormal verification denied” Rapid risky attempts lowered the trust score. You must wait for the displayed timer to expire.	IP 체커에서 48시간 대기 판정이 내려졌을 때 발생합니다.
`QS-20000`	`/error-page/abnormal_rejected`	”비정상 거부” 심각한 이상 징후가 확인되어 즉시 거부되었습니다. 보안 이슈를 해소한 후에만 재시도할 수 있습니다.	”Abnormal rejection” Severe anomalies triggered an immediate rejection. Security issues must be resolved before retrying.	IP 체커에서 fraud score 90점 이상으로 판정되었을 때 발생합니다.
`QS-30000`	`/error-page/ipqs_system_error`	”IPQS 시스템 에러” IP 조회가 시스템 오류로 인하여 실패했습니다. 잠시 후 다시 시도해 주세요.	”IPQS system error” The IP lookup failed due to a system error. Please try again later.	IP 체커에서 클라이언트/서버 오류가 발생했을 때 나타납니다.

📦 QE — Queueing Error

엔진 대기열 과부하 시 발생하는 에러 코드입니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`QE-20000`	`/error-page/queueing-timeout`	”대기열 과부하” 일시적인 트래픽 급증과 대기열 과부하로 제출을 처리하지 못했습니다. 잠시 후 다시 시도해 주세요.	”Queue overload” We couldn’t process your submission due to unusually high traffic and an overloaded queue. Please try again in a moment.	엔진 사용 대기열 과부하로 인하여 현재 유저의 데이터를 서버에서 처리할 수 없는 경우 발생합니다.

🔧 PV — Parameter Validation

쿼리스트링 파라미터 누락, 잘못된 값, 옵션 충돌 시 발생하는 에러 코드입니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`PV-40000`	`/error-page/missing-pid`	”필수 파라미터가 누락되었습니다” 프로젝트 ID(pid)가 URL에 포함되지 않았습니다. 올바른 링크를 통해 다시 접근해 주세요.	”Required parameter is missing” The project ID (pid) is not included in the URL. Please access again via the correct link.	URL 쿼리스트링에 `pid` 파라미터가 없는 경우 발생합니다. `pid`는 프로젝트 식별자로 모든 요청에 필수입니다.
`PV-40001`	`/error-page/invalid-action`	”유효하지 않은 요청입니다” action 파라미터 값이 올바르지 않거나 필수 파라미터가 누락되었습니다.	”Invalid request” The action parameter value is invalid or required parameters are missing.	`action` 파라미터가 허용된 값(`addveri`)이 아니거나, `action=addveri`임에도 `pid` 또는 `sid`가 함께 없는 경우 발생합니다.
`PV-40002`	`/error-page/invalid-distance-option`	”옵션 설정이 올바르지 않습니다” 거리 검사 옵션 값이 유효하지 않습니다. 설정을 확인하고 다시 시도해 주세요.	”Option configuration is invalid” The distance check option value is invalid. Please check the settings and try again.	`distanceCheckSource` 옵션은 전달됐으나 함께 필요한 `distanceMaxDistanceKm` 값이 숫자 형식이 아닌 경우 발생합니다.
`PV-40003`	`/error-page/invalid-iprisk-option`	”옵션 설정이 올바르지 않습니다” IP 리스크 옵션 값이 유효하지 않습니다. 설정을 확인하고 다시 시도해 주세요.	”Option configuration is invalid” The IP risk option value is invalid. Please check the settings and try again.	`ipRiskCategory` 옵션은 전달됐으나 함께 필요한 `ipRiskDurationHours` 값이 숫자 형식이 아닌 경우 발생합니다.
`PV-40004`	`/error-page/conflicting-projection`	”파라미터 설정이 충돌합니다” projectionName과 projectionId는 동시에 사용할 수 없습니다. 둘 중 하나만 설정해 주세요.	”Parameter configuration conflict” projectionName and projectionId cannot be used at the same time. Please configure only one of them.	`projectionName`과 `projectionId`를 동시에 사용한 경우 발생합니다. 둘 중 하나만 허용됩니다.
`PV-40010`	`/error-page/blacklisted-country`	”서비스를 이용할 수 없는 국가입니다” 선택하신 국가에서는 본인 인증 서비스를 제공하지 않습니다.	”Service is unavailable in this country” Identity verification service is not available in the selected country.	`selectedIssuingCountry`로 지정된 국가가 블랙리스트 국가인 경우 발생합니다.
`PV-40011`	`/error-page/blacklisted-allowed-country`	”허용 국가 설정이 올바르지 않습니다” 허용 국가 목록에 서비스가 제한된 국가가 포함되어 있습니다. 설정을 확인하고 다시 시도해 주세요.	”Allowed country configuration is invalid” The allowed country list includes a country with restricted service. Please check the settings and try again.	`allowedCountries` 목록 안에 블랙리스트 국가가 하나 이상 포함된 경우 발생합니다.
`PV-40012`	`/error-page/conflicting-universal-idtype`	”신분증 옵션 설정이 충돌합니다” 전체 허용 모드(universal)와 특정 신분증 지정(selectedIdType)은 함께 사용할 수 없습니다. 설정을 확인하고 다시 시도해 주세요.	”ID type option configuration conflict” Universal mode and specific ID type selection (selectedIdType) cannot be used together. Please check the settings and try again.	`option_universal=true`로 전체 신분증 허용 모드인데 `selectedIdType`으로 특정 신분증을 동시에 지정한 경우 발생합니다.
`PV-40013`	`/error-page/missing-issuing-country`	”발급 국가 정보가 누락되었습니다” 신분증 종류를 지정하려면 발급 국가도 함께 설정해야 합니다. 설정을 확인하고 다시 시도해 주세요.	”Issuing country information is missing” To specify an ID type, the issuing country must also be configured. Please check the settings and try again.	`selectedIdType`(신분증 종류)은 있으나 필수 선행 조건인 `selectedIssuingCountry`(발급 국가)가 없는 경우 발생합니다.
`PV-40014`	`/error-page/conflicting-knowledge-idtype`	”인증 방식 설정이 충돌합니다” 지식 기반 인증(knowledge) 모드에서는 신분증 종류를 별도로 지정할 수 없습니다. 설정을 확인하고 다시 시도해 주세요.	”Authentication method configuration conflict” In knowledge-based authentication mode, the ID type cannot be specified separately. Please check the settings and try again.	`authType=knowledge`(지식 기반 인증) 모드인데 `selectedIdType`(신분증 종류)도 함께 지정한 경우 발생합니다.
`PV-40015`	`/error-page/missing-faceauth-pid`	”인증 정보가 누락되었습니다” 얼굴 인증에 필요한 필수 파라미터(pid 또는 sid)가 없습니다. 올바른 링크를 통해 다시 접근해 주세요.	”Authentication information is missing” Required parameters (pid or sid) for face authentication are missing. Please access again via the correct link.	`faceAuth`(얼굴 인증) 진입 시 `pid` 또는 `sid` 중 하나라도 없는 경우 발생합니다.
`PV-40016`	`/error-page/conflicting-knowledge-skip`	”검증 옵션 설정이 충돌합니다” 지식 검증 건너뜀(skip)과 얼굴 비교 비활성화는 함께 사용할 수 없습니다. 설정을 확인하고 다시 시도해 주세요.	”Validation option configuration conflict” Skipping knowledge validation and disabling face comparison cannot be used together. Please check the settings and try again.	`knowledgeField=skip`(지식 검증 건너뜀)으로 설정했는데 `option_validationFaceCompare=false`도 함께 설정한 경우 발생합니다.
`PV-40017`	`/error-page/conflicting-knowledge-field`	”지식 검증 필드 설정이 충돌합니다” knowledgeField의 skip 옵션은 다른 필드와 함께 사용할 수 없습니다. skip은 단독으로만 설정해 주세요.	”Knowledge validation field configuration conflict” The skip option in knowledgeField cannot be used with other fields. Please set skip as a standalone option.	`knowledgeField`에 `skip`과 다른 필드 옵션을 동시에 선언한 경우 발생합니다. `skip`은 단독으로만 사용 가능합니다.
`PV-40018`	`/error-page/expired-start-valid-until`	”검증 링크가 만료되었습니다” 인증 시작 전에 만료되었거나 `startValidUntil` 시각이 이미 지난 후 접근하셨습니다. 새로운 링크를 발급받아 다시 시도해 주세요.	”The verification link has expired” The verification link has expired. Please try again with a new link.	쿼리스트링 `startValidUntil` 로 지정한 시각(UTC+0)이 이미 지난 상태에서 인증을 시작하려 한 경우 발생합니다. 토큰 ID 검증보다 우선 적용됩니다.

🖥️ SE — Server Error

API 호출 실패 또는 서버 에러 시 발생하는 에러 코드입니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`SE-50000`	`/error-page/project-load-error`	”프로젝트 정보를 불러올 수 없습니다” 서버에서 프로젝트 설정을 가져오는 중 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Unable to load project information” An error occurred while fetching project settings from the server. Please try again later.	앱 초기 진입 시 프로젝트 설정을 가져오는 `projectOptions` API 호출 자체가 실패한 경우 발생합니다.
`SE-50001`	`/error-page/token-check-error`	”토큰 확인 중 오류가 발생했습니다” 서버와의 통신 중 문제가 발생했습니다. 잠시 후 다시 시도해 주세요.	”An error occurred while verifying the token” A problem occurred while communicating with the server. Please try again later.	토큰 유효성을 검증하는 `checkingToken` API 호출 중 예외가 발생한 경우입니다.
`SE-50002`	`/error-page/validation-api-error`	”검증 서비스 오류가 발생했습니다” 주소 검증 중 서버 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Validation service error” A server error occurred during address validation. Please try again later.	주소 검증 API(`/live/internal/validation`) 호출 결과 에러 응답이 온 경우 발생합니다.
`SE-50010`	`/error-page/faceauth-preload-error`	”얼굴 인증 초기화에 실패했습니다” 얼굴 인증 준비 중 서버 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Face authentication initialization failed” A server error occurred while preparing face authentication. Please try again later.	`faceAuth` 진입 전 사전 데이터를 로드하는 첫 번째 API 쿼리가 실패한 경우 발생합니다.
`SE-50011`	`/error-page/faceauth-preload-error-2`	”얼굴 인증 초기화에 실패했습니다” 얼굴 인증 추가 데이터 로드 중 서버 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Face authentication initialization failed” A server error occurred while loading additional face authentication data. Please try again later.	`faceAuth` 진입 전 사전 데이터를 로드하는 두 번째 API 쿼리가 실패한 경우 발생합니다.
`SE-50012`	`/error-page/faceauth-submission-error`	”얼굴 인증 상태 확인에 실패했습니다” 인증 제출 상태를 확인하는 중 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Failed to verify face authentication status” An error occurred while checking the authentication submission status. Please try again later.	`faceAuth`에서 `checkSubmission` API는 응답했으나 `result` 값이 유효하지 않은(falsy) 경우 발생합니다.
`SE-50013`	`/error-page/faceauth-token-error`	”얼굴 인증 토큰 처리에 실패했습니다” 인증 토큰을 등록하는 중 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Face authentication token processing failed” An error occurred while registering the authentication token. Please try again later.	`faceAuth`에서 `insertToken` API 호출 중 예외가 발생한 경우입니다.
`SE-50014`	`/error-page/faceauth-project-error`	”얼굴 인증 프로젝트 정보를 불러올 수 없습니다” 서버에서 프로젝트 데이터를 가져오는 중 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.	”Unable to load face authentication project information” An error occurred while fetching project data from the server. Please try again later.	`faceAuth` 프로젝트 데이터를 조회하는 API 호출이 실패한 경우 발생합니다.
`SE-50015`	`/error-page/validation-code-error`	”검증에 실패했습니다” 주소 검증 결과 오류 코드가 반환되었습니다. 입력 정보를 확인하고 다시 시도해 주세요.	”Validation failed” An error code was returned from address validation. Please check your information and try again.	주소 검증 API 응답에 `errorCode` 필드가 포함된 경우 발생합니다. API는 응답했으나 검증 자체가 실패한 상태입니다.
`SE-50020`	`/error-page/id-liveness-server-error`	”신분증 라이브니스 인증에 실패했습니다” 잠시 후 다시 시도해 주세요.	”ID liveness verification failed” Please try again later.	신분증(ID) Liveness 엔진 처리가 연속 실패한 경우. 무한 재시도 대신 전용 에러 페이지로 이동합니다.
`SE-50021`	`/error-page/passive-liveness-error`	”패시브 라이브니스 인증에 실패했습니다” 잠시 후 다시 시도해 주세요.	”Passive liveness verification failed” Please try again later.	Passive(셀피) Liveness 엔진 처리가 연속 실패한 경우.
`SE-50022`	`/error-page/face-compare-error`	”얼굴 비교 인증에 실패했습니다” 잠시 후 다시 시도해 주세요.	”Face comparison verification failed” Please try again later.	Face Compare 엔진 처리가 연속 실패한 경우.
`SE-50030`	`/error-page/verify-kor-government-id-error`	”주민등록증 진위확인에 일시적으로 실패했습니다” 잠시 후 다시 시도해 주세요.	”Korean national ID verification temporarily failed” Please try again later.	한국 진위확인(주민등록증) 서버 처리 실패.
`SE-50031`	`/error-page/verify-kor-driver-license-error`	”운전면허증 진위확인에 일시적으로 실패했습니다” 잠시 후 다시 시도해 주세요.	”Korean driver’s license verification temporarily failed” Please try again later.	한국 진위확인(운전면허증) 서버 처리 실패.
`SE-50032`	`/error-page/verify-kor-passport-error`	”여권 진위확인에 일시적으로 실패했습니다” 잠시 후 다시 시도해 주세요.	”Korean passport verification temporarily failed” Please try again later.	한국 진위확인(여권) 서버 처리 실패.
`SE-50033`	`/error-page/verify-kor-residence-permit-error`	”외국인등록증 진위확인에 일시적으로 실패했습니다” 잠시 후 다시 시도해 주세요.	”Korean residence permit verification temporarily failed” Please try again later.	한국 진위확인(외국인등록증) 서버 처리 실패.

위 엔진 오류 중 신분증 라이브니스(SE-50020) · 셀피 Passive 라이브니스(SE-50021) · 한국 정부 진위확인(SE-50030~50033) 은 대시보드 설정에서 Error 대신 Warning 으로 처리하도록 지정할 수 있습니다. Warning 처리 시 에러 페이지로 이동하지 않고 후속 KYC 프로세스를 이어가며, 해당 Warning 은 Custom Policy 트리거로 활용할 수 있습니다. (얼굴 비교(SE-50022)는 Error 전용입니다.) Warning 으로 전환된 경우의 WarningOccurred 값과 warning[] 필드 매핑은 Warning 코드와 필드 문서를 참고하세요.

🔁 LO — Loop Error (`/error-page/loop/:params`)

신분증 촬영 및 단계별 처리 중 같은 오류가 3회 누적되면, 무한 재시도를 방지하기 위해 전용 루프 에러 페이지로 이동합니다(replace). 3회 미만에서는 재촬영 안내 또는 알림으로 처리됩니다. URL 의 params 값에 따라 아래로 매핑되며, 매핑되지 않은 경우 Fallback 페이지로 이동합니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`LO-30001`	`/error-page/loop/ocr_fail`	”신분증을 인식하지 못했습니다” 다시 촬영해 주세요.	”Unable to recognize the ID” Please retake the photo.	OCR 엔진이 신분증을 인식하지 못했거나 OCR 서버 오류가 발생한 경우.
`LO-30002`	`/error-page/loop/data_processing_error`	”데이터 처리 중 오류가 발생했습니다” 잠시 후 다시 시도해 주세요.	”An error occurred during data processing” Please try again later.	데이터 처리 중 오류가 발생한 경우.
`LO-30003`	`/error-page/loop/missing_parameters`	”필수 정보가 누락되었습니다” 처음부터 다시 시도해 주세요.	”Required information is missing” Please start over.	필수 파라미터가 누락된 경우.
`LO-30004`	`/error-page/loop/missing_requestId`	”요청 정보를 확인할 수 없습니다” 처음부터 다시 시도해 주세요.	”Unable to verify request information” Please start over.	requestId 가 누락된 경우.
`LO-30005`	`/error-page/loop/image_quality_low`	”신분증 이미지 품질이 낮습니다” 더 선명하게 다시 촬영해 주세요.	”ID image quality is too low” Please retake the photo more clearly.	신분증 이미지 품질(밝기·선명도) 기준 미달이 누적된 경우.
`LO-99999`	`/error-page/loop/*` (Fallback)	“알 수 없는 오류가 발생했습니다” 처음부터 다시 시도해 주세요.	”An unknown error occurred” Please start over.	위 항목에 매핑되지 않은 루프 오류(UnknownLoopError). 내부 모니터링용으로 오류 유형이 함께 기록됩니다.

⚡ RT — Runtime Error

프론트엔드 런타임 에러 시 발생하는 에러 코드입니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`RT-60000`	`/error-page/runtime-error`	”오류가 발생했습니다” 예기치 않은 오류가 발생했습니다. 페이지를 새로고침하거나 처음부터 다시 시도해 주세요.	”An error occurred” An unexpected error occurred. Please refresh the page or start over.	`/qr`, `/knowledge-qr`, `/face-auth-qr` 라우트에서 React ErrorBoundary가 발동한 경우 발생합니다.
`RT-60001`	`/error-page/token-runtime-error`	”토큰 처리 중 오류가 발생했습니다” 예기치 않은 오류가 발생했습니다. 페이지를 새로고침하거나 처음부터 다시 시도해 주세요.	”An error occurred during token processing” An unexpected error occurred. Please refresh the page or start over.	`useTokenCheck` 훅 내부 try/catch에서 예외가 포착된 경우 발생합니다. 토큰 처리 중 예상치 못한 런타임 오류입니다.
`RT-60002`	`/error-page/invalid-browser`	”지원하지 않는 브라우저입니다” 최신 브라우저로 다시 시도해 주세요.	”Unsupported browser” Please try again with a modern browser.	구형 브라우저, WebAssembly 미지원 환경, 또는 Android OS 9 미만 기기 등 미지원 환경에서 접속한 경우. 권장 환경은 추천 브라우저/기기 가이드를 참고하세요.

📱 DE — Device Error

Device Info 사전 검증(진입) 단계와 신분증·셀피 촬영 단계에서 차단된 경우 발생하는 에러 코드입니다. 오류 페이지에는 에러 코드와 정의가 함께 표시되어 고객사가 차단 사유를 즉시 식별할 수 있습니다.

에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
`DE-20000`	`/error-page/abnormal_device`	”지원되지 않는 기기 환경입니다” 현재 기기 또는 브라우저 환경에서는 인증을 진행할 수 없습니다. 다른 기기나 브라우저에서 다시 시도해 주세요.	”Unsupported device environment” Verification cannot be performed on the current device or browser. Please try again on a different device or browser.	abnormalDevice. 모바일 기기/브라우저 환경 문제로 KYC 진행이 차단된 경우.
`DE-30000`	`/error-page/device-fingerprint`	”비정상 기기가 감지되었습니다” 기기 이상 징후(VM, 에뮬레이터, 봇, 변조 등)가 감지되어 인증을 진행할 수 없습니다.	”Abnormal device detected” Suspicious device signals (VM, emulator, bot, or tampering) were detected, so verification cannot proceed.	deviceFingerprint. VM, Emulator, Bot, Tampering 등 감지 항목 중 1개 이상이 발견되어 KYC 진행이 차단된 경우.
`DE-30001`	`/error-page/fingerprint-init-error`	”기기 인증을 시작할 수 없습니다” 기기 인증 시스템 초기화에 실패했습니다. 광고 차단기를 해제하거나 다른 브라우저에서 다시 시도해 주세요.	”Unable to start device verification” Device verification system failed to initialize. Please disable your ad blocker or try again in a different browser.	기기 인증(Fingerprint) 시스템 초기화에 실패한 경우. 광고 차단기, 특정 브라우저 환경 등 클라이언트 환경 문제로 핑거프린트 SDK가 로드되지 않거나 초기화에 실패한 상황.
`DE-30002`	`/error-page/fingerprint-response-error`	”기기 인증 결과를 확인할 수 없습니다” 기기 인증 검사 응답이 올바르지 않습니다. 잠시 후 다시 시도해 주세요.	”Unable to verify device authentication result” The device verification response is invalid. Please try again later.	기기 인증 검사 결과 응답 오류. 서버가 예상치 못한 코드를 반환한 경우(포맷이 맞지 않거나 알 수 없는 result 값).
`DE-30003`	`/error-page/fingerprint-network-error`	”네트워크 연결을 확인해 주세요” 기기 인증 요청이 서버에 전달되지 않았습니다. 네트워크 상태를 확인하고 다시 시도해 주세요.	”Please check your network connection” The device verification request did not reach the server. Please check your network and try again.	기기 인증 네트워크 통신 실패. 요청이 서버에 도달하지 못한 경우 — 네트워크 끊김, timeout 등 통신 자체가 실패한 상황.
`DE-40000`	`/error-page/device-duplicate`	”이미 인증을 완료한 기기입니다” 기기 중복 체크 기준을 초과하여 인증을 진행할 수 없습니다.	”Duplicate device detected” Verification cannot proceed because this device has exceeded the duplicate device check limit.	deviceDuplicate. 기기 중복 체크(Device Duplicate Check) 허용 수치를 초과하고 Reject 정책이 적용되어 KYC 진행이 차단된 경우.
`DE-51010`	`-`	`-`	`-`	신분증 촬영(idCapture) 단계 — Device static 정보(브라우저·GPU·터치)가 진입 시점과 불일치.
`DE-52010`	`-`	`-`	`-`	셀피 촬영(selfie) 단계 — Device static 값이 진입 시점과 불일치.
`DE-51020`	`-`	`-`	`-`	신분증 촬영(idCapture) 단계 — Fingerprint Visitor ID가 진입 시점과 불일치(다른 기기).
`DE-52020`	`-`	`-`	`-`	셀피 촬영(selfie) 단계 — Fingerprint Visitor ID가 진입 시점과 불일치(다른 기기).
`DE-51030`	`-`	`-`	`-`	신분증 촬영(idCapture) 단계 — 진입 시 미탐지였던 항목(VM · 에뮬레이터 · 봇 · 변조)이 신규 탐지.
`DE-52030`	`-`	`-`	`-`	셀피 촬영(selfie) 단계 — 진입 시 미탐지였던 항목이 신규 탐지.

DE-51xxx(신분증 촬영)·DE-52xxx(셀피 촬영)는 2026-07 업데이트에서 추가된 촬영 단계 지점 간 검증 차단 코드입니다. 진입 단계 코드와 달리 전용 URL·안내 메시지가 별도로 정의되어 있지 않으며, 차단 시 해당 코드가 사용자에게 표시됩니다. 같은 값이 Device Verification 상세의 Internal Code 필드에도 기록됩니다.

Device Info 탭에서 Device Verification / Fingerprint option / Device Duplicate Check 설정 방법은 인증강화 및 위조방지 — Device Info를 참고하세요.

🤖 TS — Turnstile

봇·자동화 차단을 위한 Cloudflare Turnstile 챌린지가 실패했을 때 발생하는 에러 코드입니다. 번호는 Cloudflare가 반환하는 클라이언트 측 오류 코드를 그대로 사용하며, 앞에 TS- 접두사만 붙습니다. 표의 *** · *는 Cloudflare가 세부 상황에 따라 채우는 자리로, 실제 화면에는 TS-600010처럼 전체 번호가 표시됩니다.

사용자에게 표시되는 문구는 모든 TS 코드가 동일합니다

언어	제목	설명
KO	보안 문제로 일시 제한 유지	현재 사용 중인 네트워크에서 보안 위험이 감지되어 인증이 제한되었습니다. 신뢰할 수 있는 네트워크에서 다시 시도해 주세요.
EN	Temporarily restricted due to a security issue	A security risk was detected on your current network, so verification has been restricted. Please try again from a trusted network.

화면에는 위 문구와 함께 실제 에러 코드가 표시되므로, 정확한 원인은 아래 표에서 코드로 확인합니다.

에러 코드	의미	발생 상황
`TS-100***`	초기화 문제	Turnstile이 시작되기 전에 문제가 발생한 경우. 이미 해결된 챌린지의 오래된 인스턴스가 남아 있을 때 주로 발생하며, 페이지를 새로 고치면 다시 시작됩니다.
`TS-102*` · `TS-103` · `TS-104` · `TS-106*`	잘못된 매개변수	방문자가 챌린지에 잘못된 매개변수를 보낸 경우. 반복해서 발생하면 자동화된 기기일 가능성이 높습니다.
`TS-105***`	Turnstile API 호환성 문제	잘못되거나 구식 방식으로 Turnstile API가 호출된 경우. 페이지를 새로 고쳐 최신 버전을 내려받으면 해소됩니다.
`TS-110100` · `TS-110110`	유효하지 않은 사이트 키	잘못되거나 비활성된 사이트 키로 호출된 경우. 위젯 설정에서 비롯되며 사용자 기기·네트워크 환경과는 무관합니다.
`TS-110200`	알 수 없는 도메인	위젯 설정에 포함되지 않은 도메인에서 호출된 경우.
`TS-110420`	유효하지 않은 action	지원되지 않거나 잘못된 형식의 action이 제출된 경우.
`TS-110430`	유효하지 않은 cData	잘못된 형식의 Custom Data가 전달된 경우.
`TS-110500`	지원되지 않는 브라우저	지원되지 않는 브라우저로 접속한 경우. 브라우저를 업그레이드하거나 지원되는 브라우저로 접속해야 합니다.
`TS-110510`	일관성 없는 User-Agent	챌린지 진행 중 User-Agent가 일관되지 않은 경우. User-Agent를 변조하는 확장 프로그램이 원인인 경우가 많습니다.
`TS-11060*`	챌린지 시간 초과	챌린지 해결에 너무 오래 걸린 경우. 기기 시계가 실제 날짜와 다를 때도 발생합니다.
`TS-11062*`	챌린지 시간 초과 (표시 모드 전용)	오래된 챌린지가 남아 있는 경우. 위젯이 재설정·재초기화되면 다시 해결할 수 있습니다.
`TS-120***`	Cloudflare 내부 오류	Cloudflare 지원 엔지니어가 디버깅할 때만 발생하는 내부 오류로, 일반 운영 중에는 나타나지 않습니다.
`TS-200010`	잘못된 캐싱	Turnstile의 일부가 잘못 캐싱된 경우. 브라우저 캐시를 지우면 해소됩니다.
`TS-200100`	시간 문제	방문자의 기기 시계가 실제 시간과 다른 경우.
`TS-300***`	일반 클라이언트 실행 오류	챌린지 해결 중 알 수 없는 오류가 발생한 경우. 자동화된 방문자일 가능성이 있습니다.
`TS-600***`	챌린지 실행 실패	Turnstile 챌린지를 해결하지 못한 경우. 자동화된 방문자일 가능성이 있습니다.

Turnstile 검증은 Session Journey에서 CHECK_TURNSTILE(FE 요청) · TURNSTILE_TOKEN_CHECK(BE 검증, 사용자 영향 BLOCKED) 이벤트로 기록됩니다. 자세한 내용은 세션 여정 — 이벤트 레퍼런스를 참고하세요.

TS-300*** · TS-600***의 세부 하위 코드와 최신 진단 정보는 Cloudflare Turnstile 클라이언트 측 오류 코드 문서에서 확인할 수 있습니다.

🔵 토큰 에러 페이지 (`/error-page/token-*`)

토큰 검증 실패 시 발생하는 에러 페이지입니다. 2026-04 업데이트부터 TK- 접두사의 에러 코드가 부여되어, 오류 페이지에 코드와 정의가 함께 표시됩니다.

유형	개발자 코드	에러 코드	URL	사용자 메시지 (KO)	사용자 메시지 (EN)	발생 상황
토큰 누락	`token-missing`	`TK-10000`	`/error-page/token-missing`	”유효한 링크가 아닙니다” 링크 정보가 올바르지 않습니다.	”Invalid link” The link information is invalid.	공유 링크를 복사하는 과정에서 토큰 파라미터가 누락되었거나, 불완전한 URL로 접속한 경우 발생합니다.
토큰 만료	`token-expired`	`TK-10001`	`/error-page/token-expired`	”링크가 만료되었습니다” 사용할 수 있는 시간이 지났습니다.	”Link expired” This link has expired.	오래전에 받은 링크이거나, 이미 유효 시간이 지난 토큰으로 접속한 경우 발생합니다.
토큰 승인 완료	`token-approved`	`TK-10002`	`/error-page/token-approved`	”이미 인증이 완료되었습니다” 이 요청은 이미 처리되었습니다.	”Verification already completed” This request has already been completed.	이미 다른 기기에서 해당 토큰으로 인증을 완료한 뒤 다시 접속한 경우 발생합니다.
토큰 검토 중	`token-pending`	`TK-10003`	`/error-page/token-pending`	”현재 검토가 진행 중입니다” 제출하신 내용이 검토 중입니다. 잠시 후 다시 확인해 주세요.	”Review in progress” Your submission is currently under review. Please check again later.	동일한 토큰으로 제출된 건이 아직 검토 중인 상태에서 다시 진입한 경우 발생합니다.
토큰 거부	`token-rejected`	`TK-10004`	`/error-page/token-rejected`	”기존 요청이 승인되지 않았습니다” 제출하신 내용이 반려되었습니다. 자세한 내용은 담당자에게 문의해 주세요.	”Request not approved” Your submission was rejected. Please contact the person in charge for more information.	이 토큰으로 제출한 건이 거부된 상태에서 다시 시도한 경우 발생합니다.

🔄 얼굴 인증 재시도 (`/face-retry/:faceErrorCode`)

유형	개발자 코드	URL	사용자 메시지	발생 상황
동적 얼굴 재촬영	`face-retry/:faceErrorCode`	`/face-retry/:faceErrorCode`	각 에러 코드별 번역 키(기본: “다시 촬영”) / 버튼: “다시 촬영”	조명이 어둡거나 얼굴이 가이드라인 밖으로 벗어나는 등 촬영 품질이 부족하면 재촬영을 안내하며, 특정 코드(`invalid_submission_status`)일 땐 버튼이 숨겨집니다.

❌ 런타임 에러 (`Error Boundary`)

유형	개발자 코드	URL	사용자 메시지	발생 상황
런타임 에러	Next.js Error Boundary	—	기본: “요청이 실패하였습니다”, “KYC 검증이 거부되었습니다” 특수: “지원하지 않는 브라우저”(WebAssembly 에러), “This browser does not support Storage functionality”(Storage 미지원)	네트워크 단절, 강제 새로고침, 시크릿 모드처럼 저장 기능이 막힌 환경에서 앱이 비정상 종료될 때 표시되며, “다시 시도” 버튼으로 재시도하거나 최신 브라우저·정상 모드로 전환해야 합니다.

각 테이블을 기반으로 고객 지원, 모니터링 알림, QA 테스트 케이스를 매핑하면 동일한 화면을 바라보는 모든 이해관계자가 빠르게 상황을 파악할 수 있습니다.

​개요

​에러 코드 카테고리 체계

​에러와 검증 실패 구분

​🔧 시스템 오류 (System Error)

​🚫 검증 실패 · 차단 (Verification Rejected / Blocked)

​⚙️ 요청 · 환경 · 설정 오류 (Request / Environment / Configuration)

​일반 에러 페이지 (/error-page/:errorType)

​🔒 인증·권한 오류

​📅 프로젝트 상태 오류

​📤 제출 상태 오류

​📧 이메일 관련 오류

​🛡️ 보안·사기 탐지 오류

​🌍 IP 리스크 오류

​⏱️ Rate Limit · Lockout

​ER — Rate limit · Lockout

​📍 NF — Not Found

​⚠️ QS — Quality Score

​📦 QE — Queueing Error

​🔧 PV — Parameter Validation

​🖥️ SE — Server Error

​🔁 LO — Loop Error (/error-page/loop/:params)

​⚡ RT — Runtime Error

​📱 DE — Device Error

​🤖 TS — Turnstile

​🔵 토큰 에러 페이지 (/error-page/token-*)

​🔄 얼굴 인증 재시도 (/face-retry/:faceErrorCode)

​❌ 런타임 에러 (Error Boundary)

개요

에러 코드 카테고리 체계

에러와 검증 실패 구분

🔧 시스템 오류 (System Error)

🚫 검증 실패 · 차단 (Verification Rejected / Blocked)

⚙️ 요청 · 환경 · 설정 오류 (Request / Environment / Configuration)

일반 에러 페이지 (`/error-page/:errorType`)

🔒 인증·권한 오류

📅 프로젝트 상태 오류

📤 제출 상태 오류

📧 이메일 관련 오류

🛡️ 보안·사기 탐지 오류

🌍 IP 리스크 오류

⏱️ Rate Limit · Lockout

ER — Rate limit · Lockout

📍 NF — Not Found

⚠️ QS — Quality Score

📦 QE — Queueing Error

🔧 PV — Parameter Validation

🖥️ SE — Server Error

🔁 LO — Loop Error (`/error-page/loop/:params`)

⚡ RT — Runtime Error

📱 DE — Device Error

🤖 TS — Turnstile

🔵 토큰 에러 페이지 (`/error-page/token-*`)

🔄 얼굴 인증 재시도 (`/face-retry/:faceErrorCode`)

❌ 런타임 에러 (`Error Boundary`)