Como verificar CPF grátis para cadastro em marketplaces

Verificar CPF gratuitamente para cadastro em marketplaces é possível com a API da CPFHub.io, que oferece 50 consultas mensais gratuitas sem cartão de crédito. A chamada retorna nome completo, data de nascimento e gênero do titular em ~900ms, permitindo confirmar a identidade de vendedores e compradores no momento do onboarding e reduzir fraudes antes que elas aconteçam.

Introdução

Marketplaces são plataformas que conectam vendedores e compradores, intermediando transações que envolvem confiança mútua. Para que essa confiança exista, é fundamental que os dados de ambas as partes sejam reais e verificados. O CPF é a peça central desse processo no Brasil.

Vendedores com CPFs falsos podem aplicar golpes e desaparecer após receber pagamentos. Compradores com dados fictícios podem realizar compras fraudulentas com cartões clonados. Em ambos os cenários, o marketplace arca com o prejuízo financeiro e reputacional.

Por que a validação de CPF é crítica em marketplaces?

Cadastro de vendedores

O vendedor é a parte que mais precisa de verificação em um marketplace. Quando um vendedor se cadastra com dados falsos, o marketplace assume o risco de:

• Golpes contra compradores que pagam por produtos que nunca serão entregues.

• Problemas fiscais, pois o marketplace pode ser obrigado a emitir documentos com dados do vendedor.

• Danos à reputação, afastando compradores legítimos da plataforma.

Cadastro de compradores

Compradores fraudulentos usam cartões clonados e CPFs de terceiros para realizar compras. O resultado são chargebacks que impactam tanto o vendedor quanto a plataforma.

Conformidade regulatória

Marketplaces que operam como intermediadores de pagamento estão sujeitos a regulamentações do Banco Central e devem seguir procedimentos de KYC para identificar seus usuários.

Estratégia de validação em duas camadas

A abordagem mais eficiente para marketplaces combina:

Camada 1: validação no cadastro (onboarding)

Quando o vendedor ou comprador cria sua conta na plataforma, o CPF é validado antes de ativar a conta. Isso impede que cadastros com dados falsos avancem.

Camada 2: validação em transações de risco

Para compras de alto valor, primeiro pedido ou padrões suspeitos, uma nova validação pode ser acionada para confirmar os dados antes de aprovar a transação.

Implementação da validação no onboarding

Exemplo com Node.js (Express)

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/cadastro/vendedor', async (req, res) => {
    const { cpf, nome, email } = req.body;

    // Validação sintática local
    const cpfLimpo = cpf.replace(/\D/g, '');
    if (cpfLimpo.length !== 11) {
    return res.status(400).json({ error: 'CPF com formato inválido' });
    }

    // Consulta de dados via API CPFHub.io
    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 10000);

    try {
    const response = await fetch(
    `https://api.cpfhub.io/cpf/${cpfLimpo}`,
    {
    method: 'GET',
    headers: {
    'x-api-key': process.env.CPFHUB_API_KEY,
    'Accept': 'application/json'
    },
    signal: controller.signal
    }
    );

    clearTimeout(timeoutId);
    const data = await response.json();

    if (!data.success) {
    return res.status(400).json({
    error: 'CPF não encontrado. Verifique o número informado.'
    });
    }

    // Verificar correspondência de nome
    const nomeReal = data.data.name.toUpperCase();
    const nomeInformado = nome.toUpperCase();
    const primeiroNome = nomeInformado.split(' ')[0];

    if (!nomeReal.includes(primeiroNome)) {
    return res.status(400).json({
    error: 'Nome informado não corresponde ao CPF.'
    });
    }

    // Cadastro aprovado
    // Aqui você salvaria no banco de dados
    res.json({
    sucesso: true,
    mensagem: 'Cadastro aprovado',
    vendedor: {
    cpf: data.data.cpf,
    nome: data.data.name,
    dataNascimento: data.data.birthDate
    }
    });

    } catch (error) {
    clearTimeout(timeoutId);
    // Em caso de falha na API, permitir cadastro com flag de revisão
    res.json({
    sucesso: true,
    mensagem: 'Cadastro registrado, pendente de validação',
    revisaoNecessaria: true
    });
    }
});

app.listen(3000);

Resposta da API da CPFHub.io

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "Pedro Henrique Almeida",
    "nameUpper": "PEDRO HENRIQUE ALMEIDA",
    "gender": "M",
    "birthDate": "12/09/1992",
    "day": 12,
    "month": 9,
    "year": 1992
    }
}

Com esses dados, o marketplace pode:

• Confirmar a identidade do vendedor — o CPF existe e o nome confere.

• Verificar a idade — confirmar que o usuário tem mais de 18 anos, requisito para operar como vendedor na maioria das plataformas.

• Registrar dados validados — armazenar nome e data de nascimento confirmados para fins de compliance.

Validação de compradores no checkout

