APIs de CPF para plataformas de apostas esportivas: Como validar identidade

Plataformas de apostas esportivas no Brasil são obrigadas pela Lei 14.790/2023 a verificar a identidade de cada apostador antes de qualquer transação — e a validação de CPF via API é o mecanismo central desse processo, confirmando identidade, bloqueando menores de 18 anos e impedindo contas duplicadas em tempo real.

Introdução

A regulamentação das apostas esportivas no Brasil, estabelecida pela Lei 14.790/2023, trouxe exigências rigorosas de verificação de identidade. Plataformas de apostas (bets) precisam confirmar que cada apostador é quem diz ser, tem mais de 18 anos e não está em listas de restrição. A validação de CPF via API é a base desse processo de KYC (Know Your Customer).

O que a Lei 14.790/2023 exige

A regulamentação de apostas esportivas no Brasil determina:

• KYC obrigatório — Verificação de identidade de todos os apostadores.

• Restrição de idade — Apenas maiores de 18 anos podem apostar.

• Prevenção à lavagem de dinheiro — Processos de AML integrados.

• Uma conta por CPF — Proibição de contas duplicadas.

• Registro de transações — Auditabilidade de todas as operações.

Como a validação de CPF atende essas exigências

1. Verificação de identidade (KYC)

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

Resposta:

{
    "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
    }
}

A API retorna nome real, data de nascimento e gênero associados ao CPF, permitindo cruzar com os dados informados pelo apostador.

2. Verificação de idade

Com a data de nascimento retornada pela API, é possível calcular automaticamente se o apostador tem 18 anos ou mais.

from datetime import datetime

def verificar_idade_minima(ano: int, mes: int, dia: int, idade_minima: int = 18) -> bool:
    nascimento = datetime(ano, mes, dia)
    hoje = datetime.now()
    idade = hoje.year - nascimento.year
    if (hoje.month, hoje.day) < (nascimento.month, nascimento.day):
    idade -= 1
    return idade >= idade_minima

3. Prevenção de contas duplicadas

Cada CPF deve ter apenas uma conta na plataforma. Ao consultar o CPF no cadastro, verifique se já existe uma conta associada.

4. Conformidade AML

Registre cada validação com timestamp, resultado e base legal para atender exigências de prevenção à lavagem de dinheiro.

Implementação completa para plataformas de apostas

import requests
from datetime import datetime
import hashlib
import json

CPFHUB_API_KEY = 'SUA_CHAVE_DE_API'

def cadastrar_apostador(cpf: str, nome: str, nascimento: str) -> dict:
    # 1. Verificar se CPF ja esta cadastrado
    cpf_hash = hashlib.sha256(cpf.encode()).hexdigest()
    # Consultar banco de dados por cpf_hash (implementar conforme seu banco)

    # 2. Consultar API para validar identidade
    url = f'https://api.cpfhub.io/cpf/{cpf}'
    headers = {
    'x-api-key': CPFHUB_API_KEY,
    'Accept': 'application/json'
    }

    response = requests.get(url, headers=headers, timeout=10)
    resultado = response.json()

    if not resultado.get('success'):
    return {'status': 'REJEITADO', 'motivo': 'CPF nao encontrado'}

    dados = resultado['data']

    # 3. Verificar nome
    nome_confere = nome.upper().strip() in dados['nameUpper']

    if not nome_confere:
    return {'status': 'REJEITADO', 'motivo': 'Nome divergente'}

    # 4. Verificar idade minima (18 anos)
    idade_ok = verificar_idade_minima(dados['year'], dados['month'], dados['day'])

    if not idade_ok:
    return {'status': 'REJEITADO', 'motivo': 'Menor de 18 anos'}

    # 5. Registrar validacao para auditoria
    registro = {
    'timestamp': datetime.now().isoformat(),
    'cpf_hash': cpf_hash,
    'kyc_aprovado': True,
    'idade_verificada': True,
    'base_legal': 'Obrigacao legal - Lei 14.790/2023'
    }
    print(json.dumps(registro))

    return {
    'status': 'APROVADO',
    'nome_confirmado': dados['name'],
    'idade_verificada': True
    }

Fluxo de cadastro para apostadores

1. Apostador informa CPF, nome e data de nascimento.
2. Sistema valida formato do CPF localmente.
3. Sistema consulta API da CPFHub.io.
4. Verifica se o nome confere com o retornado pela API.
5. Calcula idade e confirma que é maior de 18 anos.
6. Verifica se CPF já possui conta na plataforma.
7. Se tudo confere: cria conta com status verificado.
8. Registra validação no banco para auditoria e AML.

Tabela de decisões

Requisitos de auditoria para apostas

A Lei 14.790/2023 e as portarias da SPA (Secretaria de Prêmios e Apostas) exigem:

• Registro de KYC — Evidência de verificação de identidade.

• Verificação de idade — Prova de que o apostador é maior de 18.

• Transações rastreáveis — Histórico de depósitos, apostas e saques.

• Retenção — Registros mantidos por no mínimo 5 anos.

• Relatórios ao COAF — Comunicação de operações suspeitas.

Por que a CPFHub.io é ideal para plataformas de apostas

• Resposta em ~900ms — Cadastro sem fricção para o apostador.

• 99,9% de uptime — Disponibilidade para operação 24/7.

• 100% conforme à LGPD — Base legal documentada.

• Data de nascimento na resposta — Verificação de idade automática.

• Planos escaláveis — Do gratuito (50/mês) ao corporativo com SLA dedicado.

Perguntas frequentes

A Lei 14.790/2023 obriga plataformas de apostas a validar CPF?

Sim. A regulamentação das bets no Brasil exige KYC completo antes de qualquer depósito ou aposta. A validação de CPF via API confirma identidade, bloqueia menores de 18 anos e impede a criação de contas duplicadas — todos requisitos expressos na lei e nas portarias da SPA.

Como a API retorna a data de nascimento para verificação de idade?

A resposta inclui os campos day, month e year como inteiros, além do campo birthDate formatado. Com esses dados, um cálculo simples determina se o apostador tem 18 anos ou mais no momento do cadastro, sem necessidade de processar texto ou interpretar formatos de data.

O que acontece se o apostador informar um CPF de outra pessoa?

O sistema cruza o nome informado pelo apostador com o nome retornado pela API. Se houver divergência, o cadastro é rejeitado antes de qualquer criação de conta. Isso impede que CPFs de terceiros sejam usados para burlar restrições de idade ou listas de bloqueio.

A API bloqueia o acesso quando o plano gratuito acaba?

Não. Se o limite mensal for atingido, a API continua respondendo e cobra R$0,15 por consulta adicional — sem interrupção do serviço. Plataformas de apostas em crescimento não precisam se preocupar com falhas de validação por atingir cotas.

Conclusão

Plataformas de apostas esportivas no Brasil precisam de KYC rigoroso para operar dentro da lei. A validação de CPF via API é o primeiro passo para verificar identidade, confirmar idade e prevenir fraudes. A CPFHub.io entrega esse processo em menos de 1 segundo, com dados confiáveis e integração simples em qualquer linguagem.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito.