> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración

> Consulta los outputs, respuestas y motivos de fallo de Biometría Facial.

## Outputs

### Éxito

> [accordion] Biometría Facial Aprobada
>
> Confirma la verificación facial exitosa.
>
> **Variable:** `approved`
>
> **Descripción:** Biometría Facial Aprobada
>
> **Estructura de respuesta (JSON):**
>
> ```json theme={null}
> {
>   "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:**
>
> > [tab] Foto del Registro Civil
> >
> > ```json theme={null}
> > {
> >   "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.
>
> > [tab] Foto provista en el nodo o Memory
> >
> > ```json theme={null}
> > {
> >   "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

> [accordion] Proceso abandonado
>
> El usuario abandonó el proceso antes de completarlo.
>
> **Variable:** `incomplete`
>
> **Descripción:** Proceso abandonado

> [accordion] Biometría Facial Rechazada
>
> La prueba de vida o la comparación facial falló.
>
> **Variable:** `reject`
>
> **Descripción:** Biometría Facial Rechazada

> [accordion] Error en el proceso
>
> Ocurrió un error durante la ejecución de la experiencia.
>
> **Variable:** `error`
>
> **Descripció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.

> [card] [Siguiente: Personalizar la experiencia](https://docs.jelou.ai/guides/integraciones/identidad/biometria-facial/personalizar.md)
>
> Configura las reglas, la marca, las pantallas y los mensajes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.