# Validação facial Serpro (CPF + selfie)

Comparação biométrica facial na Serpro Datavalid com apenas CPF e imagem de selfie (base64 ou URL), sem consulta a dados cadastrais externos.

- **Identificador:** `pessoas/validacao-facial-serpro-cpf-selfie`
- **Categoria:** Documentos e biometria
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/validacao-facial-serpro-cpf-selfie`
- **Preço de tabela:** R$ 3,160 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/validacao-facial-serpro-cpf-selfie

## Quando usar

Envia a selfie para o S3 e chama a API Serpro Datavalid v4 (pf-facial) com payload mínimo: apenas CPF e biometria facial. Não utiliza dados cadastrais adicionais no envio.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CPF da pessoa, com ou sem máscara. |
| `selfie_img` | sim | Selfie em base64 |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `status` | texto |
| `rfb_existe` | booleano |
| `cnh_existe` | booleano |
| `biometria_facial.face_url` | texto |
| `biometria_facial.presigned_face_url` | texto |
| `biometria_facial.disponivel` | booleano |
| `biometria_facial.probabilidade` | texto |
| `biometria_facial.similaridade` | número |
| `biometria_facial.probabilidade_nivel` | texto |
| `biometria_facial.similaridade_percentual` | número |
| `stamp` | texto |
| `timestamp` | data |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Validação facial Serpro (CPF + selfie)",
  "query_slug": "validacao-facial-serpro-cpf-selfie",
  "data": {
    "status": "texto",
    "rfb_existe": false,
    "cnh_existe": false,
    "biometria_facial": {
      "face_url": "texto",
      "presigned_face_url": "texto",
      "disponivel": false,
      "probabilidade": "texto",
      "similaridade": 0,
      "probabilidade_nivel": "texto",
      "similaridade_percentual": 0
    },
    "stamp": "texto",
    "timestamp": "2026-01-01"
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "3.160"
}
```