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

addon.activated

Se activó un complemento en una suscripción.

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.

addonobject

The add-on: id and name.

featureCodestring

The feature the add-on unlocks or extends.

proratedPricenumber

The prorated amount charged at activation in rate scale (10000 = $1.00). Zero when nothing was charged.

currencystring

The subscription currency.

{
  "event": "addon.activated",
  "timestamp": "2026-06-18T09:12:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-06-10",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "addon": {
      "id": "addon_5e6f7g8h",
      "name": "Extra Storage"
    },
    "featureCode": "storage",
    "proratedPrice": 25000,
    "currency": "usd"
  }
}

Cuándo se dispara

Cuando se completa la activación de un complemento, ya sea mediante POST /subscriptions/{id}/addons o una compra desde el portal del cliente. Cualquier cargo prorrateado de activación ya se procesó con éxito; proratedPrice es el monto cobrado (cero cuando el período restante fue gratuito).

customer.state_changed se dispara junto con él con el trigger addon_activated, reflejando la feature que el complemento desbloqueó.

Úsalo para habilitar la feature del complemento en tu aplicación en el momento en que se paga.

¿Cómo está esta guía?

seats.limit_reached

Un cambio de asientos alcanzó el límite de asientos incluidos del plan.

addon.deactivated

Se desactivó un complemento de una suscripción.