Webhook Payloads
争议 Webhook
当创建或更新争议时发送到您的 Webhook 端点的负载。处理每个事件,以响应争议并对账您的记录。
作为您的商户记录,Dodo Payments 代表您管理与银行卡网络的争议和拒付流程。这些 webhook 在争议的生命周期中保持您的系统同步,以便您可以撤销访问权、收集证据并对记录进行核对。
争议 Webhook 事件
争议在其生命周期的每个阶段会触发一个事件:通过Visa 快速争议解决 (RDR)自动解决的争议显示为
dispute.lost 与 is_resolved_by_rdr: true。这是预期的——退款是自动发出的,以防止正式拒付。Ethoca alerts 和 deflections 永远不会创建争议,因此不会发出
dispute.* 事件。Ethoca alert 退款会触发标准的 refund.succeeded 事件,任何关联的订阅取消都会触发常规的订阅事件。deflection 不会触发任何事件。处理争议事件
当dispute.opened 触发时,争议金额会立即被冻结。使用该事件更新您的记录;如果您打算提出申诉,请在 dashboard 中收集证据。
Handling dispute events
争议状态和阶段
争议对象通过两个字段报告其进度:相关内容
Managing Disputes
如何响应争议、提交证据,以及 RDR 如何保护您的争议率。
Handle Payment Failures
在失败的付款变成争议之前检测并挽回这些付款。
Webhook 负载架构
最后修改于 2026年9月26日