Limites de uso

Não há limite numérico aplicado por chave na v1. Toda requisição a /v1 é registrada com a chave usada, a rota, o status e a duração, e esse histórico é o que embasa o limite quando ele entrar.

Prefira webhook a polling: a mudança de estado de uma cobrança chega por evento, sem custo de consulta. Se precisar consultar, use intervalo crescente, começando em 30 segundos.

Nas listagens, use limit=100 e o cursor em vez de várias páginas pequenas, e filtre por created_after para buscar só o que mudou desde a última sincronização.

A resposta será 429, no mesmo formato dos outros erros, e esta página passará a documentar a janela e a cota. Trate 429 desde já com recuo exponencial: é a única resposta que vale a pena repetir sem mudar nada no payload.