用途:本技能用于在 Dodo Payments 中设置并处理 webhook,实现支付事件的实时通知,从而自动更新数据库、发送确认、同步系统状态。
主要能力:创建 webhook 端点并选择订阅事件;使用签名验证确保请求来自 Dodo;处理支付、订阅、退款、争议、许可证、权益授予、积分、恢复与催收等 40 多种事件;支持本地测试与幂等处理。
使用方式:在仪表盘 Developer → Webhooks 创建端点,填写 HTTPS URL 并复制签名密钥,设置环境变量 export DODO_PAYMENTS_WEBHOOK_KEY=whsec_...。请求包含 webhook-id、webhook-signature、webhook-timestamp 三个头。推荐使用 SDK 的 unwrap() 验证签名,需保留原始请求体;也可用 standardwebhooks 包手动验证。生产环境应快速返回 2xx,将事件持久化后异步处理,并用 webhook-id 做幂等键。
适用场景:支付成功、订阅续费、退款、争议、权益发放等需要实时响应的业务。
限制:签名验证必须使用原始字节,解析后重新序列化会失败;unsafeUnwrap() 仅用于测试;超时 15 秒,失败会重试八次;具体重试间隔资料未完整提供。