# Cancelar suscripciones

Aprende a cancelar una suscripción existente.

Los clientes también pueden gestionar sus suscripciones, facturas e información de pago a través de la [página de cancelación del portal de clientes](https://docs.stripe.com/customer-management/cancellation-page.md) alojada en Stripe.

En esta guía se describe cómo usar la [API Subscription](https://docs.stripe.com/api.md#cancel_subscription) o el [Dashboard](https://dashboard.stripe.com/test/subscriptions) 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](https://docs.stripe.com/billing/subscriptions/pause-payment.md). Pausar el cobro del pago no afecta el [estado de la suscripción](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses). 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 facturar al cliente. Puedes configurar la cantidad de intentos en la [configuración de la suscripción](https://dashboard.stripe.com/settings/billing/automatic) del Dashboard. Obtén más información sobre la configuración de recuperación de ingresos, como [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#smart-retries) y [los correos electrónicos de clientes](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#configure-emails) que se pueden configurar.

## Cancelar suscripciones

Puedes cancelar las suscripciones de los clientes manualmente con la [API](https://docs.stripe.com/api/subscriptions/cancel.md) o en el [Dashboard](https://dashboard.stripe.com/test/subscriptions). De forma predeterminada, la cancelación es inmediata y ya no se generan *facturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) para las suscripciones canceladas. Una vez cancelada, ya no podrás actualizar la suscripción ni sus [metadata](https://docs.stripe.com/metadata.md).

> 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_behavior` esté establecido en `none`.

#### Dashboard

Para cancelar una suscripción desde el Dashboard, haz lo siguiente:

1. En la página [Suscripciones](https://dashboard.stripe.com/test/subscriptions), haz clic en el menú de contenido adicional (⋯) y selecciona **Cancelar suscripción**.
1. Elige cuándo finalizar la suscripción: de forma inmediata, al final del período o en un día personalizado.
1. Elige si quieres reembolsar un importe [prorrateado](https://docs.stripe.com/billing/subscriptions/prorations.md), reembolsar el total del último pago o no emitir ningún [reembolso](https://docs.stripe.com/refunds.md).
1. Haz clic en **Cancelar suscripción** después de completar la configuración.

#### API

Para cancelar una suscripción a través de la API, haz lo siguiente:

```curl
curl -X DELETE https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

### 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](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-prorate).

Al prorratear una cancelación, tienes las siguiente opciones de facturación:

- Prorrateos pendientes
- [Consumo medido](https://docs.stripe.com/products-prices/pricing-models.md#usage-based-pricing)

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](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-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](https://support.stripe.com/questions/refunding-credit-balance-to-customer-after-subscription-downgrade-or-cancellation), emite [reembolsos](https://docs.stripe.com/refunds.md#issuing) y, luego, [ajusta el saldo de su cuenta](https://docs.stripe.com/billing/customer/balance.md#modifying) a cero.

### Cancelar al final del período 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
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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.

### Cancelar después de los cambios programados o futuros períodos de facturación

Para programar una suscripción para que finalice después de un número específico de períodos de facturación, [define un calendario de suscripciones](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md). Establece la duración del calendario especificando una o más fases e intervalos, y configura el atributo [end_behavior](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-end_behavior) en `cancel`.

Con un comportamiento final de `cancel`, los calendarios de suscripciones gestionan automáticamente el atributo [cancel_at](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date) 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](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date).

### Cómo configurar la cancelación automática después de una disputa

> #### Soporte limitado
> 
> Esta función solo está disponible para pagos disputados que se realizaron con tarjetas de débito y crédito abiertos en el *importe total*. La demora de las cancelaciones automáticas no es compatible con los [clocks de prueba](https://docs.stripe.com/billing/testing/test-clocks/simulate-subscriptions.md).

Cuando un cliente [disputa](https://docs.stripe.com/disputes.md) 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](https://dashboard.stripe.com/settings/billing/automatic) 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](https://dashboard.stripe.com/settings/billing/automatic), 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-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](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), 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](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) 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](https://docs.stripe.com/api.md#delete_invoiceitem) las partidas de factura.

De la misma manera, cualquier [consumo](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md) 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](https://docs.stripe.com/api.md#update_subscription-items-clear_usage) a fin de [actualizar la suscripción](https://docs.stripe.com/api.md#update_subscription) 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](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md) 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.subscription.updated` | Se envía para todas las actualizaciones de suscripciones, lo que incluye cuando `cancel_at_period_end` se establece en `true`.                                                                                               |
| `customer.subscription.deleted` | Se envía cuando se cancela una suscripción. La cancelación puede deberse a una llamada directa para eliminar la suscripción o cuando una suscripción con `cancel_at_period_end: true` llega al final de su período de cobro. |

## Detener una cancelación pendiente

Puedes detener una cancelación programada a través de la [API Update Subscription](https://docs.stripe.com/api/subscriptions/update.md) o el [Dashboard](https://dashboard.stripe.com/test/subscriptions). No puedes reactivar una suscripción cancelada.

#### Dashboard

Para detener una cancelación programada en el Dashboard, sigue estos pasos:

1. En la [página Suscripciones](https://dashboard.stripe.com/test/subscriptions), selecciona la suscripción que deseas actualizar.
1. En la página de detalles Suscripciones, haz clic en **Acciones** y, luego, selecciona **No cancelar**.

#### API

Para detener una cancelación programada mediante la API, establece `cancel_at_period_end` en `false`. Esta acción solo afecta a las suscripciones que no han llegado al final de su período de cobro.

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d cancel_at_period_end=false
```

> Antes de la versión [2018-02-28](https://docs.stripe.com/upgrades.md#2018-02-28), *cualquier* parámetro enviado a la API [Update Subscription](https://docs.stripe.com/api/subscriptions/update.md) detiene una cancelación pendiente.

## Define una fecha de cancelación personalizada

Usa el parámetro [cancel_at](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-cancel_at) para cancelar una suscripción en una fecha futura.

```curl
curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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](https://docs.stripe.com/api/subscription_item/object.md#subscription_item_object-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](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations) los prorrateos.

En el caso de las suscripciones `billing_mode=flexible` con `status=trialing`, agregar, actualizar o eliminar el valor `cancel_at` no afecta la fecha de [trial_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_end).

Para las suscripciones que usan [billing_mode](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-04-30.preview#create_subscription-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.

| Evento           | Descripción                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------ |
| `min_period_end` | Selecciona la marca de tiempo para el período de facturación que finaliza más pronto.      |
| `max_period_end` | Selecciona la marca de tiempo para el período de facturación que finaliza en último lugar. |

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_end`para 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](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-proration_behavior) de `always_invoice` en la actualización, o por separado [crea una factura puntual](https://docs.stripe.com/billing/invoices/subscription.md#generating-invoices).

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

La propiedad [billing cycle anchor](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-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](https://docs.stripe.com/billing/subscriptions/billing-cycle.md#new-subscriptions) 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](https://docs.stripe.com/api/subscription_items/object.md#subscription_item_object-current_period_start). 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-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&nbsp;30 para acreditar a tu cliente el tiempo no utilizado desde 1 de abril al 1 de julio.

## See also

- [Usa los períodos de prueba](https://docs.stripe.com/billing/subscriptions/trials.md)
- [Actualizar suscripción](https://docs.stripe.com/api.md#update_subscription)
- [Cancelar suscripción](https://docs.stripe.com/api.md#cancel_subscription)