credits.depleted

{ "event": "credits.depleted", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "remainingCredits": 0 } }

Cuándo se dispara

El procesador asíncrono de uso dispara este evento una vez cuando una deducción lleva el saldo de créditos de positivo a cero. A partir de ese momento, las solicitudes de uso que necesiten más créditos de los que quedan se rechazan con insufficient_credits.

customer.state_changed se dispara junto a él con el trigger credits_depleted, llevando el estado de derechos (entitlement) actual completo del cliente.

Úsalo para bloquear las funciones restringidas de tu aplicación y dirigir al cliente a la compra de un paquete de créditos.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "credits.depleted"

timestamp

string

requerido

organizationId

string

requerido

mode

enum<string>

requerido

Opciones disponibles:

live,

sandbox

apiVersion

string

requerido

data

object

requerido

Show child attributes

Respuesta

200

Return any 2xx status code to acknowledge receipt of the event.

Introducción

Eventos

credits.depleted

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara