> ## Documentation Index > Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt > Use this file to discover all available pages before exploring further. # 在 Loop 中使用订阅升级 > 在 Aftersell 中连接 Loop 并设置订阅升级的分步指南，包括 Loop 特有的限制。 本页涵盖将 **Loop** 与订阅升级配合使用的所有特定内容，包括其独有的限制。有关订阅升级工作原理的完整概览，请参阅[订阅升级](/zh/aftersell/subscription-upgrades)。
## 支持的功能
Loop 支持所有订阅升级类型： * 更改配送或计费频率 * 替换为其他产品 * 两者兼有 — 更改频率并替换产品 * 向订阅添加另一个可订阅商品（参阅[添加商品](/zh/aftersell/subscription-upgrades-add-item)） * 仅支持后付频率（不支持预付 — 参阅下方的[限制](#loop-specific-limitations)）
## 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 文档](https://loop.app/docs)。
## 在设置向导中连接 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-specific-limitations)。
### 选择循环折扣档位
某些 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 分两步处理（先拆分，再移除），因此两步之间可能出现临时行项目。第二步完成后即会自动解决。 *** ← 返回[订阅升级概览](/zh/aftersell/subscription-upgrades) · [设置与配置](/zh/aftersell/subscription-upgrades-setup) · [什么是集成？](/zh/aftersell/subscription-upgrades-integrations)