balance.low

{ "event": "balance.low", "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": 90000, "thresholdBalance": 100000, "currency": "usd" } }

Cuándo se dispara

El procesador asíncrono de uso observa cada deducción de saldo. Cuando un lote lleva el saldo prepago de estar por encima a estar en o por debajo del 10% de la última recarga (reinicio del período, recarga o ajuste manual), este evento se dispara una vez por cruce. Una recarga lo rearma.

Los montos están en escala de tarifa (10000 = $1.00) en la moneda de la suscripción.

Úsalo para incentivar al cliente a recargar antes de que se bloquee el uso.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "balance.low"

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

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara