Webhook Payloads
Facturación basada en créditos
La carga útil que se envía a tu endpoint de webhook cuando ocurren eventos de facturación basada en créditos: créditos virtuales (llamadas a la API, tokens, horas de cómputo) concedidos, consumidos, caducados, transferidos o alertas de saldo. Estos webhooks no están relacionados con las Billeteras de Cliente (saldos monetarios).
Eventos de Webhook de Facturación Basada en Créditos
Los siguientes eventos de webhook están disponibles para rastrear los cambios en el ciclo de vida de la facturación basada en créditos. Estos eventos se aplican a los derechos de crédito virtuales (llamadas a la API, tokens, horas de cómputo), no a las Billeteras de Cliente (saldos monetarios).Eventos del Libro Mayor
Todos los eventos del libro mayor (credit.added hasta credit.manual_adjustment) comparten la misma carga útil CreditLedgerEntryResponse documentada en el esquema a continuación.
La carga útil incluye un campo metadata resuelto desde la fuente del otorgamiento de crédito: la suscripción o el pago creado en el checkout. Esto te permite asociar créditos de billetera basados en tu propio checkout metadata (por ejemplo, un orgId) en lugar del emitido por Dodo customer_id: los otorgamientos basados en suscripción muestran el metadata de la suscripción y los basados en pago muestran el metadata del pago. El campo está vacío cuando el otorgamiento no tiene una fuente resoluble (por ejemplo, créditos otorgados directamente a través de la API).
Evento de Bajo Saldo (credit.balance_low)
El eventocredit.balance_low utiliza una carga útil diferente (CreditBalanceLowPayload) enfocada en alertas de umbral:
string
La marca a la que pertenece este crédito.
string
El cliente cuyo saldo de créditos activó la alerta.
string
La suscripción asociada a este crédito.
string
El crédito que tiene un saldo bajo.
string
Nombre visible del crédito.
string
Saldo de créditos actual en el momento de la alerta.
string
Total de créditos emitidos por ciclo de facturación para esta suscripción.
integer
Porcentaje del umbral de saldo bajo configurado.
string
Cantidad absoluta de créditos a la que corresponde el umbral.
Usar credit.balance_low para alertas proactivas
Usa el webhook credit.balance_low para notificar a los clientes antes de que se queden sin créditos:
Get Customer Balance
Consulta el saldo actual de un cliente mediante la API.
Create Ledger Entry
Añade o descuenta créditos manualmente del saldo de un cliente.
Esquema del payload del webhook
Response for a ledger entry
Brand id this credit ledger entry belongs to
Metadata associated with the credit grant's source (the subscription or payment created at checkout). Empty when the grant has no resolvable source (e.g. credits granted directly via the API).
Opciones disponibles:
credit_added, credit_deducted, credit_expired, credit_rolled_over, rollover_forfeited, overage_charged, overage_reset, auto_top_up, manual_adjustment, refund Última modificación el 6 de agosto de 2026