FLUJOS DE CANCELACIÓNSTRIPE

Cómo pausar una suscripción en Stripe en lugar de perder al cliente

Cómo pausar una suscripción en Stripe: pause_collection y sus tres comportamientos, el nuevo endpoint de pausa, el portal de clientes y la reanudación.

Publicado el 6 min de lectura

Cómo pausar una suscripción en Stripe en lugar de perder al cliente

Un cliente que dice “no lo necesito durante un par de meses” no es lo mismo que uno que quiere irse. Si el único botón que ve es Cancelar, pierdes a los dos. Una pausa mantiene en su sitio la cuenta, el historial y el método de pago, y da al cliente una forma fácil de volver.

Stripe tiene ahora más de una forma de pausar, y se comportan de forma distinta. Esta guía explica cada una, cuándo usarla y cómo funciona la reanudación. Se basa en la documentación de Stripe: pause payment collection, pause subscriptions, la referencia de la API pause subscription, las entradas del changelog sobre pausar y reanudar bajo demanda y la pausa en el portal de clientes, y using webhooks with subscriptions (todo consultado en noviembre de 2026).

Dos cosas distintas llamadas “pausa”

Stripe tiene dos mecanismos, y confundirlos causa la mayor parte de la confusión.

Pausar el cobro Pausar la suscripción
Cómo Definir pause_collection en la suscripción Llamar al endpoint pause subscription
Estado de la suscripción Sin cambios (por ejemplo, sigue en active) Pasa a paused
Facturas Se siguen creando, y luego se tratan según el comportamiento que elegiste No se generan mientras está en pausa
Periodos de facturación Siguen avanzando No avanzan
Reanudar Borrar pause_collection, o definir resumes_at Reanudar mediante la API
Eventos customer.subscription.updated customer.subscription.paused, luego customer.subscription.resumed

El primero es más antiguo y muy utilizado. El segundo se añadió en el changelog del 2026-09-30 de Stripe y se acerca más a lo que los clientes entienden por “pausar mi cuenta”. Comprueba qué versión de la API usa tu integración antes de basarte en el endpoint nuevo.

Opción 1: pausar el cobro

Pausar el cobro mantiene la suscripción en marcha pero te impide cobrarla. Eliges uno de tres comportamientos:

  • keep_as_draft: ofreces el servicio gratis por ahora y cobras más tarde. Las facturas se quedan como borradores.
  • mark_uncollectible: ofreces el servicio gratis y marcas las facturas como incobrables.
  • void: ofreces el servicio gratis y nunca cobras ese periodo. Las facturas se anulan.

Puedes definir una fecha opcional resumes_at para que el cobro se reanude solo. Sin ella, el cobro sigue en pausa hasta que borres pause_collection. Stripe también indica que el saldo del cliente existente se sigue aplicando a las facturas durante la pausa.

Cuándo encaja

Las pausas del cobro encajan en situaciones en las que el cliente mantiene el acceso: un gesto de buena voluntad tras una caída del servicio, unas semanas gratis mientras un cliente resuelve su presupuesto o una cuenta B2B que espera una orden de compra. Para un cliente que no va a usar el producto en absoluto durante un tiempo, encaja mal: el estado de la suscripción sigue igual, los periodos siguen avanzando y tu propia app tiene que decidir si bloquea el acceso.

Para una oferta de retención, void suele ser la opción honesta. keep_as_draft significa que el cliente debe los meses en pausa más tarde, lo que sorprende a quienes pensaban que “pausa” significaba “sin cargo”.

Opción 2: pausar la propia suscripción

Con el endpoint pause subscription, la pausa se aplica de inmediato. Según la guía de pausa de suscripciones de Stripe:

  • El estado de la suscripción pasa a paused.
  • Una suscripción en pausa no genera facturas y no avanza a nuevos periodos de facturación.
  • La reanudas mediante la API. Reanudar solo está disponible en las suscripciones que usan el cobro charge_automatically.
  • Si la reanudación no genera una factura, el estado vuelve a active de inmediato.
  • Un cupón en la suscripción conserva su periodo de validez original. La pausa no lo alarga.

Stripe envía customer.subscription.paused cuando el estado cambia a paused y customer.subscription.resumed cuando vuelve. La guía de webhooks dice explícitamente que customer.subscription.resumed no se aplica cuando solo se reanuda el cobro, lo que recuerda bien que los dos mecanismos son independientes.

Otras formas en que una suscripción pasa a estar en pausa

