跳转到主要内容
Dodo Payments 提供实时 webhook 通知,以便您了解与交易、订阅、退款、争议和许可证密钥管理相关的关键事件。以下是这些事件的详细指南,按类别分类以便于理解,并附有实施提示和注意事项。

支付事件

事件名称事件类型描述
支付成功payment.succeeded当付款成功处理时触发。
支付失败payment.failed付款尝试因错误、被拒卡或其他问题失败时发生。
支付处理中payment.processing表示付款正在处理中。
支付已取消payment.cancelled付款在完成前被取消时触发。

退款事件

事件名称事件类型描述
退款成功refund.succeeded退款成功处理时触发。
退款失败refund.failed退款尝试因处理错误或其他问题失败时发生。

争议事件

事件名称事件类型描述
争议开启dispute.opened当客户发起争议时触发。
争议过期dispute.expired表示争议在未解决的情况下过期。
争议接受dispute.accepted当商户接受争议时触发。
争议取消dispute.cancelled当客户或系统取消争议时发生。
争议质疑dispute.challenged当商户对争议提出质疑时触发。
争议胜诉dispute.won表示商户已成功赢得争议。
争议败诉dispute.lost当商户在争议中失败时发生。

订阅事件

事件名称事件类型描述
订阅激活subscription.active表示订阅已激活并且计划进行定期收费。
订阅更新subscription.updated当任何订阅字段更新时触发(无需轮询的实时同步)。
订阅暂停subscription.on_hold当订阅因续订失败而暂时暂停时触发。
订阅续订subscription.renewed当订阅成功续订时发生。
订阅计划变更subscription.plan_changed当订阅升级、降级或添加不同插件时触发。
订阅取消subscription.cancelled当商户或客户取消订阅时触发。
订阅失败subscription.failed表示订阅失败,这意味着我们无法创建授权。
订阅过期subscription.expired当订阅达到期限并过期时触发。

许可证密钥事件

事件名称事件类型描述
许可密钥创建license_key.created当为某个产品创建新的许可密钥时触发。

信用事件

事件名称事件类型描述
信用添加credit.added当向客户授予信用(订阅、一次性、附加或 API)时触发。
信用扣除credit.deducted当信用通过使用或手动扣款被消耗时发生。
信用过期credit.expired当未使用的信用在配置的过期周期后过期时触发。
信用结转credit.rolled_over在周期结束时将未使用的信用结转到新授予时发生。
结转失效credit.rollover_forfeited当达到最大结转次数而导致信用被没收时触发。
超额收费credit.overage_charged当因超出零余额而产生超额费用时发生。
手动调整credit.manual_adjustment当进行手动信用或扣款调整时触发。
余额低credit.balance_low当信用余额低于配置的阈值时触发。
这些 webhook 事件旨在为商家提供关键更新,以有效地管理其运营。在您的 webhook 集成中为每个相关事件实现稳健的处理程序,以确保功能平稳可靠。