Come mettere in pausa gli abbonamenti in Recurly

Una pausa è spesso l’offerta giusta per un cliente che vuole disdire perché per un po’ non userà il prodotto: lui tiene il suo account e tu tieni il cliente. Recurly supporta la pausa in modo nativo, ma con una serie di regole facili da trascurare, soprattutto sui piani annuali e con i coupon. Questa guida spiega come funziona la pausa in Recurly Subscriptions e come proporla bene.

Si basa sulla documentazione di Recurly: pause subscription, pause subscriptions: things to consider, la guida alla gestione degli abbonamenti, le notifiche sugli abbonamenti, la guida ai webhook del ciclo di vita dell’abbonamento e la panoramica dei webhook (tutte consultate a novembre 2026). Recurly Commerce, un prodotto separato, ha le sue impostazioni di pausa; questa guida riguarda Recurly Subscriptions.

Come funziona una pausa

La pausa si attiva con l’endpoint Pause Subscription e il campo remaining_pause_cycles, il numero di cicli di fatturazione da saltare (pause subscription). Negli esempi di Recurly il valore è 10, che blocca la fatturazione per dieci cicli. Il meccanismo:

1. Parte dalla prossima data di fatturazione. Recurly non supporta pause a metà ciclo. Il cliente mantiene il periodo che ha già pagato.
2. Ogni rinnovo saltato scala il conteggio. A ogni data di fatturazione durante la pausa, remaining_pause_cycles scende di uno e Recurly invia una notifica di rinnovo saltato.
3. Finisce da sola. Quando il conteggio arriva a zero, l’abbonamento riprende: Recurly avvia un nuovo ciclo di fatturazione e genera subito una fattura, addebitata sul metodo di pagamento salvato se l’incasso è automatico.
4. Puoi terminarla prima. Gli amministratori possono riprendere l’abbonamento dalla pagina dell’abbonamento o dell’account, e l’API ha un endpoint di ripresa. Anche una ripresa anticipata avvia un nuovo ciclo di fatturazione con fattura immediata.

Non esiste un’impostazione separata di «pausa a tempo indeterminato». Le note sulla pausa di Recurly ricordano che alcuni merchant impostano invece un numero di cicli molto alto. La documentazione che abbiamo trovato non indica un massimo.

Cosa non si può mettere in pausa

La pagina delle considerazioni di Recurly elenca i limiti:

Situazione	Cosa dice Recurly
Abbonamenti in prova, disdetti, scaduti o falliti	Non si possono mettere in pausa; solo gli abbonamenti attivi
Cliente in sollecito o con fatture scadute	Risolvi prima quello
Una pausa già programmata o in corso	Le pause simultanee non sono supportate; una deve finire prima
Modifica immediata dell’abbonamento durante una pausa	Annulla la pausa
Add-on a consumo	L’utilizzo registrato prima della pausa viene fatturato alla data della pausa; durante la pausa non si può registrare utilizzo

Le ultime due contano nella pratica. Se un agente del supporto fa un upgrade a un cliente in pausa, o la tua app fa una modifica immediata, la pausa sparisce. E se fatturi a consumo, verifica che nulla nel tuo prodotto registri utilizzo per gli account in pausa.

Piani annuali: meglio posticipare

Una pausa salta cicli di fatturazione interi. Su un piano annuale, un ciclo è un anno. L’esempio di Recurly: un cliente a sei mesi da un piano annuale chiede una pausa di un mese; mettere in pausa un ciclo programma una pausa di un anno intero a partire dal prossimo rinnovo annuale.

Per pause brevi sui piani annuali, Recurly consiglia invece di posticipare la prossima data di fatturazione, con l’endpoint Modify (update) Subscription. Così si allunga il periodo in corso invece di saltare un anno.

I coupon continuano a decorrere

Recurly dice che i coupon non vanno in pausa con l’abbonamento: la loro durata continua a scorrere durante la pausa. Se hai trattenuto un cliente con «50% di sconto per tre mesi» e poi lui mette in pausa per tre mesi, lo sconto potrebbe esaurirsi prima della fattura successiva. Offri lo sconto dopo la pausa, oppure scegli un’offerta sola, non entrambe.

