Impostare i solleciti (dunning) in Recurly

Recurly ha una delle configurazioni di dunning native più complete tra le piattaforme di fatturazione degli abbonamenti. Nuovi tentativi, email, azioni di fine ciclo e pagine di fatturazione per i clienti sono tutti integrati, e la maggior parte del lavoro consiste nello scegliere impostazioni sensate e collegare i webhook giusti alla tua app. Questa guida passa in rassegna ogni elemento e ti dà una checklist di configurazione da applicare oggi stesso.

Tutto ciò che è specifico di Recurly viene dalla documentazione di Recurly: Dunning campaigns, Intelligent retries, Static retries, Dunning 101: Understanding dunning windows, Hosted account management e il riferimento sui webhook (tutti consultati a novembre 2026). Recurly vende anche un prodotto separato, Recurly Commerce, con impostazioni di dunning proprie; questa guida riguarda Recurly Subscriptions.

Come Recurly divide il lavoro: nuovi tentativi e dunning

Recurly tratta separatamente due cose:

I nuovi tentativi decidono quando un addebito rifiutato viene ritentato.
Il dunning decide cosa riceve il cliente, per quanto tempo e cosa succede a fattura e abbonamento alla fine.

Entrambi operano sulla stessa fattura nello stesso momento, ma li configuri in punti diversi. Tenere a mente questa divisione rende più facile ragionare sul resto delle impostazioni.

Nuovi tentativi: Intelligent Retries e static retries

Intelligent Retries

Secondo la documentazione sulle Intelligent retries, Recurly usa un modello di machine learning per scegliere quando riprovare i pagamenti ricorrenti con carta rifiutati. Si concentra sui rifiuti temporanei (come i fondi insufficienti). I limiti documentati:

I nuovi tentativi si fermano a 20 tentativi di transazione totali o 60 giorni dalla creazione della fattura, a seconda di cosa arriva prima.
Le Intelligent Retries non si applicano ai metodi di addebito diretto come ACH e SEPA. Recurly li documenta a parte nei nuovi tentativi per l’addebito diretto.
I rifiuti definitivi sono in generale considerati finali e non vengono riprovati automaticamente, con alcune eccezioni documentate, per esempio quando il cliente o l’Account Updater cambiano i dati di fatturazione.

Una cosa da verificare nel tuo account: una voce di changelog di agosto 2026 di Recurly descrive i rifiuti temporanei riprovati fino a 20 volte per periodo di 30 giorni per allinearsi alle regole dei circuiti delle carte. Questa formulazione differisce dalla finestra di 60 giorni della pagina principale, quindi conferma con Recurly quale limite si applica a te prima di fare affidamento sull’uno o sull’altro.

Static retries

Recurly documenta anche un’opzione senza ML, gli static retries, guidati dai codici di rifiuto del gateway e dai merchant advice code. Si fermano dopo 7 rifiuti di transazione, 20 tentativi totali o 60 giorni dalla creazione della fattura, a seconda di cosa arriva prima, o prima se il ciclo di dunning finisce prima.

Qualunque logica usi, i nuovi tentativi non durano mai più del ciclo di dunning. Se la tua finestra di dunning è breve, limita anche i nuovi tentativi.

Campagne e cicli di dunning

Una campagna di dunning è l’insieme di regole che Recurly applica a una fattura non pagata. Ogni sito ha una campagna predefinita, e sui piani idonei puoi creare campagne aggiuntive e assegnarle a piani o account specifici. La pagina sulle campagne di dunning precisa che più campagne richiedono un piano Professional o Elite. Le campagne si trovano in Configuration, poi Dunning Management. Le impostazioni di dunning sono versionate, quindi modificare una campagna non cambia le fatture già in dunning.

Ogni campagna contiene fino a tre tipi di ciclo, ciascuno con il proprio calendario e le proprie email:

Tipo di ciclo	Si applica a	Modello di email predefinito
Payment Declined	Fatture incassate automaticamente che falliscono	Payment Declined
Invoice Past Due	Fatture incassate manualmente oltre i termini di pagamento	Invoice Past Due
Post-Trial Payment Declined	Fatture che falliscono subito dopo una prova gratuita	Post-Trial Payment Declined

Per le fatture manuali, il periodo di dunning inizia il giorno dopo che la fattura supera i suoi termini di pagamento.

Quanto deve durare un ciclo?

La guida alle finestre di dunning di Recurly consiglia:

Fatturazione mensile: una finestra di 27 giorni, così il ciclo finisce prima della fattura successiva, anche a febbraio.
Fatturazione trimestrale e annuale: circa 60 giorni.
Fatturazione settimanale: 7 giorni.

Sono raccomandazioni, non limiti rigidi. L’idea alla base è sensata: se un ciclo mensile dura più di un mese, una seconda fattura arriva sopra la prima, e ti ritrovi a inseguire due fatture non pagate di un cliente che forse non tornerà mai.

Cosa succede alla fine del ciclo

Per ogni ciclo scegli cosa succede a fattura e abbonamento se il cliente non ha pagato. Per impostazione predefinita Recurly segna la fattura come failed. Puoi anche far scadere l’abbonamento, mantenerlo attivo o impostare le fatture in modo che non falliscano mai automaticamente, il che le lascia past due a tempo indeterminato.

Alcuni comportamenti descritti negli articoli di supporto di Recurly che spesso sorprendono i team:

