兑换码管理

• 兑换码管理仅 Admin 和 Root 可访问，从侧边栏「管理员」 → 「兑换码」或访问 /redemption-codes 进入；创建、查询、编辑、启停和删除接口统一按管理员角色授权，没有单独的细粒度权限矩阵。
• 用于批量创建和分发额度兑换码，维护其名称、额度、有效期和启用状态，并清理已失效的记录。

权限与合规前置

1. Root 必须先在「系统设置」 → 「计费与支付」 → 「支付网关」中确认当前版本的支付合规条款，管理员才能创建兑换码，用户端也才会启用兑换入口。详见：支付合规确认
2. 合规状态必须同时满足「已确认」和「条款版本为当前版本」。
3. 确认操作只能通过 Root 的控制台会话完成，API Access Token 不能代替该会话。
4. 合规未确认或条款版本与当前版本不匹配时，已有兑换码仍可由管理员查看和维护，但创建操作及用户兑换会被拒绝。

兑换码管理概览

• 兑换码管理-兑换码列表

页面顶部控件

列表字段

兑换码状态说明

兑换码管理操作

查询、筛选

• 兑换码管理-查询筛选

创建兑换码

• 兑换码管理-创建兑换码

• 兑换码管理-兑换码创建完成

1. 点击「创建代码」。
2. 在「创建兑换码」抽屉中填写名称、额度、过期时间和生成数量：
   • 名称：1–20 个字符；留空时自动以额度的显示值（如 $10）作为名称。
   • 额度：必须大于 0。
   • 过期时间：可用「永不」「1 个月」「1 周」「1 天」快速设置；留空表示永不过期，不能早于当前时间。
3. 核对额度显示单位及有效期，然后点击「保存更改」。
4. 创建成功后弹出「兑换码创建完成」：
   • 需要保存发放清单时，勾选「保存为文件」并选择「保存为 TXT」或「保存为 Markdown」；「包含名称」「包含额度」默认已勾选，可按需取消。然后点击「完成」下载文件。
   • 不勾选「保存为文件」时，点击「完成」只关闭弹窗。
   • TXT 文件每行一个兑换码，名称、兑换码、额度依次以 Tab 分隔（未勾选的项不写入），没有表头；Markdown 文件为带表头的表格。
5. 之后可在列表中复制单个或勾选的兑换码，并通过安全渠道分发。

批量复制兑换码

勾选当前页的记录后，页面底部会出现批量操作栏；点击其中的复制按钮（悬停提示「复制选定的代码」）即可复制，格式为每行：

名称<Tab>完整兑换码

批量删除兑换码

1. 勾选当前页需要删除的记录。
2. 点击页面底部批量操作栏中的红色删除按钮（悬停提示「删除选中的兑换码」）。
3. 在「删除 N 个兑换码？」确认框中点击「删除」。成功提示会显示实际删除的数量。

批量删除不区分状态，「未使用」的兑换码也会被删除。

编辑

• 兑换码管理-更新兑换码

1. 点击目标行操作列的铅笔图标。只有「未使用」的兑换码可以编辑，其他状态的铅笔图标为灰色；已禁用的兑换码需先启用。
2. 在「更新兑换码」抽屉中修改名称、额度或过期时间，然后点击「保存更改」。

启用或禁用

1. 点击目标行操作列的「…」菜单。
2. 「未使用」的兑换码菜单中显示「禁用」，「已禁用」的显示「启用」，点击即可切换。「已使用」和「已过期」的兑换码菜单中只有「删除」。

单条删除兑换码

1. 点击目标行操作列的「…」菜单并选择「删除」。
2. 在确认框核对后确认删除。

删除无效兑换码

• 兑换码管理-删除无效兑换码

「删除无效」是全局清理操作，会删除所有符合下列任一条件的兑换码：

• 已使用；
• 已禁用；
• 状态为启用，但已经超过有效期。

点击页面右上角的「删除无效」，在「删除无效的兑换码？」确认框中再次点击「删除无效」。完成后页面提示删除的数量。

使用兑换码

用户在「钱包」页面输入兑换码即可充值。详见：钱包与订阅

审计与故障排查

• 创建、编辑、启用或禁用、删除（包括单条删除、批量删除和删除无效）兑换码会产生审计记录，可在「审计日志」页面查询，不会写入「使用日志」。
• 兑换码日志不包含完整明文兑换码，但当前实现会把失败请求中提交的原始兑换码写入服务端错误日志，部署方应限制日志访问并按自身合规要求做好保护或脱敏。

相关文档

• 计费与支付配置：确认支付合规条款、设置额度显示单位。
• 钱包与订阅：用户在钱包页使用兑换码充值。
• 用户管理：管理账户角色与管理员权限。