Catálogo de mensajes

Identificadores msg y code en la respuesta que recibe su aplicación en el cliente (callback del SDK Web, o JSON del SDK Android e SDK iOS).

Ejemplos de respuesta

Verificación exitosa

{
  "result": true,
  "msg": "success",
  "code": 200,
  "id": "abc123...",
  "confidence": 0.98
}

Proceso finalizado sin aprobar (resumen)

{
  "result": false,
  "msg": "failed challenges",
  "code": 200,
  "id": "abc123...",
  "confidence": 0.0
}

Error de permiso de cámara (selfie)

{
  "result": false,
  "msg": "selfie:sdk:camera:access",
  "code": 423,
  "id": "abc123..."
}

Proceso expirado

{
  "result": false,
  "msg": "expired",
  "code": 410,
  "id": "abc123..."
}

Error mínimo de captura

{
  "result": false,
  "msg": "ui:connection:error"
}

Catálogo de mensajes

Proceso finalizado con éxito

`msg`	Significado sugerido para su UX
`success`	Verificación aprobada

Proceso finalizado sin aprobar

`msg`	Significado sugerido
`failed challenges`	El proceso cerró sin aprobar (motivo agregado)
`blacklisted`	Bloqueo por reintentos fallidos
`db_write`	Error al guardar; reintentar más tarde

Los diferentes tipos de challenges se describen en el Catálogo de challenges.

Acceso, conexión y expiración

`msg`	`code`	Significado sugerido
`expired`	`410`	Proceso o enlace vencido
`error`	variable	Error al iniciar el proceso
`captcha:connection:error`	`500`	Fallo en validación de acceso inicial
`ui:connection:error`	`500`	No se cargó la pantalla de verificación
`process:response:connection:error`	`500`	Fallo de red al enviar capturas
`process:response:connection:timeout`	`408`	Timeout al validar
`process:read:timeout`	`408`	Timeout al consultar el resultado
`process:read:error`	`500`	Error al consultar el resultado
`process:read:expired`	`410`	Proceso expirado al consultar el resultado

Selfie — error de captura (flujo interrumpido)

`msg`	`code`	Significado sugerido
`selfie:assets:timeout`	`408`	Recursos del flujo no cargaron a tiempo
`selfie:sdk:connection:timeout`	`408`	Timeout de conexión en captura
`selfie:sdk:camera:access`	`423`	Sin permiso de cámara
`selfie:sdk:camera:empty`	`404`	Sin cámara disponible
`selfie:sdk:camera:busy`	`409`	Cámara en uso
`selfie:sdk:camera:overconstrained`	`416`	Requisitos de cámara no soportados
`selfie:sdk:camera:https`	`403`	Se requiere HTTPS
`selfie:sdk:camera:abort`	`422`	Captura cancelada
`selfie:sdk:camera:timeout`	`504`	Timeout de captura
`selfie:sdk:bug`	`415`	Error interno del módulo de selfie
`selfie:sdk:unknown`	variable	Error de selfie no clasificado
`selfie:sdk:<texto>`	`422`	Detalle del proveedor (texto variable)
`selfie:response:empty`	`417`	Sin imagen de selfie al enviar

Documento — error de captura

`msg`	`code`	Significado sugerido
`doc:assets:timeout`	`408`	Módulo de documento no cargó a tiempo
`doc:sdk:camera:unresponsive`	`408`	Cámara no respondió
`doc:sdk:camera:abort`	`422`	Captura de documento cancelada o incompleta
`doc:sdk:unknown`	`500`	Error del módulo de documento
`doc:response:empty`	`417`	Sin imagen de documento

Ubicación

`msg`	`code`	Significado sugerido
`location:unknown`	`500` / `417`	No se obtuvo ubicación

Nota

La información puede variar según los challenges configurados al momento de crear el proceso biométrico.
En integraciones frontend, evite basar decisiones críticas solo en las imágenes de process_data expuestas en el cliente.
Ante un msg no listado, contacte a soporte con el id del proceso y su tipo de integración.