GoCardless refer_to_payer: MS02, MS03, RR04 e SL01 numa cobrança SEPA

Uma causa, quatro códigos

As três linhas vêm da tabela de falhas de pagamento (payments · failed) da documentação da GoCardless para o SEPA Core. Ao contrário de outras causas, nenhuma indica que o mandato seja cancelado: o cliente continua autorizado a ser cobrado, embora este débito concreto não tenha passado.

O que está por detrás de cada código

MS02 é a resposta mais clara: o cliente disse ao seu banco que não pagasse aquele recibo. O conector anota no seu código que é a combinação que viu num pagamento SEPA de teste do sandbox da GoCardless. MS03 e RR04 são o contrário: o pagamento falha e o banco não dá o motivo, normalmente por razões regulamentares, por isso a única forma de saber o que se passa é perguntar ao cliente. SL01 aponta para a conta: o banco limita os débitos diretos que lhe podem ser cobrados, e só o titular o pode alterar junto do seu banco.

Com MS02, RR04 e SL01, voltar a apresentar o débito sem falar antes com o cliente costuma acabar da mesma forma e pode custar outra comissão. MS03 tem uma exceção: segundo o guia do Success+, na Áustria, Bélgica, Alemanha, Luxemburgo e Eslováquia o MS03 conta como falta de fundos, e o Success+ pode tentar novamente. Se for esse o caso, o evento chega com will_attempt_retry a true.

O que faz o Odoo com o conector

A transação abre-se 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. O conector guarda a causa no campo «Causa segundo a GoCardless», não o código SEPA, e mostra «A GoCardless não conseguiu cobrar este pagamento (refer_to_payer).». Depois segue o que disser o evento:

• Se will_attempt_retry vier a true, a transação fica «Pendente», a caixa «O Success+ vai tentar novamente» é marcada e a mensagem diz: «O Success+ vai tentar novamente de forma automática; não é preciso fazer nada.». O botão de nova tentativa não aparece.
• Caso contrário, a transação passa a «Erro» e aparece o botão «Tentar cobrar novamente», se ainda houver tentativas. Se o Odoo já tivesse dado a cobrança como feita, o conector anula o seu pagamento e a fatura volta a estar pendente de cobrança.
• O mandato não é alterado. refer_to_payer não está entre as causas com as quais o conector arquiva um mandato, por isso o método de pagamento do cliente continua disponível para a próxima cobrança.

Este último ponto é deliberado: arquivar o mandato por uma recusa pontual obrigaria o cliente a assinar outro sem motivo.

As duas mensagens são escritas pelo conector ao aplicar o evento, sem ninguém presente. Numa base de dados criada em português aparecem em português; numa criada em inglês e depois passada para português aparecem em inglês: «GoCardless could not collect this payment (refer_to_payer).» e «Success+ will retry it automatically; there is nothing to do.».

O que fazer conforme o código

O Odoo não diz qual dos quatro códigos chegou: o conector só guarda a causa. O código vê-o na GoCardless. Segundo o seu centro de ajuda, o motivo de cada falha aparece na cronologia do pagamento, no Dashboard («You are able to view the reason for a payment failure in the status timeline of the payment in your GoCardless dashboard.»). No modo avançado, o código exato também vem no evento (details.reason_code), e o Dashboard guarda os envios dos últimos 3 meses em Developers > Webhooks, com o seu conteúdo.

Quando o cliente confirmar que a cobrança vai passar, use «Tentar cobrar novamente» na transação e confirme o aviso da comissão. O conector responde «Nova tentativa pedida. A GoCardless vai confirmar a nova data de débito.» e deixa-a pendente. Lembre-se do limite: um pagamento pode ser repetido no máximo 3 vezes («Payments can be retried up to 3 times.»).

Com o nosso conector

No Odoo 17, 18, 19 e 20 o conector transforma refer_to_payer numa fatura pendente com a causa à vista e um mandato que continua válido. Não adivinha o código SEPA: o Odoo guarda a causa na transação, e o código consulta-o na GoCardless. A decisão de voltar a cobrar é sua, depois de falar com o cliente.

Continue a ler