Come ridurre il churn su Lemon Squeezy

Lemon Squeezy fa già parecchio per mantenere vivi gli abbonamenti: ritenta i pagamenti falliti, invia email di recupero e offre ai clienti un portale in cui possono mettere in pausa invece di disdire. Questa guida spiega cosa fa di serie, quali stati degli abbonamenti e quali webhook tenere d’occhio, e dove si inseriscono un flusso di disdetta e il win-back.

Si attiene alla documentazione di Lemon Squeezy: abbonamenti, l’oggetto subscription, recovery e dunning, gestione degli abbonamenti con l’API, portale clienti, tipi di evento webhook, sconti e rimborsi e chargeback (tutti consultati a novembre 2026).

Lemon Squeezy è il merchant of record

Lemon Squeezy vende ai tuoi clienti come merchant of record. Elabora pagamenti, rimborsi e chargeback. La sua documentazione dice che, in caso di contestazione, di solito rimborsa per tuo conto e trattiene l’importo (al netto della sua commissione di piattaforma) più una commissione di contestazione di 15 $ dal tuo pagamento successivo, e che fornisce informazioni al fornitore di pagamenti per sostenere il caso. Troppi chargeback possono portarlo a sospendere uno store. Per il lavoro sul churn, questo significa che modifichi gli abbonamenti tramite l’API e il portale di Lemon Squeezy, e non gestisci tu i pagamenti.

Gli stati dell’abbonamento

L’oggetto subscription ha sette stati. Sapere quali danno ancora accesso è la base di tutto il resto.

Stato	Significato	Accesso
`on_trial`	In prova, in attesa del primo pagamento	Sì
`active`	Attivo e valido	Sì
`paused`	Incasso dei pagamenti in pausa, abbonamento ancora attivo	Facoltativo, a tua scelta
`past_due`	Un rinnovo è fallito e Lemon Squeezy sta ritentando	Sì
`unpaid`	Tutti i tentativi sono falliti; le regole di dunning decidono cosa succede dopo	Vedi sotto
`cancelled`	Pagamenti futuri annullati, ancora valido fino alla fine del periodo (periodo di tolleranza)	Sì
`expired`	Terminato, dopo una disdetta o dopo il dunning	No

L’indicazione di Lemon Squeezy è di consentire l’accesso per on_trial, active, cancelled, past_due e facoltativamente paused. La sua pagina sul dunning dice che, quando l’ultimo tentativo fallisce, l’abbonamento diventa unpaid e il cliente perde l’accesso.

Cosa fa Lemon Squeezy sui pagamenti falliti

Lemon Squeezy ha un recupero integrato, descritto nella sua pagina su recovery e dunning:

Tentativi. Dopo un rinnovo fallito, l’abbonamento passa a past_due e Lemon Squeezy ritenta il pagamento quattro volte in due settimane. Un tentativo riuscito lo riporta ad active. Se falliscono tutti e quattro, diventa unpaid.
Email durante i tentativi. Ogni tentativo fallito invia al cliente un’email che gli chiede di aggiornare i dati di fatturazione.
Dunning dopo i tentativi. Se attivi il dunning, Lemon Squeezy invia una serie di email di sollecito in un periodo che configuri tu, e le tue regole di dunning decidono quando l’abbonamento diventa expired. Puoi modificare le email predefinite, gli oggetti e il calendario. Se il dunning è disattivato, lo stato resta unpaid.
Avvisi per le carte in scadenza. Lemon Squeezy può inviare email ai clienti prima che un metodo di pagamento salvato scada.
PayPal è diverso. Per gli abbonamenti PayPal, la pagina PayPal dice che i tentativi avvengono ogni 5 giorni, fino a due volte per ciclo di fatturazione, e l’abbonamento viene sospeso dopo due cicli di fatturazione falliti.

Lo stesso link per aggiornare la carta viene inviato con ogni email di tentativo e di sollecito. Lemon Squeezy precisa che questi URL di aggiornamento scadono dopo 24 ore, quindi se invii messaggi tuoi, recupera ogni volta un URL nuovo dall’API invece di salvarne uno.

È una buona base nativa. Le parti che controlli sono il calendario del dunning e il testo delle email; la tempistica dei tentativi è fissata da Lemon Squeezy.

Pausa e disdetta tramite l’API

La guida alla gestione degli abbonamenti le tratta entrambe.

Pausa. Invia PATCH /v1/subscriptions/:id con un oggetto pause. Esistono due modalità:

