GoCardless 429 rate_limit_exceeded: demasiados pedidos por minuto

O que diz a GoCardless

A página de limites da GoCardless indica o número: 1 600 pedidos por minuto numa integração padrão e 1 600 por minuto e por comerciante numa integração de parceiro. Ao ultrapassá-lo, a API devolve o 429, e a GoCardless esclarece que estes pedidos podem ser repetidos sem problema: «These requests are safe to retry.». Para saber quando, remete para os cabeçalhos da resposta: ratelimit-limit, ratelimit-remaining e ratelimit-reset.

De onde vêm tantos pedidos

O limite conta todos os pedidos à API, não só os que criam cobranças. Com o conector, cada cobrança com um mandato guardado é um pedido, quer venha de uma subscrição que se renova quer de um pagamento registado com o método de pagamento do cliente. Cada evento de um pagamento que chega ao Odoo é outro, porque o conector não confia apenas no aviso: pede esse pagamento à GoCardless e aplica o estado que ela devolve. Um lote grande no mesmo momento, como muitas renovações ao mesmo tempo enquanto chegam os eventos das cobranças anteriores, soma as duas coisas.

A GoCardless classifica este reason entre os erros invalid_api_usage, os que vêm da forma como o pedido é feito, e para estes pede que se avise a equipa técnica («alert your dev team»). Um 429 isolado não o exige; um que se repete todos os dias, sim.

O que faz o conector

1. Lê o cabeçalho ratelimit-reset e calcula quanto falta: a hora que indica menos a do servidor do Odoo.
2. Espera esse tempo, no mínimo 1 segundo e no máximo 65. Se o cabeçalho faltar ou não puder ser lido, espera 1 segundo. O teto existe para que um relógio mal configurado não deixe bloqueado o processo do Odoo que aguarda.
3. Repete o pedido uma única vez.
4. Se a repetição voltar a receber um 429, já não espera mais: trata-o como qualquer outra rejeição da API.

O conector não conta os seus pedidos nem os trava antecipadamente. Não lê ratelimit-remaining: só espera quando a GoCardless já respondeu com 429.

Se o segundo pedido também falhar

Depende do que o Odoo estava a fazer naquele momento.

• Se era uma cobrança, a transação passa a «Erro» com «A GoCardless rejeitou o pedido.» e, por baixo, a mensagem da GoCardless com rate_limit_exceeded e o request_id entre parênteses retos. A fatura continua pendente de cobrança.
• Se estava a aplicar um evento da GoCardless, o webhook responde 500 para que a GoCardless volte a enviar, e os eventos que já foram aplicados não são aplicados duas vezes. A recuperação de cada hora também não deixa para trás um evento que falhou: volta a pedi-lo na passagem seguinte.

Um 429 não é o mesmo que uma cobrança sem resposta. Sem resposta, o conector não sabe se a GoCardless criou a cobrança, por isso deixa-a pendente e volta a enviá-la, com a mesma chave, em menos de uma hora. Com um 429 há resposta: a GoCardless não aceitou o pedido, e por isso a transação fica em erro.

Esta mensagem aparece no idioma de quem lança a cobrança. Se a lança uma ação agendada, como a renovação de uma subscrição, escreve-se sem ninguém à frente: numa base de dados criada em português aparece assim, e numa criada em inglês e passada depois para português, em inglês: «GoCardless rejected the request.».

O que fazer

• Abra a transação a partir da fatura, com o botão «Transação de Pagamento» no topo; o menu de transações só aparece em modo de programador, e no Odoo 20 não existe. Se a mensagem mencionar rate_limit_exceeded, a GoCardless rejeitou esse pedido por causa do limite, não por causa do cliente nem do seu mandato.
• Passado algum tempo, volte a cobrar a fatura com o método de pagamento guardado do cliente.
• Se acontecer com frequência, verifique a hora do servidor do Odoo: a espera resulta de subtraí-la à de ratelimit-reset, e um relógio adiantado encurta-a.
• Se precisar da GoCardless, guarde o request_id da mensagem: a documentação pede que o inclua ao contactar o seu suporte.

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector trata o 429 como uma pausa: espera o tempo que a GoCardless pede, repete uma vez e, se o limite continuar, deixa a transação em erro com o request_id, para que saiba o que aconteceu e o que dar à GoCardless.

Continue a ler