As normas da B3 exigem que corretoras e distribuidoras validem o CPF do investidor antes de ativar qualquer conta de valores mobiliários. A CPFHub.io automatiza essa verificação em aproximadamente 900ms, retornando nome, data de nascimento e gênero para cruzamento com os dados cadastrais — garantindo conformidade com as exigências da B3 e da CVM sem atrasar o onboarding.
Introdução
A B3 -- Brasil, Bolsa, Balcão -- é a principal infraestrutura do mercado de capitais brasileiro. Como entidade administradora de mercados organizados, central depositária, câmara de compensação e liquidação, e registradora de ativos, a B3 estabelece normas rígidas para a identificação dos investidores que operam em seus ambientes. A validação do CPF é um requisito fundamental no processo de abertura de contas de investimento em corretoras e distribuidoras de valores mobiliários.
O papel da B3 na regulamentação do mercado
A B3 opera sob a supervisão da CVM e do BACEN, e suas normas complementam o arcabouço regulatório dessas entidades. Os regulamentos da B3 são obrigatórios para todos os participantes de seus mercados.
Regulamento de acesso
O Regulamento de Acesso da B3 define os requisitos para que participantes -- como corretoras e distribuidoras -- possam operar em seus mercados. Entre esses requisitos, está a obrigação de manter cadastros atualizados e validados de todos os investidores.
Manual de procedimentos operacionais
O Manual de Procedimentos Operacionais da B3 detalha os processos que os participantes devem seguir, incluindo os procedimentos de cadastro e identificação de investidores pessoa física.
Normas de registro de investidores
A B3 mantém o Cadastro de Investidores, que centraliza as informações de todos os investidores que operam em bolsa. O CPF é o identificador único do investidor pessoa física nesse cadastro.
O CPF como identificador no ecossistema B3
No ecossistema da B3, o CPF desempenha múltiplas funções além da simples identificação.
Código de investidor
O CPF do investidor é utilizado como base para a geração do código de investidor na B3, que permite o rastreamento de todas as operações realizadas em bolsa por aquela pessoa física.
Custódia de ativos
A central depositária da B3 utiliza o CPF para vincular os ativos custodiados ao seu titular. Uma inconsistência no CPF pode resultar em problemas de custódia que afetam a propriedade dos ativos do investidor.
Informações à Receita Federal
A B3 reporta à Receita Federal todas as operações realizadas por investidores, identificados pelo CPF. Dados incorretos geram divergências que podem resultar em malha fiscal para o investidor e em notificações para a corretora.
Processo de abertura de conta e validação de CPF
O processo de abertura de conta de investimento segue um fluxo estruturado que inclui a validação de CPF como etapa obrigatória.
Coleta de dados cadastrais
O investidor fornece seus dados pessoais, incluindo CPF, nome completo, data de nascimento, endereço e informações financeiras. A corretora deve garantir que esses dados são consistentes e verdadeiros.
Validação de CPF junto à Receita Federal
A norma exige que a corretora valide o CPF do investidor junto à base da Receita Federal, confirmando que o número é válido, está ativo e corresponde aos dados informados pelo investidor.
Suitability e perfil de investidor
Após a validação cadastral, a corretora realiza a análise de suitability (adequação), que determina o perfil de investidor e os produtos adequados. Essa análise depende de dados cadastrais precisos, reforçando a importância da validação prévia do CPF.
Ativação da conta e registro na B3
Com a validação concluída, a conta é ativada e o investidor é registrado na B3, podendo iniciar suas operações em bolsa, renda fixa e demais mercados.
Implementando validação automatizada
Corretoras e fintechs de investimento que processam centenas ou milhares de aberturas de conta diariamente precisam de validação automatizada e confiável.
Consulta via cURL
curl -X GET "https://api.cpfhub.io/cpf/22233344455" \
-H "x-api-key: SUA_API_KEY" \
-H "Accept: application/json" \
--timeout 30
Resposta:
{
"success": true,
"data": {
"cpf": "22233344455",
"name": "Lucas Pereira Gomes",
"nameUpper": "LUCAS PEREIRA GOMES",
"gender": "M",
"birthDate": "1995-01-30",
"day": "30",
"month": "01",
"year": "1995"
}
}
Sistema de onboarding de investidores em Python
import requests
from datetime import datetime, date
from typing import Dict, Optional
class OnboardingInvestidor:
"""
Sistema de validacao de CPF para onboarding de investidores,
conforme normas da B3 e CVM.
"""
API_URL = "https://api.cpfhub.io/cpf"
IDADE_MINIMA = 18
def __init__(self, api_key: str):
self.api_key = api_key
self.headers = {
"x-api-key": api_key,
"Accept": "application/json"
}
def validar_novo_investidor(
self,
cpf: str,
nome: str,
data_nascimento: str
) -> Dict:
"""
Valida CPF e dados do investidor para abertura
de conta conforme regulamentos da B3.
"""
cpf_limpo = cpf.replace(".", "").replace("-", "")
try:
response = requests.get(
f"{self.API_URL}/{cpf_limpo}",
headers=self.headers,
timeout=30
)
response.raise_for_status()
dados = response.json()
if not dados.get("success"):
return self._resultado_negativo(
cpf_limpo, "CPF nao localizado na Receita Federal"
)
info = dados["data"]
validacoes = []
# 1. Verifica nome
nome_confere = nome.upper().strip() == info["nameUpper"]
if not nome_confere:
validacoes.append("Nome divergente do cadastro")
# 2. Verifica data de nascimento
data_confere = data_nascimento == info["birthDate"]
if not data_confere:
validacoes.append("Data de nascimento divergente")
# 3. Verifica idade minima
ano_nasc = int(info["year"])
mes_nasc = int(info["month"])
dia_nasc = int(info["day"])
idade = self._calcular_idade(ano_nasc, mes_nasc, dia_nasc)
if idade < self.IDADE_MINIMA:
validacoes.append(
f"Investidor menor de {self.IDADE_MINIMA} anos"
)
aprovado = len(validacoes) == 0
return {
"aprovado": aprovado,
"cpf": info["cpf"],
"nome_oficial": info["name"],
"data_nascimento": info["birthDate"],
"genero": info["gender"],
"idade": idade,
"nome_confere": nome_confere,
"data_confere": data_confere,
"pendencias": validacoes if validacoes else None,
"data_validacao": datetime.now().isoformat()
}
except requests.exceptions.Timeout:
return self._resultado_negativo(cpf_limpo, "Timeout")
except requests.exceptions.RequestException as e:
return self._resultado_negativo(cpf_limpo, str(e))
def _calcular_idade(self, ano: int, mes: int, dia: int) -> int:
hoje = date.today()
nascimento = date(ano, mes, dia)
idade = hoje.year - nascimento.year
if (hoje.month, hoje.day) < (nascimento.month, nascimento.day):
idade -= 1
return idade
def _resultado_negativo(self, cpf: str, motivo: str) -> Dict:
return {
"aprovado": False,
"cpf": cpf,
"pendencias": [motivo],
"data_validacao": datetime.now().isoformat()
}
# Exemplo de uso no fluxo de abertura de conta
onboarding = OnboardingInvestidor(api_key="SUA_API_KEY")
resultado = onboarding.validar_novo_investidor(
cpf="222.333.444-55",
nome="Lucas Pereira Gomes",
data_nascimento="1995-01-30"
)
if resultado["aprovado"]:
print(f"Conta aprovada para: {resultado['nome_oficial']}")
print(f"Idade: {resultado['idade']} anos")
else:
print("Abertura de conta bloqueada:")
for p in resultado["pendencias"]:
print(f" - {p}")
Boas práticas para corretoras e fintechs
Validação síncrona no fluxo de cadastro
A validação do CPF deve ocorrer de forma síncrona durante o processo de cadastro, impedindo que o investidor avance para a etapa seguinte sem que o CPF seja confirmado. O tempo de resposta de aproximadamente 900ms da API do CPFHub.io é compatível com fluxos de onboarding em tempo real, sem impactar a experiência do usuário.
Confronto cruzado de dados
Além de validar a existência do CPF, confronte o nome e a data de nascimento retornados pela API com os dados informados pelo investidor. Divergências devem ser tratadas como sinais de alerta.
Integração com sistemas da B3
Os dados validados devem ser consistentes com os que serão enviados à B3 para registro do investidor. Qualquer divergência entre o cadastro da corretora e o registro na B3 pode gerar bloqueios operacionais.
Revalidação periódica
Implemente processos de revalidação periódica dos CPFs da base de investidores, especialmente antes de eventos como assembleias de acionistas, pagamento de dividendos e exercício de direitos.
O impacto da validação na experiência do investidor
Uma validação eficiente e transparente contribui para uma melhor experiência do investidor durante o onboarding. Processos que validam o CPF em tempo real e preenchem automaticamente dados cadastrais reduzem o atrito na abertura de conta e aumentam a taxa de conversão.
Perguntas frequentes
O que é necessário para implementar validação de CPF neste contexto?
A validação de CPF exige uma chamada à API com o número do documento e a chave de autenticação. A CPFHub.io retorna o status do CPF, nome do titular e data de nascimento em aproximadamente 900ms, permitindo a verificação em tempo real durante o cadastro ou transação.
A API CPFHub.io funciona para todos os volumes de consulta?
Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — ideal para testes e projetos pequenos. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia: cobra R$0,15 por consulta adicional.
Como garantir conformidade com a LGPD ao usar uma API de CPF?
Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade.
Quanto tempo leva para integrar a API CPFHub.io?
A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para https://api.cpfhub.io/cpf/{CPF} com o header x-api-key. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens.
Conclusão
As normas da B3 são claras quanto à necessidade de validação de CPF na abertura de contas de investimento. Corretoras, distribuidoras e fintechs que operam no mercado de capitais brasileiro devem implementar processos robustos de verificação de identidade para garantir conformidade regulatória e proteger seus investidores.
A CPFHub.io oferece a infraestrutura técnica para automatizar essa validação com latência de aproximadamente 900ms, plano gratuito para começar e escalabilidade para qualquer volume de onboarding. Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e comece hoje mesmo.
CPFHub.io
Pronto para integrar a API?
50 consultas gratuitas para testar agora. Sem cartão de crédito. Acesso imediato à documentação.
Sobre a redação
Redação CPFHub.io
Time editorial especializado em APIs de CPF, identidade digital e compliance no mercado brasileiro. Produzimos guias técnicos, análises regulatórias e tutoriais sobre LGPD e KYC para desenvolvedores e líderes de produto.



