Códigos de error y páginas de error

Descripción general

Esta guía cataloga todas las páginas de error que pueden aparecer durante el proceso de verificación móvil de Liveform. Cada tabla alinea el código y la ruta orientados al desarrollador con el mensaje exacto que ven sus usuarios, para que los equipos de soporte, operadores y desarrolladores hablen con una sola voz.

Todas las páginas de error se clasifican en una de cuatro rutas de renderizado:

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

Sistema de categorías de códigos de error

Formato del código de error: PREFIJO-NÚMERO (por ejemplo, NF-10000). La cantidad de dígitos varía según la categoría.

Category	Prefix	Full name	Number range	Meaning
General	Developer code	Legacy	—	Definido por tipo de error según su código de desarrollador
Not Found	`NF`	Not Found	10000s	Acceso directo a rutas no definidas
Quality Score	`QS`	Quality Score	10000–30000	Casos de error activados durante búsquedas de IP
Queueing Error	`QE`	Queueing Error	20000s	Errores de sobrecarga de cola del motor
Error Reference	`ER`	Error Reference	001+	Identificadores de API y constantes para limitación de tasa, bloqueo y casos relacionados
Parameter Validation	`PV`	Parameter Validation	40000s	Parámetros de query-string faltantes / valores no válidos / conflictos de opciones
Server Error	`SE`	Server Error	50000s	Fallos en llamadas API o errores del servidor
Runtime	`RT`	Runtime Error	60000s	Errores de tiempo de ejecución del front-end (React ErrorBoundary, excepciones try/catch)
Token	`TK`	Token	10000s	Fallo de validación de token (faltante / expirado / aprobado / en revisión / rechazado)
Device Error	`DE`	Device Error	20000–52030	Bloqueo en la etapa de pre-verificación de Device Info (ingreso: Static check · Fingerprint · Duplicate) o por la comparación entre puntos en las etapas de captura del documento/selfie
Loop Error	`LO`	Loop Error	30000s	Redirige a una página de error dedicada cuando el mismo error se acumula 3 veces en el bucle de captura de ID o reintento de paso
Turnstile	`TS`	Turnstile	Numeración original de Cloudflare	Fallo del desafío de bloqueo de bots y automatización (Cloudflare Turnstile)

Errores frente a rechazos de verificación

Aunque todas las pantallas parecen “páginas de error”, la causa raíz se divide en tres categorías distintas. Utilice esta clasificación durante el soporte al cliente y la monitorización para distinguir rápidamente una incidencia real de un rechazo normal o un problema de configuración.

🔧 Error de sistema (System Error)

Un fallo temporal en el lado de ARGOS, el motor o un tercero (3rd party). Volver a intentarlo después de un momento resuelve la mayoría de los casos.

SE-50000~SE-50015 (carga del proyecto · verificación de token · API de validación · inicialización de autenticación facial y otros errores del servidor)
SE-50020~~SE-50022 · SE-50030~~SE-50033 (errores del servidor de motor de liveness · comparación facial · verificación de autenticidad gubernamental)
RT-60000 · RT-60001 (excepciones de tiempo de ejecución del front-end)
QE-20000 (sobrecarga de la cola del motor)
QS-30000 (error de sistema del verificador de IP)
DE-30001 · DE-30002 · DE-30003 (errores de inicialización · respuesta · red en la verificación del dispositivo)
LO-30001 · LO-30002 · LO-30004 · LO-99999 (OCR · procesamiento de datos · requestId faltante · error de bucle desconocido)

🚫 Rechazo / Bloqueo de verificación (Verification Rejected / Blocked)

Un juicio normal basado en la información enviada, el comportamiento o las señales de riesgo. ARGOS funciona según lo previsto; esto no es un fallo del sistema.

Sospecha de falsificación (suspected-forgery), cara duplicada (face_validation_error), acción anormal (abnormal_action)
Riesgo de IP (ipRisk_failCategory · distanceChecks_ipGeo · blackliskCountries · ipRisk_durationHours)
QS-10000 · QS-20000 (verificación anormal denegada · rechazo inmediato)
DE-20000 · DE-30000 · DE-40000 (entorno de dispositivo bloqueado · anomalía de fingerprint · dispositivo duplicado)
TS-300*** · TS-600*** (fallo del desafío de Turnstile — se sospecha bot o automatización)
Duplicados de envío / IP / correo electrónico (already_* · processed_* · ip_already_* · email_already_rejected)
Estado del token (TK-10002 · TK-10003 · TK-10004 — ya aprobado · en revisión · rechazado)
Calidad de imagen insuficiente (LO-30005), nueva captura facial requerida (face-retry)
Límites de solicitudes y bloqueos (ER-001 · ER-002 · rate_limit_exceeded · locked_out · traffic_overload)

