Webhook Payloads
争议
创建或更新争议时发送到您的 webhook 端点的有效负载,以及如何处理每个争议生命周期事件。
作为您的商户记录,Dodo Payments 代表您管理与银行卡网络的争议和拒付流程。这些 webhook 在争议的生命周期中保持您的系统同步,以便您可以撤销访问权、收集证据并对记录进行核对。
争议 Webhook 事件
争议在其生命周期的每个阶段会触发一个事件:| 事件 | 触发时间 | 通常意味着 |
|---|---|---|
dispute.opened | 持卡人在付款上提出争议 | 资金被冻结;准备应对 |
dispute.challenged | 已提交证据以对争议进行抗辩 | 争议由网络审查中 |
dispute.accepted | 争议被接受(未抗辩) | 资金退还给持卡人 |
dispute.cancelled | 争议已撤回或取消 | 无需进一步行动 |
dispute.expired | 响应窗口过期未解决 | 通常对您不利解决 |
dispute.won | 争议以您的有利方式解决 | 资金保留 |
dispute.lost | 争议以持卡人有利解决 | 资金退还给持卡人 |
通过Visa 快速争议解决 (RDR)自动解决的争议显示为
dispute.lost 与 is_resolved_by_rdr: true。这是预期的——退款是自动发出的,以防止正式拒付。处理争议事件
当dispute.opened 触发时,争议金额会立即被冻结。使用该事件更新您的记录,并且如果您打算抗辩,请在仪表盘中收集证据。
Handling dispute events
争议状态和阶段
争议对象通过两个字段报告其进度:| 字段 | 值 |
|---|---|
dispute_status | dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost |
dispute_stage | pre_dispute, dispute, pre_arbitration |
相关
Managing Disputes
如何响应争议、提交证据以及 RDR 如何保护您的争议率。
Handle Payment Failures
在付款失败成为争议之前检测并恢复它们。
Webhook 有效负载架构
The amount involved in the dispute, represented as a string to accommodate precision.
The unique identifier of the business involved in the dispute.
The timestamp of when the dispute was created, in UTC.
The currency of the disputed amount, represented as an ISO 4217 currency code.
The unique identifier of the dispute.
The current stage of the dispute process.
可用选项:
pre_dispute, dispute, pre_arbitration The current status of the dispute.
可用选项:
dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost The unique identifier of the payment associated with the dispute.
Whether the dispute was resolved by Rapid Dispute Resolution
Remarks
最后修改于 2026年6月18日