Aggiungere un flusso di disdetta a Recurly

Un flusso di disdetta è il passaggio tra il clic di un cliente su «Disdici» e la disdetta vera e propria: chiedi perché, fai un’offerta adatta alla risposta e disdici in modo pulito se vuole comunque andarsene. Questa guida spiega come funziona la disdetta in Recurly Subscriptions, quali strumenti di salvataggio offre già Recurly e come costruire un tuo flusso sulla sua API.

Si attiene alla documentazione di Recurly: expire or cancel a subscription, la guida alla gestione degli abbonamenti, la guida ai webhook del ciclo di vita dell’abbonamento, subscription notifications, Hosted Account Management, coupons, change subscription e Recurly Engage Cancel Save (tutti consultati a novembre 2026). Recurly vende anche Recurly Commerce, un prodotto separato con un proprio portale; questa guida riguarda Recurly Subscriptions salvo diversa indicazione.

Cancel, terminate, reactivate

Recurly distingue due modi per terminare un abbonamento (expire or cancel).

	Cancel	Terminate
Quando termina	Alla prossima data di fatturazione (`timeframe: bill_date`) o alla fine del termine (`timeframe: term_end`)	Subito, a metà ciclo
Stato	`canceled` fino a `expires_at`, poi `expired`	`expired` immediatamente
Accesso	Il cliente mantiene l’accesso fino alla scadenza	Termina ora
Rimborso	Non applicabile	`none` (predefinito), `partial` (proporzionale al tempo rimanente) o `full` (l’ultimo addebito)
Reversibile	Sì, riattivando prima della scadenza	No

Due dettagli contano per un flusso di disdetta:

Bill date o term end. Per un piano con un termine di più periodi, bill_date si ferma al prossimo evento di fatturazione, mentre term_end continua a fatturare fino alla fine del termine. Scegli quello che corrisponde a ciò che hai promesso al cliente all’iscrizione.
Riattivazione. Un abbonamento disdetto può essere riattivato fino alla scadenza, così si rinnova di nuovo alla fine del ciclo in corso. Una volta scaduto, non può essere riattivato e serve un nuovo abbonamento. Nelle regioni SCA, Recurly segnala che il cliente potrebbe dover autenticare di nuovo i dati di fatturazione salvati prima della riattivazione.

Terminare rimborsa inoltre solo l’ultima fattura; se quella fattura contiene solo crediti, Recurly ignora la richiesta di rimborso. Per un cliente che vuole semplicemente fermarsi, usa cancel invece di terminate.

Dove disdicono oggi i clienti

Hosted Account Management

Le pagine account ospitate di Recurly possono includere un pulsante di disdetta. Secondo la documentazione di Hosted Account Management, lo attivi nell’Admin Console in Configuration › Hosted Page Settings, «Cancel subscriptions» sotto Customer Options. I clienti possono quindi disdire direttamente dalla loro pagina account ospitata. La documentazione di Recurly non descrive un sondaggio sui motivi in quel percorso.

Recurly Engage Cancel Save

Recurly vende un proprio strumento di salvataggio in Recurly Engage. Secondo la guida Cancel Save, parti da una guida preimpostata «Cancel Survey with Offers», imposti un selettore CSS sul tuo pulsante di disdetta come attivatore e colleghi le risposte del sondaggio ad azioni: l’esempio di Recurly manda «too expensive» a un’offerta di salvataggio e «technical issues» al supporto. Live Preview mostra il design ma non esegue il flusso, quindi Recurly suggerisce di testare con un segmento di utenti di test. Recurly dice che l’integrazione con Recurly.js, Hosted Account Management e Recurly Checkout è attivata automaticamente, e segnala che la funzione potrebbe non essere inclusa nei piani Starter o Pro.

Recurly Commerce

Se vendi tramite Recurly Commerce invece che Recurly Subscriptions, questo ha dei flussi di disdetta configurati nel suo Customer Portal: un sondaggio in più passi, un’azione di retention per risposta (sconto, pausa, abbonamento esteso o supporto), assegnato a un piano prima di andare live.

Se uno di questi si adatta al tuo piano e alle tue esigenze, usalo. Il resto di questa guida è per quando vuoi il flusso nella tua app, con design e offerte tuoi.

Le offerte supportate dall’API di Recurly

Coupon

