> ## 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.

# 在 Recharge 中使用订阅升级

> 在 Aftersell 中连接 Recharge 并设置订阅升级的分步指南。

本页涵盖将 **Recharge** 与订阅升级配合使用的所有特定内容。有关订阅升级工作原理的完整概览，请参阅[订阅升级](/zh/aftersell/subscription-upgrades)。

<div id="supported-features">
  ## 支持的功能
</div>

Recharge 支持所有订阅升级类型：

* 更改配送或计费频率
* 替换为其他产品
* 两者兼有 — 更改频率并替换产品
* 向订阅添加另一个可订阅商品（参阅[添加商品](/zh/aftersell/subscription-upgrades-add-item)）
* 预付和后付频率

<div id="generating-your-recharge-api-token">
  ## 生成你的 Recharge API 令牌
</div>

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 文档](https://docs.rechargepayments.com/)。

<div id="connecting-recharge-in-the-setup-wizard">
  ## 在设置向导中连接 Recharge
</div>

当你进入订阅升级向导的**第 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** 保持禁用状态；编辑提供商或令牌会清除之前的结果。

<div id="verifying-an-upgrade-in-recharge">
  ## 在 Recharge 中验证升级
</div>

下测试订单并接受升级优惠后：

进入 Recharge 控制台的 **Customers**，找到该客户并打开 **Subscriptions**。活跃订阅应立即反映新的频率、产品或折扣。

接受后，Recharge 会以近实时的速度更新。

<div id="troubleshooting-recharge-specific-issues">
  ## 排查 Recharge 特有的问题
</div>

**升级已被接受，但订阅未被修改**

最常见的原因：

* 你的 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 密钥，然后继续。

***

← 返回[订阅升级概览](/zh/aftersell/subscription-upgrades) · [设置与配置](/zh/aftersell/subscription-upgrades-setup) · [什么是集成？](/zh/aftersell/subscription-upgrades-integrations)