Confira se o documento bate com o cadastro oficial
Ter o nome do documento e o nome do cadastro oficial no mesmo webhook ainda deixa o trabalho de comparar para o seu time, com acento, abreviação e sobrenome de casada no meio. Este módulo faz a comparação e entrega só o veredito, por campo: bate, não bate ou não dá para afirmar.
Confere o nome e o nascimento lidos do documento contra o cadastro oficial que a Validação CPF do mesmo fluxo já consultou, e devolve o veredito campo a campo: bate, não bate, ou não foi possível conferir. Também responde se o cadastro registra o titular como falecido. Não faz consulta nova e não devolve dado de cadastro: a resposta é o produto. Não confere filiação nem gênero, por decisão. Informativo: divergência de nome tem causa legítima (casamento, divórcio, mudança de prenome) e nunca reprova sozinha.
- Documento (OCR)
- Face Match
- Liveness
- Coerência Cadastral
"status": "approved"Para quem é
Serve a quem precisa da conferência e não quer o dado: operações que pela minimização da LGPD preferem não guardar cadastro de terceiro, times de risco que querem uma regra simples no motor, fintechs que tratam documento adulterado como o sinal mais caro do cadastro. O resultado cabe numa coluna e não espalha nome e nascimento oficiais pelo seu banco.
Serve ainda a quem precisa de um olho a mais sobre documento montado. Quem troca a data de nascimento no papel para passar numa regra de idade, ou imprime outro nome sobre um CPF real, produz exatamente a divergência que este módulo aponta. E a conferência de vida responde se o cadastro registra o titular como falecido, a única situação que contradiz a prova de vida recém-aprovada.
O que você recebe
O bloco data traz verdict, que vale coherent, divergent ou indeterminate, e o mapa fields com name, birth_date e alive, cada um como match, mismatch ou not_checked. Junto vêm fields_checked, quantos campos sustentam a resposta, coverage, quais módulos a sustentaram, e name_score, a semelhança contínua dos nomes, para você aplicar a sua própria régua.
A comparação de nome tolera grafia: SOUZA e SOUSA, LUIZ e LUIS casam. Entre o que claramente bate e o que claramente diverge existe uma faixa em que o módulo não afirma nada, e é ali que caem nome de casada, nome social e sobrenome composto lido pela metade. Nessa faixa o campo sai not_checked, nunca uma divergência inventada.
O veredito viaja no mesmo evento que encerra a verificação, então a sua esteira de onboarding não ganha espera nem etapa extra para o usuário, e o resultado já está à mão quando o cadastro precisa decidir.
O módulo coerencia_cadastral compara o que o documento diz com o que o cadastro oficial diz e devolve o veredito campo a campo.
O módulo se chama coerencia_cadastral no flow e no webhook.
Como entra no seu flow
No mesmo flow, ele liga junto: Documento (OCR), Face Match, Liveness, CPF - Receita e Óbito.
O veredito é informativo e fica fora da aprovação da verificação. Divergência de nome tem causa legítima frequente, como casamento, divórcio ou troca de prenome em cartório, então o uso típico é mandar divergent para uma fila de análise sua e deixar coherent seguir. Em indeterminate, o campo reason diz o porquê.
No sandbox nada é comparado e o sufixo do documento escolhe o caminho: 02 devolve o divergente, 01 o indeterminado e 33 um coerente com cobertura parcial, com nome e sem nascimento. No resumo checks o módulo aparece com o mesmo vocabulário do campo verdict.
O grupo do módulo
Confere o CPF lido do documento nas fontes oficiais. Exigem documento, face match e prova de vida: sem isso a consulta seria sobre um CPF de terceiro.
Onde ele entra
Preço
R$ 1,89por verificação
Só é cobrado quando entrega veredito: se o cadastro não respondeu ou não trouxe nenhum campo comparável, o módulo sai do preço daquela 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çãoPor que não receber o nome oficial e comparar do meu lado?
Porque comparar nome brasileiro é mais difícil do que parece, e porque guardar o dado oficial tem custo de privacidade. Aqui você recebe a conclusão pronta, com a semelhança numérica para auditoria, e o cadastro do titular não precisa morar no seu banco.
O que faz o veredito sair indeterminado?
A fonte cadastral fora do ar, a consulta bloqueada porque a identidade não passou, ou um retorno sem nenhum campo comparável. Em qualquer desses casos fields_checked vem zerado e a conferência não entra na conta daquela verificação.
Serve de apoio para regra de idade mínima?
Serve como reforço. Se o nascimento lido do papel diverge do cadastro, a idade calculada a partir do documento perde confiança, e o seu fluxo pode exigir análise antes de liberar um produto restrito a maiores. Com match no nascimento, a data do documento ganha respaldo oficial.
Crie a conta, monte um flow com este módulo e rode a verificação inteira no ambiente de teste, sem consumir saldo.
