Come funzionano gli Smart Retries di Stripe, e quando personalizzare i tempi dei nuovi tentativi

Quando un pagamento di abbonamento fallisce su Stripe Billing, Stripe può ritentare l’addebito in automatico. Smart Retries è l’impostazione che decide quando. È l’opzione consigliata da Stripe, e molti team la attivano e non ci guardano mai più.

Va per lo più bene. Ma è utile sapere cosa fanno davvero gli Smart Retries, cosa non possono fare e le poche situazioni in cui conviene cambiare i valori predefiniti. Questo articolo si attiene a ciò che dice la documentazione di Stripe, e segnala dove Stripe non pubblica dettagli.

Cosa sono gli Smart Retries

Smart Retries è la logica automatica di Stripe per ritentare i pagamenti di fatture falliti. Invece di ritentare in giorni fissi (per esempio 3, 5 e 7 giorni dopo il fallimento), Stripe usa un modello per scegliere quando eseguire ogni tentativo. La documentazione di Stripe descrive il modello come basato su segnali dinamici e dipendenti dal tempo per scegliere i momenti migliori.

Quello che Stripe non pubblica è l’elenco esatto dei segnali, il loro peso, o gli intervalli che sceglierà per un dato pagamento. Considera gli Smart Retries una scatola nera con qualche manopola intorno.

Dove si applicano

Gli Smart Retries si applicano alle fatture che Stripe incassa in automatico, il che copre la maggior parte dei rinnovi di abbonamento. Le fatture che invii per il pagamento manuale (in cui è il cliente a pagare la fattura) seguono invece le regole di incasso automatico di Stripe, che sono una configurazione diversa.

Stripe documenta anche gli Smart Retries per i pagamenti off-session fuori da Billing. Controlla quella pagina per la disponibilità nel tuo account, che potrebbe essere limitata.

Le impostazioni che controlli

Nella Dashboard di Stripe, le impostazioni dei nuovi tentativi si trovano nella sezione revenue recovery delle impostazioni di Billing. I controlli sono:

Impostazione	Opzioni	Raccomandazione di Stripe
Politica dei nuovi tentativi	Smart Retries o un calendario personalizzato	Smart Retries
Numero di tentativi (Smart Retries)	Configurabile	8 tentativi
Finestra dei tentativi (Smart Retries)	1 settimana, 2 settimane, 3 settimane, 1 mese o 2 mesi	2 settimane
Calendario personalizzato	Fino a 3 tentativi, ciascuno un numero fisso di giorni dopo il precedente	n/d
Dopo il fallimento dell’ultimo tentativo	Disdire l’abbonamento, segnarlo come unpaid o lasciarlo past due	A tua scelta

Il valore predefinito «8 tentativi in 2 settimane» viene dalla pagina Smart Retries di Stripe. Le etichette nella tua Dashboard possono cambiare leggermente nel tempo, quindi controlla direttamente la pagina.

Cosa significano le opzioni di fine tentativi

• Disdire l’abbonamento. L’abbonamento termina. Il cliente deve sottoscriverne uno nuovo per tornare.
• Segnare l’abbonamento come unpaid. L’abbonamento resta in piedi, ma Stripe smette di tentare il pagamento delle nuove fatture finché la situazione non si risolve. Utile se vuoi tenere l’account e ripristinare l’accesso quando il cliente paga.
• Lasciare l’abbonamento past due. L’abbonamento continua a funzionare e a generare fatture. È l’opzione più permissiva, e può accumulare fatture non pagate se non intervieni.

Separatamente, decidi cosa succede alla fattura non pagata stessa (per esempio, lasciarla aperta o segnarla come uncollectible). Fai entrambe le scelte consapevolmente; cambiano l’aspetto dei tuoi numeri di MRR e churn.

Cosa non fanno gli Smart Retries

Non ritentano da soli gli hard decline

Alcuni rifiuti significano che la carta semplicemente non può essere addebitata di nuovo. La documentazione di Stripe elenca gli hard decline code per cui non può ritentare in automatico:

• incorrect_number
• lost_card
• pickup_card
• stolen_card
• revocation_of_authorization
• revocation_of_all_authorizations
• authentication_required
• highest_risk_level
• transaction_not_allowed

Per questi, Stripe continua a programmare nuovi tentativi e l’attempt_count della fattura continua a salire, ma l’addebito parte davvero solo quando viene collegato un nuovo metodo di pagamento. In altre parole, il calendario dei tentativi aspetta il cliente. Se nessuno chiede al cliente una nuova carta, non succede nulla.

Non parlano con il cliente

I nuovi tentativi sono silenziosi. Non dicono al cliente che qualcosa non va. Stripe può inviare email ai clienti separate quando i pagamenti con carta falliscono, e un link per confermare i pagamenti quando la banca richiede l’autenticazione. Queste impostazioni sono indipendenti dagli Smart Retries, quindi verifica che siano attive.

Non conoscono i tuoi clienti

Il modello lavora sui segnali di pagamento. Non sa che i tuoi clienti sono per lo più insegnanti pagati l’ultimo giorno lavorativo del mese, che un cliente ha appena scritto al supporto dicendo di aver cambiato banca, o che l’ufficio finanza di un cliente B2B paga solo il martedì. Quel contesto vive nei tuoi sistemi, non in quelli di Stripe.

