Cómo pausar suscripciones en Lemon Squeezy
Pausar una suscripción de Lemon Squeezy: los modos free y void, resumes_at, el panel y el portal, los webhooks y cómo ofrecer una pausa antes de cancelar.

Un cliente que quiere un descanso no es lo mismo que un cliente que quiere irse. Si el único botón que encuentra es “Cancelar”, pierdes a los dos. Lemon Squeezy tiene una función de pausa nativa, y es más flexible de lo que muchos equipos creen: dos modos de pausa, una fecha de reanudación automática opcional y soporte completo en la API.
Esta guía explica cómo funciona la pausa en Lemon Squeezy, cómo activarla desde el panel, el portal del cliente o la API, y cómo ofrecerla en el momento adecuado. Se limita a la documentación de Lemon Squeezy: la referencia de la API Update a Subscription, la referencia del objeto Subscription, la guía de gestión de suscripciones, la página del Customer Portal y los tipos de eventos de webhook (todos consultados en noviembre de 2026).
Los dos modos de pausa
Lemon Squeezy pausa una suscripción fijando en ella un objeto pause. El objeto tiene un mode, y la referencia Update a Subscription documenta dos valores:
| Modo | Para qué sirve según Lemon Squeezy | Qué recibe el cliente |
|---|---|---|
void |
Cuando no puedes ofrecer tu servicio durante un periodo (el ejemplo es el mantenimiento): las facturas se anulan para que no se cobre a los clientes | Ningún cobro y, por tanto, ningún servicio |
free |
Ofrecer la suscripción gratis mientras se detiene el cobro | Ningún cobro, y el servicio continúa |
Los dos modos detienen el cobro. La diferencia está en lo que prometes a cambio, y eso es una decisión de producto, no de facturación. Lemon Squeezy no controla el acceso por ti: tu app decide qué puede hacer un cliente en pausa.
En la práctica:
voides la “pausa” habitual que pide un cliente. No va a usar el producto durante un tiempo y no paga por él.freees un gesto de buena voluntad. Úsalo cuando quieras que un cliente siga usando el producto sin cobrarle, por ejemplo mientras corriges un problema que le afectó.
Pausar con una fecha de reanudación
El objeto pause también acepta un resumes_at opcional, una fecha y hora ISO 8601. Si se fija, la suscripción vuelve a cobrar a partir de esa fecha. Sin él, la pausa dura hasta que alguien la quite.
La documentación que usamos no indica una duración máxima de la pausa. Si quieres una, impónla en tu propia interfaz enviando siempre un resumes_at.
Quitar la pausa
Para terminar una pausa, fijas pause en null en la suscripción. Según la referencia Update a Subscription, la suscripción vuelve entonces a active y el cobro se reanuda según su calendario original.
Vale la pena pensar en ese “calendario original”. El ancla de facturación no se mueve por la pausa, así que a un cliente que reanuda se le puede cobrar en su fecha de renovación habitual y no el día en que vuelve. Si eso puede sorprenderle, dilo en la pantalla en la que reanuda.
Tres formas de pausar
1. Desde el panel
La guía de gestión de suscripciones describe la vía manual: en tu panel de Lemon Squeezy, ve a Store, después a Subscriptions, selecciona la suscripción y haz clic en “Pause Subscription”. Útil para las peticiones de soporte.
2. Desde el portal del cliente
El Customer Portal alojado de Lemon Squeezy permite a los suscriptores pausar y quitar la pausa, cancelar y reanudar, y cambiar de producto. Eliges qué funciones muestra el portal en sus ajustes de diseño. Si dependes del portal, comprueba que la pausa está activada y visible junto a la cancelación.
3. Desde la API
Para pausar desde tu propia app, envía un PATCH al endpoint de la suscripción con un objeto pause, como muestra la referencia Update a Subscription. Un cuerpo de petición mínimo, en formato JSON:API:
{
"data": {
"type": "subscriptions",
"id": "123",
"attributes": {
"pause": {
"mode": "void",
"resumes_at": "2027-02-01T00:00:00.000000Z"
}
}
}
}
Para quitar la pausa, envía la misma petición con "pause": null.
Qué cambia en la suscripción
Según la referencia del objeto Subscription:
- Una suscripción en pausa tiene el estado
paused. - El atributo
pausecontiene el modo yresumes_atmientras está en pausa, y esnullen caso contrario.
La página de tipos de eventos incluye dos eventos dedicados, subscription_paused y subscription_unpaused. Lemon Squeezy también envía subscription_updated con cada cambio, así que si ya gestionas ese evento y lees status, la pausa no necesita ningún webhook adicional.
Cómo ofrecer bien una pausa
Lemon Squeezy te da la mecánica. Que los clientes elijan de verdad una pausa depende de cómo la ofrezcas.
Ofrécela en el momento de cancelar
El momento de mayor intención es cuando el cliente hace clic en “Cancelar”. Si tu app envía a los clientes directamente al portal, ven la pausa como una opción entre varias. Si creas tu propia página de cancelación, puedes preguntar primero por qué se van y después ofrecer una pausa a los clientes cuyo motivo encaja: “me tomo un descanso”, “es estacional”, “no lo uso ahora mismo”, “presupuesto de este mes”.
Mantén visible la opción de cancelar en esa página. Una oferta de pausa debe ser una alternativa real, no un muro. Ocultar la cancelación genera tickets de soporte y contracargos, y en varios lugares está regulado.
Haz la pausa concreta
“Pausa tu suscripción” es vago. “Pausa 1, 2 o 3 meses, sin cobro, tus datos se quedan aquí” es una decisión que alguien puede tomar en cinco segundos. Asocia cada opción a un resumes_at y envíalo con la petición.
Avisa antes de que termine
Una pausa que reanuda el cobro sin avisar parece una trampa. Programa un recordatorio unos días antes de resumes_at: “Tu pausa termina el 1 de marzo. Se te cobrará en tu fecha habitual. ¿Quieres ampliarla o cancelar?” La documentación de Lemon Squeezy que usamos no describe un recordatorio integrado para esto, así que envíalo desde tu propia herramienta de correo.
Elige el modo a propósito
Para un descanso que pide el cliente, usa void. Reserva free para cuando decidas seguir dando servicio a un cliente sin coste. Confundirlos significa cobrar por nada o regalar un servicio que querías pausar.
Mídelo
Cuenta los eventos subscription_paused y lo que pasa después con cada cliente en pausa: quitó la pausa y renovó, canceló durante la pausa o canceló justo después de reanudar. Eso te dice si las ofertas de pausa salvan clientes o solo retrasan la cancelación.
Una lista antes de lanzar
- La pausa está activada en el portal del cliente, o tu propia página de cancelación la ofrece.
- Tu app asocia
pauseda una regla de acceso (sin acceso paravoid, acceso normal parafree). - Cada pausa desde tu interfaz envía un
resumes_at. - Sale un recordatorio antes de que termine la pausa.
- Tu handler de webhooks actualiza tus registros con
subscription_paused,subscription_unpausedosubscription_updated. - Has probado el recorrido completo en modo test con eventos de webhook simulados.
Hacerlo con NoChurn
La pausa en sí sigue siendo una función de Lemon Squeezy; NoChurn la usa en lugar de sustituirla. NoChurn añade un flujo de cancelación delante del botón de cancelar: el cliente da un motivo, ve una oferta que encaja con él (una pausa, un descuento o un cambio de plan) y siempre puede cancelar en un clic. El flujo está alojado, o es headless mediante la API si lo quieres totalmente con tu propio diseño. Las respuestas alimentan el churn score y los correos de win-back enviados los días 30, 60 y 90. Consulta NoChurn + Lemon Squeezy.