FLUJOS DE CANCELACIÓNLEMON SQUEEZY

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.

Publicado el 6 min de lectura

Cómo pausar suscripciones en Lemon Squeezy

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:

  • void es la “pausa” habitual que pide un cliente. No va a usar el producto durante un tiempo y no paga por él.
  • free es 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 pause contiene el modo y resumes_at mientras está en pausa, y es null en 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

  1. La pausa está activada en el portal del cliente, o tu propia página de cancelación la ofrece.
  2. Tu app asocia paused a una regla de acceso (sin acceso para void, acceso normal para free).
  3. Cada pausa desde tu interfaz envía un resumes_at.
  4. Sale un recordatorio antes de que termine la pausa.
  5. Tu handler de webhooks actualiza tus registros con subscription_paused, subscription_unpaused o subscription_updated.
  6. 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.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Deja de perder ingresos.

  • Gratis hasta 300 € de MRR
  • Sin tarjeta
  • Listo en 10 minutos
  • Sin comisión