Documentation Index
Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
Use this file to discover all available pages before exploring further.
Resumen
La validación KYC se ramifica en Reject (Rechazo) / Retry (Reintento) / Warning (Advertencia) según el resultado. Warning omite únicamente la verificación afectada y continúa el flujo KYC: no se bloquea ni se solicita una nueva captura al usuario; solo queda un registro.Los registros de Warning acumulados aparecen en el arraywarning[] de la respuesta del GET Submission API. Cada elemento contiene los campos userDataType, relatedEngine y occurrenceTime. Los clientes pueden capturar estos valores con el disparador “Warning Occurred” en Custom Policy para aplicar acciones posteriores como deducción de ARGOS Score, estado Pending o Reject.Este documento agrupa los 11 valores WarningOccurred producidos por el liveform según el mecanismo que los genera, describe la combinación de campos que cada valor expone en warning[] y la opción del dashboard con la que está conectado.Esquema del campo warning[]
| Campo | Tipo | Descripción |
|---|---|---|
warning[i].userDataType | String | Tipo de dato de entrada que activó la advertencia (p. ej. ID Card, ID_card_uploaded, User Input) |
warning[i].relatedEngine | String | Nombre del motor o etapa de validación que produjo la advertencia |
warning[i].occurrenceTime | String | Momento en que se generó la advertencia (ISO 8601) |
Para la definición completa de los campos de respuesta, consulte Campos de respuesta de GET Submission.
Grupo A — Warnings de modo subida (Upload) de ID Liveness
En la política de ID Liveness, cuando un pipeline (Screen replay / Paper printed / Replace portraits) está configurado en Retry y la subopción “Apply Warning on Upload” está activada, el resultado Retry se convierte en Warning únicamente si el usuario envió el documento en modo Upload. El modo Upload no permite recapturar la imagen, por lo que el flujo continúa con una Warning en lugar de forzar un Retry.| WarningOccurred | Pipeline | Condición de activación | userDataType | relatedEngine |
|---|---|---|---|---|
id_liveness_screen_replay | Screen replay | Pipeline Screen replay activa Retry, envío en modo Upload | ID_card_uploaded | ID Liveness Screen replay |
id_liveness_paper_printed | Paper printed | Pipeline Paper printed activa Retry, envío en modo Upload | ID_card_uploaded | ID Liveness Paper printed |
id_liveness_replace_portraits | Replace portraits | Pipeline Replace portraits activa Retry, envío en modo Upload | ID_card_uploaded | ID Liveness Replace portraits |
Grupo B — Warnings de validación de expiración
Cuando la opción del dashboard para expiración del documento o expiración de estancia del pasaporte se configura como Warning, el envío no se rechaza automáticamente; en su lugar se aprueba (Approved) con un registro de Warning.| WarningOccurred | Condición de activación | userDataType | relatedEngine |
|---|---|---|---|
expired_id | La opción Expired ID está configurada en Warning y, ya sea la fecha de expiración del OCR o la introducida por el usuario, es anterior a la fecha actual: se omite el bloqueo de expiración de Step 1 / Step 2 | ID Card / User Input | Expiry validation |
gov_verification_passport_expired_stay | La verificación gubernamental coreana detecta que la fecha de expiración de estancia del pasaporte (expiryDateOfStayKor, registrada en el Ministerio de Justicia) es anterior a la fecha actual | User Input | KOR Gov Passport stay expiry |
Grupo C — Conversión de errores de motor a Warning
Para los motores de ID Liveness · Selfie Passive Liveness · verificación gubernamental coreana, el dashboard ofrece una configuración Error Handling Method. Cuando se establece en Warning, el flujo no redirige a la página de error específica del motor (SE-5002x / SE-5003x); la verificación afectada se omite y queda registrada como Warning.| WarningOccurred | Código de error mapeado | Motor |
|---|---|---|
id_liveness_engine_error_warning | SE-50020 | ID Liveness |
selfie_liveness_engine_error_warning | SE-50021 | Selfie Passive Liveness |
kor_gov_rrc_error_warning | SE-50030 | Verificación gubernamental KOR — Cédula de registro residente |
kor_gov_drvlic_error_warning | SE-50031 | Verificación gubernamental KOR — Permiso de conducir |
kor_gov_passport_error_warning | SE-50032 | Verificación gubernamental KOR — Pasaporte |
kor_gov_foreign_error_warning | SE-50033 | Verificación gubernamental KOR — Cédula de registro de extranjero |
Los errores del motor Face Compare (
SE-50022) son solo Error y no pueden convertirse en Warning. La comparación de la selfie con la foto del documento es esencial para la integridad del KYC, por lo que no se ofrece una rama de omisión (Skip).Uso de Warnings en Custom Policy
Cada elemento registrado enwarning[] puede capturarse mediante la condición Custom Policy → Trigger → “Warning Occurred” en el dashboard de KYC Process y procesarse con una acción posterior.Condiciones de coincidencia
Las condiciones se construyen a partir de combinaciones deuserDataType y relatedEngine. Ejemplos:| Objetivo de coincidencia | Significado |
|---|---|
userDataType = ID Card, relatedEngine = Expiry validation | Warning generada por la fecha de expiración del OCR del documento |
userDataType = ID_card_uploaded, relatedEngine = ID Liveness Screen replay | Warning de liveness Screen replay producida por envío en modo Upload |
relatedEngine = SE-50020 (o nombre de motor ID Liveness) | Conversión a Warning del error del motor ID Liveness |
Acciones posteriores aplicables
- Deducción de ARGOS Score (p. ej. -10 a -30)
- Cambiar el resultado a Pending para revisión manual del administrador
- Reject del envío
- Pase por defecto (cuando no se aplica ninguna política)
La lista de Triggers, los operadores y la composición de acciones de Custom Policy se documentan en la guía del dashboard de KYC Process.
Documentos relacionados
- Campos de respuesta de GET Submission — Esquema de
warning[]y otros campos de respuesta - Códigos de error y páginas — Páginas de error SE utilizadas cuando Error Handling Method está configurado en Error
- Códigos de rechazo y códigos de reintento — Códigos de las ramas Reject y Retry
- Actualización de abril de 2026 — Introducción de Warnings para Expired ID y modo Upload de ID Liveness
- Actualización de mayo de 2026 — Introducción de la conversión a Warning de errores de motor