Cancelar suscripciones

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.

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:

• Prorrateos pendientes
• 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_at_period_end en true:

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d cancel_at_period_end=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_at_period_end 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

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_advance 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.

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.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d cancel_at=1723766400

Cuando programas una fecha de cancelación que se produce antes de que finalice el período de facturación, el current_period_end de los elementos de la suscripción se actualiza para que coincida con la fecha cancel_at. Esto crea prorrateos para el cambio en el período actual, a menos que tu actualización desactive los prorrateos.

Para las suscripciones que usan billing_mode, puedes usar ayudas de enumeración con el parámetro cancel_at para simplificar la cancelación de una suscripción al final de un período de facturación. Las ayudas min_period_end y max_period_end te permiten especificar cuándo cancelar una suscripción en función de los períodos de facturación de todos los ítems de la suscripción.

Estas ayudas resuelven las marcas de tiempo de inmediato, lo que reduce el riesgo de que cambios posteriores en el current_period_end de un elemento afecten la marca de tiempo de cancelación resuelta.

Si programas una fecha de cancelación que se produce a más de un período de distancia, el ciclo de la suscripción no se verá afectado hasta que la suscripción se renueve en el período que contiene la fecha cancel_at. Luego, el items.current_period_endpara la renovación se acorta para que coincida con la fecha cancel_at.

Por ejemplo, tu cliente contrata una suscripción con licencia de 120 USD por año que se renueva el 1 de enero de 2024. Estableció la cancelación de la suscripción el 1 de julio de 2024. El subtotal final de la factura del 1 de enero se calcula como 60 USD y el items.current_period_end es el 1 de julio.

Cambiar, agregar o eliminar una fecha de cancelación programada dentro del período actual actualiza el items.current_period_end y crea prorrateos. En el ejemplo anterior, el 15 de febrero actualizas la fecha de cancelación al 1 de octubre. El final del período actual se convierte en el 1 de octubre, y Stripe crea prorrateos por 30 USD para el trimestre adicional. Para facturar los ítems prorrateados inmediatamente en lugar de en una factura final el 1 de octubre, especifica un proration_behavior de always_invoice en la actualización, o por separado crea una factura puntual.

Cancelación con delimitación del ciclo de facturación

La propiedad billing cycle anchor de la suscripción puede cambiar si realiza un seguimiento de la fecha de cancelación anterior. Durante el primer período, Stripe conserva cualquier anclaje que hayas establecido originalmente en la suscripción. Cuando finaliza el primer período, o si no proporcionaste un anclaje personalizado al crear la suscripción, el anclaje se restablece al inicio del período actual. Este comportamiento de restablecimiento del ciclo de cobro solo se garantiza para las suscripciones creadas después de junio de 2024. Las suscripciones creadas antes de esa fecha podrían mostrar el comportamiento heredado, donde la propiedad billing cycle anchor permanece sin cambios después de la anulación de la cancelación o la extensión.

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.