⚙️ Error de solicitud / entorno / configuración (Request / Environment / Configuration)

Un problema con el enlace, los parámetros o la configuración del proyecto del cliente, o con el dispositivo, el navegador o el método de acceso del usuario. El problema se resuelve corrigiendo la configuración o el entorno correspondiente.

Errores de parámetros y opciones (PV-40000~PV-40018)
Errores de ruta (NF-10000 · NF-10001 · bad-path · page-not-found)
Acceso en modo solo cifrado (encrypted_only)
Navegador o dispositivo no compatible (invalid-browser = RT-60002)
Problemas de entorno de Turnstile (TS-110500 · TS-110510 · TS-11060* · TS-11062* · TS-200010 · TS-200100)
Estado del proyecto (project-closed · period · submission-number-limit · service-blocked)
Token faltante o expirado (TK-10000 · TK-10001)
Parámetro obligatorio faltante (LO-30003)
Problemas de integridad de sesión (refresh · hash_problem)
Permiso de carga bloqueado (not-allow-file-upload)

Algunos códigos pueden pertenecer a una categoría diferente según el contexto. La clasificación anterior es una guía de triaje de primer nivel; para conocer las condiciones de activación exactas, consulte la columna de condición de ocurrencia en cada tabla a continuación.

Páginas de error generales (`/error-page/:errorType`)

Errores de autenticación y autorización

Type	Developer code	URL	User message	Occurrence
Page not found	`page-not-found`	`/error-page/page-not-found`	”The page could not be found”	Aparece cuando un usuario escribe una URL inexistente o abre un marcador desactualizado.
Service blocked	`service-blocked`	`/error-page/service-blocked`	”Submissions are temporarily paused”	Se muestra cuando un operador detiene temporalmente las solicitudes pero los usuarios siguen visitando el enlace.
Invalid path	`bad-path`	`/error-page/bad-path`	”Invalid URL path”	Se activa si alguien edita el enlace compartido o navega a una ruta no incluida en la lista blanca.
Refresh detected	`refresh`	`/error-page/refresh`	”Refresh detected”	Se muestra cuando el usuario actualiza o hace clic en atrás/adelante durante el flujo y la sesión se reinicia.
Unsupported browser	`invalid-browser`	`/error-page/invalid-browser`	”Unsupported browser”	Aparece en navegadores antiguos o entornos sin soporte de WebAssembly; los usuarios deben cambiar a un navegador moderno. (código de error `RT-60002`)
Hash validation failure	`hash_problem`	`/error-page/hash_problem`	”Hash validation issue”	Se muestra si múltiples pestañas o pasos omitidos rompen la integridad de los datos; el flujo debe reiniciarse.
Encrypted only	`encrypted_only`	`/error-page/encrypted_only`	”Unencrypted access”	Aparece al acceder a un proyecto con `option_encryptedOnly=true` usando una cadena de consulta no cifrada, o cuando se incluyen parámetros de consulta distintos a `pid`, `lang` y `encrypted`.

Errores de estado del proyecto

Type	Developer code	URL	User message	Occurrence
Project closed	`project-closed`	`/error-page/project-closed`	”This project is closed and access is restricted”	Los usuarios que reabren una campaña finalizada ven que no se permiten más solicitudes.
Period expired	`period`	`/error-page/period`	”Project submission window expired”	Se activa cuando alguien visita después de que la ventana de envío permitida haya terminado.
Submission count limit	`submission-number-limit`	`/error-page/submission-number-limit`	”You submitted more than 15 times”	Los proyectos de prueba detienen intentos adicionales una vez que se supera el límite de 15 envíos.

Errores de estado de solicitud

Type	Developer code	URL	User message	Occurrence
Already approved	`already_approved`	`/error-page/already_approved`	”This device has already been verified”	Un dispositivo/navegador que ya completó la verificación queda bloqueado hasta que termine el período de espera.
Already rejected	`already_rejected`	`/error-page/already_rejected`	”This submission was already rejected”	El usuario intenta de nuevo antes de que expire el período de enfriamiento del rechazo y se le indica que espere.
Pending review	`already_pending`	`/error-page/already_pending`	”Your submission is under review”	Se intenta un nuevo envío mientras el anterior aún está en revisión.
Processed (approved)	`processed_submission-approved`	`/error-page/processed_submission-approved`	”This submission was already processed (approved)“	Reabrir un resultado aprobado simplemente recuerda al usuario que no se necesita ninguna acción adicional.
Processed (rejected)	`processed_submission-rejected`	`/error-page/processed_submission-rejected`	”Verification was rejected”	Reabrir un resultado rechazado muestra el tiempo de espera restante antes de un reintento.
IP already approved	`ip_already_approved`	`/error-page/ip_already_approved`	”This IP address has already been approved”	Otro usuario en la misma red intenta rehacer una verificación que ya fue exitosa.
IP already rejected	`ip_already_rejected`	`/error-page/ip_already_rejected`	”This IP address has already been rejected”	La misma red falla repetidamente o aún está dentro del período de enfriamiento del rechazo; los usuarios deben cambiar de red.