Come vedere cosa fanno gli Smart Retries

Puoi seguire i nuovi tentativi in due posti:

• Nella Dashboard, apri la fattura. La timeline mostra ogni tentativo e il suo decline code, più il prossimo tentativo programmato.
• Tramite API e webhook. L’oggetto Invoice ha i campi attempt_count e next_payment_attempt. Ascolta invoice.payment_failed per reagire a ogni fallimento, e invoice.paid per fermare qualsiasi seguito quando va a buon fine.

Un semplice registro di ogni fallimento (decline code, numero del tentativo, importo, data, se è stato poi pagato) basta per misurare come vanno i nuovi tentativi per te. Vedi la sezione sulla misurazione della guida completa ai pagamenti falliti per le formule.

Quando personalizzare i tempi dei nuovi tentativi

Gli Smart Retries sono un buon punto di partenza. Ecco i casi in cui vale la pena ripensarci.

1. I tuoi clienti vengono pagati in date prevedibili

Se la maggior parte dei tuoi clienti sono consumatori nello stesso paese, molti soft decline saranno insufficient_funds verso la fine del mese. Un tentativo subito dopo i giorni di paga comuni (per esempio l’1, il 15 o l’ultimo giorno lavorativo, a seconda del paese) può funzionare meglio di un modello addestrato su tutti. Non puoi comunicare i giorni di paga agli Smart Retries, quindi questo significa o un calendario personalizzato o una logica di nuovi tentativi fuori da Stripe.

2. Il tuo ciclo di fatturazione è breve

Sui piani settimanali, una finestra di 2 settimane significa che la fattura successiva viene creata prima che la precedente sia risolta. Accorcia la finestra, o usa un calendario personalizzato con tentativi meno numerosi e più ravvicinati.

3. Vendi alle aziende

I fallimenti B2B riguardano più spesso una carta sostituita, un limite di spesa o un processo dell’ufficio finanza, e meno i tempi. Meno tentativi e un contatto precoce con la persona giusta (spesso non l’utente che si è iscritto) tendono a contare più di tempi di nuovo tentativo precisi.

4. Ti serve una timeline prevedibile

Un calendario personalizzato rende facile allineare le email ai tentativi («riproveremo giovedì») e spiegare il processo al supporto. Gli Smart Retries sono per natura meno prevedibili.

5. Vuoi un periodo di tolleranza più lungo per i clienti di valore

Le impostazioni dei nuovi tentativi di Stripe valgono per tutto l’account. Se vuoi una finestra più lunga per i clienti annuali o di lunga data, ti serve una logica tua, come sospendere il flusso predefinito per quei clienti e gestirli a parte.

Smart Retries o calendario personalizzato

	Smart Retries	Calendario personalizzato
Tempi	Scelti dal modello di Stripe	Giorni fissi impostati da te
Numero di tentativi	Configurabile (8 consigliati)	Fino a 3
Finestra	Da 1 settimana a 2 mesi	Somma dei tuoi intervalli
Usa i dati dei tuoi clienti	No	No, ma scegli le date tenendone conto
Prevedibile per email e supporto	Meno	Sì
Sforzo	Nessuno	Basso

Se costruisci la tua logica di nuovi tentativi (per esempio, tentativi calibrati sull’ora locale e sul giorno di paga del cliente), in genere disattivi i nuovi tentativi automatici di Stripe per quelle fatture così i due sistemi non si sovrappongono. Testalo con cura prima in modalità test.

Una configurazione pratica per la maggior parte dei team SaaS

1. Tieni attivi gli Smart Retries, con gli 8 tentativi in 2 settimane consigliati per i piani mensili.
2. Imposta consapevolmente l’azione di fine tentativi. «Mark unpaid» è una buona via di mezzo se vuoi tenere l’account e ripristinare l’accesso al pagamento.
3. Attiva almeno le email di Stripe per i pagamenti falliti, o meglio, gestisci una tua sequenza di sollecito ai giorni 0, 3, 7 e 14.
4. Tratta gli hard decline in modo diverso: chiedi subito una nuova carta.
5. Attiva le email di autenticazione se vendi in Europa.
6. Registra ogni fallimento e misura il recupero per coorte.
7. Rivedi le impostazioni quando hai qualche mese di dati. Se la maggior parte dei tuoi fallimenti sono insufficient_funds di fine mese, testa tempi allineati al giorno di paga.

Come aiuta NoChurn

NoChurn lavora accanto a Stripe. Puoi tenere gli Smart Retries di Stripe, o lasciare che NoChurn ritenti i pagamenti falliti in momenti basati sui probabili giorni di paga e sull’ora locale del cliente. In entrambi i casi, invia email di recupero scritte dall’IA (giorno 0, 3, 7 e 14 per impostazione predefinita) nella lingua del cliente, controllate prima dell’invio, con un link a una pagina hosted di aggiornamento della carta. I dati della carta restano in Stripe; NoChurn non vede mai i numeri delle carte.

Si collega a Stripe in un clic. Il prezzo dipende solo dall’MRR, con tutte le funzioni in ogni piano (il tuo dominio email da 9 $) e nessuna quota dei ricavi recuperati. Vedi pagamenti falliti e prezzi.