GoCardless mandate_replaced: o mandato tem um substituto

O que diz a GoCardless

A documentação de eventos explica-o assim: «The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).». E o que traz o evento: «The event will include links[new_mandate] with the ID of the new mandate.».

mandate_replaced é um erro invalid_state: a ação não vale no estado atual do recurso. Para estes erros a GoCardless pede que se avise o utilizador e que não se volte a tentar («invalid_state → inform the end user, do not allow retry.»).

Quando aparece

A mudança não é provocada pelo cliente nem pelo seu banco: o evento replaced tem origem gocardless, e a causa documentada é que o credor, a conta com que cobra na GoCardless, passou para outro identificador de esquema. A GoCardless cancela o mandato antigo e cria um novo no seu lugar.

mandate_replaced só aparece se o Odoo tentar cobrar com o mandato antigo: a cobrança de uma subscrição que se renova, ou um pagamento registado com o método de pagamento guardado do cliente, antes de o Odoo ter aplicado o evento.

O que faz o Odoo com o conector

Com o evento replaced:

1. Toma o mandato novo de links.new_mandate.
2. Passa para esse mandato o método de pagamento guardado do cliente e dá-o por válido, em vez de o dar por perdido. Se o método estava arquivado, reativa-o; o Odoo 17 não permite desarquivar um método de pagamento, e aí o conector cria um novo para o mandato novo.
3. Escreve-o na ficha do cliente: «O mandato GoCardless pode voltar a ser usado (replaced).».

Essa nota é escrita pelo conector ao aplicar o evento, sem ninguém à frente. Numa base de dados criada em português sai assim; numa criada em inglês e passada depois para português, em inglês: «The GoCardless mandate is usable again (replaced).».

Com mandate_replaced numa cobrança, o conector não faz nada de especial: ao criar uma cobrança trata à parte apenas mandate_is_inactive. A transação passa a «Erro» com «A GoCardless rejeitou o pedido.» e, por baixo, a mensagem da GoCardless com mandate_replaced e o request_id entre parênteses retos. O mandato novo é tirado do evento, não do erro. Essa mensagem sai no idioma de quem lança a cobrança; se a lança uma ação agendada, numa base criada em inglês e passada depois para português sai em inglês: «GoCardless rejected the request.».

O que fazer

1. Se uma cobrança ficar em erro com mandate_replaced, 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.
2. Veja na ficha do cliente se já está a nota de que o mandato pode voltar a ser usado (replaced). Se estiver, o método de pagamento já aponta para o mandato novo.
3. Se não estiver, o evento ainda não chegou. A tarefa que a cada hora recupera os eventos perdidos trá-lo; se demorar mais do que isso, verifique se os webhooks da GoCardless chegam ao Odoo.
4. Com o método de pagamento atualizado, volte a cobrar a fatura.

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector segue o mandato novo assim que a GoCardless avisa da substituição: o cliente mantém o seu método de pagamento e a fatura seguinte é cobrada com o mandato que a GoCardless deixou no seu lugar.

Continue a ler