Commet
  • Precios
Iniciar SesiónRegistrarse
Introducción

Eventos de Suscripción

subscription.createdsubscription.activatedsubscription.reactivatedsubscription.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.reactivated

Se emite cuando una suscripción cancelada se reactiva y su cobro de reactivación tiene éxito.

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 "active" for this event. Restore access here.

currentPeriodStartstring | null

ISO 8601 start of the new billing period, anchored to the reactivation date.

currentPeriodEndstring | null

ISO 8601 end of the new billing period.

namestring | null

Optional custom name for the subscription.

invoiceIdstring

The fresh reactivation invoice ID.

invoiceNumberstring

The human-readable invoice number.

invoiceTotalnumber

Invoice total in cents (100 = $1.00).

invoiceCurrencystring

The invoice currency code.

{
  "event": "subscription.reactivated",
  "timestamp": "2026-05-10T09:20:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "active",
    "currentPeriodStart": "2026-05-10T00:00:00.000Z",
    "currentPeriodEnd": "2026-06-10T00:00:00.000Z",
    "name": "Acme Corp",
    "invoiceId": "inv_q7r8s9",
    "invoiceNumber": "INV-0051",
    "invoiceTotal": 9900,
    "invoiceCurrency": "usd"
  }
}

Cuándo se emite

Una suscripción cancelada se reactivó mediante reactivate y el cobro de reactivación tuvo éxito. Commet genera un recibo nuevo, cobra el método de pago guardado y vuelve el estado a active con un período de facturación anclado a la fecha de reactivación.

La suscripción vuelve a active al mismo tiempo, así que customer.state_changed también se emite. Restaura el acceso con cualquiera de los dos eventos.

Esto se diferencia de dos eventos similares. subscription.activated se emite en la primera activación de una suscripción. payment.recovered se emite cuando una suscripción past_due se recupera: ese flujo conserva el recibo y el ancla de facturación originales, mientras que la reactivación emite un recibo nuevo y reinicia el ancla a ahora.

La reactivación requiere que el plan siga disponible en la moneda de la suscripción. Si el cobro de reactivación se rechaza, no se emite ningún evento y la API devuelve un recoveryUrl que el cliente puede usar para agregar una tarjeta nueva y pagar.

¿Cómo está esta guía?

subscription.activated

Se dispara cuando una suscripción se activa después del pago

subscription.canceled

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