Webhook 事件指南 - Dodo Payments Documentation

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

支付事件

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

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

事件名称	事件类型	描述
授予创建	`entitlement_grant.created`	为客户创建新的权限授予。许可证密钥授予通过 `delivered` 到达；基于 OAuth 的授予（Discord、GitHub、Notion）通过 `pending` 到达。
授予交付	`entitlement_grant.delivered`	授予履行完成—许可证密钥已发放、文件链接已解析或平台访问已授予。
授予失败	`entitlement_grant.failed`	授予履行失败；检查 `error_code` 和 `error_message`。
授予撤销	`entitlement_grant.revoked`	访问被撤销；检查 `revocation_reason` （订阅状态、退款、计划变更或手动）。

有关详细的有效载荷架构、示例事件和完整的 revocation_reason 参考，请参阅权限授予 Webhooks。

事件名称	事件类型	描述
放弃的结账检测	`abandoned_checkout.detected`	当检测到不完整或失败的结账超过 60 分钟时触发。
放弃的结账恢复	`abandoned_checkout.recovered`	当客户通过恢复链接完成付款时发生。

有关详细的负载架构、字段描述和处理程序示例，请参见恢复 Webhooks。

事件名称	事件类型	描述
催款开始	`dunning.started`	当对处于保留或取消状态的订阅开始催款尝试时触发。
催款恢复	`dunning.recovered`	当客户更新其付款方式并成功扣款时发生。

有关详细的有效载荷架构、字段说明和处理程序示例，请参阅恢复 Webhooks。这些 webhook 事件旨在为商家提供重要更新，以有效管理其运营。在您的 webhook 集成中为每个相关事件实施稳健的处理程序，以确保功能顺畅和可靠。