Come aggiungere un flusso di disdetta a Chargebee
Flusso di disdetta su Chargebee: impostazioni del portale, codici di motivo, API di disdetta, disdette programmate e offerte che trattengono in modo equo.
Di Florian
Chargebee ti dà molto controllo su come termina un abbonamento: quando ha effetto la disdetta, cosa succede ai crediti, se è richiesto un motivo e se i clienti possono farlo da soli. Quello che non ti dà per impostazione predefinita è un flusso: una breve sequenza che chiede perché il cliente se ne va e offre qualcosa di utile prima che vada.
Questa guida mostra come funziona la disdetta in Chargebee Billing, quali impostazioni contano e come costruirci sopra un flusso di disdetta equo, con il prodotto di retention di Chargebee o con una tua pagina e l’API. Si attiene alla documentazione di Chargebee: Subscription Cancellation, il Self-Serve Portal, Reason Codes, l’API Cancel a subscription, i tipi di evento e il caso d’uso delle offerte mirate di Chargebee Growth (tutti consultati a novembre 2026).
Come funziona la disdetta in Chargebee
Impostazioni predefinite del sito
La documentazione sulla disdetta di Chargebee colloca le impostazioni predefinite in Settings › Configure Chargebee › Billing LogIQ › Customers & Subscriptions › Subscription cancellation. Lì imposti:
- Quando ha effetto: subito, alla fine del periodo in corso, a una data specifica o alla fine del periodo di fatturazione.
- Cosa succede al tempo non usato: come vengono gestiti i crediti.
- Eccezioni: “Allow overriding via Chargebee interface” permette al tuo team di cambiare l’impostazione predefinita caso per caso, e “Add condition to this rule” permette un comportamento diverso per canale (interfaccia web, API, Self-Serve Portal, disdette programmate).
Fine periodo: non-renewing
Quando una disdetta è programmata a fine periodo, l’abbonamento non termina subito. Secondo l’API Cancel a subscription, il suo stato diventa non_renewing e i cicli di fatturazione rimanenti scendono a 0. Poi viene disdetto alla fine del periodo. Chargebee invia subscription_cancellation_scheduled quando la disdetta viene programmata, un subscription_cancellation_reminder 6 giorni prima che abbia effetto e subscription_cancelled quando ha effetto (tipi di evento).
Un abbonamento non-renewing può ancora essere mantenuto. Chargebee ha un’operazione “Remove scheduled cancellation” proprio per questo caso.
Durate contrattuali
Per gli abbonamenti con una durata contrattuale, la documentazione sulla disdetta dice che una disdetta dal Self-Serve Portal avviene solo alla fine della durata contrattuale. Nell’API, questi abbonamenti usano contract_term_cancel_option invece di cancel_option.
Lasciare che i clienti disdicano da soli
Nelle impostazioni del Self-Serve Portal, “Allow customers to cancel subscription” attiva la disdetta self-service. Scegli quando ha effetto: subito, alla fine del periodo o a scelta del cliente (in questo caso può anche scegliere una data entro il periodo dell’abbonamento). La stessa sezione include la raccolta facoltativa di feedback, la riattivazione e la rimozione delle disdette programmate.
Attivala. Costringere i clienti a scrivere al supporto per disdire crea un attrito che si traduce in chargeback e recensioni arrabbiate, e in molti Paesi la legge ormai si aspetta che disdire sia facile quanto iscriversi.
Codici di motivo
Chargebee ha un elenco nativo di motivi di disdetta. Lo configuri in Settings › Configure Chargebee › Reason Codes › Subscriptions › Subscription Cancellation (Reason Codes). I codici compaiono poi come scelte quando un abbonamento viene disdetto dall’interfaccia di Chargebee o dal Self-Serve Portal, e puoi renderli obbligatori.
Nell’API, l’endpoint Cancel a subscription accetta cancel_reason_code: una stringa sensibile alle maiuscole, fino a 100 caratteri, che deve corrispondere a uno dei codici configurati e che va passata se hai reso obbligatori i motivi.
Mantieni l’elenco breve e utilizzabile. Da sei a otto motivi che corrispondono ciascuno a una risposta diversa sono meglio di venti che nessuno legge:
| Codice di motivo | Cosa puoi offrire |
|---|---|
| Troppo caro | Uno sconto per qualche mese, o un piano più economico |
| Non lo uso abbastanza | Una pausa, o un piano più piccolo |
| Pausa / stagionale | Una pausa con una data di ripresa |
| Manca una funzione | Niente da vendere; registralo e di’ se è in programma |
| Passaggio a un altro strumento | Niente; chiedi cosa ha scelto e lascialo andare |
| Problemi tecnici | Un canale rapido verso il supporto |
| Altro | Testo libero |
Costruire il flusso
Opzione 1: il prodotto di retention di Chargebee
Chargebee offre le offerte sulla pagina di disdetta tramite Chargebee Growth (che ha assorbito il prodotto prima chiamato Chargebee Retention). Il suo caso d’uso delle offerte mirate descrive tre offerte su una pagina di disdetta: uno sconto (legato a un coupon in Chargebee Billing), una pausa e un downgrade di piano, applicati in Billing quando il cliente accetta. Nota anche che gli abbonati senza un metodo di pagamento salvato non possono completare la modifica né riprendere automaticamente dopo una pausa. Se paghi già Growth, parti da lì.
Opzione 2: la tua pagina e l’API
Se preferisci una tua pagina, i mattoni sono tutti in Chargebee Billing:
- Intercetta il pulsante di disdetta nella tua app. Mostra la tua pagina prima che venga disdetto qualsiasi cosa.
- Chiedi il motivo. Una domanda, con i tuoi codici di motivo Chargebee come opzioni.
- Mostra un’offerta adatta al motivo, o nessuna. Usa un coupon per gli sconti, l’API di pausa per le pause, o un cambio di piano.
- Mantieni “Disdici il mio abbonamento” visibile a ogni passaggio. Un clic, nessuna schermata in più.
- Disdici con il motivo. Chiama l’endpoint di disdetta con
cancel_optionimpostato suend_of_term(ocontract_term_cancel_optionper gli abbonamenti contrattuali) e ilcancel_reason_code. Nota cheend_of_termcome booleano è deprecato a favore dicancel_option. - Conferma in modo chiaro. Mostra la data di fine e invia un’email di conferma.
- Offri una strada per tornare. Fino alla data di fine, un pulsante “Mantieni il mio abbonamento” che rimuove la disdetta programmata.
Usare il motivo dopo la disdetta
Chargebee nota che cancel_reason_code potrebbe non essere restituito per impostazione predefinita quando recuperi gli abbonamenti non-renewing; un’impostazione a livello di sito lo include, così puoi agire sul motivo prima che la disdetta venga eseguita (Subscription Cancellation). Attivala se vuoi promemoria basati sul motivo durante il periodo residuo.
Regole di equità da mantenere
- La disdetta è sempre a un clic. Un’offerta è una scelta, non un cancello.
- Non più di un’offerta. Una seconda offerta dopo un “no” sa di contrattazione.
- Non chiedere il motivo due volte. Se il cliente ha risposto sulla tua pagina, passalo avanti; non fargli scegliere di nuovo nel portale.
- Rispetta subito la disdetta. Se rifiuta l’offerta, disdici, conferma e fermati.
Misurarlo
Tieni traccia, per motivo, di: quanti clienti sono arrivati alla pagina di disdetta, quanti hanno accettato un’offerta e quanti di questi pagavano ancora 90 giorni dopo. Un salvataggio che disdice un mese dopo è un rinvio, non un salvataggio. Gli eventi subscription_cancellation_scheduled e subscription_cancelled di Chargebee, insieme ai log della tua pagina, ti danno tutti e tre i numeri.
Farlo con NoChurn
La disdetta in sé resta in Chargebee: NoChurn chiama Chargebee per disdire, mettere in pausa o applicare un’offerta, e il portale di Chargebee continua a funzionare come configurato. NoChurn fornisce il flusso: motivi, un’offerta per motivo (sconto, pausa o cambio di piano) e una disdetta in un clic visibile a ogni passaggio, ospitato o headless tramite l’API. Le risposte alimentano un punteggio di churn da 0 a 100 e le email di win-back a 30, 60 e 90 giorni in base al motivo. Vedi NoChurn + Chargebee.