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

​
支持的功能

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

​
生成你的 Recharge API 令牌

  1. 登录你的 Recharge 商家门户。
  2. 进入 Tools & Apps → API Tokens。
  3. 点击 Create an API Token。
  4. 输入名称和联系邮箱。
  5. 设置 Aftersell 所需的权限：对 Subscriptions 的 Read and Write，以及对 Orders 和 Plans 的 Read。不需要 Products 权限范围。
  6. 点击 Save 并复制 API 密钥。
令牌必须具有全部四个权限范围：read_orders、read_subscriptions、write_subscriptions 和 read_plans。当你测试密钥时，Aftersell 会检查这四项，并在错误消息中指明缺少的权限范围。 更多详情请参阅 Recharge 的 API 文档。

​
在设置向导中连接 Recharge

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

​
在 Recharge 中验证升级

下测试订单并接受升级优惠后： 进入 Recharge 控制台的 Customers，找到该客户并打开 Subscriptions。活跃订阅应立即反映新的频率、产品或折扣。 接受后，Recharge 会以近实时的速度更新。

​
排查 Recharge 特有的问题

升级已被接受，但订阅未被修改 最常见的原因：
  • 你的 API 令牌已过期或缺少必需权限。令牌必须具有 read_orders、read_subscriptions、write_subscriptions 和 read_plans。请前往第 1 步：Connect provider，重新测试你的密钥，并查看错误消息中指明的缺失权限范围。
  • 漏斗中符合条件的产品与客户实际订阅的产品不匹配。
Aftersell 会在后台工作流中自动重试失败的提供商调用。如果所有重试均失败，请联系支持团队，并提供你的商店 URL、Shopify 订单 ID、客户邮箱、升级被接受的大致时间以及你使用的提供商。 销售计划下拉菜单为空 “Use an existing selling plan” 选项直接从 Recharge 拉取计划。如果下拉菜单为空：
  • 确认你的 Recharge 控制台中已配置销售计划。
  • 确保你的 API 令牌具有 read_plans 权限范围。
  • 返回第 1 步：Connect provider，重新测试你的 API 密钥，然后继续。
← 返回订阅升级概览 · 设置与配置 · 什么是集成？