Errores relacionados con correo electrónico

Type	Developer code	URL	User message	Occurrence
Email already rejected	`email_already_rejected`	`/error-page/email_already_rejected`	”Verification rejected / This email was already rejected”	Reutilizar un correo electrónico que aún está dentro del período de espera de rechazo muestra el tiempo de enfriamiento restante.

Seguridad y detección de fraude

Type	Developer code	URL	User message	Occurrence
Suspected forgery	`suspected-forgery`	`/error-page/suspected-forgery`	”Suspected forgery detected”	Se activa cuando el ID capturado se ve borroso, manipulado o de otra manera no auténtico; el usuario debe volver a fotografiar.
File upload not allowed	`not-allow-file-upload`	`/error-page/not-allow-file-upload`	”File upload is not allowed”	Navegadores seguros, modo privado o permisos de cámara/archivos denegados impiden las cargas; los usuarios deben habilitar el acceso o cambiar de dispositivo.
Duplicate face detected	`face_validation_error`	`/error-page/face_validation_error`	”Duplicate face detected”	El sistema detecta la misma cara de un envío anterior e indica al usuario que contacte a soporte.
Abnormal action	`abnormal_action`	`/error-page/abnormal_action`	”Abnormal behavior detected”	Subir capturas de pantalla, imágenes excesivamente editadas o selfies idénticos activa este mensaje y fuerza un reintento adecuado.

Errores de riesgo de IP

Type	Developer code	URL	User message	Occurrence
Risky category	`ipRisk_failCategory`	`/error-page/ipRisk_failCategory`	”IP risk category failed”	Las conexiones desde VPNs, Tor o centros de datos se bloquean hasta que los usuarios cambien de red.
Distance check failed	`distanceChecks_ipGeo`	`/error-page/distanceChecks_ipGeo`	”IP distance check failed”	Cuando el GPS y la geolocalización de IP están muy separados (por ejemplo, GPS local pero VPN en el extranjero), el usuario debe desactivar la VPN.
Blacklisted country	`blackliskCountries`	`/error-page/blackliskCountries`	”Blacklisted country”	El acceso desde países restringidos se deniega con la indicación de que el servicio no está disponible allí.
Risk duration lock	`ipRisk_durationHours`	`/error-page/ipRisk_durationHours`	”IP risk duration limit”	Los intentos riesgosos repetidos bloquean la IP durante un período establecido; los usuarios solo pueden reintentar después de que el temporizador termine.

Límite de tasa y bloqueo

Type	Developer code	URL	User message	Occurrence
Rate limit exceeded	`rate_limit_exceeded`	`/error-page/rate_limit_exceeded`	”Request limit exceeded”	Demasiadas actualizaciones o envíos en un corto período activan una pausa temporal.
Account locked	`locked_out`	`/error-page/locked_out`	”Account locked”	Numerosos fallos o actividad sospechosa bloquean la cuenta hasta que expire el temporizador mostrado.
Traffic overload	`traffic_overload`	`/error-page/traffic_overload`	”Traffic overload”	El sondeo del estado de envío supera los 32 intentos, indicando sobrecarga del servidor; se pide a los usuarios que intenten de nuevo más tarde.

ER — Límite de tasa y bloqueo

Estos códigos se asignan a los mismos identificadores de API y constantes (RATE_LIMIT_EXCEEDED, LOCKED_OUT) y rutas que los códigos de desarrollador de Límite de tasa y bloqueo rate_limit_exceeded y locked_out en la tabla anterior.

Error code	Identifier	URL	User message (EN)	Occurrence
`ER-001`	`RATE_LIMIT_EXCEEDED`	`/error-page/rate_limit_exceeded`	”Request limit exceeded”	Demasiadas actualizaciones o envíos en un corto período activan una pausa temporal.
`ER-002`	`LOCKED_OUT`	`/error-page/locked_out`	”Account locked”	Numerosos fallos o actividad sospechosa bloquean la cuenta hasta que expire el temporizador mostrado.

NF — Not Found

Códigos de error para cuando no se puede encontrar una ruta.

Error code	URL	User message	Occurrence
`NF-10000`	`/error-page/not-found`	”Page not found” The page you requested does not exist. Please check the URL and try again.	Acceso a una ruta no definida en el router. Tanto las rutas comodín (`*`) de móvil como de PC redirigen aquí.
`NF-10001`	`/error-page/invalid-path`	”Invalid access path” You accessed an unauthorized path. Please try again with the correct URL.	La ruta URL existe pero no está en la lista de rutas iniciales permitidas (`VALID_INITIAL_PATH`).

