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

credits.low

Los créditos restantes cayeron por debajo del 10% del otorgamiento del período.

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.

remainingCreditsnumber

Total credits remaining (plan plus purchased).

thresholdCreditsnumber

The low-credit threshold that was crossed: 10% of the period's granted plan credits.

periodCreditsnumber

The plan credits granted at the last period reset.

{
  "event": "credits.low",
  "timestamp": "2026-06-18T09:12:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-06-10",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "remainingCredits": 42,
    "thresholdCredits": 50,
    "periodCredits": 500
  }
}

Cuándo se dispara

El procesador asíncrono de uso observa cada deducción de créditos. Cuando un lote de uso lleva los créditos restantes (del plan más los comprados) de estar por encima a estar en o por debajo del 10% de los créditos otorgados en el último reinicio del período, este evento se dispara una vez. No se vuelve a disparar mientras el saldo se mantenga bajo, y el siguiente reinicio del período lo rearma.

Si una sola ráfaga de uso salta directamente más allá de cero, solo se dispara credits.depleted.

Úsalo para incentivar al cliente a comprar un paquete de créditos antes de que llegue a cero.

¿Cómo está esta guía?

credits.purchased

Se completó la compra de un paquete de créditos.

credits.depleted

Una suscripción se quedó sin créditos.