Integração HTTP

Como integrar a FaceID API

Gere um token HTTP no portal autenticado, crie uma verificação, entregue o link público ao usuário final e consulte o status do processamento.

1. Criando uma verificação

Crie uma nova sessão de envio usando o token HTTP gerado no portal.

POST /api/v1/partner/verifications
Authorization: Bearer SEU_TOKEN

{
  "external_reference": "USER-123",
  "name": "João da Silva",
  "cpf": "123.456.789-00"
}

2. Abrindo o link público

A resposta da criação retorna um verification_url para o navegador do usuário final.

{
  "verification_id": "ver_...",
  "verification_url": "https://seu-dominio.com/verify/TOKEN_DE_SESSAO"
}

3. Consultando o status

Depois do envio do documento e das selfies, consulte o status pela referência externa.

GET /api/v1/partner/verifications/{external_reference}
Authorization: Bearer SEU_TOKEN

{
  "status": "approved",
  "final_decision": "approved",
  "scores": {
    "ocr_name": "JOAO DA SILVA",
    "cpf_match": true,
    "name_match": true,
    "document_selfie_score": 0.93,
    "liveness_score": 0.82
  }
}