QS — Quality Score

Códigos de error activados durante búsquedas de IP.

Error code	URL	User message	Occurrence
`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.	El verificador de IP emite una espera de 48 horas debido a comportamiento riesgoso repetido.
`QS-20000`	`/error-page/abnormal_rejected`	”Abnormal rejection” Severe anomalies triggered an immediate rejection. Security issues must be resolved before retrying.	El verificador de IP detecta una puntuación de fraude de 90 o superior.
`QS-30000`	`/error-page/ipqs_system_error`	”IPQS system error” The IP lookup failed due to a system error. Please try again later.	Ocurre un error de cliente o servidor en el verificador de IP.

QE — Queueing Error

Códigos de error para situaciones de sobrecarga de cola del motor.

Error code	URL	User message	Occurrence
`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.	La cola de procesamiento del motor está sobrecargada y el servidor no puede manejar los datos del usuario actual.

PV — Parameter Validation

Códigos de error para parámetros de query-string faltantes, valores no válidos o conflictos de opciones.

Error code	URL	User message	Occurrence
`PV-40000`	`/error-page/missing-pid`	”Required parameter is missing” The project ID (pid) is not included in the URL. Please access again via the correct link.	Falta el parámetro `pid` en la cadena de consulta de la URL. `pid` es obligatorio para todas las solicitudes.
`PV-40001`	`/error-page/invalid-action`	”Invalid request” The action parameter value is invalid or required parameters are missing.	El parámetro `action` no es `addveri`, o `action=addveri` está establecido sin `pid` o `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.	Se proporciona `distanceCheckSource` pero `distanceMaxDistanceKm` no es un número válido.
`PV-40003`	`/error-page/invalid-iprisk-option`	”Option configuration is invalid” The IP risk option value is invalid. Please check the settings and try again.	Se proporciona `ipRiskCategory` pero `ipRiskDurationHours` no es un número válido.
`PV-40004`	`/error-page/conflicting-projection`	”Parameter configuration conflict” projectionName and projectionId cannot be used at the same time. Please configure only one of them.	Se especifican simultáneamente `projectionName` y `projectionId`. Solo se permite uno.
`PV-40010`	`/error-page/blacklisted-country`	”Service is unavailable in this country” Identity verification service is not available in the selected country.	El país especificado en `selectedIssuingCountry` está en la lista negra del servicio.
`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.	La lista `allowedCountries` contiene uno o más países en la lista negra.
`PV-40012`	`/error-page/conflicting-universal-idtype`	”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` está establecido junto con `selectedIdType`, que son mutuamente excluyentes.
`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.	Se proporciona `selectedIdType` sin el `selectedIssuingCountry` requerido.
`PV-40014`	`/error-page/conflicting-knowledge-idtype`	”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` está establecido junto con `selectedIdType`, que no son compatibles.
`PV-40015`	`/error-page/missing-faceauth-pid`	”Authentication information is missing” Required parameters (pid or sid) for face authentication are missing. Please access again via the correct link.	Se ingresa al flujo `faceAuth` sin `pid` o `sid`.
`PV-40016`	`/error-page/conflicting-knowledge-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` está establecido junto con `option_validationFaceCompare=false`.
`PV-40017`	`/error-page/conflicting-knowledge-field`	”Knowledge validation field configuration conflict” The skip option in knowledgeField cannot be used with other fields. Please set skip as a standalone option.	`knowledgeField` incluye tanto `skip` como otras opciones de campo. `skip` debe usarse solo.
`PV-40018`	`/error-page/expired-start-valid-until`	”El enlace de verificación ha expirado” Se expiró antes del inicio de autenticación o accedió después de que la hora `startValidUntil` pasara. Obtenga un nuevo enlace e intente nuevamente.	”The verification link has expired” The verification link has expired. Please try again with a new link.	El parámetro de cadena de consulta `startValidUntil` especifica una hora (UTC+0) que ya ha pasado cuando se intenta iniciar la autenticación. Se aplica con prioridad antes de la validación de token ID.

SE — Server Error

Códigos de error para fallos en llamadas API o errores del servidor.

Error code	URL	User message	Occurrence
`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.	La llamada API `projectOptions` falla durante la entrada inicial de la aplicación.
`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.	Ocurre una excepción durante la llamada API `checkingToken`.
`SE-50002`	`/error-page/validation-api-error`	”Validation service error” A server error occurred during address validation. Please try again later.	La API de validación de dirección (`/live/internal/validation`) devuelve una respuesta de error.
`SE-50010`	`/error-page/faceauth-preload-error`	”Face authentication initialization failed” A server error occurred while preparing face authentication. Please try again later.	La primera consulta API para la precarga de datos `faceAuth` falla.
`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.	La segunda consulta API para la precarga de datos `faceAuth` falla.
`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.	La API `checkSubmission` responde pero `result` es 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.	Ocurre una excepción durante la llamada API `insertToken` en `faceAuth`.
`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.	La llamada API para obtener datos del proyecto `faceAuth` falla.
`SE-50015`	`/error-page/validation-code-error`	”Validation failed” An error code was returned from address validation. Please check your information and try again.	La respuesta de la API de validación de dirección contiene un campo `errorCode`. La API respondió pero la validación en sí falló.
`SE-50020`	`/error-page/id-liveness-server-error`	”La verificación de vivacidad del ID ha fallado” Por favor, inténtelo de nuevo más tarde.	El motor de verificación de vivacidad del ID (ID Liveness) falla de forma consecutiva. En lugar de reintentar indefinidamente, el flujo redirige a una página de error dedicada.
`SE-50021`	`/error-page/passive-liveness-error`	”La verificación de vivacidad pasiva ha fallado” Por favor, inténtelo de nuevo más tarde.	El motor de Passive Liveness (selfie) falla de forma consecutiva.
`SE-50022`	`/error-page/face-compare-error`	”La verificación de comparación facial ha fallado” Por favor, inténtelo de nuevo más tarde.	El motor de Face Compare falla de forma consecutiva.
`SE-50030`	`/error-page/verify-kor-government-id-error`	”La verificación del documento nacional de identidad coreano ha fallado temporalmente” Por favor, inténtelo de nuevo más tarde.	Fallo en el procesamiento del servidor de verificación de autenticidad del DNI coreano.
`SE-50031`	`/error-page/verify-kor-driver-license-error`	”La verificación del permiso de conducir coreano ha fallado temporalmente” Por favor, inténtelo de nuevo más tarde.	Fallo en el procesamiento del servidor de verificación de autenticidad (permiso de conducir coreano).
`SE-50032`	`/error-page/verify-kor-passport-error`	”La verificación del pasaporte coreano ha fallado temporalmente” Por favor, inténtelo de nuevo más tarde.	Fallo en el procesamiento del servidor de verificación de autenticidad (pasaporte coreano).
`SE-50033`	`/error-page/verify-kor-residence-permit-error`	”La verificación del permiso de residencia de extranjeros coreano ha fallado temporalmente” Por favor, inténtelo de nuevo más tarde.	Fallo en el procesamiento del servidor de verificación de autenticidad (tarjeta de registro de extranjeros coreana).