Altri effetti collaterali

• Date del termine. Recurly segnala che le date di rinnovo del termine non si aggiornano durante una pausa.
• Report. Gli abbonamenti in pausa contano come attivi nelle analytics di Recurly ma non aggiungono MRR, perché non generano fatture. Seguili a parte quando analizzi la retention.
• Regioni SCA. Le pagine di Recurly consigliano, nelle regioni SCA, di riprendere tramite API con un’autenticazione corretta del cliente invece che dall’Admin Console. Le due pagine che ne parlano non descrivono il problema allo stesso modo, quindi testa la ripresa nella tua regione prima di farci affidamento.

Chi può mettere in pausa

La documentazione di Recurly dice che i clienti non possono mettere in pausa o riprendere il proprio abbonamento da Hosted Account Management. Quella pagina mostra lo stato di pausa, ma la pausa vera e propria deve arrivare da:

• il tuo team di supporto, nell’Admin Console;
• la tua app o la tua pagina account, tramite gli endpoint di pausa e ripresa, l’unica opzione self-service in Recurly Subscriptions;
• Recurly Commerce, il cui Customer Portal ha un interruttore di pausa, se vendi con quel prodotto.

Se vuoi che la pausa faccia parte di un flusso di disdetta, devi costruire quel passaggio o usare uno strumento che lo fa.

Webhook

Recurly invia notifiche per ogni fase di una pausa (notifiche sugli abbonamenti): pausa programmata, pausa modificata, pausa annullata (i campi della pausa tornano a null), abbonamento in pausa, ogni rinnovo saltato e abbonamento ripreso, inviata quando passa da in pausa ad attivo con un nuovo ciclo di fatturazione.

Le pagine di Recurly chiamano questi eventi in modi diversi. Il riferimento delle notifiche usa titoli come «Scheduled subscription pause» e «Subscription pause canceled», la guida al ciclo di vita usa identificatori come pause.scheduled e renewal.skipped, e un’altra pagina usa subscription.paused e subscription.resumed. Controlla i nomi nei payload che il tuo account riceve davvero. Recurly dice anche che i webhook si configurano nell’Admin Console, non via API, che conviene confermare lo stato tramite API prima di aggiornare i tuoi sistemi e che il tuo endpoint deve accettare duplicati ed eventi fuori ordine.

Proporre bene una pausa

1. Proponila per il motivo giusto. «Non lo userò per un po’», «attività stagionale», «budget bloccato fino al prossimo trimestre». È una risposta debole a «il prodotto non fa quello che mi serve».
2. Verifica prima l’idoneità. Mostra l’offerta solo per abbonamenti attivi, non in prova, non in sollecito e senza pause programmate.
3. Scegli lo strumento giusto per il piano. Cicli di pausa per i piani mensili; posticipo della prossima data di fatturazione per pause brevi sui piani annuali.
4. Di’ esattamente cosa succede. «Il tuo abbonamento è in pausa dal 12 dicembre per 2 mesi. La prossima fattura arriverà il 12 febbraio.» Leggi le date dalla risposta di Recurly.
5. Avvisa prima che la fatturazione riprenda. La ripresa crea subito una fattura. Manda un promemoria qualche giorno prima, con un link per disdire se il prodotto non serve più.
6. Tieni visibile la disdetta. L’offerta di pausa sta accanto a «Cancel now», mai al suo posto.
7. Segui cosa succede dopo. Guarda quanti clienti in pausa riprendono e continuano a pagare, e quanti disdicono alla fine.

Farlo con NoChurn

Il flusso di disdetta di NoChurn può proporre una pausa, insieme a un coupon o a un cambio di piano, e applica l’offerta accettata all’abbonamento Recurly; una disdetta in un clic resta visibile a ogni passaggio, in versione hosted o headless via API. Segue i webhook di Recurly, così i clienti che disdicono più tardi ricevono email di win-back a 30, 60 e 90 giorni in base al loro motivo, e il churn score da 0 a 100 tiene conto della loro storia. Fatturazione, fatture e addebito alla ripresa restano in Recurly. NoChurn è gratuito sotto i 300 $ di MRR. Vedi NoChurn + Recurly.