Webhook Payloads
Kreditbasierte Abrechnung
Die Nutzlast, die an Ihren Webhook-Endpunkt gesendet wird, wenn ereignisbasierte Änderungen der kreditbasierten Abrechnung eintreten – virtuelle Credits (API-Aufrufe, Tokens, Compute-Stunden) werden gewährt, verbraucht, verfallen, übertragen oder es gibt Guthabenwarnungen. Diese Webhooks beziehen sich nicht auf Customer Wallets (monetäre Guthaben).
Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Kreditbasierte Abrechnung Webhook-Ereignisse
Die folgenden Webhook-Ereignisse stehen zur Verfügung, um Änderungen im Lebenszyklus der kreditbasierten Abrechnung nachzuverfolgen. Diese Ereignisse gelten für virtuelle Credit-Berechtigungen (API-Aufrufe, Tokens, Compute-Stunden), nicht für Customer Wallets (monetäre Guthaben).| Ereignis | Beschreibung |
|---|---|
credit.added | Gutschriften werden einem Kunden gewährt (über Abonnement, Einmalkauf, Add-on oder API) |
credit.deducted | Gutschriften werden durch Nutzung oder manuelle Belastung verbraucht |
credit.expired | Unbenutzte Gutschriften sind nach der konfigurierten Verfallsfrist verfallen |
credit.rolled_over | Unbenutzte Gutschriften werden am Zyklusende in eine neue Gewährung übertragen |
credit.rollover_forfeited | Gutschriften verfallen, weil die maximale Übertragsanzahl erreicht wurde |
credit.overage_charged | Überlastungsgebühren werden erhoben, wenn die Nutzung über den Nullsaldo hinaus fortgesetzt wird |
credit.overage_reset | Aufgelaufene Überlastungsgebühren werden zurückgesetzt (z. B. zu Beginn eines neuen Abrechnungszeitraums) |
credit.manual_adjustment | Manuelle Gutschrift oder Belastungsanpassung über Dashboard oder API vorgenommen |
credit.balance_low | Guthaben fällt unter die konfigurierte Schwelle für niedrigen Saldo |
Ledger-Ereignisse
Alle Ledger-Ereignisse (credit.added bis credit.manual_adjustment) verwenden dieselbe CreditLedgerEntryResponse-Nutzlast, die im untenstehenden Schema dokumentiert ist.
Event bei niedrigem Guthaben (credit.balance_low)
Dascredit.balance_low-Ereignis verwendet eine andere Nutzlast (CreditBalanceLowPayload), die sich auf Schwellenwertwarnungen konzentriert:
Der Kunde, dessen Kreditguthaben den Alarm ausgelöst hat.
Das mit dieser Credit-Berechtigung verknüpfte Abonnement.
Die Credit-Berechtigung, deren Guthaben niedrig ist.
Anzeigename der Credit-Berechtigung.
Aktuelles Credit-Guthaben zum Zeitpunkt der Warnung.
Gesamte Credits, die pro Abrechnungszyklus für dieses Abonnement ausgegeben werden.
Der konfigurierte Schwellenwert in Prozent für niedrigen Kontostand.
Der absolute Credit-Betrag, dem der Schwellenwert entspricht.
Verwendung von credit.balance_low für proaktive Warnungen
Verwenden Sie den credit.balance_low-Webhook, um Kunden zu benachrichtigen, bevor ihnen die Credits ausgehen:
Get Customer Balance
Ermitteln Sie das aktuelle Guthaben eines Kunden über die API.
Create Ledger Entry
Buchen Sie manuell ein Credit oder Debit auf das Guthaben eines Kunden.
Webhook-Payload-Schema
Response for a ledger entry
Verfügbare Optionen:
credit_added, credit_deducted, credit_expired, credit_rolled_over, rollover_forfeited, overage_charged, overage_reset, auto_top_up, manual_adjustment, refund Last modified on May 22, 2026