GoCardless total_amount_confirmation_invalid: o total reembolsado não bate certo

O que diz a GoCardless

A referência dos reembolsos explica o primeiro: «total_amount_confirmation_invalid if the confirmation amount doesn't match the total amount refunded for the payment.». E para que serve: «This safeguard is there to prevent two processes from creating refunds without awareness of each other.».

Esse campo, diz a GoCardless, é a soma dos reembolsos que o pagamento já tem mais o que se cria, em cêntimos. No exemplo deles, um reembolso de 100 leva um total_amount_confirmation de 150: desse pagamento já tinham sido devolvidos 50.

Como o conector calcula esse valor

Para cada reembolso, o conector soma os reembolsos dessa cobrança que, no Odoo, estão pendentes, autorizados ou concluídos, e acrescenta o novo. Os que estão em erro não contam. Essa soma vai como total_amount_confirmation.

Que contem também os pendentes é importante: um reembolso em curso já foi pedido à GoCardless, e se não fosse somado, o valor ficaria aquém e a GoCardless rejeitaria o seguinte.

Quando não bate certo

O valor sai do que o Odoo sabe. Se alguém devolveu dinheiro dessa cobrança por um caminho que não passa pelo Odoo, por exemplo com outro programa ligado à mesma conta GoCardless, a GoCardless tem esse registo e o Odoo não. O total enviado pelo conector fica aquém, e a GoCardless rejeita o reembolso. É exatamente o caso para que existe esta salvaguarda: se o aceitasse, o cliente receberia duas vezes o mesmo dinheiro.

number_of_refunds_exceeded é outra coisa: o conector permite reembolsos parciais, e a GoCardless admite no máximo 5 por pagamento. O sexto é rejeitado mesmo que ainda falte devolver valor.

O que faz o Odoo com o conector

No Odoo, uma cobrança reembolsa-se a partir do seu pagamento, com o botão de reembolso, e só se a sua transação estiver confirmada. O conector envia o reembolso com a sua chave de idempotência e, se a GoCardless o rejeitar, a transação do reembolso 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.

Desde a versão 1.1.5, um reembolso em erro não mostra o botão «Tentar cobrar novamente»: um reembolso não é uma cobrança.

O que fazer

1. Abra a transação da cobrança 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. A partir dela, o botão de reembolsos leva à transação do reembolso e à sua mensagem.
2. Com total_amount_confirmation_invalid, consulte no Dashboard da GoCardless os reembolsos desse pagamento. Se houver algum feito fora do Odoo, o dinheiro já voltou ao cliente: não o devolva outra vez a partir do Odoo.
3. Com number_of_refunds_exceeded, esse pagamento já não aceita mais reembolsos na GoCardless. Se ainda tiver de devolver algo, terá de ser por outra via.
4. Para não chegar ao limite, junte num único reembolso tudo o que haja a devolver de uma mesma cobrança.
5. Se precisar da GoCardless, guarde o request_id da mensagem: a documentação deles pede que o inclua ao contactar o suporte.

Com o nosso conector

No Odoo 17, 18, 19 e 20, o conector envia em cada reembolso o total reembolsado dessa cobrança, contando os que estão em curso, para que a GoCardless trave um reembolso duplicado em vez de o pagar, e deixa a rejeição na transação com o seu request_id.

Continue a ler