Come mettere in pausa gli abbonamenti su Lemon Squeezy

Un cliente che vuole una pausa non è un cliente che vuole andarsene. Se l’unico pulsante che trova è “Disdici”, li perdi entrambi. Lemon Squeezy ha una funzione di pausa nativa, ed è più flessibile di quanto molti team pensino: due modalità di pausa, una data di ripresa automatica facoltativa e pieno supporto dall’API.

Questa guida spiega come funziona la pausa su Lemon Squeezy, come attivarla dalla dashboard, dal portale clienti o dall’API e come offrirla al momento giusto. Si attiene alla documentazione di Lemon Squeezy: il riferimento API Update a Subscription, il riferimento dell’oggetto Subscription, la guida alla gestione degli abbonamenti, la pagina Customer Portal e i tipi di evento webhook (tutti consultati a novembre 2026).

Le due modalità di pausa

Lemon Squeezy mette in pausa un abbonamento impostandovi un oggetto pause. L’oggetto ha un mode, e il riferimento Update a Subscription documenta due valori:

Modalità	A cosa serve secondo Lemon Squeezy	Cosa ottiene il cliente
void	Quando non puoi offrire il tuo servizio per un periodo (l’esempio dato è la manutenzione): le fatture vengono annullate così i clienti non vengono addebitati	Nessun addebito, e di conseguenza nessun servizio
free	Offrire l’abbonamento gratuitamente sospendendo l’incasso dei pagamenti	Nessun addebito, e servizio continuato

Entrambe le modalità fermano l’incasso dei pagamenti. La differenza riguarda cosa prometti in cambio, ed è una decisione di prodotto, non di fatturazione. Lemon Squeezy non gestisce l’accesso al posto tuo: è la tua app a decidere cosa può fare un cliente in pausa.

In pratica:

• void è la “pausa” che chiede di solito un cliente. Non usa il prodotto per un po’, e non lo paga.
• free è un gesto di buona volontà. Usalo quando vuoi che un cliente continui a usare il prodotto senza addebitarlo, per esempio mentre risolvi un problema che lo ha colpito.

Mettere in pausa con una data di ripresa

L’oggetto pause accetta anche un resumes_at facoltativo, una data e ora ISO 8601. Quando è impostato, l’abbonamento riprende a incassare i pagamenti da quella data. Senza, la pausa dura finché qualcuno non la toglie.

La documentazione che abbiamo usato non indica una durata massima della pausa. Se ne vuoi una, imponila nella tua interfaccia inviando sempre un resumes_at.

Togliere la pausa

Per terminare una pausa, imposti pause a null sull’abbonamento. Secondo il riferimento Update a Subscription, l’abbonamento torna allora active e l’incasso dei pagamenti riprende secondo il calendario originale.

Vale la pena riflettere sul “calendario originale”. La data di riferimento della fatturazione non si sposta per via della pausa, quindi un cliente che toglie la pausa può essere addebitato alla sua solita data di rinnovo invece che il giorno in cui torna. Se potrebbe sorprenderlo, dillo nella schermata in cui riprende.

Tre modi per mettere in pausa

1. Dalla dashboard

La guida alla gestione degli abbonamenti descrive il percorso manuale: nella tua dashboard Lemon Squeezy, vai su Store, poi Subscriptions, seleziona l’abbonamento e clicca “Pause Subscription”. Utile per le richieste al supporto.

2. Dal portale clienti

Il Customer Portal ospitato da Lemon Squeezy permette agli abbonati di mettere in pausa e togliere la pausa, annullare e riprendere, e cambiare prodotto. Scegli tu quali funzioni mostra il portale nelle sue impostazioni di design. Se ti affidi al portale, verifica che la pausa sia attiva e visibile accanto alla disdetta.

3. Dall’API

Per mettere in pausa dalla tua app, invia un PATCH all’endpoint dell’abbonamento con un oggetto pause, come mostrato nel riferimento Update a Subscription. Un corpo di richiesta minimo, in formato JSON:API:

