Webhook Payloads
基于额度的计费 Webhook
当基于额度的计费事件发生时发送到您的 webhook endpoint 的 payload — 虚拟额度被授予、消耗、过期、结转或触发余额警报。
基于信用的计费 Webhook 事件
以下 webhook 事件可用于跟踪基于信用的计费生命周期的变化。这些事件适用于虚拟信用权益(API 调用、令牌、计算小时),而非客户钱包(货币余额)。分类账事件
所有分类账事件(credit.added 至 credit.manual_adjustment)使用下方模式中记录的相同 CreditLedgerEntryResponse 负载。
有效负载包括从信用授权的来源解析出的metadata字段——即在结账时创建的订阅或付款。这使您可以根据自己的结账流程键入钱包积分metadata(例如,一个orgId),而不是Dodo发出的customer_id:订阅来源的授权会显示订阅的metadata,付款来源的授权会显示付款的metadata。当授权没有可解析来源时(例如,通过API直接授予的信用),该字段为空。
余额低事件 (credit.balance_low)
credit.balance_low事件使用不同的有效负载(CreditBalanceLowPayload),专注于阈值警报:
使用 credit.balance_low 进行主动提醒
使用 credit.balance_low webhook,在客户 credits 用尽前通知他们:
Get Customer Balance
通过 API 查看客户的当前 balance。
Create Ledger Entry
手动为客户的 balance 充值或扣款。
Webhook Payload Schema
Response for a ledger entry
最后修改于 2026年9月26日