totalUnsettledSet 字段在 OrderTransaction 对象上现在能正确计算当捕获处于待处理状态时的未结算金额。受影响的字段是 OrderTransaction.totalUnsettledSet。
变更内容
此前,当捕获处于待处理状态时,totalUnsettledSet 会因错误地返回授权金额加上待处理捕获金额而重复计数。现在它正确地返回实际的未结算金额。
例如,对于授权金额为 $100 且待捕获金额为 $50 的情况:
- 变更前:返回 $150(不正确)
- 变更后:返回 $100(正确)
您需要执行的操作
无需任何操作。您现有的查询将继续正常工作,无需对代码进行任何更改。返回值现在将是正确的。
影响范围
此错误仅影响支持多次捕获的订单,即支持部分或多次捕获的订单。
根据我们的 API 重大变更政策,旨在纠正值以匹配文档行为的错误修复会立即在所有 API 版本中应用。
变更原因
此更新修复了一个在待处理捕获状态下重复计算错误的 bug。totalUnsettledSet 字段代表网关上可用于捕获的可用金额及货币,但之前的值未能反映这一点。
此 bug 是在添加多捕获支持时引入的,并在 Shopify Payments 迁移到一种捕获先经过 PENDING 状态再进入 SUCCESS 状态的流程后变得更加明显。

