Biometria e documentos

Use estes serviços para extrair dados de documentos, comparar imagens faciais, validar vivacidade e apoiar decisões de identidade em fluxos de onboarding e KYC. Eles ajudam a reduzir fraude documental, automatizar leitura de documentos e verificar se a pessoa apresentada corresponde à evidência enviada. Todos os serviços desta categoria são consumidos pelo endpoint:

POST /api/service-api

Para OCR, comece pelo guia OCR via Service API. Ele reúne os payloads de RG, CNH, cartão CNPJ, emancipação e comprovante de endereço, além do padrão de retorno limpo em result.

OCR

Extraia dados de RG, CNH, cartão CNPJ, comprovantes e documentos variáveis.

FaceMatch

Compare duas imagens faciais e leia o percentual de similaridade.

Documentoscopia

Processe documento, imagem e selfie em fluxos de análise documental.

Quando usar

Use estes serviços quando precisar:

extrair dados de documentos por OCR;
comparar imagens de rosto com FaceMatch;
consultar score biométrico;
executar documentoscopia digital e consultar o resultado depois.

Serviços disponíveis

Serviço	Código `service`	Uso principal
OCR React	`SERVICE_OCR`	Lê RG/CIN, CNH, OAB, RNE/CRNM, passaporte ou identifica automaticamente e retorna campos limpos dentro de `result`
OCR de cartão CNPJ	`SERVICE_OCR_CNPJ_CARD`	Extrai CNPJ e texto OCR do cartão CNPJ
OCR de comprovante de endereço	`SERVICE_OCR_PROOF_OF_ADDRESS`	Extrai nome, endereço, datas e valores quando encontrados
OCR de emancipação	`SERVICE_OCR_EMANCIPATION`	Lê documentos variáveis de emancipação e retorna texto, campos objetivos e análise
FaceMatch	`SERVICE_FACE_MATCH`	Compara duas imagens e retorna status e percentual de similaridade facial
Score biométrico	`SERVICE_DATAVALID_CNH`	Compara CPF e selfie com bases oficiais e retorna similaridade
Validação de CNH no DataValid	`SERVICE_DATAVALID_CNH`	Valida dados de CNH com apoio do validação documental
Documentoscopia digital	`SERVICE_DIGITAL_DOCUMENTOSCOPY`	Processa documento, extrai dados e executa FaceMatch quando houver selfie
Resultado da documentoscopia	`SERVICE_DIGITAL_DOCUMENTOSCOPY_CONSULT`	Consulta o resultado de uma documentoscopia usando a chave enviada na criação

Documentos suportados no OCR

Documento	Valor
CNH	`CNH`
RG	`RG`
RG novo	`NEWRG`
RNE	`RNE`
Cartão CPF	`CARTAOCPF`
Passaporte	`PASSPORT`
CRLV	`BR_CAR_LICENCE`
Comprovante de luz	`LIGHTRECEIPT`
Carteira de trabalho	`CTPS`

Exemplo rápido

Comparação facial entre duas imagens:

curl --location '{base_url}/api/service-api' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "service": "SERVICE_FACE_MATCH",
    "image1": "base64",
    "image2": "base64"
  }'

Payload:

{
  "service": "SERVICE_FACE_MATCH",
  "image1": "base64",
  "image2": "base64"
}

Resposta esperada:

{
  "result": {
    "status": "Face picture match",
    "similarity": 99.95
  },
  "status": {
    "code": 200,
    "message": "Success"
  }
}

Boas práticas

Envie imagens nítidas, sem cortes no documento ou no rosto.
Use image1Url e image2Url quando as imagens já estiverem hospedadas em URL acessível pelo serviço.
Para documentos com frente e verso, envie as duas imagens quando disponível.
Combine OCR e FaceMatch quando o fluxo exigir validação de identidade com maior robustez.

Para campos, exemplos completos e responses, consulte a API Reference ou o Catálogo técnico de Pessoa Física.

Primeiros passos

Suporte e referência

Fluxos principais

POST /api/service-api

Pessoas

Empresas

Catálogo técnico

Biometria e documentos

Biometria e documentos

OCR

FaceMatch

Documentoscopia

Quando usar

Serviços disponíveis

Documentos suportados no OCR

Exemplo rápido

Boas práticas

​Biometria e documentos

OCR

FaceMatch

Documentoscopia

​Quando usar

​Serviços disponíveis

​Documentos suportados no OCR

​Exemplo rápido

​Boas práticas

Biometria e documentos

Quando usar

Serviços disponíveis

Documentos suportados no OCR

Exemplo rápido

Boas práticas