APIs de verificação de identidade (CPF): Como garantir segurança na compra online

APIs de verificação de identidade protegem compras online em duas etapas. Primeiro, uma consulta de CPF confere em ~150 ms se o número existe e se nome e data de nascimento batem com o pedido. Depois, nos pedidos de risco alto, uma verificação com selfie com prova de vida e foto do documento confirma que o comprador é de fato o titular do CPF, que é o que a consulta de dados sozinha não consegue provar. Na CPFHub.io, a API de Consulta de CPF está disponível para qualquer conta, e a Verificação de Identidade está em piloto com empresas selecionadas. Segundo o CERT.br, fraudes digitais no Brasil cresceram de forma consistente nos últimos anos.

Como funciona a verificação de identidade com CPF

A conferência de dados acontece em ~150 ms (tempo típico) durante o checkout:

1. O comprador informa o CPF no momento da compra.
2. O seu backend consulta a API com o CPF informado.
3. A API retorna nome, gênero e data de nascimento do titular.
4. O sistema cruza esses dados com as informações do pedido.
5. Com base no cruzamento, aprova, rejeita ou encaminha para uma verificação mais forte.

curl -X GET https://api.cpfhub.io/cpf/12345678909 \
    -H "x-api-key: SUA_CHAVE_DE_API" \
    -H "Accept: application/json"

Cada CPF encontrado consome 1 crédito. CPF não encontrado (404) não consome.

O que a API permite verificar

A Consulta Simples não retorna situação cadastral nem óbito. Se a sua regra depende disso, use a Consulta em Tempo Real, feita CPF a CPF.

Cenários de proteção

Compra com cartão de crédito

O nome no cartão deve corresponder ao nome do titular do CPF. Divergência indica possível uso de cartão roubado.

Compra via PIX

Confirmar que o CPF do pagador PIX corresponde ao CPF do comprador cadastrado.

Produtos de alto valor

Para compras acima de determinado valor, a conferência de nome e nascimento não basta: quem comprou os dados de outra pessoa passa por ela. Aqui vale uma verificação com selfie e documento, como a Verificação de Identidade, hoje em acesso antecipado.

Primeira compra

Novos clientes têm perfil de risco desconhecido. Validar CPF na primeira compra reduz o risco.

Quando a consulta de CPF não basta: Verificação de Identidade

A consulta de CPF responde se os dados existem e combinam. Ela não responde se quem está comprando é o dono deles. Em fraudes com dados vazados, o golpista digita nome, CPF e data de nascimento corretos, e a conferência aprova.

A Verificação de Identidade da CPFHub.io, em piloto com empresas selecionadas, fecha essa brecha. O fluxo junta:

• selfie com prova de vida (liveness), que barra foto ou vídeo apresentado à câmera;
• foto do documento: CNH, RG ou passaporte;
• comparação facial entre a selfie e o documento;
• cruzamento dos dados com o CPF do pedido.

No e-commerce, o jeito mais simples é mandar um link de verificação para o comprador quando o pedido cai na faixa de risco alto: ele conclui pelo celular e o pedido segue. A loja recebe a decisão com a similaridade do rosto e escolhe liberar, recusar ou mandar para revisão. O preço será publicado no lançamento; para participar do piloto, peça acesso pela página da Verificação de Identidade.

Implementação no checkout

O exemplo abaixo roda no seu backend (a API Key nunca deve ir para o navegador).

async function verificarIdentidadeCheckout(cpf, nomeComprador) {
    const response = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {
    headers: { 'x-api-key': process.env.CPFHUB_API_KEY }
    });

    if (response.status === 404) {
    // CPF não encontrado: não consome crédito
    return { seguro: false, motivo: 'CPF não encontrado' };
    }

    const data = await response.json();

    if (!response.ok) {
    const erro = typeof data.error === 'string' ? data.error : data.error?.message;
    throw new Error(erro);
    }

    const nomeReal = data.data.nameUpper;
    const nomeCheck = nomeComprador.toUpperCase().trim();

    // Verificação de nome
    const nomeConfere = nomeReal.includes(nomeCheck) || nomeCheck.includes(nomeReal);

    if (!nomeConfere) {
    // Em pedidos de valor alto, encaminhe para a verificação com selfie e documento
    return { seguro: false, motivo: 'Nome divergente do titular do CPF' };
    }

    return { seguro: true, nomeConfirmado: data.data.name };
}

