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

trial.expired

Se dispara cuando un período de prueba se agota y comienza la facturación regular.

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 — "active" once the billing cycle has activated the subscription.

planIdstring

The plan ID.

planNamestring

The plan name.

trialEndsAtstring

ISO 8601 datetime when the trial ended.

{
  "event": "trial.expired",
  "timestamp": "2026-04-08T01:00:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "active",
    "planId": "plan_pro_monthly",
    "planName": "Pro",
    "trialEndsAt": "2026-04-08T00:00:00.000Z"
  }
}

Cuándo se dispara

La prueba alcanzó trialEndsAt. El ciclo de facturación activa la suscripción (status: "active"), inicia el primer período de facturación regular y genera la primera factura: invoice.created y los eventos de pago siguen a medida que se procesa el cobro.

El acceso no cambia en este momento: el cliente ya tenía acceso completo durante la prueba y lo mantiene como suscriptor activo. Si el primer cobro falla, se aplica el flujo regular de falla de pago (payment.failed, y subscription.past_due una vez que la suscripción ya fue pagada antes).

¿Cómo está esta guía?

trial.converted

Se dispara cuando un cliente en prueba se convierte a una suscripción paga antes de que termine la prueba.

trial.will_end

Evento predictivo que se dispara una vez, 3 días antes de que termine una prueba.