Webhook Payloads
Webhooks de facturation basée sur les crédits
La charge utile envoyée à votre point de terminaison webhook lorsque des événements de facturation basée sur les crédits se produisent — crédits virtuels accordés, consommés, expirés, reportés ou alertes de solde.
Événements webhook de facturation basés sur les crédits
Les événements webhook suivants sont disponibles pour suivre les changements du cycle de vie de la facturation basée sur les crédits. Ces événements s’appliquent aux droits de crédits virtuels (appels d’API, jetons, heures de calcul), pas aux Customer Wallets (soldes monétaires).Événements du grand livre
Tous les événements du grand livre (credit.added à credit.manual_adjustment) partagent la même charge utile CreditLedgerEntryResponse documentée dans le schéma ci-dessous.
La charge utile inclut un champ metadata résolu à partir de la source de l’octroi de crédit — l’abonnement ou le paiement créé lors du passage en caisse. Cela vous permet d’associer vos crédits de portefeuille à votre propre checkout metadata (par exemple, un orgId) plutôt qu’à celui émis par Dodo : les octrois issus de l’abonnement affichent le metadata de l’abonnement et les octrois issus du paiement affichent le metadata du paiement. Le champ est vide lorsque l’octroi n’a pas de source résolvable (par exemple, des crédits accordés directement via l’API).
Événement de Solde Bas (credit.balance_low)
L’événementcredit.balance_low utilise une charge utile différente (CreditBalanceLowPayload) axée sur l’alerte de seuil :
Utiliser credit.balance_low pour les alertes proactives
Utilisez le webhook credit.balance_low pour avertir les clients avant qu’ils n’épuisent leurs crédits :
Get Customer Balance
Consultez le solde actuel d’un client via l’API.
Create Ledger Entry
Créditez ou débitez manuellement le solde d’un client.
Schéma de payload du webhook
Response for a ledger entry
Dernière modification le 26 septembre 2026