Commet
  • Precios
Iniciar SesiónRegistrarse
Introducción

Eventos de Suscripción

subscription.createdsubscription.activatedsubscription.canceledsubscription.updatedsubscription.plan_changedsubscription.cancellation_scheduledsubscription.cancellation_revokedsubscription.plan_change_scheduledsubscription.plan_change_revokedsubscription.past_due

Eventos de Prueba

trial.startedtrial.convertedtrial.expiredtrial.will_endtrial.checkout_ready

Eventos de Checkout

checkout.ready

Eventos de Pago

payment.receivedpayment.failedpayment.recoveredpayment.refundedpayment.disputedpayment.dispute_resolved

Eventos de Recibo

invoice.createdinvoice.upcominginvoice.overdueinvoice.voided

Eventos de Método de Pago

payment_method.attachedpayment_method.updated

Eventos de Cliente

customer.createdcustomer.updatedcustomer.state_changed

Eventos de Créditos y Saldo

credits.grantedcredits.purchasedcredits.lowcredits.depletedcredits.expiredbalance.topped_upbalance.lowbalance.depleted

Eventos de Cuota y Uso

quota.threshold_reachedquota.exceededusage.recorded

Eventos de Asientos

seats.updatedseats.limit_reached

Eventos de Complementos

addon.activatedaddon.deactivated

Eventos de Payout

payout.availablepayout.createdpayout.paidpayout.failed
DocumentaciónRecursosConstruir con AIAPI ReferenceWebhooks

subscription.plan_change_revoked

Se dispara cuando un cambio de plan programado se reemplaza antes de ejecutarse.

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

Current status — the subscription stays usable.

currentPlanobject

The plan currently in effect (id and name).

revokedPlanobject

The previously scheduled plan that will no longer take effect (id and name).

billingIntervalstring | null

The current billing interval.

revokedBillingIntervalstring | null

The previously scheduled billing interval, if the revoked change included one.

{
  "event": "subscription.plan_change_revoked",
  "timestamp": "2026-04-18T16:30:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "active",
    "currentPlan": {
      "id": "plan_pro",
      "name": "Pro"
    },
    "revokedPlan": {
      "id": "plan_starter",
      "name": "Starter"
    },
    "billingInterval": "monthly",
    "revokedBillingInterval": null
  }
}

Cuándo se dispara

Una suscripción solo puede tener un cambio programado pendiente. Cuando se programa un nuevo downgrade o cambio de intervalo mientras otro sigue pendiente, el anterior se reemplaza:

  1. subscription.plan_change_revoked se dispara con el plan que ya no tendrá efecto (revokedPlan).
  2. subscription.plan_change_scheduled se dispara con el nuevo plan objetivo.

Programar exactamente el mismo cambio de nuevo es una operación sin efecto y no dispara este evento. El plan actual de la suscripción y el acceso no se ven afectados: solo se mueve el cambio pendiente.

¿Cómo está esta guía?

subscription.plan_change_scheduled

Se dispara cuando se programa un downgrade o cambio de intervalo para el fin del período de facturación.

subscription.past_due

Se dispara cuando un pago recurrente falla y la suscripción entra en un período de gracia mientras Commet reintenta el cobro.