大数跨境

订阅功能现已支持通过 allowStoreCredit 使用商店信用额度

订阅功能现已支持通过 allowStoreCredit 使用商店信用额度 Shopify电商独立站
2026-11-19
0
导读:截至 API 版本 2027-01,应用可以读取和管理订阅中的商店余额。当顾客在结账时选择为符合条件的订阅使用商店余额时,Shopify 会优先从顾客的商店余额中扣除每次续订的费用,并将剩余金额通过已

截至 API 版本 2027-01,应用可以读取和管理订阅中的商店积分。当顾客在结账时选择为符合条件的订阅使用商店积分时,Shopify 会优先将顾客的商店积分应用于每次续订,并将剩余余额记入已保存的支付方式。此变更适用于 GraphQL Admin API 和 Customer Account API,且不需要任何强制操作。

变更内容

GraphQL Admin API 新增以下字段和输入参数:

  • 销售计划:SellingPlanRecurringBillingPolicy.paymentConfiguration.allowStoreCredit 显示销售计划上的订阅是否可以使用商店积分。你可以通过 SellingPlanRecurringBillingPolicyInput 上的 paymentConfiguration、sellingPlansToCreate 以及 sellingPlanGroupCreate 和 sellingPlanGroupUpdate 上的 sellingPlansToUpdate 进行设置。
  • 合同:SubscriptionContract.paymentConfiguration.allowStoreCredit 和 SubscriptionBillingCycleEditedContract.paymentConfiguration.allowStoreCredit 显示合同的商店积分设置。
  • 合同计算:paymentConfiguration 是 SubscriptionContractCalculationContractCreateInput 和 SubscriptionContractCalculationContractUpdateInput 上新增的可选输入参数。SubscriptionCalculatedContract.paymentConfiguration 显示提交所应用的值。
  • SubscriptionDraft:SubscriptionDraftInput.paymentConfiguration 可在 subscriptionDraftUpdate、subscriptionContractCreate 和 subscriptionContractAtomicCreate 上使用。

在 Customer Account API 中,SubscriptionContract.paymentConfiguration.allowStoreCredit 返回商店积分设置。顾客门户可以显示该字段,且该字段为只读。

Customer Account API 应用以下验证规则:

  • 当合同没有行项目时,API 会拒绝 allowStoreCredit: true。
  • 当任何行项目的销售计划的商店积分处于关闭状态时,API 会拒绝 allowStoreCredit: true。固定的销售计划被视为商店积分关闭。
  • API 接受没有销售计划的行项目上的 allowStoreCredit: true。
  • API 始终接受 allowStoreCredit: false。

如果计算未通过验证,则 API 会在 calculatedContract.paymentConfiguration.allowStoreCredit 上返回 INVALID 错误。在 subscriptionDraftCommit 上,它会返回 INVALID 用户错误。

受影响范围

此变更影响:

  • 使用 GraphQL Admin API 创建或管理订阅销售计划或订阅合同的应用。
  • 使用 Customer Account API 读取并显示订阅合同的客户门户。

新的 paymentConfiguration.allowStoreCredit 字段在 API 版本 2027-01 及更高版本中可用。现有的销售计划和合同保持不变,其 allowStoreCredit 默认值为 false。

应对措施

无需采取任何操作。现有的销售计划和订阅将继续按原样运行,仅当您希望为应用添加对商店积分的支持时,才需要更新您的应用。

要在应用中添加商店积分支持:

  1. 通过 SellingPlanRecurringBillingPolicyInput.paymentConfiguration 在你的销售计划上设置 allowStoreCredit。
  2. 在你的合同上设置 allowStoreCredit,可以直接通过 SubscriptionDraftInput 设置,也可以通过合同计算设置。
  3. 每次计算后,请读取 calculatedContract.paymentConfiguration.allowStoreCredit,如果该值与你发送的值不同,则不要提交该计算。

有关实现细节、端到端示例和请求结构,请参阅 Use store credit with subscriptions。

相关文档

  • 在订阅中使用商店积分
  • 关于订阅
  • 管理 API:销售计划循环计费政策 SellingPlanRecurringBillingPolicy
  • 管理 API:订阅合同 SubscriptionContract
  • 管理 API:订阅草稿输入 SubscriptionDraftInput
  • 管理 API: SubscriptionCalculatedContract
  • 客户账户 API: SubscriptionContract
【声明】内容源于网络
0
0
Shopify电商独立站
Shopify 是全球首屈一指的商务操作系统,致力于服务来自世界各地的数百万中小商户、大型零售贸易企业和国际知名品牌;其完善的软硬件及产品生态帮助用户简单便捷地,通过线上线下的多种渠道管理并销售自己的商品。
内容 7252
粉丝 1
Shopify电商独立站 Shopify 是全球首屈一指的商务操作系统,致力于服务来自世界各地的数百万中小商户、大型零售贸易企业和国际知名品牌;其完善的软硬件及产品生态帮助用户简单便捷地,通过线上线下的多种渠道管理并销售自己的商品。
总阅读127.3k
粉丝1
内容7.3k