🧾O que é o DICT?
O DICT (Diretório de Identificadores de Contas Transacionais) é um sistema gerenciado pelo Banco Central do Brasil, que armazena as informações das chaves Pix (como CPF, CNPJ, e-mail, número de telefone e chaves aleatórias) vinculadas às contas dos usuários.
Ele permite que instituições participantes realizem consultas seguras e centralizadas para identificar o banco e a conta associados a uma chave Pix, viabilizando transferências instantâneas com agilidade e precisão.
O sistema de consultas ao DICT utiliza o modelo de "baldes e fichas", conforme descrito no Manual Operacional do DICT (Seção 13 – Mecanismos de Prevenção a Ataques de Leitura).
🛡️Por que existe o sistema de baldes e fichas?
Para garantir a segurança, estabilidade e privacidade das informações no DICT, o Banco Central implementou um mecanismo de controle de uso, conhecido como "balde de fichas".
Esse sistema:
Evita sobrecarga nas consultas;
Previne abusos e acessos em massa;
Reduz o risco de tentativas de ataque (como leitura em massa de chaves);
Protege os dados dos usuários.
O modelo está descrito na Seção 13 do Manual Operacional do DICT e se aplica a todas as instituições participantes
É essencial que os parceiros respeitem as regras estabelecidas pelo Banco Central, pois o descumprimento pode levar à suspensão temporária ou até ao bloqueio do acesso à API.
⚙️Como funciona o balde de fichas
Cada CPF ou CNPJ possui um balde exclusivo de fichas, mesmo que haja múltiplas contas vinculadas. O balde define o número máximo de consultas que podem ser feitas em determinado período.
Tipo de cliente/Capacidade do balde: Pessoa Física (PF) até 10 fichas - Pessoa Jurídica (PJ) até 100 fichas
🔄Regras de consumo de fichas
1 ficha é consumida por: Consulta válida de chave Pix; Solicitação de cash-out (retirada de valores).
20 fichas são consumidas se: A consulta for inválida (chave inexistente ou incorreta); A transação não for concluída com sucesso. Se a transação for bem-sucedida, a ficha é devolvida ao balde.
⚠️ Atenção: Ao atingir o limite de fichas disponíveis, o cliente não poderá realizar novas consultas ao DICT e receberá o erro: [limite de consultas excedido | onz-0009]
⏱️Reposição automática
A cada 1 minuto, são repostas 2 fichas automaticamente, até atingir o limite máximo do balde.
Esse mecanismo se aplica em todos os ambientes, inclusive em integrações com alto volume de requisições.
💡Dica importante
Se notar um consumo elevado de fichas, é recomendável:
Revisar as requisições enviadas ao DICT;
Evitar consultas com dados incorretos ou repetidos;
Monitorar erros e logs de integração para identificar padrões de falhas.