Além do cadastro de vendedores, marketplaces podem validar o CPF do comprador em momentos estratégicos:

import requests

def validar_comprador_marketplace(cpf, nome_comprador, valor_compra):
    """
    Valida o CPF do comprador. Acionada para:
    - Primeiro pedido do comprador
    - Compras acima de R$ 500
    - Padrões de compra suspeitos
    """
    url = f"https://api.cpfhub.io/cpf/{cpf}"
    headers = {
    "x-api-key": "SUA_CHAVE_DE_API",
    "Accept": "application/json"
    }

    try:
    response = requests.get(url, headers=headers, timeout=10)
    data = response.json()

    if not data.get("success"):
    return {
    "aprovado": False,
    "motivo": "CPF não encontrado",
    "acao": "bloquear_compra"
    }

    nome_real = data["data"]["name"].upper()
    nome_input = nome_comprador.upper()

    if nome_input.split()[0] not in nome_real:
    return {
    "aprovado": False,
    "motivo": "Nome divergente do CPF",
    "acao": "revisao_manual"
    }

    return {
    "aprovado": True,
    "comprador_validado": data["data"]["name"],
    "valor": valor_compra
    }

    except requests.exceptions.Timeout:
    return {"aprovado": True, "revisao_manual": True}
    except requests.exceptions.RequestException:
    return {"aprovado": True, "revisao_manual": True}

# Uso no checkout
resultado = validar_comprador_marketplace(
    "12345678900",
    "Pedro Almeida",
    750.00
)
print(resultado)

Volume de consultas para marketplaces

O volume necessário depende do modelo do marketplace:

Para otimizar o uso de consultas:

• Valide o CPF apenas no cadastro inicial do usuário.

• Use cache para evitar revalidações desnecessárias.

• Reserve consultas adicionais para transações de alto risco.

Tratamento de erros e resiliência

Marketplaces precisam garantir que o fluxo de cadastro não seja bloqueado por falhas externas. Implemente:

• Timeout — defina um tempo máximo de espera (10 segundos) para a resposta da API.

• Fallback — se a API estiver indisponível, permita o cadastro com flag de "pendente de validação" e valide posteriormente.

• Fila de validação — cadastros pendentes podem ser colocados em uma fila para validação quando a API estiver disponível.

Vale destacar: a CPFHub.io não bloqueia requisições ao atingir o limite do plano. Ao ultrapassar a cota, cada consulta adicional é cobrada a R$0,15 — sem interrupção do serviço.

Segurança e LGPD em marketplaces

Marketplaces tratam dados de milhares de usuários e têm responsabilidade direta pela proteção dessas informações:

• Informar os usuários — a política de privacidade deve mencionar que dados serão validados em fontes externas.

• Obter consentimento — no momento do cadastro, o usuário deve consentir com a validação dos dados.

• Usar provedores em conformidade — a CPFHub.io é 100% conforme à LGPD.

• Limitar acesso — apenas sistemas autorizados devem ter acesso à chave de API.

• Registrar consultas — manter logs de auditoria de todas as validações realizadas.

Perguntas frequentes

Qual é a diferença entre validar CPF no cadastro e no checkout em um marketplace?

No cadastro, a validação confirma a identidade do usuário antes de ativar a conta — bloqueando CPFs inexistentes ou com dados divergentes. No checkout, a validação é acionada em situações de risco específicas (primeiro pedido, alto valor, padrão suspeito). A combinação das duas camadas reduz fraudes sem criar atrito excessivo no fluxo normal de compra.

A API CPFHub.io bloqueia quando o limite do plano é atingido?

Não. A CPFHub.io nunca bloqueia requisições. Ao ultrapassar o limite do plano (50 no gratuito, 1.000 no Pro), cada consulta adicional é cobrada a R$0,15. Para marketplaces em crescimento, isso significa que um pico inesperado de cadastros não interrompe o serviço — apenas gera cobrança proporcional ao uso real.

Como evitar recontagem de CPFs já validados para economizar cota?

Implemente cache da resposta da API com TTL de 24 horas. Após a validação inicial, armazene o resultado no banco de dados e reutilize para revalidações dentro do período. CPFs já confirmados no cadastro não precisam ser consultados novamente em transações subsequentes, salvo em fluxos de alto risco com verificação periódica.

Um marketplace pequeno consegue usar a API gratuitamente?

Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — suficiente para marketplaces em fase de lançamento ou MVP com até 50 novos cadastros mensais. Quando o crescimento exigir mais volume, o plano Pro (R$149/mês com 1.000 consultas) cobre a maioria dos marketplaces em estágio de crescimento.

Conclusão

Verificar o CPF de vendedores e compradores é uma prática essencial para a segurança e a credibilidade de qualquer marketplace. Com a API da CPFHub.io, a validação acontece em tempo real durante o cadastro, sem bloquear o fluxo e com custo proporcional ao uso.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar os usuários do seu marketplace ainda hoje.