Un bonifico accettato non è un bonifico arrivato

«Accettato» non vuol dire «arrivato»

Lei invia un lotto di pagamenti. L'API risponde in due secondi, ogni riga porta un identificativo, e lo stato dice PENDING o SUCCESS a seconda del fornitore. Il suo pannello mostra «inviato», l'affiliato riceve un'e-mail che gli annuncia il pagamento, e tutti passano ad altro.

Solo che la risposta che ha appena ricevuto non dice che i fondi sono arrivati. Dice che la richiesta è stata accettata per l'elaborazione. Sono due affermazioni molto diverse, e lo scarto tra le due può durare trenta giorni.

Il caso PayPal, nel dettaglio

Un pagamento PayPal verso un indirizzo e-mail segue questo percorso:

1. Lei invia il lotto. PayPal accetta e restituisce un identificativo di lotto.
2. Se l'indirizzo corrisponde a un conto PayPal confermato, i fondi arrivano in pochi minuti. È il caso più frequente, ed è quello che dà fiducia nel resto.
3. Se l'indirizzo non corrisponde ad alcun conto confermato, PayPal mette il pagamento in attesa e invia un messaggio a quell'indirizzo: «qualcuno le ha inviato un pagamento, crei un conto per riceverlo».
4. La persona ha trenta giorni. Trascorso questo termine, il pagamento è UNCLAIMED, poi RETURNED, e i fondi tornano sul suo saldo.

Ci sono altri percorsi di ritorno: un conto chiuso, un paese non servito, un indirizzo con un errore di battitura, un blocco di conformità. Il punto in comune è che nulla di tutto ciò è noto nel momento in cui l'API le ha risposto.

Che cosa succede se nessuno controlla

Una piattaforma che si ferma alla prima risposta produce una situazione precisa, e sgradevole:

• La sua contabilità indica 128 € pagati, e i fondi sono sul suo saldo PayPal.
• Il saldo dell'affiliato è a zero, mentre Lei gli deve ancora 128 €.
• È stata emessa una fattura per un pagamento che non è avvenuto.
• L'affiliato ha ricevuto un'e-mail che gli annunciava un pagamento che non ha mai ricevuto.

E soprattutto: è lui a farglielo sapere, spesso settimane dopo, spesso irritato. Lei apre PayPal, non ritrova la riga, deve cercarla, e nel frattempo la persona che le porta vendite si chiede se sarà pagata.

La cosa peggiore di un bonifico tornato indietro non è la somma. È che l'unica persona al corrente sia quella che aspetta i fondi.

Che cosa fare invece

Interrogare fino a una risposta che non può più cambiare

Ogni riga partita deve restare in uno stato «in corso» ed essere interrogata di nuovo periodicamente — qui, ogni ora — finché il fornitore non dà uno stato definitivo: arrivato, fallito o tornato indietro. Finché la risposta può ancora cambiare, la riga non è chiusa.

Un'ora non è un numero magico. È un compromesso: abbastanza frequente perché Lei lo sappia in giornata, abbastanza distanziato da non far scattare limiti di frequenza dell'API su un lotto di duecento righe.

Annullare per intero, non a metà

Quando la risposta è «tornato indietro», ci sono cinque cose da fare, e farne quattro su cinque lascia il database incoerente:

1. Contrassegnare la riga come tornata indietro, con la sua data e il motivo restituito dal fornitore.
2. Ripristinare il saldo dell'affiliato, con una scrittura di segno opposto — non modificando la scrittura originale, che deve restare leggibile.
3. Riportare le vendite interessate a «da pagare», perché rientrino naturalmente nel lotto successivo.
4. Emettere una nota di credito numerata che indichi la fattura emessa. Una fattura non si cancella: si annulla.
5. Avvisare entrambe le parti. L'affiliato ha ricevuto un messaggio che diceva che era stato pagato: deve riceverne uno che lo corregga, e che gli dica che cosa fare.

Come averne di meno

Un rientro resta un caso raro, ma lo si può rendere ancora più raro.

• Chiedere l'indirizzo di pagamento all'iscrizione, non al momento del primo pagamento. L'affiliato lo verifica quando è attento, non quando è in attesa.
• Rifiutare un lotto incompleto invece di saltare delle righe. Un affiliato senza indirizzo deve comparire in una lista «impossibile da pagare» con il motivo, e ricevere un'e-mail — una volta, nel momento in cui Lei decide di pagare.
• Verificare la destinazione prima dell'invio quando il fornitore lo consente. Wise, per esempio, non accetta il solo indirizzo e-mail per tutte le destinazioni: per alcune servono le coordinate bancarie. Meglio saperlo prima di inviare.
• Una soglia minima. Inviare importi molto piccoli produce soprattutto costi e rientri.

La domanda da porre

A una piattaforma di affiliazione, o a chi scrive la sua:

Che cosa succede, esattamente, trenta giorni dopo che un pagamento PayPal è partito verso un indirizzo senza un conto confermato?

Se la risposta comincia con «si controlla in PayPal», il lavoro non è fatto. Dovrebbe cominciare con «Lei riceve un'e-mail, il saldo dell'affiliato viene ripristinato, e una nota di credito ha annullato la fattura».

Da leggere dopo