Consulta de CPF gratuita para verificação de doadores em campanhas

ONGs, campanhas políticas e instituições religiosas podem verificar o CPF de doadores gratuitamente usando a API da CPFHub.io — o plano gratuito cobre até 50 consultas/mês sem cartão de crédito, suficiente para pequenas arrecadações e projetos em fase de validação.

Introdução

Campanhas de arrecadação — sejam para organizações sem fins lucrativos, instituições religiosas, campanhas políticas ou iniciativas de financiamento coletivo — recebem doações de pessoas físicas que informam seus dados, incluindo o CPF. Validar esses dados é fundamental para garantir transparência, emitir recibos corretos e cumprir obrigações legais.

A validação do CPF de doadores pode ser feita gratuitamente usando APIs especializadas.

Por que verificar o CPF de doadores?

Transparência e prestação de contas

Organizações que recebem doações devem prestar contas sobre a origem dos recursos. Verificar o CPF de cada doador garante que os registros são reais e rastreáveis.

Emissão de recibos para dedução fiscal

Doações para entidades qualificadas (OSCIP, organizações de saúde, educação, etc.) podem ser deduzidas do imposto de renda do doador. Para isso, o recibo precisa conter o CPF correto do doador. Um CPF inválido impossibilita a dedução.

Conformidade com a legislação eleitoral

Em campanhas políticas, a Lei nº 9.504/1997 exige identificação completa de todos os doadores. CPFs inválidos ou de terceiros podem configurar irregularidades graves, passíveis de sanções eleitorais.

Prevenção de lavagem de dinheiro

Doações de valores elevados podem ser usadas para ocultar a origem de recursos ilícitos. Validar o CPF do doador é uma camada de prevenção contra essa prática.

Como funciona a verificação via API

A API da CPFHub.io recebe o CPF via GET https://api.cpfhub.io/cpf/{CPF} com o header x-api-key e retorna nome completo, gênero e data de nascimento do titular em aproximadamente 900ms — dados suficientes para cruzar com as informações declaradas pelo doador.

Exemplo de integração em Python

import requests

def verificar_doador(cpf, nome_doador, valor_doacao):
    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 {
    "status": "rejeitado",
    "motivo": "CPF não encontrado na base de dados",
    "acao": "Solicitar novo CPF ao doador"
    }

    nome_real = data["data"]["name"].upper()
    nome_informado = nome_doador.upper()

    # Verificar correspondência de nome
    primeiro_nome = nome_informado.split()[0]
    if primeiro_nome not in nome_real:
    return {
    "status": "divergente",
    "motivo": f"Nome divergente. Base: {data['data']['name']}",
    "acao": "Solicitar confirmação ao doador"
    }

    return {
    "status": "aprovado",
    "nome_completo": data["data"]["name"],
    "data_nascimento": data["data"]["birthDate"],
    "valor": valor_doacao
    }

    except requests.exceptions.Timeout:
    return {"status": "erro", "motivo": "Timeout na consulta"}
    except requests.exceptions.RequestException as e:
    return {"status": "erro", "motivo": str(e)}

# Verificar doação recebida
resultado = verificar_doador("12345678900", "João Silva", 500.00)
print(resultado)

Resposta da API

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "João da Silva",
    "nameUpper": "JOÃO DA SILVA",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
    }
}

Fluxo recomendado para validação de doadores

1. Coleta de dados no momento da doação

Quando o doador realiza a contribuição (online ou presencial), solicite:

• Nome completo.
• CPF.
• Valor da doação.

2. Validação sintática imediata

Antes de processar a doação, verifique localmente se o CPF tem formato válido (11 dígitos, dígitos verificadores corretos). Isso pode ser feito no front-end da plataforma de doações.

3. Consulta via API

Para CPFs com formato válido, consulte a API da CPFHub.io para confirmar que o CPF existe e obter os dados cadastrais reais.

4. Cruzamento de dados

Compare o nome informado pelo doador com o nome retornado pela API. Em caso de divergência, sinalize para revisão manual.

5. Registro e recibo

Após a validação, registre a doação com os dados confirmados e emita o recibo com o CPF correto.

Cenários de uso por tipo de campanha

ONGs e organizações sem fins lucrativos

