GoCardless internal_server_error e request_timed_out: a falha está na GoCardless

O que diz a GoCardless

A GoCardless agrupa estes reasons no tipo gocardless, o dos erros que se produzem dentro da GoCardless: «These errors occurred within GoCardless while processing your request.». A sua tabela de códigos HTTP diz isto sobre os dois códigos:

Na página de limites, a GoCardless fixa ainda quanto pode durar um pedido: 29 segundos («Request timeout 29 seconds»).

Três casos que o conector não trata da mesma forma

O conector espera a resposta da GoCardless até 30 segundos em cada pedido. Com uma cobrança, um reembolso ou uma nova tentativa, o Odoo pode deparar-se com três situações diferentes:

• A GoCardless responde com um 500 ou um 504, com o reason na resposta.
• A GoCardless não responde: a ligação corta-se ou esgotam-se os 30 segundos.
• A falha surge ao aplicar um evento, quando o conector pede à GoCardless o pagamento a que o evento se refere.

O que faz o conector

Com um 500 ou um 504. O conector só repete um pedido quando fica sem resposta ou depois de um 429. Com um 500 ou um 504 há resposta, por isso dá-a como rejeitada. Numa cobrança, a transação passa a «Erro» com «A GoCardless rejeitou o pedido.» e, por baixo, a mensagem da GoCardless com o reason e o request_id entre parênteses retos. A tarefa de cada hora não reenvia uma transação em erro. Se a GoCardless chegasse a criar a cobrança mesmo assim, o seu primeiro evento liga-a: cada cobrança leva nos seus metadados a referência da transação do Odoo, o conector procura-a com essa referência e aplica-lhe o estado do pagamento. Uma transação em erro volta assim a «Pendente» ou passa a «Confirmado».

Sem resposta. O conector repete o pedido uma vez, com a mesma chave de idempotência. Se também ninguém responder, não dá a cobrança por perdida: a transação fica pendente com «A GoCardless não respondeu, por isso ainda não se sabe se aceitou o pedido. Será enviado novamente, em segurança, dentro de uma hora.». A tarefa de cada hora volta a enviá-la com a mesma chave; se a GoCardless já a tiver criado, responde 409 e o conector adota o que já existe.

Ao aplicar um evento. Com cada evento de um pagamento, o conector pede esse pagamento à GoCardless. Se essa consulta falhar, 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.

Estes textos saem no idioma de quem lança a cobrança; se for uma ação agendada, como a renovação de uma subscrição, são escritos sem ninguém à frente: numa base de dados criada em português saem assim, e numa criada em inglês e passada depois para português, em inglês: «GoCardless rejected the request.» e «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.».

O que fazer

1. 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 indicar internal_server_error ou request_timed_out, a falha foi da GoCardless, não do cliente nem do seu mandato.
2. Antes de voltar a cobrar a fatura, procure a cobrança no Dashboard da GoCardless: o conector põe como descrição de cada cobrança a referência da sua transação do Odoo. Se estiver lá, não cobre de novo; o seu evento vai ligar a transação.
3. Se não estiver, volte a cobrar a fatura com o método de pagamento guardado do cliente. Uma cobrança nova é outra transação, com outra chave de idempotência: por isso convém verificar antes.
4. Se se repetir, escreva ao suporte da GoCardless com o request_id da mensagem: a sua documentação pede que o inclua ao contactar o suporte.

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector separa um erro da GoCardless de um pedido sem resposta: o primeiro fica em erro com o seu request_id, o segundo fica pendente e é reenviado com a mesma chave, e nos dois casos o evento de uma cobrança que existe liga-a à sua transação.

Continue a ler