Entre los errores de motor anteriores, ID Liveness (SE-50020), Selfie Passive Liveness (SE-50021) y la verificación gubernamental coreana (SE-50030–50033) se pueden configurar en el panel de control para tratarlos como Advertencia (Warning) en lugar de Error. Cuando se tratan como Advertencia, el flujo no redirige a la página de error y el proceso KYC subsiguiente continúa. La Advertencia también puede utilizarse como disparador de Custom Policy. (Face Compare (SE-50022) es solo Error.) Para los valores de WarningOccurred y el mapeo de los campos de warning[] producidos tras la conversión, consulte Códigos y campos de Warning.

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

Cuando el mismo error se acumula 3 veces durante la captura del ID o el procesamiento paso a paso, el flujo redirige (replace) a una página de error de bucle dedicada para evitar reintentos infinitos. Menos de 3 ocurrencias se gestionan con una solicitud de nueva captura o una notificación. Cada caso se asigna según el valor de params en la URL; los casos no asignados redirigen a una página de Fallback.

Error code	URL	User message	Occurrence
`LO-30001`	`/error-page/loop/ocr_fail`	”No se pudo reconocer el documento de identidad” Por favor, vuelva a fotografiarlo.	El motor OCR no pudo reconocer el ID, o se produjo un error en el servidor OCR.
`LO-30002`	`/error-page/loop/data_processing_error`	”Se produjo un error durante el procesamiento de datos” Por favor, inténtelo de nuevo más tarde.	Se produjo un error durante el procesamiento de datos.
`LO-30003`	`/error-page/loop/missing_parameters`	”Falta información obligatoria” Por favor, empiece de nuevo.	Faltan parámetros obligatorios.
`LO-30004`	`/error-page/loop/missing_requestId`	”No se puede verificar la información de la solicitud” Por favor, empiece de nuevo.	Falta el requestId.
`LO-30005`	`/error-page/loop/image_quality_low`	”La calidad de la imagen del documento es demasiado baja” Por favor, vuelva a fotografiarlo con más claridad.	Fallos acumulados en el estándar de calidad de imagen del ID (brillo / nitidez).
`LO-99999`	`/error-page/loop/*` (Fallback)	“Se ha producido un error desconocido” Por favor, empiece de nuevo.	Un error de bucle que no coincide con ninguno de los casos anteriores (UnknownLoopError). El tipo de error también se registra para monitoreo interno.

RT — Runtime Error

