Cancelar suscripciones
Aprende a cancelar una suscripción existente.
En esta guía se describe cómo usar la API Subscription o el Dashboard para gestionar las suscripciones de los clientes.
Si quieres mantener activa la suscripción pero dejar de cobrar el pago temporalmente, puedes pausar el cobro del pago. Pausar el cobro del pago no afecta el estado de la suscripción. Esto es lo que te recomendamos usar como desencadenante para iniciar o detener el servicio a tu cliente.
Las suscripciones se cancelan automáticamente después de hasta ocho intentos fallidos de cobrarle al cliente. Puedes configurar la cantidad de intentos en tu configuración del ciclo de vida de las suscripciones. Obtén más información sobre la configuración de recuperación de ingresos, como Smart Retries y los correos electrónicos para clientes personalizables.
Cancelar suscripciones
Puedes cancelar las suscripciones de los clientes manualmente con la API o en el Dashboard. De forma predeterminada, la cancelación es inmediata y ya no se generan facturas para las suscripciones canceladas. Una vez cancelada, ya no podrás actualizar la suscripción ni sus metadata.
Errores habituales
Si estableces una fecha de cancelación personalizada, no podrás proporcionar un reembolso. Siempre se genera un prorrateo del crédito. Para que el prorrateo del crédito no se genere, asegúrate de que la fecha de cancelación personalizada esté dentro del período de cobro actual y proration_ esté establecido en none.
Prorrateo para cobro por consumo
Si una suscripción forma parte de un período de cobro pagado, puedes prorratear la cancelación especificando el parámetro prorate.
Al prorratear una cancelación, tienes las siguiente opciones de facturación:
- Outstanding prorations
- Consumo medido
Si no prorrateas la suscripción, se descartará todo el consumo medido y el cliente no recibirá ningún crédito por posibles prorrateos.
Crea una factura final de inmediato con el parámetro invoice_now. Si le debes un crédito al cliente después de la cancelación, puedes agregar el crédito a su saldo acreedor para que se aplique a las próximas facturas. Para reembolsar a tu cliente, emite reembolsos y, luego, ajusta el saldo de su cuenta a cero.
Cómo cancelar al final del ciclo de facturación actual
Para cancelar una suscripción al final del período de cobro actual, establece cancel_ en true:
Esto permite que la suscripción complete el período que el cliente ya pagó. Para reactivar las suscripciones que están programadas para que se cancelen, establece cancel_ en false. Puedes reactivar la suscripción en cualquier momento hasta el final del período.
Cancela después de los cambios programados o futuros ciclos de cobro
Para configurar una suscripción de manera de que finalice después de un número específico de ciclos de cobro, crea un calendario de suscripciones. Para establecer la duración del calendario, especifica una o más fases e intervalos, y establece su atributo end_behavior en cancel.
Con un comportamiento final de cancel, los calendarios de suscripciones gestionan automáticamente el atributo cancel_at de la suscripción. Cuando el calendario está en su última fase, la fecha de cancelación de la suscripción se establecerá en la fecha de finalización de la fase; de otra manera, la fecha de cancelación no se establecerá en la suscripción.
Como resultado, agregar una nueva fase a un calendario que se encuentra actualmente en su última fase elimina la fecha de cancelación. Si la suscripción se encuentra en su último período de cobro al extender o eliminar la fecha de cancelación, es posible que se actualice el final del período y la delimitación del ciclo de cobro. Para obtener más información, consulta cómo establecer una fecha de cancelación personalizada.
Cómo configurar la cancelación automática después de una disputa
Soporte limitado
Esta función solo está disponible para disputas de pagos efectuados con tarjetas de débito y crédito abiertas por el importe total.
Cuando un cliente disputa el cargo de una suscripción, esta continúa hasta cumplir su ciclo, por lo que pueden aparecer más cargos disputados. Puedes cambiar este comportamiento en el Dashboard para que se cancele la suscripción. Los cambios en la suscripción tardan cerca de una hora en surtir efecto.
En Gestiona los pagos en disputa, selecciona una de las siguientes opciones:
cancelar la suscripción de inmediato, sin prorrateo: la suscripción se cancela de inmediato sin ningún prorrateo. No puedes reiniciar una suscripción cancelada. Debes crear una nueva suscripción para el cliente si quieres seguir cobrándole.
cancelar la suscripción al final del período: la suscripción se cancela al final del período de cobro actual y cancel_at_period_end se establece en
true. Esto te da margen de tiempo para ocuparte del proceso de disputa antes de que se efectúe la cancelación.
Para las suscripciones gestionadas con calendarios, primero la suscripción es separada del calendario y luego es cancelada. Esto significa que el resto de los cambios programados no surtirán efecto.
Cómo gestionar ítems de factura al cancelar suscripciones
Es posible que tu cliente aún tenga que pagar por las partidas de factura pendientes de una suscripción en los siguientes casos:
- La cancelación de la suscripción incluye una factura final.
- Tu cliente tiene otra suscripción activa.
Para no cobrarle a tu cliente por las partidas de factura pendientes, debes eliminar manualmente las partidas de factura.
De la misma manera, cualquier consumo informado durante el período de cobro se cobrará al finalizar el período. Para evitar un cargo final por consumo, usa el parámetro clear_usage a fin de actualizar la suscripción y eliminar el precio medido.
Si estableces que la suscripción se cancele al final del período, todos los prorrateos pendientes seguirán vigentes y se cobrarán al final del período. Si cancelas la suscripción antes del final del período, quedarán las partidas de factura y no se procesarán a menos que generes específicamente una factura que las incluya.
Al cancelar una suscripción, la propiedad auto_ de todas las facturas open y draft para esa suscripción cambia a false. Esto suspende el cobro automático de tales facturas y evita que se envíen recordatorios automáticos por correo electrónico. Aun así, es posible intentar el cobro de pagos y enviar correos electrónicos manualmente.
Cómo identificar eventos de cancelación
Stripe envía los siguientes eventos para las suscripciones canceladas.
| Evento | Descripción |
|---|---|
customer. | Se envía cuando cancelas de inmediato la suscripción de un cliente. Si la propiedad request del evento no es null, significa que la cancelación se debe a tu solicitud y no a la configuración de tus suscripciones. |
customer. | Se envía cuando cancelas la suscripción de un cliente al final del período de cobro. Esto se activa cuando estableces cancel_ en true y el evento refleja un cambio en el valor de cancel_ para la suscripción. |
Detener una cancelación pendiente
Puedes detener una cancelación programada a través de la API Update Subscription o el Dashboard. No puedes reactivar una suscripción cancelada.
Define una fecha de cancelación personalizada
Usa el parámetro cancel_at para cancelar una suscripción en una fecha futura.
Cuando programas una fecha de cancelación que ocurre antes de que finalice el período de cobro, el current_period_end de la suscripción se actualiza para que coincida con la fecha cancel_. Esto crea prorrateos para el cambio en el período actual, a menos que tu actualización los deshabilite.
Si falta más de un período para la fecha de cancelación, el ciclo de la suscripción no se verá afectado hasta que la suscripción se renueve al período que contiene la fecha cancel_. Luego, el current_ para la renovación se acorta de manera que coincida con la fecha cancel_.
Por ejemplo, tu cliente contrata una suscripción con licencia de USD 120 por año que se renueva el 1 de enero de 2024. Si cancela la suscripción el 1 de julio de 2024, el subtotal final de la factura del 1 de enero será de aproximadamente USD 60 y current_ será el 1 de julio.
Cambiar, agregar o eliminar una fecha de cancelación programada dentro del período actual actualiza el current_ y crea prorrateos. En el ejemplo anterior, si el 15 de febrero actualizas la fecha de cancelación al 1 de octubre, el final del período actual pasará al 1 de octubre, y Stripe creará prorrateos por USD 30 para el trimestre adicional. A fin de facturar las partidas prorrateadas de inmediato en lugar de en una factura final el 1 de octubre, puedes especificar un proration_behavior de always_ en la actualización o crear una factura puntual por separado.
La propiedad billing cycle anchor de la suscripción podría cambiar si se realizó un seguimiento de la fecha de cancelación anterior. Durante el primer período, Stripe conserva las delimitaciones que hayas establecido originalmente en la suscripción. Cuando finaliza el primer período, o si no proporcionaste una delimitación personalizada al crear la suscripción, la delimitación se restablecerá al current period start.
Agregar una fecha de cancelación o cambiar una que ya existe para que sea más próxima acorta el billing cycle anchor de manera que coincida con la nueva fecha de cancelación. En el ejemplo anterior, si el 15 de febrero actualizas la fecha de cancelación al 1 de abril, el final del período y la delimitación del cobro pasarán al 1 de abril, y Stripe creará prorrateos por -USD 30 para acreditar a tu cliente el tiempo no utilizado desde 1 de abril al 1 de julio.