balance.depleted

{ "event": "balance.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", "currentBalance": 0, "currency": "usd" } }

Cuándo se dispara

El procesador asíncrono de uso dispara este evento una vez cuando una deducción lleva el saldo prepago de positivo a cero o por debajo. En planes que bloquean al agotarse, el uso posterior se rechaza con insufficient_balance; de lo contrario, el saldo queda en negativo y el uso continúa.

customer.state_changed se dispara junto a él con el trigger balance_depleted.

Úsalo para cortar las funciones restringidas o impulsar un flujo de recarga urgente.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "balance.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

balance.depleted

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara