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:CATEGORY-5DIGITS (por ejemplo, NF-10000)
| 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–40000 | Bloqueo en la etapa de pre-verificación de Device Info (Static check · Fingerprint · Duplicate) |
| 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 |
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-50020SE-50022·SE-50030SE-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)- 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) - 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. 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). |
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.