429 Too Many Requests em vez de processar a chamada.
Limites
Além do limite geral, o polling de eventos tem uma cadência própria: uma chamada a cada 30 segundos, exceto para drenar uma fila acumulada. Veja Consultar novos pedidos.
Ao receber 429
1
Pare de enviar
Não repita a chamada imediatamente: cada tentativa dentro da janela conta para o limite.
2
Espere
Se a resposta trouxer o header
Retry-After, espere o tempo indicado. Sem ele, espere ao menos a janela de 10 segundos.3
Repita com backoff
Tente de novo dobrando a espera a cada
429 seguido (10 s, 20 s, 40 s…), com um teto.Boas práticas
Reaproveite o token. Ele vale 24 horas. Pedir um token por chamada dobra o número de requisições sem ganho nenhum.
Prefira webhook a polling agressivo. O webhook entrega cada evento na hora, sem consumir o seu limite.
Use cache para o que muda pouco. Catálogo, dados da loja e horários de funcionamento não precisam ser consultados a cada pedido.
Espalhe as rotinas em lote. Sincronizações de muitas lojas devem ser distribuídas no tempo, não disparadas todas no mesmo segundo.