> ## 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.

# Configuração

> Consulte as saídas, respostas e motivos de falha da Biometria Facial.

## Saídas

### Sucesso

> [accordion] Biometria Facial aprovada
>
> Confirma uma verificação facial bem-sucedida.
>
> **Variável:** `approved`
>
> **Estrutura da resposta:**
>
> ```json theme={null}
> {
>   "document_response": { "document_check": { "skipped": true, "reason": "not_in_biometric_flow" } },
>   "liveness_response": { "result": "APROVADO", "url_selfie_image": "URL da selfie aprovada" },
>   "facematch_response": { "facematch_result": "approved", "facematch_confidence": 97.4, "threshold": 80 },
>   "gov_response": { "gov_entity_data": "Dados do Registro Civil ou referência omitida" },
>   "reporte_de_biometria": { "report": "URL do relatório web", "report_pdf": "URL do relatório PDF" }
> }
> ```
>
> **Resposta por experiência:**
>
> > [tab] Foto do 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": "APROVADO" } },
> >   "document_response": { "document_check": { "skipped": true, "reason": "not_in_biometric_flow" } }
> > }
> > ```
> >
> > A imagem vem do Registro Civil do Equador depois da validação do documento e do código dactilar.
>
> > [tab] Foto do nó ou 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" } }
> > }
> > ```
> >
> > A imagem é `referenceImageUrl`, enviada pelo nó Biometria ou recuperada do **Memory**. O usuário faz somente a prova de vida.
>
> Os campos importantes são `liveness_response`, `facematch_response`, `gov_response`, `reporte_de_biometria` e os dados de auditoria do dispositivo.

### Erros

> [accordion] Processo abandonado
>
> O usuário saiu antes de concluir. **Variável:**`incomplete`.

> [accordion] Biometria Facial rejeitada
>
> A prova de vida ou comparação facial falhou. **Variável:**`reject`.

> [accordion] Erro no processo
>
> Ocorreu um erro durante a experiência. **Variável:**`error`.

### Motivos de falha

| Situação | `failure_step` | `failure_reason` |
| - | - | - |
| Tentativas do documento esgotadas | `document_government` | `gov_identity_max_attempts` |
| Limite do Registro Civil | `document_government` | `gov_identity_rate_limited` |
| Os rostos não coincidem | `facematch` | `facematch_failed` |
| Referência indisponível | `facematch` | `reference_image_unavailable` |
| Sessão expirada | `session` | `session_expired` |

## Retomar e expirar a sessão

Se o usuário fechar e reabrir o link enquanto a sessão estiver válida, continuará de onde parou e manterá as tentativas usadas. Quando expirar, aparece **Este link não está mais disponível** e o webhook inclui `failure_step: "session"` e `failure_reason: "session_expired"`. É necessário gerar um novo link.


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