I coupon di Recurly possono durare per sempre, per un solo utilizzo, per un tempo limitato o per un numero fisso di periodi di fatturazione, e Recurly consiglia i coupon per periodi di fatturazione rispetto a quelli a tempo. Per la retention, due opzioni aiutano:

Codici univoci in blocco: codici monouso generati in lotti, così un’offerta di salvataggio non può essere condivisa. Ogni codice può essere usato una sola volta per impostazione predefinita.
Restrizioni per piano: un coupon si applica a tutti i piani per impostazione predefinita; limitalo ai piani in cui l’offerta ha senso.

Cambio di piano

Un downgrade è una modifica dell’abbonamento che può applicarsi subito, alla prossima data di fatturazione o al rinnovo del termine. Recurly mantiene una sola modifica in sospeso; una seconda sostituisce la prima. Per «troppo caro», una modifica alla prossima data di fatturazione evita proration a sorpresa.

Pausa

Recurly può mettere in pausa un abbonamento per un numero di cicli di fatturazione a partire dalla prossima data di fatturazione. Ha abbastanza regole proprie (solo abbonamenti attivi, piani annuali, coupon che continuano a scorrere) da meritare una guida a parte: come mettere in pausa gli abbonamenti in Recurly. Una regola da ricordare qui: Recurly dice che i clienti non possono mettere in pausa da Hosted Account Management, quindi un’offerta di pausa deve venire dal tuo flusso, dal tuo team di supporto o dal portale di Recurly Commerce.

Costruire il flusso

Collega «Disdici» nella tua app al tuo flusso. Se Hosted Account Management mostra anche un pulsante di disdetta, decidi se mantenerlo. Mantenerlo è onesto e semplice; significa solo che alcuni clienti salteranno il flusso.
Chiedi perché. Una breve lista di motivi più «Altro». Salva la risposta con l’UUID dell’abbonamento.
Mostra una sola offerta adatta. «Troppo caro»: un coupon per periodi di fatturazione o un piano più economico dalla prossima data di fatturazione. «Non lo uso in questo periodo»: una pausa. «Manca una funzione» o «Qualcosa non funziona»: una risposta da una persona.
Tieni «Disdici ora» visibile a ogni passo. Un clic completa la disdetta, senza dover prima accettare un’offerta.
Applica il risultato tramite l’API. Applica il coupon, programma il cambio di piano, metti in pausa o disdici con il timeframe che hai scelto.
Conferma la data di fine. Leggi expires_at dall’abbonamento restituito da Recurly, e mostrala.
Offri di annullare. Finché l’abbonamento non scade, un pulsante «Mantieni il mio abbonamento» può chiamare l’endpoint di riattivazione.

Webhook da ascoltare

La guida ai webhook del ciclo di vita descrive il percorso: una disdetta invia una notifica canceled; segue o reactivated, se il cliente torna prima della scadenza, o expired quando si raggiunge expires_at. Terminazione e rimborsi immediati portano direttamente a expired.

Le pagine di Recurly usano più di uno stile di nomi per questi eventi: la pagina subscription notifications usa tipi di evento come «canceled» ed «expired», mentre altre pagine usano nomi più vecchi come canceled_subscription_notification e expired_subscription_notification. Controlla i nomi nei tuoi payload. Recurly consiglia anche di trattare i webhook come avvisi: conferma lo stato attuale tramite l’API, accetta i duplicati e gestisci gli eventi che arrivano in disordine.

Misurare il flusso

L’export degli abbonamenti in churn di Recurly ha una colonna expiration_reason (per esempio Canceled o Non-payment) che separa il churn volontario da quello involontario. Combinala con i motivi raccolti dal tuo flusso, e con quanti clienti hanno accettato ogni offerta ed erano ancora abbonati qualche mese dopo.

Farlo con NoChurn

NoChurn si collega a Recurly con una chiave API privata e segue i suoi webhook. Aggiunge un flusso di disdetta con motivi, offerte che diventano un coupon, una pausa o un cambio di piano sull’abbonamento Recurly, e una disdetta in un clic sempre visibile, ospitato o headless tramite l’API. Invia anche email di win-back a 30, 60 e 90 giorni in base al motivo della disdetta e calcola un churn score da 0 a 100. Fatturazione, addebito e gateway restano in Recurly. NoChurn è gratuito sotto i 300 $ di MRR, con ogni funzione in ogni piano (il tuo dominio email da 9 $). Vedi NoChurn + Recurly.