Se dispara cuando una suscripción termina, al final del período o de inmediato. Revoca el acceso acá.

Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

subscriptionIdstring

The subscription ID.

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

statusstring

Always "canceled" for this event. Revoke access when you receive this.

canceledAtstringoptional

ISO 8601 datetime when the cancellation was requested or triggered.

cancelReasonstring | null

The reason for cancellation, if provided. Set to "dunning_exhausted" when all payment retries fail. Historical refund-triggered cancellations may have "refund".

endDatestringoptional

ISO 8601 datetime when the subscription ended. Matches the billing period end for scheduled cancellations; for immediate terminations it is the moment of termination.

{
  "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".

subscription.canceled