Cómo reducir el churn en Lemon Squeezy
Cómo gestiona Lemon Squeezy los estados de suscripción, los reintentos, el dunning, la pausa y la cancelación, y cómo añadir cancelación guiada y win-back.

Lemon Squeezy ya hace bastante para mantener vivas las suscripciones: reintenta los pagos fallidos, envía correos de recuperación y da a los clientes un portal donde pueden pausar en lugar de cancelar. Esta guía explica lo que hace de forma nativa, qué estados de suscripción y qué webhooks vigilar, y dónde encajan un flujo de cancelación y el win-back por encima.
Se limita a la documentación de Lemon Squeezy: suscripciones, el objeto subscription, recovery and dunning, gestionar suscripciones con la API, portal del cliente, tipos de eventos de webhook, descuentos y reembolsos y contracargos (todos consultados en noviembre de 2026).
Lemon Squeezy es el merchant of record
Lemon Squeezy vende a tus clientes como merchant of record. Procesa los pagos, los reembolsos y los contracargos. Su documentación dice que, ante una disputa, normalmente reembolsa en tu nombre y descuenta el importe (menos su comisión de plataforma) más una comisión de disputa de 15 $ de tu siguiente pago, y que aporta información al proveedor de pagos para defender el caso. Demasiados contracargos pueden llevarle a suspender una tienda. Para el trabajo de churn, esto significa que cambias las suscripciones mediante la API y el portal de Lemon Squeezy, y que no gestionas tú los pagos.
Los estados de la suscripción
El objeto subscription tiene siete estados. Saber cuáles siguen dando acceso es la base de todo lo demás.
| Estado | Significado | Acceso |
|---|---|---|
on_trial |
En periodo de prueba, a la espera del primer pago | Sí |
active |
Activa y válida | Sí |
paused |
Cobro en pausa, la suscripción sigue viva | Opcional, decides tú |
past_due |
Falló una renovación y Lemon Squeezy está reintentando | Sí |
unpaid |
Todos los reintentos fallaron; las reglas de dunning deciden qué pasa después | Ver abajo |
cancelled |
Pagos futuros cancelados, sigue válida hasta el final del periodo (periodo de gracia) | Sí |
expired |
Terminada, después de la cancelación o del dunning | No |
La recomendación de Lemon Squeezy es dar acceso en on_trial, active, cancelled, past_due y, opcionalmente, paused. Su página de dunning dice que cuando falla el último reintento, la suscripción pasa a unpaid y el cliente pierde el acceso.
Qué hace Lemon Squeezy con los pagos fallidos
Lemon Squeezy tiene una recuperación integrada, descrita en su página de recovery and dunning:
- Reintentos. Tras una renovación fallida, la suscripción pasa a
past_duey Lemon Squeezy reintenta el pago cuatro veces a lo largo de dos semanas. Un reintento correcto la devuelve aactive. Si los cuatro fallan, pasa aunpaid. - Correos durante los reintentos. Cada intento fallido envía al cliente un correo pidiéndole que actualice sus datos de facturación.
- Dunning después de los reintentos. Si activas el dunning, Lemon Squeezy envía una serie de correos de recuperación durante un periodo que configuras, y tus reglas de dunning deciden cuándo la suscripción pasa a
expired. Puedes editar los correos por defecto, los asuntos y el calendario. Si el dunning está desactivado, el estado se queda enunpaid. - Avisos de tarjeta a punto de caducar. Lemon Squeezy puede enviar un correo a los clientes antes de que caduque un método de pago guardado.
- PayPal es distinto. Para las suscripciones de PayPal, la página de PayPal dice que los reintentos se hacen cada 5 días, hasta dos veces por ciclo de facturación, y que la suscripción se suspende tras dos ciclos de facturación fallidos.
Con cada correo de reintento y de dunning se envía el mismo enlace de actualización de tarjeta. Lemon Squeezy indica que estas URL de actualización caducan a las 24 horas, así que si envías tus propios mensajes, obtén una URL nueva de la API cada vez en lugar de guardar una.
Es una buena base nativa. Lo que controlas es el calendario del dunning y el texto de los correos; el momento de los reintentos lo fija Lemon Squeezy.
Pausar y cancelar mediante la API
La guía de gestión de suscripciones cubre las dos cosas.
Pausar. Envía PATCH /v1/subscriptions/:id con un objeto pause. Hay dos modos:
void: para periodos en los que no puedes prestar el servicio;free: el cliente sigue usando el producto gratis durante la pausa.
Los dos detienen el cobro. Una fecha opcional resumes_at quita la pausa automáticamente. Fijar pause en null reanuda el cobro según el calendario original.
Cancelar. DELETE /v1/subscriptions/:id cancela una suscripción activa. Pasa a cancelled y sigue siendo válida hasta la siguiente fecha de renovación, indicada en ends_at, y después caduca. Durante ese periodo de gracia puedes reanudarla actualizando la suscripción con cancelled en false.
El portal del cliente
El portal del cliente alojado de Lemon Squeezy permite a los clientes cambiar entre productos de suscripción, pausar y quitar la pausa, cancelar y reanudar, y actualizar los datos de facturación. Eliges qué funciones aparecen en los ajustes del portal. Cada objeto subscription lleva también una URL customer_portal, un enlace prefirmado válido durante 24 horas, que puedes abrir desde tu app.
Si dejas que los clientes cancelen directamente desde el portal, se saltan cualquier paso de retención que construyas. Decide a propósito: o envías el “Cancelar” de tu app primero a tu propio flujo, o confías en la opción de pausa del portal como tu única oferta.
Descuentos
Los descuentos de Lemon Squeezy tienen tres duraciones (objeto discount): once, repeating durante un número fijo de meses, o forever. En los planes anuales el número de repeticiones sigue contándose en meses, así que dos pagos anuales son 24. La documentación de descuentos describe códigos que se canjean en el checkout; no describe cómo aplicar un descuento a una suscripción que ya existe. Consulta con Lemon Squeezy antes de prometer a un suscriptor actual una oferta de “50% de descuento en tus próximos 3 meses”. La pausa y el paso a un producto más barato desde el portal son las ofertas que su documentación admite claramente.
Webhooks que escuchar
De la página de tipos de eventos:
| Evento | Para qué usarlo |
|---|---|
subscription_updated |
Evento general con los datos más recientes de la suscripción; Lemon Squeezy lo recomienda |
subscription_payment_failed |
Falló una renovación; empiezan los reintentos |
subscription_cancelled |
Cancelada por el cliente o por ti; empieza el periodo de gracia |
subscription_expired |
El acceso debe terminar |
subscription_paused / subscription_unpaused |
La pausa empezó o terminó |
Puedes simular eventos como subscription_cancelled y subscription_expired en modo test.
Añadir un flujo de cancelación
- Dirige el “Cancelar” de tu app a tu flujo. Muestra una lista corta de motivos más “Otro”.
- Ofrece una sola cosa que encaje con el motivo. “No lo uso ahora”: una pausa en modo
voidconresumes_atfijado. “Demasiado caro”: un producto más barato. “Falta una función”: una respuesta de una persona. - Mantén “Cancelar ahora” visible en cada paso. Un clic debe terminar la cancelación sin aceptar ninguna oferta.
- Aplica el resultado con la API. Pausa con
PATCHy un objetopause; cancela conDELETE, que mantiene el acceso hastaends_at. - Confirma la fecha de fin a partir de la suscripción que devuelve la API.
- Ofrece “mantener mi suscripción” durante el periodo de gracia, lo que fija
cancelleden false.
Win-back
Cuando una suscripción está en expired, se acabó. Guarda el motivo que recogiste y contacta al cliente más adelante con algo que responda a él. Usa el evento subscription_expired como inicio del temporizador y envíalo a un checkout nuevo.
Hacerlo con NoChurn
NoChurn lee tus suscripciones y webhooks de Lemon Squeezy. Añade un flujo de cancelación con motivos, ofertas (como una pausa o un cambio de plan) y una cancelación en un clic siempre visible, alojado o headless mediante la API, además de correos de win-back los días 30, 60 y 90 según el motivo de cancelación y un churn score de 0 a 100. Lemon Squeezy sigue siendo el merchant of record: los pagos, la recuperación de pagos, los reembolsos y las disputas siguen en sus manos. Los pagos fallidos aparecen en la cronología del cliente y en el churn score de NoChurn, y las disputas aparecen en solo lectura. NoChurn es gratis por debajo de 300 € de MRR. Consulta NoChurn + Lemon Squeezy.