跳转到主要内容
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当为产品创建新的许可证密钥时触发。
这些 webhook 事件旨在为商家提供关键更新,以有效管理其运营。在您的 webhook 集成中为每个相关事件实施强大的处理程序,以确保顺畅和可靠的功能。