Skip to content

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:camera:freshness_timeout 408 Timeout en verificación de autenticidad de la imagen
selfie:sdk:camera:landscape 400 Dispositivo en orientación horizontal en móvil
selfie:sdk:camera:multiple_faces 422 Más de un rostro detectado
selfie:sdk:camera:face_distance 422 Rostro demasiado cerca o lejos de la cámara
selfie:sdk:camera:framerate 422 Framerate de cámara insuficiente
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

Documento — lectura del chip por NFC

Aplica a los procesos que incluyen alguna validación match:epassport:* (véase el Catálogo de challenges).

msg code Significado sugerido
nfc:unsupported 404 El dispositivo o la versión del SDK no permiten leer el chip
nfc:sdk:<texto> 400 Error informado por el SDK durante la lectura (véase la tabla siguiente)
nfc:sdk:invalid_response 500 No se pudo interpretar la respuesta del SDK

nfc:unsupported se emite cuando el proceso no encuentra ningún puente de lectura NFC en el entorno en que se abrió: un navegador web, o una versión del SDK móvil anterior a la 0.0.8. Un dispositivo sin hardware NFC no produce este valor: en ese caso el SDK sí está presente y responde con nfc:sdk:device:hardware.

Errores informados por el SDK móvil (nfc:sdk:<texto>)

Cuando el puente de lectura existe, el <texto> es el identificador que envía el SDK móvil, reenviado sin modificar. Procede de un conjunto acotado de valores:

msg code Situación informada por el SDK
nfc:sdk:device:hardware 400 El dispositivo no está en condiciones de leer el chip: sin hardware NFC, o con el NFC desactivado —tanto al solicitarse la lectura como si el usuario lo apaga mientras la pantalla espera el documento—.
nfc:sdk:client:request 400 La interfaz solicitó la lectura con un JSON de petición mal formado.
nfc:sdk:client:date 400 dateOfBirth o dateOfExpiry no son fechas MRZ válidas en formato YYMMDD (ICAO 9303). El SDK lo valida antes de activar el lector, de modo que el error no aparece recién después de que el usuario haya acercado el documento.
nfc:sdk:client:document 400 El documento acercado no admite la lectura NFC, o la lectura del chip falló (por ejemplo, datos BAC/PACE que no corresponden al documento, o documento retirado antes de que terminara la lectura).

Los errores de lectura NFC abortan la captura

Todos los valores anteriores, junto con nfc:unsupported y nfc:sdk:invalid_response, se entregan a su aplicación con result: false y cierran la captura, sin reintentar dentro del mismo flujo. Esto no da por finalizado el proceso de validación de identidad ni consume un intento: un proceso solo se resuelve cuando las capturas llegan completas al backend y este determina si la persona fue validada o no.

Ubicación

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

Errores nativos de los SDK móviles (sdk:*)

A diferencia del resto del catálogo, estos valores no los origina el proceso: los genera el propio SDK de Android antes de iniciar la verificación, y los entrega directamente a su aplicación.

msg code Significado sugerido
sdk:camera:denied 401 El usuario denegó el permiso de cámara
sdk:endpoint:invalid 403 El endPoint configurado no es un destino permitido
sdk:idsession:invalid 400 El idSession no cumple el formato esperado

Los dos primeros ocurren antes de que la verificación comience, por lo que no consumen un intento. sdk:endpoint:invalid y sdk:idsession:invalid indican un problema de configuración de la integración, no una acción del usuario: reintentar no los resuelve.

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.