NovoVerificação de identidade facial

Como desenhar o fluxo ideal de verificação de CPF para apps de banco digital

Projete o fluxo ideal de verificação de CPF para apps de banco digital. Da abertura de conta ao KYC, com UX e integração de API.

Lucas Vieira
Lucas Vieira
··8 min de leitura
Como desenhar o fluxo ideal de verificação de CPF para apps de banco digital

O Banco Central define os requisitos mínimos de identificação de clientes em contas digitais — o fluxo de verificação de CPF deve estar alinhado com essas normas.

O fluxo ideal de verificação de CPF em apps de banco digital começa com a coleta do CPF na segunda tela do onboarding, valida os dígitos localmente e consulta a API em seguida — tudo antes de solicitar qualquer outro dado ao usuário. Esse modelo reduz o drop-off, evita cadastros inválidos e permite pré-preencher automaticamente nome, data de nascimento e gênero com os dados retornados. Quando bem executado, a etapa de CPF deve ter abandono inferior a 5% e ser concluída em menos de 30 segundos.


Requisitos regulatórios

Circular BCB 3.978/2020

O Banco Central exige que instituições financeiras implementem políticas de KYC (Know Your Customer) que incluem a identificação e verificação da identidade do cliente. O CPF é o documento base para essa verificação.

Resolução CVM 50/2021

Para fintechs que operam com investimentos, a CVM exige verificação de identidade antes de qualquer transação, reforçando a necessidade de validação de CPF no onboarding.

Implicações para o design

O fluxo deve ser obrigatório -- não há como "pular" a etapa de CPF em um banco digital. O desafio de UX é tornar essa etapa obrigatória o mais suave possível.


Visão geral do fluxo de onboarding

Etapas recomendadas

1. Tela de boas-vindas
2. Input de CPF (verificação inicial)
3. Dados pessoais (nome, data de nascimento)
4. Endereço
5. Selfie e documento (KYC avançado)
6. Revisão e confirmação
7. Conta criada

A verificação de CPF acontece logo na etapa 2, antes mesmo de solicitar outros dados. Isso permite:

  • Identificar CPFs inválidos imediatamente.
  • Pré-preencher campos com dados retornados pela API.
  • Bloquear CPFs já cadastrados ou irregulares antes de investir tempo nas etapas seguintes.

Etapa 2 -- Tela de input de CPF

Design da tela

A tela deve ser minimalista, com foco total no campo de CPF. Elementos recomendados:

  • Título claro: "Informe seu CPF".
  • Campo de input grande com máscara (000.000.000-00).
  • Botão "Continuar" visível e acessível.
  • Texto de contexto: "Precisamos do seu CPF para abrir sua conta conforme exigências do Banco Central."
  • Link para política de privacidade.

Implementação da validação

const API_URL = 'https://api.cpfhub.io/cpf/';
const API_KEY = process.env.CPFHUB_API_KEY;

async function verificarCPFOnboarding(cpf) {
    const cleanCPF = cpf.replace(/\D/g, '');

    // Etapa 1: Validação local dos dígitos
    if (!validarDigitosCPF(cleanCPF)) {
    return { status: 'invalid', message: 'CPF inválido. Verifique os números.' };
    }

    // Etapa 2: Consulta à API
    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 10000);

    try {
    const res = await fetch(`${API_URL}${cleanCPF}`, {
    headers: {
    'x-api-key': API_KEY,
    'Accept': 'application/json'
    },
    signal: controller.signal
    });

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

    if (data.success) {
    return {
    status: 'valid',
    name: data.data.name,
    birthDate: data.data.birthDate,
    gender: data.data.gender
    };
    } else {
    return { status: 'not_found', message: 'CPF não encontrado na base.' };
    }
    } catch (error) {
    clearTimeout(timeoutId);
    return { status: 'error', message: 'Erro na verificação. Tente novamente.' };
    }
}

function validarDigitosCPF(cpf) {
    if (cpf.length !== 11 || /^(\d)\1{10}$/.test(cpf)) return false;

    let soma = 0;
    for (let i = 0; i < 9; i++) soma += parseInt(cpf[i]) * (10 - i);
    let resto = (soma * 10) % 11;
    if (resto === 10) resto = 0;
    if (resto !== parseInt(cpf[9])) return false;

    soma = 0;
    for (let i = 0; i < 10; i++) soma += parseInt(cpf[i]) * (11 - i);
    resto = (soma * 10) % 11;
    if (resto === 10) resto = 0;
    return resto === parseInt(cpf[10]);
}

Etapa 3 -- Pré-preenchimento inteligente

O valor do auto-complete

Quando a API retorna os dados do CPF (nome, data de nascimento, gênero), use-os para pré-preencher os campos da próxima etapa. Isso traz dois benefícios:

  1. Redução de fricção -- o usuário não precisa digitar informações que o sistema já conhece.
  2. Validação cruzada -- se o usuário alterar o nome pré-preenchido, pode ser um indicativo de inconsistência.

Fluxo de pré-preenchimento

async function avancarParaDadosPessoais(cpf) {
    const resultado = await verificarCPFOnboarding(cpf);

    if (resultado.status === 'valid') {
    // Preenche campos automaticamente
    document.getElementById('nome').value = resultado.name;
    document.getElementById('nascimento').value = resultado.birthDate;
    document.getElementById('genero').value = resultado.gender;

    // Marca campos como pré-preenchidos (para auditoria)
    document.getElementById('nome').dataset.prefilled = 'true';

    // Navega para a próxima tela
    navegarPara('dados-pessoais');
    } else if (resultado.status === 'not_found') {
    exibirAlerta('CPF não localizado. Preencha seus dados manualmente.');
    navegarPara('dados-pessoais');
    } else {
    exibirErro(resultado.message);
    }
}

