Limite de requisições

O limite é aplicado por chave de API. Chaves diferentes têm orçamentos independentes — é mais um motivo para separar a chave do checkout da chave do worker.

Ao estourar, a resposta é 429 com o envelope de erro padrão.

Como reagir

• Repita com backoff exponencial e jitter, nunca em laço apertado.
• Respeite o header Retry-After quando ele vier.
• Trabalhos em lote (relatório, conciliação) vão para uma fila com concorrência limitada, fora do caminho da requisição do cliente.

O que costuma estourar o limite sem necessidade

• Polling de status de segundo em segundo em vez de webhook.
• Consultar a mesma cobrança em toda renderização de tela.
• Reprocessar histórico inteiro a cada execução do worker, em vez de partir da última posição.