Configuración

Outputs

Éxito

Biometría Facial Aprobada

Confirma la verificación facial exitosa.Variable: approvedDescripción: Biometría Facial AprobadaEstructura de respuesta (JSON):

{
  "document_response": {
    "document_check": {
      "skipped": true,
      "reason": "not_in_biometric_flow"
    }
  },
  "liveness_response": {
    "result": "APROBADO",
    "url_selfie_image": "URL de la selfie aprobada"
  },
  "facematch_response": {
    "facematch_result": "approved",
    "facematch_confidence": "Porcentaje de coincidencia (0-100)",
    "threshold": "Umbral configurado"
  },
  "gov_response": {
    "gov_entity_data": "Datos del Registro Civil o referencia omitida"
  },
  "reporte_de_biometria": {
    "report": "URL del reporte de biometría (web)",
    "report_pdf": "URL del reporte de biometría (PDF)"
  },
  "device_info": {
    "userAgent": "Cadena del agente de usuario",
    "browser": "Navegador",
    "operatingSystem": "Sistema operativo",
    "ipAddress": "Dirección IP",
    "location": {
      "latitude": "Latitud si el usuario otorga permiso",
      "longitude": "Longitud si el usuario otorga permiso"
    },
    "timestamp": "Marca de tiempo del dispositivo"
  }
}

Response según la experiencia:

Foto del Registro Civil
Foto provista en el nodo o Memory

{
  "verification_success": "true",
  "facematch_response": {
    "facematch_result": "approved",
    "facematch_confidence": 97.4,
    "threshold": 80
  },
  "gov_response": {
    "gov_entity_data": { "gov_result": "APROBADO" }
  },
  "document_response": {
    "document_check": { "skipped": true, "reason": "not_in_biometric_flow" }
  }
}

La foto de referencia proviene del Registro Civil de Ecuador, después de validar la cédula y el código dactilar.

{
  "verification_success": "true",
  "facematch_response": {
    "facematch_result": "approved",
    "facematch_confidence": 97.4,
    "threshold": 80
  },
  "gov_response": {
    "gov_entity_data": { "skipped": true, "reason": "face_reference_client" }
  },
  "document_response": {
    "document_check": { "skipped": true, "reason": "not_in_biometric_flow" }
  }
}

La foto de referencia es referenceImageUrl, entregada desde el nodo Biometría o recuperada desde Memory. El usuario solo realiza la prueba de vida.

Campos importantes:

document_response: indica que la etapa documental fue omitida; no incluye imágenes de documento.
liveness_response: resultado y URL de la selfie usada para la prueba de vida.
facematch_response: resultado, confianza y umbral de la comparación facial.
gov_response: datos del Registro Civil en el modo Foto del Registro Civil o etapa omitida en Foto provista en el flujo.
reporte_de_biometria: URLs del reporte web y PDF.
device_info: datos del dispositivo y ubicación para auditoría, si el usuario concede permiso.

Definición de variables:

document_response: document_check.skipped, document_check.reason.
liveness_response: result, url_selfie_image.
facematch_response: facematch_result, facematch_confidence, threshold.
gov_response: gov_entity_data cuando se usa la foto del Registro Civil.
reporte_de_biometria: report, report_pdf.
device_info: navegador, sistema operativo, IP, ubicación y timestamp.

Response en caso de éxito: verification_success: "true", facematch_result: "approved" y el webhook vuelve al flujo o al cliente.

Errores

Proceso abandonado

El usuario abandonó el proceso antes de completarlo.Variable: incompleteDescripción: Proceso abandonado

Biometría Facial Rechazada

La prueba de vida o la comparación facial falló.Variable: rejectDescripción: Biometría Facial Rechazada

Error en el proceso

Ocurrió un error durante la ejecución de la experiencia.Variable: errorDescripción: Error en el proceso

Motivos de fallo

Situación	`failure_step`	`failure_reason`	`step_name`
Intentos de cédula agotados	`document_government`	`gov_identity_max_attempts`	`gov`
Límite del Registro Civil	`document_government`	`gov_identity_rate_limited`	`gov`
La cara no coincide	`facematch`	`facematch_failed`	`facematch`
No se pudo leer la foto de referencia	`facematch`	`reference_image_unavailable`	`facematch`
Fallo en la prueba de vida	`liveness`	Igual que en Biometría completa	`liveness`
La sesión expiró	`session`	`session_expired`	—

Retomar y expirar la sesión

Si el usuario cierra y vuelve a abrir el enlace mientras la sesión sigue vigente, continúa donde quedó y conserva los intentos usados. Cuando expira, se muestra Este enlace ya no está disponible y se envía un webhook con failure_step: "session" y failure_reason: "session_expired". Después de expirar hay que generar un enlace nuevo.

Siguiente: Personalizar la experiencia

Configura las reglas, la marca, las pantallas y los mensajes.

Empezando

Desarrollador

Jelou CLI

Mensajería Outbound

Bandeja de entrada

Marketplace

Canales

Facturación

Configuración

Outputs

Éxito

Errores

Motivos de fallo

Retomar y expirar la sesión

Siguiente: Personalizar la experiencia

​Outputs

​Éxito

​Errores

​Motivos de fallo

​Retomar y expirar la sesión

Siguiente: Personalizar la experiencia

Outputs

Éxito

Errores

Motivos de fallo

Retomar y expirar la sesión