Cómo pausar suscripciones en Paddle Billing
Cómo funciona la pausa en Paddle Billing: la operación de pausa, effective_from, resume_at, las opciones de on_resume, los casos past due, webhooks y Retain.

Algunos clientes no quieren irse; quieren un descanso. Un negocio estacional, un proyecto en espera, un trimestre ajustado. Si la única opción es cancelar, cancelan, y recuperarlos más tarde cuesta un checkout nuevo y a menudo un descuento. Una pausa conserva la suscripción, el registro del cliente y el método de pago, y le da una forma fácil de volver.
Paddle Billing admite la pausa de forma nativa, mediante la API y mediante los flujos de cancelación de Paddle Retain. Esta guía explica cómo funciona, qué pasa al reanudar y cómo ofrecerla bien. Se limita a la documentación de Paddle: pausar una suscripción, la referencia de la API pause subscription, pausar o reanudar una suscripción, el webhook subscription.paused, las entradas del changelog sobre las opciones de facturación al reanudar y pausar suscripciones vencidas, y las Cancellation Flows (todas consultadas en noviembre de 2026).
Cómo funciona una pausa en Paddle
Pausas una suscripción con la operación pause subscription. Las opciones principales:
| Campo | Qué hace |
|---|---|
effective_from |
next_billing_period o immediately. Para las suscripciones activas, el valor por defecto es next_billing_period. |
resume_at |
Fecha y hora opcionales (RFC 3339) en las que la suscripción debe reanudarse sola |
on_resume |
Cómo funciona la facturación cuando se reanuda la suscripción (ver abajo) |
En el próximo periodo de facturación (por defecto)
Pausar en el próximo periodo de facturación es la opción suave. La guía de pausa de Paddle explica que crea un cambio programado en la suscripción que indica que debe pausarse en la próxima fecha de facturación. Hasta entonces, la suscripción sigue activa y el cliente conserva lo que pagó.
Verás el cambio programado mediante subscription.updated, y subscription.paused cuando la pausa se haga efectiva, como se describe en pausar o reanudar una suscripción.
De inmediato
Con immediately, la suscripción se pausa ahora. Úsalo cuando el cliente pide explícitamente parar enseguida, o cuando tu propia lógica lo necesita (por ejemplo, tras un pago fallido).
Reanudar
Una suscripción en pausa puede reanudarse de dos formas: automáticamente en resume_at si lo fijaste, o cuando llamas a la operación de reanudación.
Lo que paga el cliente al reanudar lo controla on_resume, añadido en el changelog de 2024 de Paddle:
start_new_billing_period(por defecto): empieza un periodo de facturación nuevo y Paddle cobra de inmediato.continue_billing_period: la suscripción mantiene su periodo de facturación existente. Paddle devuelve un error si lo combinas con una fecha de reanudación posterior al final de ese periodo.
Para la mayoría de las pausas de retención, el valor por defecto es más fácil de explicar a los clientes: “tu plan se reanuda el [fecha] y se te cobrará entonces”. Usa continue_billing_period para pausas cortas dentro de un periodo que el cliente ya ha pagado.
Suscripciones vencidas
La pausa interactúa con los pagos fallidos de formas que conviene conocer:
- La documentación de Paddle dice que mientras una suscripción está en
past_due, todavía puedes pausarla o cancelarla, aunque la mayoría de las demás modificaciones estén bloqueadas. - El changelog de 2024 de Paddle dice que cuando pausas una suscripción, las transacciones de renovación vencidas se cancelan automáticamente, para no cobrar periodos de facturación que se solapan. Cuando la suscripción en pausa se reanuda, empieza un ciclo de facturación nuevo.
- Paddle devuelve un error si intentas continuar el periodo de facturación existente de una suscripción vencida. Usa
start_new_billing_perioden su lugar.
Eso hace de la pausa un estado final razonable también para los pagos fallidos. El artículo de ayuda de Paddle sobre el ritmo de reintentos dice que puedes elegir pausar, cancelar o dejar vencida una suscripción cuando termina la ventana de recuperación.
Pausar y cancelar
Un detalle de la documentación de las Cancellation Flows de Paddle: si un cliente cancela una suscripción activa, se programa la cancelación para el próximo periodo de facturación, pero una suscripción en pausa se cancela de inmediato. Díselo a los clientes en tu confirmación de pausa, para que “pausar y cancelar más tarde” no les sorprenda.
Ofrecer una pausa con Paddle Retain
Las Cancellation Flows de Paddle Retain muestran una encuesta breve cuando un cliente intenta cancelar y después le hacen una oferta para que se quede. La documentación de Paddle incluye la pausa entre las opciones de rescate, programada para el próximo periodo de facturación, junto a los cambios de plan y un descuento temporal cuando el cliente rechaza la primera oferta. Las decisiones de cancelar, pausar y bajar de plan se trasladan a Paddle Billing.
Desde enero de 2026, el changelog de Paddle dice que las Cancellation Flows también aparecen cuando los clientes cancelan en el portal del cliente de Paddle y desde los enlaces de cancelación de los correos de suscripción de Paddle. Sin un flujo configurado, los clientes ven un simple diálogo de confirmación. Una entrada posterior del changelog añade que los flujos pueden crearse y probarse en sandbox mediante el portal del cliente.
Para las regiones con normas de cancelación en un clic, el changelog de 2024 de Paddle dice que aparece un enlace de cancelación en cada pantalla del flujo. Paddle detecta esas regiones automáticamente.
Cómo ofrecer bien una pausa
- Ajusta la oferta al motivo. Una pausa responde a motivos temporales: estacionalidad, un proyecto en pausa, un viaje, un ciclo de presupuesto. No responde a “demasiado caro” ni a “faltan funciones”. Consulta pausa o descuento como oferta de retención.
- Ofrece duraciones fijas. Uno, dos o tres meses, con
resume_atfijado. Las pausas sin fin suelen convertirse en cancelaciones silenciosas. - Di qué pasa al reanudar. La fecha, el importe y si empieza un periodo de facturación nuevo.
- Avisa antes de reanudar. Envía un correo unos días antes de
resume_atcon un enlace para ampliar o cancelar. Un cobro sorpresa después de una pausa es una fuente clásica de peticiones de reembolso. - Mantén la cancelación a un clic. La pausa es una oferta, nunca una barrera. Consulta las reglas de click-to-cancel.
Conectarlo con tu app
- Con
subscription.updatedy una pausa programada, muestra la fecha de la pausa en la página de la cuenta. - Con
subscription.paused, pasa la cuenta a un estado de pausa y decide qué datos siguen visibles. - Al reanudar, restaura el acceso y regístralo.
- En los informes, cuenta aparte a los clientes en pausa. Una pausa no es churn, pero una pausa que termina en cancelación debe conservar su motivo original.
Lista de pruebas
- Una pausa en el próximo periodo de facturación mantiene el acceso hasta esa fecha.
- Una pausa inmediata corta el acceso enseguida.
-
resume_atreanuda la suscripción y cobra como esperas según tu elección deon_resume. - Pausar una suscripción vencida cancela la renovación vencida.
- Cancelar una suscripción en pausa la termina de inmediato, y tu app lo gestiona.
Hacerlo con NoChurn
El flujo de cancelación de NoChurn pide un motivo y, según él, ofrece una pausa, un descuento o un cambio de plan, con la cancelación en un clic siempre visible. Funciona alojado o headless mediante la API, así que encaja con apps en las que no usas el portal de Paddle. La suscripción en sí se queda en Paddle, que sigue siendo el merchant of record. Los motivos de cancelación alimentan después los correos de win-back de los días 30, 60 y 90 y el churn score. Consulta NoChurn + Paddle.