Skip to main content
本页涵盖将 Loop 与订阅升级配合使用的所有特定内容，包括其独有的限制。有关订阅升级工作原理的完整概览，请参阅订阅升级。

​
支持的功能

Loop 支持所有订阅升级类型：
  • 更改配送或计费频率
  • 替换为其他产品
  • 两者兼有 — 更改频率并替换产品
  • 向订阅添加另一个可订阅商品（参阅添加商品）
  • 仅支持后付频率（不支持预付 — 参阅下方的限制）

​
Loop 特有的限制

  • **计费频率必须等于配送频率。**Loop 不支持通过此集成使用预付订阅。计费频率字段被禁用，并自动与配送频率同步。如果你的商店依赖预付计划，这是需要注意的最大约束。

​
生成你的 Loop API 令牌

  1. 打开 Loop 应用，进入左下角的 Settings。
  2. 在 Admin 下，点击 API Tokens。
  3. 设置 Aftersell 所需的权限：对 Subscription contracts 的 Read and Write，以及对 Orders 和 Selling plans 的 Read。只有订阅需要写入权限。
  4. 点击 Generate New Token。
  5. 输入名称，选择相应的权限范围，然后点击 Generate Token。
  6. 点击 Show Token 查看并复制你的密钥。请像对待密码一样对待它，并妥善保存。
更多详情请参阅 Loop 的 API 文档。

​
在设置向导中连接 Loop

当你进入订阅升级向导的第 1 步：Connect provider 时：
  1. 在 Subscription provider 下拉菜单中选择 Loop。
  2. 将你的 API 令牌粘贴到 API token 字段中。
  3. 点击 Test API key。Aftersell 会验证令牌，检查它能否正确通过身份验证、是否具有所有必需的权限范围，以及是否属于你的商店。
  4. 测试通过（绿色对勾）后，点击 Continue 进入第 2 步。
测试结果会显示两种状态之一：
  • **绿色对勾 — “API key verified”。**令牌通过了身份验证，所有必需的权限范围均已具备，且令牌属于你的商店。Continue 现已启用。
  • **红色取消图标。**检查未能顺利通过。请阅读图标旁边的消息：要么令牌被拒绝，要么缺少必需的权限范围。消息会指明具体缺少哪些权限范围。请在 Loop 中修正令牌后重新测试。也可能是 Aftersell 无法完成检查（“Could not verify the API key. Please try again.”），这属于调用失败而非令牌无效 — 这种情况下重新测试即可。
无法验证的结果看起来与被拒绝完全一样，因此请以消息内容而非图标为准。在检查结果变为绿色之前，Continue 保持禁用状态；编辑提供商或令牌会清除之前的结果。

​
保持多产品订阅完整

默认情况下，当频率升级或频率加产品升级应用于其 Loop 订阅上有两个或更多活跃行项目的客户时，Aftersell 会将升级的产品拆分为一个新的订阅。这样其他商品会保留原有的扣款周期。 如果订阅上的其他产品是升级产品的附加品（而不是独立的订阅），你可以在优惠上启用 Don’t split multi-product subscriptions。启用后，Aftersell 会将整个合约重新计时为新频率，而不是拆分它。 启用此设置后可以预期：
  • 订阅上的其他产品也会转到新的频率。
  • 这些产品会保留其原有频率销售计划中的折扣，但按新的节奏。
  • Aftersell 不保证同一订阅中其他商品的定价正确 — 如果同一订阅中的某个产品处于固定价销售计划且新频率没有匹配的计划，它将按新的节奏保留原有的绝对价格。
只有当其他产品是升级产品的附加品时才启用此项。如果它们是独立的订阅，请使用默认的拆分行为，让每个产品保留在自己的扣款周期上。
此设置仅在 Loop 上、frequency 和 frequency + product 升级类型下可用。它以复选框形式出现在优惠设置面板中。

​
配置升级之前（第 3 步）

配置频率变更时，你可以选择现有的销售计划，也可以手动设置频率：
  • **使用现有的销售计划。**从销售计划下拉菜单中选择。该计划必须已存在于你的 Loop 控制台中并处于活跃状态。
  • **手动设置频率。**自行输入配送频率。Loop 接受任意周期，无需匹配的销售计划。使用手动频率时，你还可以应用循环折扣。
如果你手动设置了频率，而客户的订阅有两个或更多活跃产品行（多产品或捆绑合约），除非目标频率存在匹配的销售计划，否则升级将失败。详情请参阅限制。

​
选择循环折扣档位

某些 Loop 销售计划会在订阅的不同阶段应用不同的折扣 — 例如，首次扣款减 $20，第二次扣款起减 $10。当你选择这样的计划时，Recurring discount 字段会被替换为一组单选按钮，显示该计划的每个折扣档位及其扣款范围（例如 “Charge 1” 或 “Charge 2 onward”）。 选择你希望应用于升级后订阅每次未来续订的档位。所选档位会随优惠一起保存，并在客户接受升级时应用。 如果所选计划没有折扣档位，或者你是手动设置频率，则会显示标准的自由输入折扣字段。

​
在 Loop 中验证升级

下测试订单并接受升级优惠后： 进入 Loop 控制台的 Subscriptions，找到该客户的订阅。Loop 的升级调用是同步的，因此 Aftersell 这边没有处理延迟 — 调用返回的那一刻，变更就已在 Loop 应用。Loop 自身的订阅列表可能需要更长时间才能跟上，因此如果暂时没有显示，请等待几分钟并刷新，再判断是否失败。 如果变更没有出现，说明它没有生效 — 参见下文。

​
排查 Loop 特有的问题

我无法更改计费频率 这是预期行为。Loop 不支持通过此集成使用预付订阅。计费频率字段被禁用，并自动与配送频率同步。 升级已被接受，但订阅未被修改 如果订阅没有变化，最常见的原因是：
  • 你手动设置了频率，而客户的订阅有两个或更多活跃产品行。这种情况下，Loop 要求目标频率有匹配的销售计划。请在 Loop 中创建该销售计划，或在优惠配置中切换到 Use an existing selling plan。
  • 你使用了 Use an existing selling plan，但所选销售计划已不存在于你的 Loop 控制台中。请在 Loop 中创建该销售计划并重试。
  • 你的 API 令牌已过期或缺少必需权限：对 Subscription contracts 的写入权限，对 Orders 和 Selling plans 的读取权限。请前往第 1 步：Connect provider，重新测试你的密钥，并查看错误消息中指明的缺失权限范围。
  • 漏斗中符合条件的产品与客户实际订阅的产品不匹配。
Aftersell 会在后台工作流中自动重试失败的提供商调用。如果所有重试均失败，请联系支持团队，并提供你的商店 URL、Shopify 订单 ID、客户邮箱、升级被接受的大致时间以及你使用的提供商。 销售计划下拉菜单为空 “Use an existing selling plan” 选项直接从 Loop 拉取计划。如果下拉菜单为空：
  • 确认你的 Loop 控制台中已配置销售计划。
  • 确保你的 API 令牌对 Selling plans 具有 Read 权限。
  • 返回第 1 步：Connect provider，重新测试你的 API 密钥，然后继续。
我的 Loop 控制台中出现了临时的处理中行项目 当多行订阅升级使用默认的拆分行为时，这是预期行为。Loop 分两步处理（先拆分，再移除），因此在 24 小时的同步窗口内可能会出现临时行项目。同步完成后它们会自动解决。如果你想完全避免拆分，请参阅保持多产品订阅完整。
← 返回订阅升级概览 · 设置与配置 · 什么是集成？