Códigos de error para errores de tiempo de ejecución del front-end.

Error code	URL	User message	Occurrence
`RT-60000`	`/error-page/runtime-error`	”An error occurred” An unexpected error occurred. Please refresh the page or start over.	React ErrorBoundary se activa en las rutas `/qr`, `/knowledge-qr` o `/face-auth-qr`.
`RT-60001`	`/error-page/token-runtime-error`	”An error occurred during token processing” An unexpected error occurred. Please refresh the page or start over.	Se captura una excepción en el bloque try/catch dentro del hook `useTokenCheck`.
`RT-60002`	`/error-page/invalid-browser`	”Navegador no compatible” Por favor, inténtelo de nuevo con un navegador moderno.	Se activa en navegadores antiguos, entornos sin soporte de WebAssembly, o dispositivos con Android OS inferior a la versión 9. Consulte la guía de navegadores y dispositivos recomendados para conocer los entornos compatibles.

DE — Device Error

Códigos de error generados cuando el usuario es bloqueado en la etapa de pre-verificación de Device Info (ingreso) y en las etapas de captura del documento/selfie. El código de error y su definición se muestran juntos en la página de error para que los clientes puedan identificar inmediatamente el motivo del bloqueo.

Código de error	URL	Mensaje para el usuario (ES)	Mensaje para el usuario (EN)	Condición de ocurrencia
`DE-20000`	`/error-page/abnormal_device`	”Entorno de dispositivo no compatible” La verificación no se puede realizar en el dispositivo o navegador actual. Inténtelo de nuevo en un dispositivo o navegador diferente.	”Unsupported device environment” Verification cannot be performed on the current device or browser. Please try again on a different device or browser.	abnormalDevice. Bloqueo del proceso KYC por un problema del entorno del dispositivo móvil / navegador.
`DE-30000`	`/error-page/device-fingerprint`	”Se ha detectado un dispositivo anómalo” Se han detectado señales anómalas del dispositivo (VM, emulador, bot, manipulación, etc.), por lo que no se puede proceder con la verificación.	”Abnormal device detected” Suspicious device signals (VM, emulator, bot, or tampering) were detected, so verification cannot proceed.	deviceFingerprint. Bloqueo del proceso KYC porque se detectó uno o más elementos (VM, emulador, bot, manipulación, etc.).
`DE-30001`	`/error-page/fingerprint-init-error`	”No se puede iniciar la verificación del dispositivo” Error al inicializar el sistema de verificación del dispositivo. Desactive el bloqueador de anuncios o inténtelo de nuevo en otro navegador.	”Unable to start device verification” Device verification system failed to initialize. Please disable your ad blocker or try again in a different browser.	Error al inicializar el sistema de verificación del dispositivo (Fingerprint). Un problema del entorno del cliente, como un bloqueador de anuncios o un navegador específico, impidió que el SDK de fingerprint se cargara o inicializara.
`DE-30002`	`/error-page/fingerprint-response-error`	”No se puede verificar el resultado de la autenticación del dispositivo” La respuesta de verificación del dispositivo no es válida. Inténtelo de nuevo más tarde.	”Unable to verify device authentication result” The device verification response is invalid. Please try again later.	Error en la respuesta del resultado de verificación del dispositivo. El servidor devolvió un código inesperado (formato no válido o valor de result desconocido).
`DE-30003`	`/error-page/fingerprint-network-error`	”Compruebe su conexión de red” La solicitud de verificación del dispositivo no llegó al servidor. Compruebe su red e inténtelo de nuevo.	”Please check your network connection” The device verification request did not reach the server. Please check your network and try again.	Fallo de comunicación de red en la verificación del dispositivo. La solicitud no llegó al servidor — la comunicación falló por desconexión de red, timeout, etc.
`DE-40000`	`/error-page/device-duplicate`	”Dispositivo duplicado detectado” No se puede proceder con la verificación porque este dispositivo ha superado el límite de comprobación de dispositivos duplicados.	”Duplicate device detected” Verification cannot proceed because this device has exceeded the duplicate device check limit.	deviceDuplicate. Bloqueo del proceso KYC porque se superó el límite permitido de Device Duplicate Check y se aplica la política de rechazo (Reject).
`DE-51010`	`-`	`-`	`-`	Etapa de captura del documento (idCapture) — la información static de Device (navegador, GPU, táctil) no coincide con el ingreso.
`DE-52010`	`-`	`-`	`-`	Etapa de captura de la selfie (selfie) — los valores static de Device no coinciden con el ingreso.
`DE-51020`	`-`	`-`	`-`	Etapa de captura del documento (idCapture) — el Visitor ID de Fingerprint no coincide con el ingreso (dispositivo distinto).
`DE-52020`	`-`	`-`	`-`	Etapa de captura de la selfie (selfie) — el Visitor ID de Fingerprint no coincide con el ingreso (dispositivo distinto).
`DE-51030`	`-`	`-`	`-`	Etapa de captura del documento (idCapture) — un elemento no detectado en el ingreso (VM · emulador · bot · manipulación) se detecta por primera vez.
`DE-52030`	`-`	`-`	`-`	Etapa de captura de la selfie (selfie) — un elemento no detectado en el ingreso se detecta por primera vez.

