Consultas periódicas e limites

Use webhooks para receber atualizações de cobranças e saques. Consultas repetidas da mesma entidade têm limite de 30 requisições por 60 segundos por conta e entidade, compartilhado entre as chaves de API. Entidades diferentes têm cotas independentes. Os aliases de cobrança compartilham a cota, incluindo IDs públicos com prefixo ch_ e IDs sem prefixo.

O limite se aplica a GET /v1/charges/:id, GET /v1/payments/:id e GET /v1/withdrawals/:id (e ao alias GET /v1/pix/charges/:id, se registrado). Listagens e criação permanecem iguais.

Ao receber HTTP 429 com error.code = entity_rate_limited, aguarde pelo menos os segundos indicados em Retry-After. Aumente progressivamente o intervalo entre tentativas e adicione variação aleatória. Não alterne chaves de API para tentar novamente. A janela fixa de 60 segundos começa na primeira consulta. Se o Redis estiver indisponível, as consultas continuam.

Sua conta recebe no máximo um e-mail por dia UTC, no idioma de comunicação escolhido, recomendando webhooks.