从2026-01 API版本开始,OrderTransaction对象上的authorizationCode字段已弃用,我们建议使用paymentId字段作为替代。
paymentId字段为Shopify上所有支付提供商的支付对账提供了一致且标准化的标识符;采用paymentId可确保您的集成依赖于最稳定且受支持的字段来跟踪和对账交易,而无论底层支付网关如何。
警告:paymentId返回的是Shopify特定的标识符,这与authorizationCode中的提供商特定值不同,请确保您的系统已更新以存储并使用此新ID格式进行对账。
推荐迁移
开发人员应在通过Admin GraphQL API访问OrderTransaction对象时,将查询更新为使用paymentId字段,并将authorizationCode的实例替换为paymentId;通过进行这些更改,可确保您的应用依赖于用于支付交易的标准标识符。
例如,将您的查询从:
query TransactionDetails { order(id: "gid://shopify/Order/12345") { transactions { id authorizationCode } } }更新为:
query TransactionDetails { order(id: "gid://shopify/Order/12345") { transactions { id paymentId } } }
