---
updatedAt: 2025-02-19T02:54:15.000Z
agentTools:
  projectIndex: https://devs.bs2.com/llms.txt
---

# Balde de Fichas

O Banco Central realiza o controle do fluxo de acesso ao DICT utilizando algoritmo de token bucket.

Existem dois baldes de fichas: um para chaves do tipo **E-MAIL** e **PHONE** e outro para chaves do tipo **CPF**, **CNPJ** e **chave aleatória** (EVP).

Cada balde possui capacidade máxima de 1000 fichas, e há reposição de 20 fichas por minuto até a capacidade máxima do balde.

> ⚠️ Importante:
>
> Caso haja esvaziamento do balde de fichas, não será possível realizar requisições ao DICT.

#

## Política de uso do balde de fichas

Regra de contagem da política **antiscan** usando as APIs do Banco BS2:

* Quando há sucesso na iniciação de pagamento, subtrai-se 1 ficha;
* Quando é realizada uma confirmação de pagamento no Banco Central pelo Banco BS2, adiciona-se 2 fichas;
* Quando há iniciação de pagamento para chave inexistente, subtrai-se 20 fichas;

Disponibilizamos a funcionalidade [TokenBucket - Obter](https://devs.bs2.com/reference/get_pix-direto-forintegration-v1-chaves-token-bucket-situacao-1)  onde retornaremos o nível de fichas no balde do cliente, que pode ser:

* Status 1: quantidade de fichas do balde acima de 600 fichas;
* Status 2: quantidade de fichas do balde entre 300 e 600 fichas;
* Status 3: quantidade de fichas do balde abaixo de 300 fichas;

#

> 📝 Nota:
>
> A limitação por parte dos token bucket não ocorrerá nas iniciações por dados manuais, pois neste caso, não haverá acesso ao DICT.
>
> No [Manual Operacional do DICT](https://www.bcb.gov.br/estabilidadefinanceira/pix?modalAberto=regulamentacao_pix) o BACEN explana sobre a política de uso do balde virtual.