我们引入了一个新的 DisputeStatus 值 prevented，并更新了所有争议状态的描述，以确保清晰性和一致性。
变更内容
您现在可以在 Admin API（包括 GraphQL 和 REST）以及包含争议状态的任何 webhook 或有效载荷中收到 prevented 状态；我们已刷新所有争议状态的描述，以更好地反映实际结果和处理方术语。
适用对象
为何重要
- 区分通过上游机制（例如 Visa Rapid Dispute Resolution）阻止的拒付案例与其他结果。
- 更新您的用户界面和报告，以反映被阻止的争议不会产生拒付费用。
- 在争议生命周期的各个阶段获得更清晰、更具可操作性的状态定义。
工作原理
当拒付在提交前被阻止时，处理方可能会发送 prevented 状态；目前，对于通过第三方注册的商户，Stripe 可能会针对受 RDR 保护的 Visa 交易发送 prevented。
Shopify 不会将商户注册到争议预防服务中，但如果商户通过第三方注册且处理方发送了 prevented，您将在 Shopify 管理后台中看到该状态。
可用性
- 现已在 Admin API（GraphQL 和 REST）以及包含争议状态的负载中提供。
- 这是一个非破坏性更改；无需进行版本锁定。
您应该做什么
- 请审查任何严格的枚举处理（如 switch 语句、验证逻辑、数据库约束），以确保接受 prevented。
- 更新界面文案、翻译和过滤器，使 prevented 与开放、胜诉或败诉状态明显区分开来。
- 检查对结果进行分组或计算费用的分析和报告管道，以确保 prevented 被正确分类。
- 验证任何响应争议状态变化的 webhook 或事件处理程序是否能优雅地处理 prevented。
限制与说明
- 仅当您的支付处理方提供 prevented 时才会显示该状态；可用性因处理方和商户注册情况而异。
- Prevented 表示争议未进入拒付阶段，商户不会被收取拒付费用。
文档
如需更多信息，请参阅以下资源：
- Admin GraphQL DisputeStatus 枚举
- Admin GraphQL Dispute 对象
- 管理员 REST 争议
破坏性变更
无