{
  "data": {
    "type": "subscriptions",
    "id": "123",
    "attributes": {
      "pause": {
        "mode": "void",
        "resumes_at": "2027-02-01T00:00:00.000000Z"
      }
    }
  }
}

Per togliere la pausa, invia la stessa richiesta con "pause": null.

Cosa cambia sull’abbonamento

Secondo il riferimento dell’oggetto Subscription:

• Un abbonamento in pausa ha lo stato paused.
• L’attributo pause contiene la modalità e resumes_at durante la pausa, ed è null altrimenti.

La pagina dei tipi di evento elenca due eventi dedicati, subscription_paused e subscription_unpaused. Lemon Squeezy invia anche subscription_updated a ogni modifica, quindi se gestisci già quell’evento e leggi status, la pausa non richiede webhook aggiuntivi.

Come offrire bene una pausa

Lemon Squeezy ti dà la meccanica. Se i clienti scelgono davvero una pausa dipende da come la offri.

Offrila al momento della disdetta

Il momento di massima intenzione è quando il cliente clicca “Disdici”. Se la tua app manda i clienti direttamente al portale, vedono la pausa come un’opzione tra le tante. Se costruisci una tua pagina di disdetta, puoi prima chiedere perché se ne vanno, poi offrire una pausa ai clienti il cui motivo è adatto: “mi prendo una pausa”, “stagionale”, “non lo uso in questo momento”, “budget di questo mese”.

Tieni visibile l’opzione di disdetta in quella pagina. Un’offerta di pausa deve essere una vera alternativa, non un muro. Nascondere la disdetta crea ticket al supporto e chargeback, e in diversi paesi è regolamentato.

Rendi concreta la pausa

“Metti in pausa il tuo abbonamento” è vago. “Pausa di 1, 2 o 3 mesi, nessun addebito, i tuoi dati restano qui” è una decisione che si prende in cinque secondi. Associa ogni scelta a un resumes_at e invialo con la richiesta.

Avvisa prima che finisca

Una pausa che riprende la fatturazione in silenzio sembra una trappola. Programma un promemoria qualche giorno prima di resumes_at: “La tua pausa termina il 1° marzo. Ti verrà addebitato alla solita data. Vuoi prolungarla o disdire?” La documentazione di Lemon Squeezy che abbiamo usato non descrive un promemoria integrato per questo, quindi invialo dal tuo strumento di email.

Scegli la modalità di proposito

Per una pausa chiesta dal cliente, usa void. Riserva free a quando scegli di continuare a servire un cliente gratuitamente. Confonderle significa addebitare per niente o regalare un servizio che volevi sospendere.

Misuralo

Conta gli eventi subscription_paused e cosa succede dopo per ogni cliente in pausa: ha tolto la pausa e rinnovato, ha disdetto durante la pausa, o ha disdetto subito dopo la ripresa. Ti dice se le offerte di pausa salvano clienti o rimandano soltanto la disdetta.

Una checklist prima del rilascio

1. La pausa è attiva nel portale clienti, oppure la tua pagina di disdetta la offre.
2. La tua app associa paused a una regola di accesso (nessun accesso per void, accesso normale per free).
3. Ogni pausa dalla tua interfaccia invia un resumes_at.
4. Un promemoria parte prima della fine della pausa.
5. Il tuo handler dei webhook aggiorna i tuoi record su subscription_paused, subscription_unpaused o subscription_updated.
6. Hai provato l’intero percorso in modalità test con eventi webhook simulati.

Farlo con NoChurn

La pausa resta una funzione di Lemon Squeezy; NoChurn la usa invece di sostituirla. NoChurn aggiunge un flusso di disdetta davanti al pulsante di disdetta: il cliente indica un motivo, vede un’offerta adatta (una pausa, uno sconto o un cambio di piano) e può sempre disdire in un clic. Il flusso è ospitato, o headless tramite API se lo vuoi interamente nel tuo design. Le risposte alimentano il churn score e le email di win-back inviate ai giorni 30, 60 e 90. Vedi NoChurn + Lemon Squeezy.