Dos casos producen el estado paused sin que llames al endpoint:

  1. Una prueba termina sin método de pago, si configuraste la prueba para que se pause en ese caso. Stripe lo documenta en la guía de webhooks.
  2. Un pago falla y usas pause on payment failure. Solo las suscripciones que cumplen los requisitos y usan el modo de facturación flexible pueden pausarse así. Eliges una reanudación automática o manual, y el campo status_details.paused.subscription.type te dice por qué se pausó una suscripción.

Si lees las suscripciones paused en tus propios informes, usa ese campo para que una pausa voluntaria no cuente igual que una prueba que terminó sin tarjeta.

Opción 3: dejar que los clientes pausen en el portal de clientes

El changelog del 2026-10-28 de Stripe añade la pausa al portal de clientes rediseñado:

  1. En la configuración de tu portal, pon features.subscription_pause.enabled en true.
  2. Opcionalmente, define features.subscription_pause.duration para ofrecer duraciones de pausa predefinidas.
  3. Para llevar a un cliente directamente al flujo de pausa de una suscripción, crea una sesión del portal con flow_data.type en subscription_pause y el ID de la suscripción.

Es nuevo, y algunos artículos de soporte antiguos de Stripe todavía dicen que el portal no puede pausar suscripciones. Básate en el changelog y en la referencia de la API de tu versión, y pruébalo en un sandbox antes de anunciarlo a los clientes.

Cómo ofrecer bien una pausa

Uses el mecanismo que uses, la oferta importa tanto como la fontanería.

  1. Ofrécela en el momento adecuado. Una pausa es más útil cuando el motivo de cancelación es temporal: negocio estacional, un proyecto en espera, un viaje, el calendario del presupuesto. Es una respuesta débil a “es demasiado caro” o “faltan funciones”. Nuestra guía sobre ofertas de pausa o descuento cubre qué oferta encaja con cada motivo.
  2. Da duraciones fijas. Uno, dos o tres meses son más fáciles de elegir que una pausa indefinida, y la suscripción vuelve sola. Usa resumes_at para las pausas del cobro, o las duraciones predefinidas del portal.
  3. Di exactamente lo que pasa. ¿Mantendrá el cliente el acceso? ¿Se le cobrará al reanudar? ¿Cuándo? Pon la fecha de reanudación en el correo de confirmación.
  4. Avisa antes de reanudar. Envía un correo breve unos días antes de que termine la pausa, con un enlace para alargar la pausa o cancelar. Las renovaciones sorpresa tras una pausa se convierten en solicitudes de reembolso y en disputas.
  5. Mantén visible la cancelación. Una oferta de pausa es una oferta, no una barrera. El cliente tiene que poder cancelar en un solo paso. Consulta las reglas de click to cancel.

Gestionar la reanudación en tu app

La pausa afecta al control de acceso, así que conecta los eventos:

  • En customer.subscription.paused, pasa la cuenta a un estado de pausa. Decide si los datos siguen siendo consultables y dilo en el producto.
  • En customer.subscription.resumed, restaura el acceso y registra la reanudación.
  • Para las pausas del cobro, vigila customer.subscription.updated y lee el campo pause_collection, ya que el estado no cambia.
  • Cuenta las pausas por separado en tus informes de churn. Un cliente en pausa no se ha ido, pero una pausa que termina en cancelación debe atribuirse al motivo de cancelación original. Consulta cómo calcular la tasa de churn.

Lista de pruebas

  • Una pausa del cobro con void produce facturas anuladas y ningún cargo.
  • Una pausa del cobro con resumes_at reanuda la facturación en esa fecha.
  • Una pausa de la suscripción pone el estado en paused y detiene las facturas.
  • La reanudación devuelve la suscripción a active y tu app restaura el acceso.
  • Tu app reacciona a los eventos paused y resumed, e ignora las reanudaciones del cobro en la lógica de reanudación.
  • El correo de recordatorio sale antes de cada reanudación programada.

Hacerlo con NoChurn

El flujo de cancelación de NoChurn pregunta el motivo de cancelación y puede ofrecer una pausa, un descuento o un cambio de plan según ese motivo, con un botón de cancelación en un clic visible en cada paso. Funciona alojado, o en headless a través de la API si quieres tu propio diseño. La pausa en sí se aplica en tu cuenta de Stripe. Cada respuesta se guarda y se usa después para los correos de win-back el día 30, 60 y 90 y para el score de churn. Consulta NoChurn + Stripe.

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