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.converted

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

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.

planIdstring

The plan ID the customer converted to.

planNamestring

The plan name.

{
  "event": "trial.converted",
  "timestamp": "2026-04-01T10: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"
  }
}

Cuándo se dispara

Un cliente en una prueba cambia de plan antes de que la prueba se agote. La prueba termina de inmediato, se cobra el precio completo del nuevo plan (sin crédito de prorrateo: las pruebas son gratuitas) y la suscripción pasa a active.

subscription.plan_changed se dispara junto con este evento con los detalles del cobro. Usá trial.converted para analíticas de conversión y mensajes del ciclo de vida; usá subscription.plan_changed para actualizaciones de permisos.

Las pruebas que simplemente se agotan disparan trial.expired en su lugar: esa es la transición natural de prueba a pago.

¿Cómo está esta guía?

trial.started

Se dispara cuando una suscripción entra en su período de prueba. Otorgá el acceso aquí.

trial.expired

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