租户管理员充值与积分兑换
功能概述
| 项目 | 内容 |
|---|---|
| 适用角色 | 租户管理员 |
| 更新日期 | 2026-06-01 |
gahorouter 中，所有 API 调用的额度都来自组织余额池（租户余额池）。作为租户管理员，您可以通过以下两种方式为组织余额池充入积分：
| 方式 | 场景 | 到账方式 |
|---|---|---|
| 在线充值 | 您希望使用支付宝、微信或 Stripe 在线支付，即买即用 | 支付成功后自动到账 |
| 兑换码兑换 | 您从系统管理员处获得了兑换码（如活动赠送、线下采购、赠予等） | 输入兑换码后立即到账 |
充值成功后的积分进入组织余额池，由您统一管理，可按需分配给租户下的成员使用。
前置条件
- 您已注册 gahorouter 并以 租户管理员 身份登录
- 普通租户成员无法使用充值和兑换功能，充值入口对其不可见
- 在线充值需要系统管理员已开通至少一种支付渠道（支付宝 / 微信 / Stripe）
- 兑换码兑换需要您已从系统管理员处获取有效的兑换码
功能入口
登录控制台后，在左侧导航栏中您可以看到与充值相关的三个入口：
| 菜单项 | 用途 |
|---|---|
| 购买 | 选择套餐并在线支付 |
| 余额管理 | 查看当前组织余额、分配与回收余额、查看余额流水 |
| 兑换码 | 输入兑换码为组织余额池充值 |
| 订单记录 | 查看历史充值订单及下载凭证 |
您也可以从「余额管理」页面右上角的 「充值」 按钮直接跳转到购买页。
方式一：在线充值（购买）
适用于通过支付宝、微信或 Stripe 即时购买积分的场景，支付成功后积分自动进入组织余额池。
操作步骤
第一步：进入购买页
通过以下任一入口进入购买页：
- 左侧导航栏 → 购买
- 左侧导航栏 → 余额管理 → 点击右上角 「充值」 按钮
第二步：选择套餐
购买页会展示系统管理员配置的所有可用充值套餐，按类型分 Tab 展示：
- 点击某张套餐卡片即可选中，选中的套餐会高亮显示并出现勾选图标
- 每张卡片展示：套餐名称、额度（积分数）、有效期等信息
- 如果套餐为「自定义金额」类型，选中后页面下方会出现金额输入框，需手动输入充值金额
第三步：选择支付方式
选中套餐后，页面下方会展示系统管理员启用的支付渠道：
| 支付渠道 | 说明 |
|---|---|
| 支付宝 | 扫描二维码用支付宝 App 完成支付 |
| 微信支付 | 扫描二维码用微信完成支付 |
| Stripe | 跳转至 Stripe 托管页面，支持信用卡等国际支付方式 |
只有当系统管理员启用了对应渠道时，才会显示该选项。如页面提示「暂无可用的支付渠道」，请联系系统管理员。
第四步：点击「立即支付」
点击页面右下角的 「立即支付」 按钮，系统会：
- 支付宝 / 微信支付：弹出二维码对话框，请在 5 分钟内使用对应 App 扫码完成支付
- Stripe：弹出等待对话框，在新窗口中打开 Stripe 支付页面，完成后返回 gahorouter
第五步：等待支付成功
支付完成后：
- 页面会自动检测支付状态并弹出「支付成功！余额已到账」提示
- 提示框中会显示当前最新的组织余额
- 您可以点击 「关闭」 返回，或点击 「继续购买」 发起下一次充值
二维码有效期为 5 分钟，超时未支付将需要重新发起订单。
业务规则
- 在线充值后的积分会进入组织余额池，由租户管理员统一支配
- 订单 30 分钟未完成支付会自动标记为超时，超时订单无法继续支付，需要重新下单
- 退款由系统管理员在后台操作，退款成功后会从对应购买余额中扣减
方式二：兑换码兑换
适用于您从系统管理员处获得了兑换码（例如活动奖励、线下采购、赠予等场景），通过输入兑换码完成充值。
操作步骤
第一步：进入兑换码页面
侧边栏【兑换码】
第二步：输入兑换码
- 页面顶部的卡片会显示当前的组织余额
- 在「兑换码」输入框中粘贴或输入完整的兑换码
- 点击 「立即兑换」 按钮
第三步：查看兑换结果
- 兑换成功：页面会弹出绿色提示卡片，显示「兑换成功！」、本次充值金额、新余额。组织余额卡片也会同步刷新。
- 兑换失败：页面会弹出红色提示卡片，显示具体原因（见下方「常见错误」）。
业务规则
- 每个兑换码只能使用一次，兑换成功后立即作废
- 兑换成功后，额度直接进入当前租户的组织余额池，由您统一支配
- 兑换成功的记录会显示在同页面下方的「兑换历史」列表中
常见错误
| 错误提示 | 原因 | 解决办法 |
|---|---|---|
| 兑换码无效 | 兑换码不存在，或类型错误（如输入了个人余额兑换码） | 确认从系统管理员处获取的是「租户余额」类型兑换码 |
| 兑换码已被使用 | 该兑换码已被其他人或您自己之前兑换过 | 联系系统管理员确认或申请新的兑换码 |
查看充值记录
余额流水
进入 左侧导航栏 → 余额管理，可以看到完整的组织余额变动流水：
流水表中的类型说明：
| 类型 | 说明 |
|---|---|
| 购买 | 通过「购买」页在线支付充入的积分 |
| 兑换码 | 通过「兑换码」页兑换充入的积分 |
| 充值 | 由系统管理员直接为您充值的积分 |
| 分配 | 将组织余额池分配给租户成员的扣减 |
| 回收 | 从租户成员处回收到组织余额池的增加 |
| 消费 | 成员调用模型的扣减 |
| 退款 | 退款操作的扣减 |
| 优惠码 | 通过优惠码充入的积分 |
订单记录
进入 左侧导航栏 → 订单记录，可以看到历史的充值订单列表。
在已支付的订单上，您可以点击 「下载凭证」 获取报销用的充值凭证。
管理组织余额
充值成功后，积分进入组织余额池。作为租户管理员，您可以进一步：
| 操作 | 入口 | 说明 |
|---|---|---|
| 单个分配 | 余额管理 → 分配余额 → 单个分配 | 为某个成员分配指定额度 |
| 批量分配 | 余额管理 → 分配余额 → 批量分配 | 一次为多个成员分配相同额度 |
| 回收余额 | 余额管理 → 回收余额 | 将成员未用完的额度回收到组织余额池 |
分配和回收操作同样会记录在余额流水中，便于后续审计。
常见问题
Q1：在线充值支付成功后余额没有到账怎么办？
A：请按以下顺序排查：
- 刷新页面，等待 1-2 分钟后再次查看余额管理页
- 进入「订单记录」查看订单状态是否为「已支付」
- 如订单长时间处于「待支付」，可能是支付回调未到达，请联系系统管理员协助处理
- 如订单状态为「支付失败」或「已超时」，请重新下单
Q2：点击「充值」按钮后显示「暂无可购买的套餐」？
A：说明系统管理员尚未配置可用的充值套餐。请联系系统管理员在后台「商品管理」中创建套餐。
Q3：页面提示「暂无可用的支付渠道」？
A：说明系统管理员尚未启用任何支付渠道。请联系系统管理员在后台「支付管理 → 支付渠道」中配置并启用支付宝、微信或 Stripe。
Q4：为什么我输入的兑换码提示「无效」？
A：可能原因：
- 兑换码拼写错误 —— 请复制粘贴完整的兑换码，注意大小写
- 兑换码已被删除 —— 请联系系统管理员重新发放
Q5：兑换码可以多次使用吗？
A：不可以。每个兑换码只能使用一次，兑换成功后立即作废。
Q6：自定义金额怎么填？
A：在线充值的「自定义金额」套餐支持手动输入充值金额，具体可输入范围以页面提示为准。
Q7：二维码过期了怎么办？
A：二维码有效期为 5 分钟，过期后请重新点击「立即支付」或「重新发起支付」生成新二维码。如果已经过期且未支付，旧订单会自动变为「已超时」状态，不会重复扣费。
Q8：充值后可以退款吗？
A：本期退款操作由系统管理员在后台发起，租户管理员无法自行退款。如需退款，请联系系统管理员并提供订单号。
Q9：充值的积分可以转给租户下的成员吗？
A：可以。组织余额池的积分可以通过「余额管理 → 分配余额」分配给成员。成员使用模型调用时，也会直接从组织余额池扣减（具体取决于管理员的分配策略）。
Q10：普通成员可以看到充值入口吗？
A：不可以。购买、兑换码、订单记录等菜单仅对租户管理员角色（tenant_admin）可见。普通成员登录后不会看到这些入口，也无法直接调用充值相关接口。
注意事项
- 在线充值和兑换码是两种独立的充值方式，两者到账的积分都进入同一个组织余额池
- 订单 30 分钟自动超时，请尽快完成支付
- 充值成功的积分由租户管理员统一支配，请合理规划分配策略，避免成员用超或囤积
- 请妥善保管兑换码，避免泄露导致被他人兑换
- 所有充值记录都会保留在余额流水和订单记录中，便于审计和报销
- 涉及大额充值或财务对账时，建议从「订单记录」下载凭证留存
联系我们
如果在使用过程中遇到任何问题，请及时联系我们。