ONGs que recebem doações de pessoas físicas precisam manter registros detalhados para prestação de contas a conselhos, órgãos reguladores e doadores corporativos.

Campanhas de financiamento coletivo

Plataformas de crowdfunding que processam contribuições individuais podem validar o CPF do doador para garantir a legitimidade das contribuições.

Instituições religiosas

Igrejas e entidades religiosas que emitem recibos de doação para fins de declaração de IR precisam garantir que o CPF do fiel é válido.

Campanhas políticas

A legislação eleitoral exige que todos os doadores sejam identificados com CPF válido. A validação automatizada garante conformidade e reduz o risco de impugnação.

Volume e custo para campanhas

O volume de consultas necessárias depende do número de doadores únicos por mês:

Para campanhas pontuais com volume dentro de 50 doadores, o plano gratuito da CPFHub.io é suficiente. Para campanhas recorrentes ou de grande porte, o plano Pro oferece 1.000 consultas por mês por R$149, com excedente cobrado a R$0,15 por consulta — sem bloqueio de serviço.

Boas práticas para organizações

• Valide o CPF antes de emitir o recibo — nunca emita recibos com CPFs não verificados.

• Mantenha registro de todas as validações — para fins de auditoria e prestação de contas.

• Informe o doador sobre a verificação — transparência no processo fortalece a confiança na organização.

• Proteja os dados dos doadores — siga as diretrizes da LGPD no armazenamento e tratamento de dados pessoais.

• Implemente timeout e fallback — em caso de indisponibilidade da API, registre a doação como pendente de validação.

Segurança e LGPD

A CPFHub.io processa dados de CPF como operadora, e a organização arrecadadora atua como controladora dos dados dos doadores. Para manter a conformidade com a LGPD:

• Obtenha consentimento do doador para validação dos dados.

• Armazene apenas as informações necessárias para a finalidade declarada.

• Implemente controle de acesso aos dados de doadores.

• Mantenha políticas claras de privacidade e proteção de dados.

Perguntas frequentes

ONGs pequenas realmente precisam validar o CPF de cada doador?

Mesmo para pequenas organizações, a validação é recomendada. Recibos emitidos com CPFs inválidos podem ser questionados pela Receita Federal na hora do ajuste anual do imposto de renda do doador, gerando reclamações e desgaste para a ONG. Além disso, a validação evita fraudes simples — como alguém informando o CPF de outra pessoa para ocultar a origem de recursos. Com o plano gratuito da CPFHub.io (50 consultas/mês), a maioria das ONGs pequenas não tem custo adicional.

Como proceder quando o nome informado pelo doador diverge do nome cadastrado na Receita Federal?

A divergência nem sempre indica fraude — o doador pode usar nome social, apelido ou ter sobrenomes omitidos. O fluxo recomendado é: (1) alertar internamente sobre a divergência sem rejeitar a doação automaticamente; (2) entrar em contato com o doador para confirmação; (3) emitir o recibo apenas com o nome confirmado via API. Para doações acima de determinados valores, a revisão manual é obrigatória de qualquer forma.

A validação de CPF de doadores está em conformidade com a LGPD?

Sim, desde que a base legal esteja corretamente documentada. O tratamento de CPF de doadores se enquadra em "cumprimento de obrigação legal" (art. 7º, II da LGPD) para organizações sujeitas à legislação eleitoral ou tributária, e em "legítimo interesse" para fins de prevenção à fraude. A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade — colete apenas o que for imprescindível para a finalidade declarada.

O que acontece se eu ultrapassar o limite de 50 consultas gratuitas durante uma campanha?

A CPFHub.io não bloqueia as consultas ao atingir o limite do plano gratuito. Cada consulta adicional é cobrada automaticamente a R$0,15 — a campanha continua operando normalmente. Para campanhas com volume previsível acima de 50 doadores/mês, o plano Pro (R$149/mês, 1.000 consultas) oferece melhor custo-benefício.

Conclusão

Verificar o CPF de doadores é uma prática essencial para garantir transparência, conformidade legal e a correta emissão de recibos em campanhas de arrecadação.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar doadores hoje mesmo, garantindo registros confiáveis e recibos válidos para dedução fiscal sem custo inicial.