DE-51xxx (captura del documento) y DE-52xxx (captura de la selfie) son códigos de bloqueo de la comparación entre puntos añadidos en la actualización de 2026-07. A diferencia de los códigos de la etapa de ingreso, no tienen una URL ni un mensaje dedicados; el propio código se muestra al usuario en el bloqueo. El mismo valor se registra también en el campo Internal Code del detalle de Device Verification.

Consulte Refuerzo de autenticación y prevención de falsificación — Device Info para saber cómo configurar Device Verification / Fingerprint option / Device Duplicate Check en la pestaña Device Info.

TS — Turnstile

Códigos de error que se generan cuando falla el desafío de Cloudflare Turnstile, utilizado para bloquear bots y automatización. Los números son los propios códigos de error del lado del cliente de Cloudflare, empleados tal cual y solo con el prefijo TS- añadido. Los *** y * de la tabla son posiciones que Cloudflare completa según la situación; en pantalla se muestra el número completo (por ejemplo, TS-600010).

Todos los códigos TS comparten el mismo mensaje para el usuario

Idioma	Título	Descripción
ES	Restricción temporal por un problema de seguridad	Se ha detectado un riesgo de seguridad en la red que está utilizando, por lo que la verificación ha sido restringida. Vuelva a intentarlo desde una red de confianza.
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.

El código de error real se muestra junto a este mensaje, por lo que la causa exacta se identifica con el código en la tabla siguiente.

Código de error	Significado	Condición de ocurrencia
`TS-100***`	Problema de inicialización	Se produjo un problema antes de que Turnstile pudiera iniciarse. Suele deberse a una instancia antigua de un desafío ya resuelto; al actualizar la página, el desafío se reinicia.
`TS-102*` · `TS-103` · `TS-104` · `TS-106*`	Parámetros no válidos	El visitante envió parámetros no válidos al desafío. Si ocurre de forma repetida, es probable que se trate de un dispositivo automatizado.
`TS-105***`	Problema de compatibilidad con la API de Turnstile	La API de Turnstile se invocó de forma incorrecta o desactualizada. Se resuelve al actualizar la página para obtener la última versión.
`TS-110100` · `TS-110110`	Sitekey no válida	Se invocó con una sitekey no válida o desactivada. Se origina en la configuración del widget y no guarda relación con el dispositivo ni la red del usuario.
`TS-110200`	Dominio desconocido	Se invocó desde un dominio no incluido en la configuración del widget.
`TS-110420`	Action no válida	Se envió una action no admitida o con formato incorrecto.
`TS-110430`	cData no válido	Se transmitió Custom Data con formato incorrecto.
`TS-110500`	Navegador no compatible	El visitante accedió con un navegador no compatible y debe actualizarlo o usar uno compatible.
`TS-110510`	User-Agent inconsistente	El User-Agent cambió durante el desafío, con frecuencia por una extensión que lo falsifica.
`TS-11060*`	Tiempo de espera del desafío agotado	El desafío tardó demasiado en resolverse. También ocurre cuando el reloj del dispositivo difiere de la fecha real.
`TS-11062*`	Tiempo de espera agotado (solo modo de visualización)	Queda un desafío obsoleto. Al restablecer y reinicializar el widget, el visitante puede resolverlo de nuevo.
`TS-120***`	Error interno de Cloudflare	Error interno que solo se produce mientras un ingeniero de soporte de Cloudflare está depurando; no aparece en la operación normal.
`TS-200010`	Almacenamiento en caché incorrecto	Una parte de Turnstile se almacenó en caché de forma incorrecta. Se resuelve al borrar la caché del navegador.
`TS-200100`	Problema de hora	El reloj del dispositivo del visitante difiere de la hora real.
`TS-300***`	Error genérico de ejecución del cliente	Se produjo un error desconocido al resolver el desafío. Puede tratarse de un visitante automatizado.
`TS-600***`	Fallo en la ejecución del desafío	No se pudo resolver el desafío de Turnstile. Puede tratarse de un visitante automatizado.

La verificación de Turnstile se registra en Session Journey como los eventos CHECK_TURNSTILE (solicitud FE) y TURNSTILE_TOKEN_CHECK (validación BE, impacto en el usuario BLOCKED). Consulte la Referencia de eventos del recorrido de sesión para más detalles.

