Serviços / Biometria

Face match: documento e selfie

POST/api/v1/oracle/face/verify

Compara o rosto do documento com uma selfie e responde se são a mesma pessoa, com a distância medida e o limiar usado.

Envie doc_photo e selfie — foto, HEIC ou PDF, inclusive a CNH digital. Com crop_rg e crop_selfie, os rostos também são recortados antes de comparar.

Processado em motor próprio, sem envio da imagem a terceiros. Não faz prova de vida.

Fonte: Motor próprio · tempo real

Parâmetros

doc_photofileObrigatório

Foto ou PDF do documento (CNH, RG, CNH digital).

file
selfiefileObrigatório

Selfie da pessoa.

file
crop_rgbooleanOpcional

Recorta o rosto do documento antes de comparar.

false
query
crop_selfiebooleanOpcional

Recorta o rosto da selfie antes de comparar.

false
query

Campos da resposta

Mesma pessoa

verified

Os dois rostos são da mesma pessoa.

boolean

Distância medida

distance

number

Limiar

threshold

Limiar usado. Abaixo dele, `verified` é verdadeiro.

number

Comparação que decidiu

plan

Qual comparação decidiu: `original` (imagens inteiras) ou `recorte` (rostos recortados).

string

Detalhe

detail

string

Exemplo de resposta

Modelo de resposta: FaceVerifyOutput
JSON · response
{
  "success": true,
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": null,
  "data_count": 1,
  "data": [
    {
      "verified": true,
      "distance": 0.31,
      "threshold": 0.68,
      "plan": "original",
      "detail": null
    }
  ]
}

Casos de uso

Onboarding com selfie

Confirmar que quem está abrindo a conta é o titular do documento apresentado.

Reautenticação em operação sensível

Pedir selfie antes de transferência alta ou troca de dispositivo e comparar com o documento já cadastrado.