GraphQL Admin API 中的新SubscriptionContractCalculation对象现已在2026-10发布候选版API版本中提供早期访问，它是用于创建、更新和编辑订阅合同的GraphQL Admin API的SubscriptionDraft对象的继任者，通过Shopify的统一结账引擎以无状态的calculate → poll → commit生命周期取代了多步骤草稿工作流。
将合同编辑移至统一结账引擎可确保计算与结账保持一致，一个calculate突变替代了12个以上的草稿突变，且新的结账功能可与合同编辑配合使用而无需等待订阅专属支持，这会影响任何管理订阅合同的应用；如果您基于订阅进行开发，则需要迁移到新API以获取其新功能，但由于两个API将共存，您可以逐步迁移。
受影响的用户
这适用于任何使用SubscriptionDraft对象创建、更新或编辑订阅合同的应用；仅读取合同或通过subscriptionContractActivate、subscriptionContractPause及类似突变管理合同状态的应用不受影响，状态仍通过这些专用突变设置，而非计算输入。
该API现可在2026-10发布候选版API版本中进行早期访问，并将在2026-10上变为稳定版本。
变更内容
合同编辑现在通过支撑Checkout、草稿订单和订阅计费尝试的相同C1结账引擎运行，而不是以前与结账并行运行的定制SubscriptionDraft引擎。
之前的工作流程需要在草稿生命周期中执行十几个有状态的突变来编辑单个合同（创建草稿→添加行→更新行→移除行→添加折扣→应用代码→更新配送→提交），而新API将此整合为三个calculate操作加上一个共享提交：
- Calculate：通过单个突变提交所需的合同状态：subscriptionContractCreateCalculate、subscriptionContractUpdateCalculate或subscriptionBillingCycleContractEditCalculate。
- Poll：calculate突变返回SubscriptionContractCalculationPending响应轮询subscriptionContractCalculation查询，或订阅subscription_contract_calculations/succeed和subscription_contract_calculations/fail webhook，直到收到SubscriptionContractCalculationSuccess或SubscriptionContractCalculationFailure。
- Commit：调用subscriptionContractCalculationCommit以持久化计算出的快照。
Shopify在服务端计算价格、税费、折扣和Shopify Functions，并在您持久化任何内容之前返回不可变的预览——包括行、配送、税费、关税和折扣总额——由于状态由客户端提供，您在更新时省略的任何字段都会保留，因此您只需发送发生变化的内容，有关详细信息，请参阅migration guide。
使用 C1 运行还可解锁通过草稿 API 无法实现的功能：在合同中捆绑产品、购物车转换和配送自定义函数，以及定价与税务功能，这些功能将与订阅者在定期订单中看到的保持一致。
操作指南
需要采取行动以采用新功能，一旦新API在2026-10达到通用可用性，SubscriptionDraft对象将被弃用；它仍将可用，但不再支持新功能，请在2026-10稳定之前不要构建生产集成。
我们编写了一份完整的migration guide以支持您迁移到新API。
相关文档
- 迁移到 SubscriptionContractCalculation 对象
- 构建订阅合同