# Como verificar CPF grátis para cadastro em marketplaces > Aprenda a verificar CPF gratuitamente para validar vendedores e compradores em marketplaces. Reduza fraudes com consulta automatizada via API. **Publicado:** 04/05/2025 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/como-verificar-cpf-gratis-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](https://www.bcb.gov.br/) 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) ```javascript 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 ```json { "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: ```python 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: | Cenário | Volume estimado | Plano recomendado | | --- | --- | --- | | Marketplace em lançamento | Até 50 cadastros/mês | Gratuito (50/mês) | | Marketplace em crescimento | 50-500 cadastros/mês | Pro (R$ 149/mês) | | Marketplace consolidado | 500+ cadastros/mês | Pro ou Corporativo | 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. ### Leia também - [Como evitar chargebacks usando validação de CPF no checkout](https://cpfhub.io/blog/como-evitar-chargebacks-usando-validacao-de-cpf-no-checkout) - [Como pedir CPF no checkout sem espantar o cliente](https://cpfhub.io/blog/como-pedir-cpf-no-checkout-sem-espantar-o-cliente) - [Golpe do CPF clonado em compras online: como detectar e prevenir](https://cpfhub.io/blog/golpe-cpf-clonado-compras-online-detectar-prevenir) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) --- ## 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](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar os usuários do seu marketplace ainda hoje.