Introdução
Validar um CPF responde a uma pergunta: esse número existe e pertence a quem? A consulta devolve nome, gênero e data de nascimento do titular. Verificar a pessoa responde a outra: quem está digitando esse número agora é mesmo o titular? A primeira checagem lida com dados; a segunda lida com uma pessoa na frente de uma câmera. Confundir as duas é a origem de muita fraude de identidade que passa por "CPF válido".
Neste artigo, vamos separar o que a consulta de CPF resolve do que só a verificação de identidade (KYC) resolve, e propor um guia de decisão por nível de risco: cadastro simples, free tier ou trial, fintech e pagamento de alto valor. A CPFHub.io oferece a consulta de CPF por API e a verificação de identidade com prova de vida, liberada em todos os planos.
O que a consulta de CPF confirma
Uma consulta GET /cpf/{cpf} na CPFHub.io confirma que o CPF existe e retorna os dados cadastrais do titular:
-
Existência -- CPF não encontrado é um sinal imediato de dado inventado, e não consome crédito.
-
Nome -- permite comparar com o que a pessoa digitou no formulário.
-
Gênero e data de nascimento -- permitem checar consistência com o restante do cadastro.
Essa consulta não traz a situação cadastral nem informação de óbito. Quando você precisa saber se o CPF está regular, existe a Consulta em Tempo Real, que cruza CPF e data de nascimento direto na Receita Federal. Para a diferença entre checar o formato e consultar de fato, veja validação sintática x validação real de CPF via API e validação x consulta de CPF.
O que ela não consegue provar
Os dados de um CPF são, em boa parte, informação que circula: vazamentos, documentos de parentes, cadastros antigos. Quem tem o CPF e a data de nascimento de outra pessoa passa em qualquer consulta de dados, porque os dados estão corretos. O que está errado é quem os apresenta. Nenhuma consulta de CPF sabe se há uma pessoa real do outro lado, nem se ela é o titular.
O que a verificação de identidade (KYC) confirma
A verificação de identidade da CPFHub.io junta três checagens em um fluxo só, feito pelo celular:
-
Prova de vida (liveness) -- confirma que há uma pessoa real e ao vivo na frente da câmera. A análise recusa foto impressa, foto ou vídeo em tela, máscaras e vídeo injetado no lugar da câmera. O fluxo só aceita câmera ao vivo, sem upload de imagem pronta.
-
Leitura do documento -- RG, CNH (frente e verso) e passaporte são fotografados na hora, e o sistema lê nome, número do documento, CPF, nascimento e validade por OCR.
-
Comparação facial -- o rosto da selfie é comparado com a foto do documento. Abaixo do limite, a verificação é reprovada; perto do limite, vai para revisão humana em vez de ser aprovada no automático.
O resultado chega como aprovado, em revisão ou reprovado, com os motivos, por webhook assinado e no painel. Opcionalmente, o nome e o nascimento lidos do documento podem ser cruzados com o CPF na base da CPFHub.io. Detalhes na página de verificação de identidade.
Limites que vale conhecer
Verificação de identidade é uma camada, não uma garantia absoluta. Segundo a própria página do produto:
-
Os dados do documento são lidos por OCR, mas não são conferidos em base do governo.
-
Ela não consulta a situação do CPF na Receita. Para isso, use a Consulta em Tempo Real.
-
Ainda não há perícia do documento: divergências e leituras falhas vão para revisão.
-
A CNH Digital ainda não é aceita, porque um print da tela não prova que ela é autêntica.
-
A política de aceite e as obrigações do seu setor continuam sendo da sua empresa.
Na prática, isso significa combinar as camadas, não escolher uma. O artigo biometria vs. validação de CPF compara as duas tecnologias em detalhe; aqui o foco é decidir quando cada uma entra.
Comparação direta
| Pergunta | Consulta de CPF | Verificação de identidade (KYC) |
|---|---|---|
| O CPF existe? | Sim | Não é o objetivo (o CPF é lido do documento) |
| Qual o nome do titular? | Sim | Lido do documento por OCR |
| Há uma pessoa real na câmera? | Não | Sim, pela prova de vida |
| O rosto é o do documento? | Não | Sim, pela comparação facial |
| Situação cadastral na Receita? | Não (use a Consulta em Tempo Real) | Não |
| Funciona em tempo de digitação? | Sim | Não, exige um fluxo de câmera |
| Atrito para o usuário | Nenhum | Alguns minutos no celular |
Guia de decisão por nível de risco
A pergunta certa não é "qual tecnologia é melhor", e sim "quanto custa errar nesse cadastro". Quanto maior a perda possível, mais camadas.
Nível 1: cadastro simples
Newsletter, conta de leitor, comentário, lista de espera. O prejuízo de um cadastro falso é baixo.
-
Recomendação -- validação do formato do CPF no front-end e, se o campo for obrigatório, uma consulta por API para barrar CPF inexistente e comparar o nome.
-
KYC? -- não. O atrito derrubaria a conversão sem reduzir risco relevante.
Nível 2: free tier e trial
Planos gratuitos e testes grátis atraem abuso: uma pessoa cria várias contas para consumir o benefício repetidas vezes, muitas vezes com CPFs de terceiros ou inventados. O prejuízo é pequeno por conta, mas se acumula.
-
Recomendação -- consulta de CPF no cadastro, uma conta por CPF, e comparação entre o nome retornado e o informado. Isso já elimina CPF inventado e duplicidade simples.
-
KYC? -- em geral não no cadastro. Reserve para o gatilho de risco: um pico de cadastros com padrão suspeito, ou o momento em que o usuário tenta converter o benefício em algo de valor (por exemplo, sacar, vender ou pedir aumento de limite).
Para o desenho do cadastro nesses cenários, veja como começar com uma API de CPF grátis e o custo de não validar CPFs.
Nível 3: fintech, crédito e contas digitais
Abertura de conta, concessão de crédito, carteira digital, cripto, apostas. Aqui o CPF de terceiros é o vetor principal de fraude de identidade, e as obrigações regulatórias do seu setor entram na conta.
-
Recomendação -- consulta de CPF no início do funil (barra o dado inexistente barato e rápido), verificação de identidade com prova de vida, documento e comparação facial antes de liberar a conta, e Consulta em Tempo Real quando a política exigir a situação cadastral.
-
KYC? -- sim, como regra. A consulta filtra; o KYC prova.
Referências úteis: onboarding digital em fintechs e KYC no Brasil: quais setores são obrigados.
Nível 4: pagamento ou saque de alto valor
Transferência grande, primeiro saque, troca de dados de recebimento, venda de bem de alto valor. O risco aqui é duplo: o cadastro pode ter sido feito por outra pessoa, e a pessoa que opera hoje pode não ser a que se cadastrou.
-
Recomendação -- tudo do nível 3, mais uma nova verificação de identidade no momento da operação sensível (não apenas no cadastro), com revisão humana ligada para casos limítrofes.
-
KYC? -- sim, e repetido no ponto de maior risco. Um cadastro aprovado há meses não prova quem está na conta hoje.
Resumo do guia
| Cenário | Consulta de CPF | Tempo Real (situação) | KYC com prova de vida |
|---|---|---|---|
| Cadastro simples | Opcional | Não | Não |
| Free tier ou trial | Sim | Não | Só por gatilho de risco |
| Fintech, crédito, conta digital | Sim | Conforme a política | Sim |
| Pagamento ou saque de alto valor | Sim | Conforme a política | Sim, na operação |
A consulta como primeira camada do fluxo
Mesmo quando o KYC é obrigatório, consultar o CPF antes é uma boa prática: CPF inexistente ou nome divergente nem precisa chegar ao fluxo de câmera, e a verificação mais cara e mais pesada fica reservada a quem passou pelo filtro barato. O exemplo abaixo faz a consulta com timeout em Node.js.
// Primeira camada: consulta de CPF antes de acionar o KYC
async function consultarCpf(cpf) {
const res = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {
method: "GET",
headers: {
"x-api-key": process.env.CPFHUB_API_KEY, // SUA_CHAVE_DE_API
"Accept": "application/json",
},
signal: AbortSignal.timeout(5000), // timeout de 5 segundos
});
if (!res.ok) {
// 403: créditos esgotados | 429: limite por minuto | demais: tratar como falha
throw new Error(`Consulta falhou: HTTP ${res.status}`);
}
const { data } = await res.json();
return data; // { cpf, name, gender, birthDate, ... }
}
// 52998224725 e um CPF ficticio de exemplo
consultarCpf("52998224725")
.then((d) => {
const nomeBate = d.name.toLowerCase() === "maria exemplo".toLowerCase();
console.log(nomeBate ? "Segue para o proximo nivel" : "Revisar cadastro");
})
.catch((e) => console.error(e.message));
O resultado da consulta decide o próximo passo: CPF não encontrado ou nome divergente vai para recusa ou revisão; CPF consistente segue para o nível de verificação que o risco do cenário exige. Em caso de timeout ou erro, defina a regra de antemão (por exemplo, tentar de novo e, depois, encaminhar para revisão) em vez de aprovar por padrão.
Erros comuns na decisão
-
Tratar "CPF válido" como "pessoa verificada" -- o dado correto na mão da pessoa errada passa em qualquer consulta.
-
Exigir KYC em todo cadastro -- aumenta o abandono em fluxos de baixo risco sem reduzir perda relevante.
-
Verificar só no cadastro -- operações de alto valor pedem confirmação no momento em que acontecem.
-
Aprovar por padrão quando o serviço falha -- falha de consulta ou de verificação deve ir para nova tentativa ou revisão, nunca para aprovação automática.
-
Ignorar a LGPD -- selfie e documento são dados biométricos e sensíveis. Colete o necessário, registre o consentimento e defina papéis claros entre controlador e operador.
Perguntas frequentes
Validar o CPF já conta como KYC?
Não. A consulta confirma que o CPF existe e traz os dados do titular, mas não prova que quem está se cadastrando é essa pessoa. KYC exige evidência da identidade de quem está na tela, como documento, selfie e prova de vida.
A consulta de CPF informa a situação cadastral?
A Consulta Simples (GET /cpf/{cpf}) retorna nome, gênero e data de nascimento, sem situação cadastral. Para a situação na Receita Federal, a CPFHub.io tem a Consulta em Tempo Real.
Preciso de KYC no meu plano gratuito ou trial?
Em geral, não no cadastro. Uma consulta de CPF com regra de uma conta por CPF resolve a maior parte do abuso. Use KYC como gatilho quando houver sinal de risco ou quando o usuário for converter o benefício em algo de valor.
A prova de vida impede deepfake?
Ela recusa foto, vídeo em tela, máscaras e vídeo injetado, mas nenhuma tecnologia é infalível. Por isso casos limítrofes vão para revisão humana. Veja também deepfakes e fraude documental.
A verificação de identidade da CPFHub.io já está disponível?
Está liberada em todos os planos, inclusive no Grátis, e custa 5 créditos por verificação concluída. Veja a página de verificação de identidade.
-
KYC no Brasil: quais setores são obrigados a validar CPF por lei
-
Onboarding digital em fintechs: validar CPF em menos de 30 segundos
Conclusão
Consultar o CPF e verificar a pessoa são camadas diferentes, e o risco do cenário define quantas você precisa. Em cadastros simples, a consulta basta. Em free tier e trial, a consulta com uma conta por CPF resolve a maior parte do abuso, com KYC reservado a gatilhos de risco. Em fintech, crédito e pagamentos de alto valor, a consulta filtra e a verificação de identidade com prova de vida comprova, inclusive no momento da operação sensível.
Cadastre-se em cpfhub.io para começar com a consulta de CPF, e use a verificação de identidade quando o seu risco pedir a segunda camada.
CPFHub.io
Pronto para integrar a API?
50 créditos gratuitos para testar agora. Sem cartão de crédito. Acesso imediato à documentação.




