Leia o documento e receba o CPF já conferido
Campo de CPF digitado é onde o cadastro erra e onde o fraudador escolhe o número que lhe convém. Aqui o titular fotografa o documento dentro do widget, e o que chega ao seu servidor são os dados impressos nele, lidos e organizados, sem ninguém redigitar nada.
Lê o documento (RG ou CNH) por OCR e extrai nome, CPF, número do documento e nascimento.
- Documento (OCR)
"status": "approved"Para quem é
Serve a toda empresa que precisa saber quem está do outro lado antes de liberar conta, limite ou serviço regulado: bancos digitais, carteiras, correspondentes, plataformas de trabalho sob demanda e locadoras. É o primeiro passo do KYC de pessoa física e a origem do dado que o restante da verificação consome.
Também serve a quem quer consultar bases cadastrais, listas de sanções ou situação de crédito sem abrir a porta para o CPF de um terceiro. Esses módulos só aceitam o número que saiu do documento fotografado, nunca um campo preenchido no navegador, e por isso pedem esta leitura no mesmo flow.
Aceita os documentos que o brasileiro de fato carrega na carteira: o RG, a Carteira Nacional de Habilitação e a Carteira de Identidade Nacional. A CNH entra aqui como documento de identidade com foto, lida do mesmo jeito que os outros dois.
O que você recebe
O retorno traz name, cpf, birth_date e o bloco document com tipo, número e validade, mais a filiação quando o documento a imprime. O CPF passa pelo dígito verificador ainda na leitura: um número que não fecha volta como null, e o seu sistema nunca grava um CPF inválido achando que é bom.
Documento vencido não barra ninguém. O campo expired responde em três estados, vencido, vigente ou impossível de afirmar, e aceitar um RG antigo é decisão da sua política. Na CIN, o impresso é confrontado com a zona de leitura mecânica, e a divergência leva a verificação para review com o motivo identity_document_mrz_review.
A imagem do documento não viaja no webhook. Ela fica guardada no painel, visível só para os papéis que você autorizar, e o payload leva apenas os campos extraídos. No resumo checks, esta leitura e a comparação facial aparecem juntas na chave identity.
Os três módulos base do KYC de pessoa (cpf_ocr, face e liveness): o que cada um entrega e o payload de resultado no webhook.
O módulo se chama cpf_ocr no flow e no webhook.
Como entra no seu flow
Nada de upload do seu lado: o widget conduz a captura, e a imagem sai do aparelho do titular sem passar pelo seu front nem pelo seu backend. Foto ilegível não reprova ninguém: a sessão pede um novo envio, e só a leitura bem-sucedida segue adiante.
Combine com a comparação facial e a prova de vida para fechar o trio de identidade: o documento diz quem é, a comparação diz que ele pertence a quem está na câmera, e a prova de vida diz que há alguém real ali. Com a validação de CPF na fonte oficial no mesmo flow, nome e nascimento passam a vir dela, e a leitura fica como reserva.
O grupo do módulo
Documento, selfie e prova de vida capturados pelo widget, com o resultado de cada etapa no seu webhook.
Onde ele entra
Preço
R$ 0,16por verificação
O valor é lido do mesmo catálogo que o painel usa para montar um flow, somando os módulos que este exige, se exigir. Ver preços.
Perguntas frequentes
Ler a documentaçãoE se o titular for estrangeiro, com passaporte?
Para passaporte ou identidade emitida fora do Brasil, o módulo certo é o Documento de Viagem, que ocupa o lugar deste no flow. Os dois leem a mesma foto e são o mesmo passo de captura, por isso não convivem na mesma configuração.
O que acontece se um reflexo trocar um algarismo do CPF?
O campo cpf volta null. Como o dígito verificador é recalculado na hora, um algarismo trocado não vira um CPF errado gravado no seu banco: o dado simplesmente deixa de ser entregue como confiável.
Consigo testar os desfechos antes de ir para produção?
Sim. No sandbox, o sufixo do campo document do submit escolhe o cenário: 41 simula a divergência entre o impresso e a zona mecânica, e 45 aprova com documento vencido. Assim a sua fila de revisão e a sua régua de validade ficam prontas antes do primeiro cliente real.
Crie a conta, monte um flow com este módulo e rode a verificação inteira no ambiente de teste, sem consumir saldo.
