Verificação Completa
Realiza o fluxo completo de KYC: OCR do documento + Comparação Facial (Liveness).
Este é o endpoint principal. Ele recebe a foto do documento e a selfie, processa a extração de dados (OCR) e realiza a comparação biométrica facial.
Nota: Este endpoint aguarda o processamento completo (pode levar até 60 segundos). Recomendamos configurar um timeout alto no seu cliente HTTP ou utilizar o fluxo de Webhook para atualizações assíncronas.
POST
/api/verifiky/processar
Custo: 1 Crédito
O crédito é consumido ao realizar a extração OCR e comparação facial com sucesso.
Parâmetros (Query String & Body)
| Campo | Local | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
| user_reference | Query | string | Sim | ID único do usuário no seu sistema. Ex: ?user_reference=1203. Essencial para vincular o Webhook. |
| documento | Body | file | Sim | Foto legível do RG (Frente) ou CNH. Formatos: JPG, PNG. Máx: 10MB. |
| foto_ao_vivo | Body | file | Sim | Selfie tirada no momento. Deve conter apenas um rosto para comparação biométrica. |
| tipo_documento | Body | string | Não | Dica para o motor de OCR: rg, cnh ou cpf. Padrão: rg. |
Critérios de Aprovação
- Dados Essenciais: O OCR deve conseguir ler Nome, Data de Nascimento e CPF/RG.
- Biometria: A distância facial entre a selfie e a foto do documento deve ser menor que o threshold (0.55).
- Validade: A Data de Nascimento deve ser válida (no passado).
Resposta de Sucesso (200 OK)
{
"success": true,
"verificado": true,
"status": "approved", // ou "pending" / "rejected"
"verificacao_id": 150,
"dados_extraidos": {
"nome": "Fulano DA SILVA",
"cpf": "000.000.000-00",
"data_nascimento": "1976-09-04",
"rg": "12.345.678-9"
},
"face_distance": 0.42, // Quanto menor, mais parecido
"ocr_error": null
}