Benefícios para o lojista

• Redução de chargebacks: compras com dados inconsistentes são barradas antes do processamento.

• Redução de análise manual: pedidos com dados consistentes seguem sem revisão, e os casos de risco alto vão para a verificação com selfie em vez da fila do analista.

• Evidência de diligência: registros de verificação servem como prova em disputas.

• Base para KYC: a verificação com selfie e documento é a mesma usada em fluxos de KYC; a adequação à LGPD continua sendo responsabilidade da loja.

Benefícios para o consumidor

• Proteção contra uso indevido: se alguém tentar usar seu CPF, a divergência de nome ou a selfie bloqueia a compra.

• Confiança na plataforma: saber que a loja verifica identidade aumenta a confiança.

• Experiência fluida: a consulta de CPF leva ~150 ms e a selfie só aparece nos pedidos de risco alto.

Perguntas frequentes

Por que validar o CPF no checkout e não apenas no cadastro?

O cadastro é feito uma única vez, mas o risco existe em cada transação. Um fraudador pode obter acesso a uma conta legítima e realizar compras com um cartão roubado cujo titular é diferente do CPF cadastrado. Validar no checkout permite cruzar o CPF da conta com o nome no cartão em tempo real, bloqueando esse cenário.

A verificação de CPF impacta a taxa de conversão do e-commerce?

A consulta de CPF quase não pesa: leva ~150 ms, tempo que se perde no carregamento normal do checkout. A selfie com documento pede uma ação do comprador, então faz sentido reservá-la para pedidos de risco alto, onde o custo de uma fraude (chargeback, perda de mercadoria, custo operacional) justifica o passo extra.

O que acontece quando o nome do comprador não confere com o titular do CPF?

A recomendação é não bloquear automaticamente, exceto em casos de divergência total. Divergências parciais, como nome social, abreviações e nomes compostos, são comuns e não indicam fraude. Uma comparação flexível (cruzando ao menos dois sobrenomes) reduz falsos positivos, e os casos duvidosos podem ir para uma verificação com selfie e documento em vez da revisão manual.

A consulta de CPF prova que o comprador é o titular?

Não. Ela confirma que o CPF existe e que os dados batem. Quem tem os dados de outra pessoa passa nessa conferência. Para provar a titularidade, a Verificação de Identidade compara uma selfie com prova de vida com a foto da CNH, RG ou passaporte, cruzando com o CPF. Ela está em piloto com empresas selecionadas, e o acesso é pedido pela página do produto.

A API CPFHub.io funciona para todos os volumes de consulta?

O plano Grátis oferece 50 créditos por mês sem cartão de crédito, bom para testes e projetos iniciais. Ao esgotar esses créditos, as consultas param: HTTP 403, "Limite de créditos excedido", sem cobrança extra. O Pro começa em R$ 19 por 100 créditos e tem faixas de R$ 149 (1.000), R$ 599 (5.000) e R$ 999 (10.000), com excedente conforme a faixa; volumes maiores vão para o Corporativo, sob consulta. Detalhes na página de preços. Chamadas acima do limite por minuto recebem HTTP 429 e devem respeitar o Retry-After.

Conclusão

No e-commerce, a verificação de identidade funciona melhor em duas camadas: a consulta de CPF confere os dados de todo pedido em ~150 ms, e a selfie com documento entra nos pedidos de risco alto para provar que o comprador é o titular. Crie sua conta grátis e comece hoje pela Consulta Simples e pela Consulta em Tempo Real, com os 50 créditos do plano Grátis. Para a camada de selfie com documento, peça acesso antecipado à Verificação de Identidade da CPFHub.io.