GoCardless refer_to_payer: MS02, MS03, RR04 e SL01 in un addebito SEPA

Una causa, quattro codici

Le tre righe provengono dalla tabella dei pagamenti falliti (payments · failed) della documentazione di GoCardless per SEPA Core. A differenza di altre cause, nessuna dice che il mandato viene annullato: il cliente resta autorizzato ad addebitarti, anche se questo specifico addebito non è andato a buon fine.

Cosa c'è dietro ogni codice

MS02 è la risposta più chiara: il cliente ha detto alla sua banca di non pagare quella ricevuta. Il connettore annota nel suo codice che è la combinazione che ha visto in un pagamento SEPA di prova della sandbox di GoCardless. MS03 e RR04 sono il contrario: il pagamento fallisce e la banca non fornisce il motivo, di solito per ragioni normative, quindi l'unico modo per saperlo è chiederlo al cliente. SL01 riguarda il conto: la sua banca limita gli addebiti diretti che possono essergli addebitati, e questo può cambiarlo solo il titolare con la propria banca.

Con MS02, RR04 e SL01, ripresentare l'addebito senza prima parlare con il cliente di solito finisce allo stesso modo e può costare un'altra commissione. MS03 ha un'eccezione: secondo la guida di Success+, in Austria, Belgio, Germania, Lussemburgo e Slovacchia MS03 viene considerato come fondi insufficienti, e Success+ può riprovare. In tal caso l'evento arriva con will_attempt_retry impostato a true.

Cosa fa Odoo con il connettore

La transazione si apre dalla fattura, con il pulsante «Transazione di pagamento» in alto; il menu delle transazioni compare solo in modalità sviluppatore e in Odoo 20 non esiste. Il connettore salva la causa nel campo «GoCardless Cause», non il codice SEPA, e mostra «GoCardless could not collect this payment (refer_to_payer).». Poi segue quanto indicato dall'evento:

• Se will_attempt_retry è true, la transazione passa a «In sospeso», la casella «Success+ Will Retry» viene spuntata e il messaggio dice «Success+ will retry it automatically; there is nothing to do.». Il pulsante per riprovare non compare.
• Altrimenti la transazione passa a «Errore» e compare il pulsante «Retry collection», se restano dei tentativi. Se Odoo considerava già il pagamento incassato, il connettore annulla il suo pagamento e la fattura torna da incassare.
• Il mandato non viene toccato. refer_to_payer non è tra le cause per cui il connettore archivia un mandato, quindi il metodo di pagamento del cliente resta disponibile per il successivo addebito.

Quest'ultimo punto è voluto: archiviare il mandato per un rifiuto puntuale costringerebbe il cliente a firmarne un altro senza motivo.

I due messaggi li scrive il connettore nell'applicare l'evento, senza che nessuno intervenga. Il connettore non è tradotto in italiano: questi testi compaiono sempre in inglese, anche in un Odoo in italiano, sia che li avvii un utente sia un'azione pianificata: «GoCardless could not collect this payment (refer_to_payer).» e «Success+ will retry it automatically; there is nothing to do.».

Cosa fare in base al codice

Odoo non ti dice quale dei quattro codici è arrivato: il connettore salva solo la causa. Il codice lo vedi in GoCardless. Secondo il loro centro di assistenza, il motivo di ogni fallimento compare nella cronologia del pagamento, nella Dashboard («You are able to view the reason for a payment failure in the status timeline of the payment in your GoCardless dashboard.»). In modalità avanzata, il codice esatto è anche nell'evento (details.reason_code), e la Dashboard conserva gli invii degli ultimi 3 mesi in Developers > Webhooks, con il loro contenuto.

Quando il cliente conferma che l'addebito andrà a buon fine, usa «Retry collection» sulla transazione e conferma l'avviso sulla commissione. Il connettore risponde «Retry requested. GoCardless will confirm the new charge date.» e la lascia in sospeso. Ricorda il limite: un pagamento può essere riprovato al massimo 3 volte («Payments can be retried up to 3 times.»).

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore trasforma refer_to_payer in una fattura da incassare con la causa in vista e un mandato che resta valido. Non deduce il codice SEPA: Odoo salva la causa nella transazione, e il codice lo consulti in GoCardless. La decisione di riprovare a incassare spetta a te, dopo aver parlato con il cliente.

Continua a leggere