Skip to main content
作为您的商户记录,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
在处理之前,始终验证 Webhook 签名——有关设置,请参阅 Webhook 指南。为简洁起见,上述处理程序省略了验证步骤。
争议创建后,您有 10 天 时间进行响应。有关需要收集的证据及其格式,请参阅争议响应最佳实践。

争议状态和阶段

争议对象通过两个字段报告其进度:

相关内容

Managing Disputes

如何响应争议、提交证据,以及 RDR 如何保护您的争议率。

Handle Payment Failures

在失败的付款变成争议之前检测并挽回这些付款。

Webhook 负载架构

amount
string
必填

The amount involved in the dispute, represented as a string to accommodate precision.

brand_id
string
必填

Brand id this dispute belongs to

business_id
string
必填

The unique identifier of the business involved in the dispute.

created_at
string<date-time>
必填

The timestamp of when the dispute was created, in UTC.

currency
string
必填

The currency of the disputed amount, represented as an ISO 4217 currency code.

customer
object
必填

The customer who filed the dispute

dispute_id
string
必填

The unique identifier of the dispute.

dispute_stage
enum<string>
必填

The current stage of the dispute process.

可用选项:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
必填

The current status of the dispute.

可用选项:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
必填

The unique identifier of the payment associated with the dispute.

payment_provider
enum<string>
必填

Which processor handled the underlying payment. stripe / adyen for BYOP routes (the merchant's own payment connector); dodo for everything Dodo processed itself.

可用选项:
stripe,
adyen,
dodo
is_resolved_by_rdr
boolean | null

Whether the dispute was resolved by Rapid Dispute Resolution

reason
string | null

Reason for the dispute

remarks
string | null

Remarks

最后修改于 2026年9月26日