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

​
支持的功能

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

​
Loop 特有的限制

  • **计费频率必须等于配送频率。**Loop 不支持通过此集成使用预付订阅。计费频率字段被禁用，并自动与配送频率同步。如果你的商店依赖预付计划，这是需要注意的最大约束。
  • 多行订阅分两步处理：目标产品行会被拆分到一个具有目标频率的新订阅中，然后从原订阅中移除。这涉及多次 API 调用，在同步窗口期间，你的 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 保持禁用状态；编辑提供商或令牌会清除之前的结果。

​
配置升级之前（第 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 分两步处理（先拆分，再移除），因此两步之间可能出现临时行项目。第二步完成后即会自动解决。
← 返回订阅升级概览 · 设置与配置 · 什么是集成？