GoCardless refund_payment_invalid_state: esta cobrança ainda não pode ser reembolsada

O que diz a GoCardless

Na referência dos reembolsos, a GoCardless acrescenta um prazo: «A refund can only be created once it is outside the safer refund period (7 calendar days after the charge date) otherwise an error is returned.». Esse período pode ser retirado: «The safer refund period can be disabled by contacting GoCardless.». E recorda porque existe: «A payment that has been (partially) refunded can still receive a late failure or chargeback from the customer's bank.».

Os reembolsos pela API, além disso, vêm desligados: «This endpoint is disabled by default. To enable it, you will need to enable refunds on your GoCardless Dashboard.».

As regras de prazo, num relance

As duas contagens não começam no mesmo sítio. A GoCardless conta a partir da data de débito do pagamento. O conector conta a partir da última mudança de estado da transação da cobrança no Odoo. Se a GoCardless tiver retirado o período seguro, entre 2 e 7 dias o reembolso pode avançar.

Quando sai refund_payment_invalid_state com o conector

O Odoo só deixa reembolsar uma transação confirmada, e o conector confirma-a quando a GoCardless indica confirmed ou paid_out. Por isso, com o conector, este reason quer dizer que o pagamento mudou na GoCardless e o Odoo ainda não o sabe: uma falha tardia, que a GoCardless pode comunicar com o pagamento já confirmado, ou uma devolução do cliente cujo evento ainda não chegou.

O que faz o conector

1. Com menos de 2 dias, não envia nada: o Odoo para com «A GoCardless não pode reembolsar uma cobrança até esta estar liquidada. Esta foi debitada há … dia(s); os reembolsos são possíveis após 2 dias.».
2. Caso contrário, envia o reembolso à GoCardless com a sua chave de idempotência. Se a GoCardless o rejeitar, por este reason, pelo período seguro ou por qualquer outro motivo, 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.
3. Se aceitar, a transação fica «Pendente» com «Reembolso enviado. A GoCardless vai descontá-lo de uma liquidação futura.», e passa a «Confirmado» quando a GoCardless o pagar ou o descontar numa liquidação.

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, e não há nada que a GoCardless possa voltar a tentar. Se a GoCardless não conseguir que o dinheiro chegue ao cliente, o conector passa o reembolso para erro com «A GoCardless não conseguiu pagar este reembolso (…).». 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 could not pay this refund back (…).».

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. Se o reason for refund_payment_invalid_state, veja o pagamento no Dashboard da GoCardless. Se falhou tarde ou o cliente o devolveu, não há nada para reembolsar: o dinheiro já não está consigo. O Odoo refletirá isso quando o evento chegar; a tarefa que de hora a hora recupera os eventos perdidos trá-lo.
3. Se a recusa vier do período seguro, aguarde 7 dias desde a data de débito, ou peça à GoCardless que o retire.
4. Para reembolsar outra vez, faça-o a partir do pagamento da cobrança, com o seu botão de reembolso. O conector admite reembolsos parciais.

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector não envia reembolsos de cobranças com menos de 2 dias, deixa em erro, com o seu request_id, os que a GoCardless rejeita, e não oferece tentar de novo um reembolso, que não é uma cobrança.

Continue a ler