void: per i periodi in cui non puoi fornire il servizio;
free: il cliente continua a usare il prodotto gratuitamente durante la pausa.

Entrambe fermano l’incasso dei pagamenti. Una data resumes_at facoltativa toglie la pausa automaticamente. Impostare pause a null riprende l’incasso secondo il calendario originale.

Disdetta. DELETE /v1/subscriptions/:id annulla un abbonamento attivo. Passa a cancelled e resta valido fino alla prossima data di rinnovo, indicata in ends_at, poi scade. Durante quel periodo di tolleranza puoi riprenderlo aggiornando l’abbonamento con cancelled impostato a false.

Il portale clienti

Il portale clienti ospitato da Lemon Squeezy permette ai clienti di passare da un prodotto in abbonamento all’altro, mettere in pausa e togliere la pausa, disdire e riprendere, e aggiornare i dati di fatturazione. Scegli tu quali funzioni compaiono nelle impostazioni del portale. Ogni oggetto subscription contiene anche un URL customer_portal, un link pre-firmato valido 24 ore, che puoi aprire dalla tua app.

Se lasci che i clienti disdicano direttamente dal portale, saltano qualsiasi passaggio di retention che costruisci. Decidi di proposito: o mandi prima il “Disdici” della tua app al tuo flusso, o ti affidi all’opzione di pausa del portale come unica offerta.

Sconti

Gli sconti di Lemon Squeezy hanno tre durate (oggetto discount): once, repeating per un numero stabilito di mesi, o forever. Per i piani annuali il conteggio dei mesi ripetuti è comunque in mesi, quindi due pagamenti annuali significano 24. La documentazione sugli sconti descrive codici riscattati al checkout; non descrive come applicare uno sconto a un abbonamento già esistente. Verifica con Lemon Squeezy prima di promettere a un abbonato attuale un’offerta “50% di sconto sui prossimi 3 mesi”. La pausa e il passaggio a un prodotto più economico tramite il portale sono le offerte che la sua documentazione supporta chiaramente.

I webhook da ascoltare

Dalla pagina dei tipi di evento:

Evento	Usalo per
`subscription_updated`	Raccogliere i dati più recenti dell’abbonamento; Lemon Squeezy lo consiglia
`subscription_payment_failed`	Un rinnovo è fallito; iniziano i tentativi
`subscription_cancelled`	Annullato dal cliente o da te; inizia il periodo di tolleranza
`subscription_expired`	L’accesso deve terminare
`subscription_paused` / `subscription_unpaused`	Pausa iniziata o terminata

Puoi simulare eventi come subscription_cancelled e subscription_expired in modalità test.

Aggiungere un flusso di disdetta

Indirizza il “Disdici” della tua app al tuo flusso. Mostra un breve elenco di motivi più “Altro”.
Offri una sola cosa adatta al motivo. “Non lo uso ora”: una pausa in modalità void con resumes_at impostato. “Troppo caro”: un prodotto più economico. “Manca una funzione”: una risposta da una persona.
Tieni “Disdici ora” visibile a ogni passaggio. Un clic deve concludere la disdetta senza accettare un’offerta.
Applica l’esito con l’API. Pausa con PATCH e un oggetto pause; disdetta con DELETE, che mantiene l’accesso fino a ends_at.
Conferma la data di fine dall’abbonamento restituito dall’API.
Offri “mantieni il mio abbonamento” durante il periodo di tolleranza, che imposta cancelled a false.

Win-back

Quando un abbonamento è expired, è finito. Conserva il motivo che hai raccolto, e ricontatta il cliente più avanti con qualcosa che vi risponda. Usa l’evento subscription_expired come avvio del conteggio, e mandalo a un nuovo checkout.

Farlo con NoChurn

NoChurn legge i tuoi abbonamenti e webhook Lemon Squeezy. Aggiunge un flusso di disdetta con motivi, offerte (come una pausa o un cambio di piano) e una disdetta in un clic sempre visibile, ospitato o headless tramite API, più email di win-back ai giorni 30, 60 e 90 basate sul motivo della disdetta e un churn score da 0 a 100. Lemon Squeezy resta il merchant of record: pagamenti, recupero dei pagamenti, rimborsi e contestazioni restano a lui. I pagamenti falliti compaiono nella cronologia del cliente e nel churn score di NoChurn, e le contestazioni compaiono in sola lettura. NoChurn è gratuito sotto i 300 $ di MRR. Vedi NoChurn + Lemon Squeezy.