大数跨境

修复了待处理扣款(pending captures)的 totalUnsettledSet 计算问题

修复了待处理扣款(pending captures)的 totalUnsettledSet 计算问题 Shopify电商独立站
2026-04-24
2
导读:Order Transaction 对象上的“总未结算金额”字段现在能够在捕获(capture)处于待处理状态时正确计算未结算金额。受影响的字段为 Order Transaction.total Un

totalUnsettledSet 字段在 OrderTransaction 对象上现在能正确计算当捕获处于待处理状态时的未结算金额。受影响的字段是 OrderTransaction.totalUnsettledSet。

变更内容

此前,当捕获处于待处理状态时,totalUnsettledSet 会因错误地返回授权金额加上待处理捕获金额而重复计数。现在它正确地返回实际的未结算金额。

例如,对于授权金额为 $100 且待捕获金额为 $50 的情况:

  • 变更前:返回 $150(不正确)
  • 变更后:返回 $100(正确)

您需要执行的操作

无需任何操作。您现有的查询将继续正常工作,无需对代码进行任何更改。返回值现在将是正确的。

影响范围

此错误仅影响支持多次捕获的订单,即支持部分或多次捕获的订单。

根据我们的 API 重大变更政策,旨在纠正值以匹配文档行为的错误修复会立即在所有 API 版本中应用。

变更原因

此更新修复了一个在待处理捕获状态下重复计算错误的 bug。totalUnsettledSet 字段代表网关上可用于捕获的可用金额及货币,但之前的值未能反映这一点。

此 bug 是在添加多捕获支持时引入的,并在 Shopify Payments 迁移到一种捕获先经过 PENDING 状态再进入 SUCCESS 状态的流程后变得更加明显。

【声明】内容源于网络
0
0
Shopify电商独立站
1234
内容 7146
粉丝 0
Shopify电商独立站 1234
总阅读87.4k
粉丝0
内容7.1k