O que é e como lidar com o Rate Limit no Pix?

O Rate Limit é um mecanismo de segurança que limita a quantidade de requisições que sua aplicação pode enviar para as APIs da Celcoin em um determinado intervalo de tempo. No ecossistema Pix, esse controle garante que o sistema permaneça estável para todos os usuários, evitando sobrecargas.

Como identificar que você atingiu o limite?

Quando o volume de chamadas excede o limite configurado para sua conta, a API retornará o código de erro HTTP 429 (Too Many Requests).

Boas práticas para evitar o bloqueio:

• Implemente Retry com Backoff Exponencial: Se receber um erro 429, não reenvie a requisição imediatamente. Configure sua aplicação para aguardar um tempo crescente entre as tentativas (ex: 1s, 2s, 4s...).

• Otimize as Consultas com Webhooks: Evite consultar o status de um Pix repetidamente via GET. Utilize os Webhooks, que entregam a confirmação de forma passiva assim que o Banco Central liquida a transação.

• Distribuição de Carga: Se precisar realizar grandes lotes de pagamentos (Cash-out), distribua as chamadas ao longo de alguns minutos em vez de disparar todas no mesmo segundo.

Diferenças entre Ambientes:

• Sandbox (Homologação): Possui limites mais restritos, voltados para testes de integração.

• Produção: Os limites são dimensionados de acordo com o volume de transações previsto em seu contrato.

Dica Técnica: Se a sua operação cresceu e você está atingindo o Rate Limit constantemente, mesmo com o uso de Webhooks e código otimizado, entre em contato com seu Gerente de Contas para solicitar um ajuste de quota.