Tratamento de cenários especiais

CPF de menor de idade

Se a data de nascimento retornada pela API indica que o titular é menor de 18 anos, o fluxo deve redirecionar para o processo de conta de menor, que exige consentimento do responsável legal.

function verificarIdade(birthDate) {
    const [dia, mes, ano] = birthDate.split('/').map(Number);
    const nascimento = new Date(ano, mes - 1, dia);
    const hoje = new Date();
    const idade = Math.floor((hoje - nascimento) / (365.25 * 24 * 60 * 60 * 1000));

    if (idade < 18) {
    return 'menor';
    } else if (idade < 16) {
    return 'bloqueado'; // Não pode abrir conta
    }
    return 'adulto';
}

CPF já cadastrado

Consulte sua base interna antes de prosseguir. Se o CPF já tem conta ativa, ofereça a opção de login em vez de novo cadastro.

CPF com situação irregular

Caso o CPF apresente inconsistências, direcione para um fluxo de atendimento humano em vez de simplesmente bloquear o usuário.


Segurança no fluxo

Rate limiting no client-side

Para evitar abusos (bots testando CPFs em massa), implemente rate limiting no frontend:

const tentativas = new Map();

function verificarRateLimit(cpf) {
    const agora = Date.now();
    const ultimaTentativa = tentativas.get(cpf);

    if (ultimaTentativa && agora - ultimaTentativa < 5000) {
    return false; // Aguardar 5 segundos entre tentativas
    }

    tentativas.set(cpf, agora);
    return true;
}

Criptografia em trânsito

Todas as chamadas à API do CPFHub.io são feitas via HTTPS. No app mobile, implemente certificate pinning para prevenir ataques man-in-the-middle.


Teste via cURL

Para validar a integração durante o desenvolvimento do app:

curl --max-time 10 -X GET "https://api.cpfhub.io/cpf/12345678901" \
    -H "x-api-key: SUA_API_KEY_AQUI" \
    -H "Accept: application/json"

Resposta esperada:

{
    "success": true,
    "data": {
    "cpf": "12345678901",
    "name": "João da Silva",
    "nameUpper": "JOAO DA SILVA",
    "gender": "M",
    "birthDate": "01/01/1990",
    "day": "01",
    "month": "01",
    "year": "1990"
    }
}

Métricas do fluxo

KPIs a acompanhar

  • Taxa de conversão do onboarding -- percentual de usuários que completam todas as etapas.
  • Drop-off na etapa de CPF -- quantos abandonam especificamente nessa tela.
  • Tempo médio na etapa de CPF -- ideal: menos de 30 segundos.
  • Taxa de CPFs inválidos -- indica qualidade do tráfego de aquisição.
  • Taxa de pré-preenchimento bem-sucedido -- mede a eficácia da API.

Benchmarks do setor

Bancos digitais brasileiros de referência reportam taxas de conversão de onboarding entre 40-65%. A etapa de CPF, quando bem projetada, deve ter drop-off inferior a 5%.


Perguntas frequentes

O que é necessário para implementar validação de CPF no onboarding de um banco digital?

A validação exige uma chamada à API com o número do CPF e a chave de autenticação. A CPFHub.io retorna o status do documento, nome do titular e data de nascimento — tempo suficiente para exibir um feedback visual enquanto o usuário avança para a próxima tela.

A API CPFHub.io funciona para todos os volumes de consulta?

O plano gratuito oferece 50 créditos por mês sem cartão de crédito, ideal para testes e projetos em fase inicial. Para volumes maiores, consulte as faixas dos planos pagos na página de preços. O volume acompanha o plano: quando os créditos do Grátis terminam, a API pausa e responde HTTP 403 ("Limite de créditos excedido"). Planos pagos podem seguir com excedente na fatura seguinte, no valor da página de preços. Separado disso, o limite por minuto devolve HTTP 429 com Retry-After.

Como garantir conformidade com a LGPD ao usar uma API de CPF no app?

Use o CPF apenas para a finalidade declarada ao titular, armazene somente o necessário (prefira tokens internos ao CPF bruto após a verificação), 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.

Como lidar com falhas de API sem travar o onboarding?

Configure um timeout de 10 segundos na chamada e implemente um fallback gracioso: se a API não responder, permita que o usuário preencha os dados manualmente e marque o cadastro para validação assíncrona posterior. Isso preserva a conversão sem abrir mão da verificação.


Conclusão

O fluxo de verificação de CPF em apps de banco digital é a porta de entrada para a relação entre a instituição e o cliente. Quando bem projetado, ele transmite segurança, competência e respeito pelo tempo do usuário. A combinação de validação local, consulta à API do CPFHub.io e pré-preenchimento inteligente entrega uma experiência que converte sem comprometer a conformidade regulatória.

A API é desenhada para que a etapa de CPF não se torne um gargalo no onboarding, mesmo em períodos de alta demanda.

Cadastre-se em cpfhub.io

CPFHub.io

Pronto para integrar a API?

50 créditos gratuitos para testar agora. Sem cartão de crédito. Acesso imediato à documentação.

WhatsApp