Consulte la documentación de códigos de error del lado del cliente de Cloudflare Turnstile para conocer los subcódigos detallados de TS-300*** · TS-600*** y la información de diagnóstico más reciente.

Páginas de error de token (`/error-page/token-*`)

A partir de la actualización de 2026-04, se han asignado códigos de error con prefijo TK- a los errores de token, mostrándose el código y su definición juntos en la página de error.

Tipo	Código de desarrollador	Código de error	URL	Mensaje para el usuario (ES)	Mensaje para el usuario (EN)	Condición de ocurrencia
Token faltante	`token-missing`	`TK-10000`	`/error-page/token-missing`	”Enlace no válido” La información del enlace no es correcta.	”Invalid link” The link information is invalid.	El parámetro de token falta al copiar el enlace, o se accede con una URL incompleta.
Token expirado	`token-expired`	`TK-10001`	`/error-page/token-expired`	”El enlace ha expirado” El tiempo de uso ha expirado.	”Link expired” This link has expired.	Se accede con un enlace muy antiguo o con un token cuyo tiempo de validez ya ha pasado.
Token ya aprobado	`token-approved`	`TK-10002`	`/error-page/token-approved`	”La verificación ya está completa” Esta solicitud ya ha sido procesada.	”Verification already completed” This request has already been completed.	Se intenta acceder nuevamente después de haber completado la verificación con ese token en otro dispositivo.
Token en revisión	`token-pending`	`TK-10003`	`/error-page/token-pending`	”La revisión está en curso” El contenido enviado está siendo revisado. Por favor, vuelva a verificar más tarde.	”Review in progress” Your submission is currently under review. Please check again later.	Se vuelve a acceder con el mismo token mientras el envío aún está en revisión.
Token rechazado	`token-rejected`	`TK-10004`	`/error-page/token-rejected`	”La solicitud anterior no fue aprobada” El contenido enviado fue rechazado. Contacte al responsable para más información.	”Request not approved” Your submission was rejected. Please contact the person in charge for more information.	Se intenta de nuevo con un token cuyo envío fue rechazado.

Reintento facial (`/face-retry/:faceErrorCode`)

Type	Developer code	URL	User message	Occurrence
Dynamic face reshoot	`face-retry/:faceErrorCode`	`/face-retry/:faceErrorCode`	Localizado por código de error / Botón: “Retake”	Mala iluminación, caras desalineadas u otros problemas de captura solicitan volver a fotografiar; ciertos códigos (por ejemplo, `invalid_submission_status`) ocultan completamente el botón de volver a fotografiar.

Errores de tiempo de ejecución (`Error Boundary`)

Type	Developer code	URL	User message	Occurrence
Runtime error	Next.js Error Boundary	—	Default: “Your request failed”, “KYC verification was rejected” Special: “Unsupported browser” (WebAssembly error), “This browser does not support storage functionality”	Caídas de red, actualizaciones forzadas o entornos con almacenamiento desactivado (modo privado) pueden hacer que la aplicación falle; los usuarios deben tocar “Retry” o cambiar a un navegador moderno/modo estándar.

Use estas tablas para alinear scripts de soporte, alertas de monitoreo y escenarios de QA para que todas las partes interesadas describan la misma pantalla con el mismo vocabulario.

​Descripción general

​Sistema de categorías de códigos de error

​Errores frente a rechazos de verificación

​🔧 Error de sistema (System Error)

​🚫 Rechazo / Bloqueo de verificación (Verification Rejected / Blocked)

​⚙️ Error de solicitud / entorno / configuración (Request / Environment / Configuration)

​Páginas de error generales (/error-page/:errorType)

​Errores de autenticación y autorización

​Errores de estado del proyecto

​Errores de estado de solicitud

​Errores relacionados con correo electrónico

​Seguridad y detección de fraude

​Errores de riesgo de IP

​Límite de tasa y bloqueo

​ER — Límite de tasa y bloqueo

​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

​Páginas de error de token (/error-page/token-*)

​Reintento facial (/face-retry/:faceErrorCode)

​Errores de tiempo de ejecución (Error Boundary)

Descripción general

Sistema de categorías de códigos de error

Errores frente a rechazos de verificación

🔧 Error de sistema (System Error)

🚫 Rechazo / Bloqueo de verificación (Verification Rejected / Blocked)

⚙️ Error de solicitud / entorno / configuración (Request / Environment / Configuration)

Páginas de error generales (`/error-page/:errorType`)

Errores de autenticación y autorización

Errores de estado del proyecto

Errores de estado de solicitud

Errores relacionados con correo electrónico

Seguridad y detección de fraude

Errores de riesgo de IP

Límite de tasa y bloqueo

ER — Límite de tasa y bloqueo

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

Páginas de error de token (`/error-page/token-*`)

Reintento facial (`/face-retry/:faceErrorCode`)

Errores de tiempo de ejecución (`Error Boundary`)