subscription.canceled

{ "event": "subscription.canceled", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "status": "canceled", "canceledAt": "2026-04-20T10:15:00.000Z", "cancelReason": "Too expensive", "endDate": "2026-04-25T00:00:00.000Z" } }

Ciclo de vida de la cancelación

Una cancelación regular se agenda para el final del período de cobro actual. Se disparan dos eventos en momentos distintos:

Momento	Evento	status	Qué hacer
El cliente solicita la cancelación	`subscription.updated`	`active`	Muestra “termina el {endDate}” en tu UI. NO revoques el acceso.
Termina el período de cobro	`subscription.canceled`	`canceled`	Revoca el acceso.

POST /subscriptions/{id}/cancel
  └→ subscription.updated  (status: "active", canceledAt: set, endDate: set)
       ... pasa el tiempo hasta que termina el período de cobro ...
  └→ subscription.canceled (status: "canceled")

Terminaciones inmediatas

Algunas terminaciones se saltan la agenda: subscription.canceled llega de inmediato, sin un subscription.updated previo, y endDate es el momento de la terminación — no un límite del período de cobro.

POST /subscriptions/{id}/cancel con immediate: true. Las cancelaciones de planes gratuitos y de suscripciones en pending_payment o past_due también se resuelven de inmediato — cancelar dentro de la ventana de gracia de dunning anula la renovación impaga.
Reintentos de dunning agotados: se dispara con cancelReason: "dunning_exhausted", junto con payment.retry_failed.

Reembolsar un pago no cancela su suscripción. Si querés ambas cosas, pedí la cancelación por separado. Los eventos históricos de cancelación por refund pueden tener cancelReason: "refund".

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "subscription.canceled"

timestamp

string

requerido

organizationId

string

requerido

mode

enum<string>

requerido

Opciones disponibles:

live,

sandbox

apiVersion

string

requerido

data

object

requerido

Show child attributes

Respuesta

200

Return any 2xx status code to acknowledge receipt of the event.

Introducción

Eventos

subscription.canceled

Ciclo de vida de la cancelación

Terminaciones inmediatas

Cuerpo

Respuesta

​Ciclo de vida de la cancelación

​Terminaciones inmediatas

Cuerpo

Respuesta

Ciclo de vida de la cancelación

Terminaciones inmediatas