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.

creditsnumber

The number of credits granted.

reasonstring

Why the credits were granted: period_reset or manual_adjustment.

{
  "event": "credits.granted",
  "timestamp": "2026-06-01T00:00:05.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-06-10",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "credits": 500,
    "reason": "period_reset"
  }
}

Cuándo se dispara

Los créditos incluidos en el plan se otorgan al inicio de cada período de facturación (reason: "period_reset"), y los ajustes manuales desde el dashboard otorgan créditos comprados (reason: "manual_adjustment"). Las compras de paquetes de créditos son un flujo aparte y disparan credits.purchased en su lugar.

La clave de idempotencia se deriva de la operación de facturación que otorgó los créditos, por lo que los reintentos del motor nunca envían un duplicado.

Úsalo para reiniciar los medidores de uso de tu aplicación al inicio de un período o para confirmar que un otorgamiento de créditos gestionado por soporte llegó al cliente.