Lo stato dell’abbonamento e lo stato della fattura sono separati. Un abbonamento può essere attivo mentre la sua fattura è past due (articolo di supporto). Basa le decisioni sull’accesso anche sulla fattura, non solo sull’abbonamento.
Far fallire una fattura non cancella l’abbonamento. Se vuoi che la fatturazione si fermi, cancella l’abbonamento separatamente (articolo di supporto).
Cancellare un abbonamento non ferma il dunning sulle fatture aperte. Usa Stop Collection sulla fattura per questo (articolo di supporto).
Non esiste un’opzione nativa di pausa nella configurazione del dunning.

Email di sollecito

Ogni passo di un ciclo può inviare un’email. Recurly fornisce modelli di base (Payment Declined, Invoice Past Due, Post-Trial Payment Declined e Subscription Expired for Non-Payment) che non possono essere eliminati, e puoi crearne di tuoi e associarli ai passi della campagna.

L’email Payment Declined predefinita porta già il cliente alla sua pagina hosted account management. Ogni account ha due URL ospitati: un Account Management URL che fa accedere il cliente, e un Edit Billing Information URL che apre solo il modulo di fatturazione. Se ospiti una tua pagina di fatturazione, puoi modificare il modello per puntare lì, usando l’hosted login token dell’account ottenuto dall’API.

Un piano di email sensato per una campagna mensile:

Giorno	Email	Obiettivo
0	Pagamento rifiutato	Informare, un solo link chiaro per aggiornare la fatturazione
3	Promemoria	Ripetere il link, dire cosa succede dopo
10	Promemoria	Breve, segnalare che l’accesso è a rischio
20	Ultimo avviso	Indicare la data esatta in cui termina l’abbonamento
Fine	Scaduto per mancato pagamento	Confermare la fine, offrire un modo per tornare

Mantieni ogni email breve e concentrata sul link di fatturazione. Non ripetere al cliente il motivo grezzo del rifiuto.

Gli aggiornamenti della fatturazione fanno partire subito un nuovo tentativo

È uno dei comportamenti nativi più utili. Secondo la documentazione di Recurly, quando un cliente aggiorna i dati di fatturazione, Recurly riprova l’incasso su tutte le fatture scadute di quell’account. Vale anche per i rifiuti definitivi: una nuova carta è l’unico evento che rende utile riprovare una fattura con rifiuto definitivo. Per l’addebito diretto, passare a un nuovo conto bancario azzera il contatore dei nuovi tentativi.

In pratica, significa che le tue email di sollecito non hanno bisogno di un passaggio «paga ora» separato. Portare il cliente al modulo di fatturazione è tutto il lavoro.

Webhook da ascoltare

Il riferimento sui webhook di Recurly e la documentazione sul dunning elencano gli eventi che contano durante il dunning. Quali ricevi dipende dalla configurazione del tuo sito:

Evento	Quando scatta	Cosa fare nella tua app
`failed_payment`	Dopo ogni pagamento fallito	Segnalare l’account, mostrare un banner in-app
`successful_payment`	Dopo un pagamento riuscito	Rimuovere la segnalazione, ripristinare l’accesso
`new_dunning_event`	Quando le fatture entrano e restano in dunning	Seguire lo stato del dunning per account
`charge_invoice.past_due`	Una charge invoice diventa past due (siti con credit invoice)	Avviare i tuoi promemoria, se ne hai
`charge_invoice.failed`	Una charge invoice fallisce, direttamente o alla fine del dunning	Decidere sull’accesso, fermare i promemoria
`subscription_expired`	Recurly fa scadere un abbonamento, anche per mancato pagamento	Rimuovere l’accesso

I siti senza credit invoice ricevono invece le notifiche legacy sulle fatture di Recurly, con nomi diversi. Verifica quale insieme invia il tuo sito prima di scrivere gli handler.

Una checklist di configurazione

Scegli la logica dei nuovi tentativi. Intelligent Retries per la maggior parte dei business con carte; verifica come viene riprovato l’addebito diretto se accetti ACH o SEPA.
Imposta la durata del ciclo in base alla frequenza di fatturazione. Parti dalle raccomandazioni di Recurly di 27 giorni (mensile) e 60 giorni (annuale).
Scegli con cognizione l’azione di fine ciclo. Decidi se l’abbonamento scade o resta attivo, e se le fatture falliscono. Mettilo per iscritto così il supporto lo sa.
Scrivi le email. Un link per email, verso la pagina Edit Billing Information o il tuo modulo di fatturazione.
Aggiungi una campagna post-prova se fai prove gratuite. Il primo addebito dopo una prova fallisce in modo diverso da un rinnovo: il cliente non ti ha mai pagato.
Collega i webhook. Basa l’accesso sullo stato della fattura, non solo su quello dell’abbonamento.
Aggiungi un banner in-app per i clienti connessi con una fattura past due. Le email sono facili da perdere; il prodotto no.
Rivedi ogni mese. Guarda le fatture fallite alla fine del dunning e i codici di rifiuto dietro.

Farlo con NoChurn

I nuovi tentativi e il dunning nativi di Recurly sono solidi, e NoChurn non li sostituisce: nuovi tentativi, fatturazione e addebito restano in Recurly. NoChurn si collega con una chiave API di Recurly, segue i webhook di Recurly e aggiunge email di recupero scritte dall’IA che controlli prima dell’invio, con un link perché il cliente aggiorni i dati di fatturazione. Copre anche ciò che il dunning non copre: flussi di disdetta con motivi e offerte (un coupon, una pausa o un cambio di piano sull’abbonamento Recurly) e un pulsante di disdetta in un clic sempre visibile, email di win-back a 30, 60 e 90 giorni in base al motivo della disdetta e un churn score da 0 a 100. I chargeback arrivano dal gateway dietro Recurly; con Stripe o Braintree, NoChurn raccoglie le prove e prepara una risposta che controlli tu. Vedi NoChurn + Recurly.