GoCardless mandate_not_inactive: o mandato não pode ser reativado

O que diz a GoCardless

A GoCardless separa as duas partes do texto com um travessão. Na referência da API detalha: «This will fail with a mandate_not_inactive error if the mandate is already being submitted, or is active.». É um erro invalid_state, e para esses a GoCardless pede que se avise o utilizador e não se volte a tentar («invalid_state → inform the end user, do not allow retry.»).

Que mandatos se podem reativar

A reativação tem mais condições do que o estado:

• É uma função restrita: «Restricted this endpoint requires approved custom payment pages».
• Só vale para um mandato cancelado através do Dashboard ou da API: «A mandate can only be reinstated if it has been cancelled through the dashboard or the API.». Um que cancelou o banco, não: «Any mandate that has been cancelled by the bank cannot be reinstated.».
• Serve para mandatos cancelados ou expirados («Reinstates a cancelled or expired mandate to the banks.»), e um mandato pode voltar a ser apresentado até 10 vezes («Mandates can be resubmitted up to 10 times.»).

Depois de a pedir, o processo é o de uma adesão: chega resubmission_requested e depois, como diz a GoCardless, «so you will receive a submitted webhook, followed by a reinstated or failed webhook up to two working days later.».

O que o Odoo faz com o conector

Na ficha do método de pagamento do cliente, o conector mostra o botão «Reativar mandato (sandbox)». Só aparece se o mandato for da GoCardless, o fornecedor não estiver em produção (no Odoo 17, 18 e 19, o estado do fornecedor; no Odoo 20, a caixa de produção) e «Estado do mandato» for cancelled, failed ou expired.

Ao carregar nele:

1. O conector pede à GoCardless a reativação desse mandato.
2. Se a GoCardless a aceitar, o estado passa a reinstate_requested e na ficha do cliente fica «Foi pedida a reativação do mandato da GoCardless. Não poderá ser usado até o banco o confirmar.». O método de pagamento continua arquivado.
3. Quando chega reinstated, o conector volta a dá-lo por válido: reativa-o e escreve «O mandato GoCardless pode voltar a ser usado (reinstated).».

Se a GoCardless responder mandate_not_inactive, o conector não o captura: o Odoo mostra «A GoCardless rejeitou o pedido.» com a mensagem da GoCardless, o reason e o request_id, e o mandato fica como estava. Acontece quando o Odoo acha que o mandato está morto e na GoCardless já está ativo ou em apresentação, porque os seus eventos ainda não chegaram ao Odoo. Depois de um pedido aceite, o botão deixa de aparecer, porque o estado passa a reinstate_requested.

A nota de que o mandato pode voltar a ser usado é escrita pelo conector ao aplicar o evento, sem ninguém à frente. 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: «The GoCardless mandate is usable again (reinstated).».

O que fazer

1. Se aparecer mandate_not_inactive, procure o mandato no Dashboard da GoCardless. Se estiver ativo ou em apresentação, não há nada a reativar: espere que cheguem os seus eventos. A tarefa que de hora a hora recupera os eventos em falta trá-los.
2. Se o mandato foi cancelado pelo banco, não tente: a GoCardless não reativa esses. Peça ao cliente um mandato novo.
3. Em produção, o conector não oferece a reativação: o caminho é um mandato novo assinado pelo cliente.
4. Para testar, use o sandbox da GoCardless com o fornecedor em testes.

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector só oferece reativar um mandato cancelado, falhado ou expirado, e só fora de produção, e não volta a usá-lo até a GoCardless confirmar a reativação com o seu evento.

Continue a ler