07 · 系统直充¶
入口路径：后台 → 系统直充 目标读者：副组长 / 财务 / 营销执行 / 客服主管 核心问题：从后台手动给玩家加钱、加宝箱、加奖券，或者把"亏损用户"的打码量清零 资料来源：
系统直充子项.png+现金直充.png+单人充值.png+批量充值.png+文本批量充值.png+文本批量充值-下载模板.png+现金充值类型.png+现金直充操作类型.png+直充宝箱.png+批量直充宝箱.png+文本批量充值宝箱.png+文本批量直充宝箱-下载模板.png+奖券直充.png+奖券批量直充.png+打码量清空列表.png最后更新：2026-05-11 作者：Bob/Aimee
一、模块定位¶
系统直充 = 业主从后台手动给玩家账户加东西的统一入口。和 04-营销工具的兑换码 的区别：
| 维度 | 兑换码 | 系统直充 |
|---|---|---|
| 触发方 | 玩家主动输入码 | 后台主动塞给指定用户 |
| 颗粒度 | 一批码（玩家先到先得） | 指定用户名单（精准投放） |
| 用途 | 营销活动 | 补偿 / 私域回访 / VIP 关怀 / 风控扣款 |
| 风险 | 中（码可能被刷） | 高（直接动账，谷歌验证码必填） |
4 个子菜单：
| 子项 | 标的物 | 用途 |
|---|---|---|
| 现金直充 | 余额 + 提现码量（=有效打码量） | 补偿 / 扣款 / VIP 关怀 |
| 直充宝箱 | 宝箱（随机翻倍奖金） | 高端营销玩法 |
| 奖券直充 | 奖券（如「白银」奖券） | 活动奖品发放 |
| 打码量清空列表 | 清空亏损用户的打码量 | 风控自动化（亏损达阈值后清空） |
⚠️ 谷歌验证码硬要求：所有直充操作（无论现金、宝箱、奖券）都强制要求 Google Authenticator 2FA。直接动账风险极高，业主必须用谷歌验证码二次确认。这和 04-营销工具的兑换码创建 一致。
二、现金直充¶
2.1 列表页¶
顶部信息： - 平台：p222 - 服务器时区：GMT +8:00（与菲律宾本地时间一致，菲律宾全境 PHT = GMT+8） - 平台余额：0（业主在该平台预存额度，每次直充会从这里扣减）
筛选区：
| 字段 | 含义 |
|---|---|
| 用户 ID | 精确查指定用户的所有直充记录 |
| 时间 | 默认今天，可改区间 |
| 操作类型 | 单人充值 / 批量充值 / 接口充值 / 文本批量充值（见 §2.2） |
| 充值类型 | 加款 / 扣款（见 §2.3） |
右上 4 个按钮：
| 按钮 | 用途 |
|---|---|
| 查询（蓝） | 套用筛选刷新列表 |
| 导出 Excel | 导出本次筛选结果（与 14-导出Excel列表 联动） |
| 单人充值（绿） | §2.4 |
| 批量充值（绿） | §2.5 |
| 文本批量充值（绿） | §2.6 |
列表字段：
| 字段 | 含义 |
|---|---|
| 时间（GMT+8:00） | 操作发生时间 |
| 操作人 | 后台账号（如 aimee） |
| 操作类型 | 单人 / 批量 / 接口 / 文本批量 |
| 充值类型 | 加款 / 扣款 |
| 充值用户 | 本次操作覆盖的总用户数 |
| 成功用户 | 实际成功数 |
| 失败用户 | 失败数（如用户被冻结、ID 不存在） |
| 金额 | 单笔金额（加款正数，扣款负数） |
| 码量设置 | 提现码量变化（增加 / 减少 + 数额） |
| 成功充值总额 | 成功部分的实际累加 |
| 状态 | 处理中 / 完成 / 失败 |
| 备注 | 操作人填的原因（如"5月活动补偿"） |
📌 「操作类型」中的"接口充值"：除了人工三种方式（单/批/文本批），还有「接口充值」——说明 p222 支持外部系统通过 API 触发直充（如 CRM、自建工具、合作方）。❓ API 文档待用户提供给副组长团队。
2.2 操作类型对照¶
| 类型 | 触发方式 | 适用场景 | 单次上限 |
|---|---|---|---|
| 单人充值 | 弹窗手输 1 个 ID | 个案补偿 / VIP 关怀 / 风控扣款 | 1 人 |
| 批量充值 | 弹窗多行 ID + 同金额 | 群体补偿（如"系统故障 2 小时"给 200 人各送 ₱50） | 5 万人 |
| 文本批量充值 | 上传 Excel（每行不同金额） | 精细化运营（每个用户的金额、码量都不一样） | ❓ 模板上限 |
| 接口充值 | API 调用 | 外部系统自动化 | ❓ |
2.3 加款 vs 扣款¶
| 类型 | 用途 | 注意 |
|---|---|---|
| 加款 | 给玩家加余额 / 加打码量 | 占用业主"平台余额" |
| 扣款 | 从玩家账户扣减 | 风控用：发现违规（撞库、撸新、刷码）后追回奖金 |
⚠️ 扣款是高危操作：扣款前必须保留完整证据链（玩家违规行为截图 + 风控审核结论 + 业主签字）。扣款记录会写入审计日志，玩家可以投诉。
2.4 单人充值弹窗¶
操作流：
flowchart TD
A["输入用户 ID → 点#quot;查询#quot;"] --> B["弹窗显示：到账用户名 / 用户余额 / 提现码量"]
B --> C["余额：增加 ▼ | [数字]<br/>提现码量：增加 ▼ | [数字]"]
C --> D["填写：谷歌验证码 + 备注"]
D --> E["点#quot;确定#quot; → 提示成功"]字段说明：
| 字段 | 含义 |
|---|---|
| 用户查询输入框 | 输入用户 ID |
| 到账用户 | 查询后自动回填用户名 |
| 用户余额 | 当前余额（核对用，避免错操作） |
| 提现码量 | 当前提现门槛对应的有效打码量（绿色高亮） |
| 余额（下拉） | 增加 / 减少 |
| 余额（数字） | 变化值 |
| 提现码量（下拉） | 增加 / 减少 |
| 提现码量（数字） | 变化值 |
| 谷歌验证码 | 必填，6 位数 |
| 备注 | 选填，但强烈建议写清楚原因 |
💡 "余额"和"提现码量"分两栏的原因：补偿场景下经常需要两个一起调（送 ₱100 + 同时给打码量 ₱100，让玩家直接能提）；风控扣款则只动一栏（如玩家撸到不合规奖金，扣余额但不动码量记录）。
2.5 批量充值弹窗¶
操作流：粘贴一批 ID（一行一个）→ 设置统一的余额变化 + 统一的码量变化 → 谷歌验证码 → 确定。
字段说明：
| 字段 | 含义 |
|---|---|
| 到账用户（多行文本框） | 一行一个用户 ID，每次最多 5 万个用户 |
| 余额 | 增加 / 减少 + 数字（所有人共用同一值） |
| 码量 | 增加 / 减少 + 数字（所有人共用同一值） |
| 谷歌验证码 | 必填 |
| 备注 | 选填 |
⚠️ 5 万上限：超过 5 万需要拆批处理。建议每批控制在 1 万以内，避免单个请求超时。
2.6 文本批量充值弹窗¶
操作流：先下载模板 → 填入 Excel → 上传 → 谷歌验证码。
字段说明：
| 字段 | 含义 |
|---|---|
| Excel 文件 | 仅支持 .xlsx |
| 下载模版 | 灰色按钮，点击下载空白 Excel 模板 |
| 谷歌验证码 | 必填 |
| 备注 | 选填 |
模板字段（截图所示）：
| 列 | 字段名 | 规则 |
|---|---|---|
| A | 用户 id | 一行一个 |
| B | 余额变化值（正数增加，负数扣减） | 单位：PHP |
| C | 打码量变化值（正数增加，负数扣减） | 单位：PHP |
💡 文本批量 vs 批量 的核心差异：每个用户金额可以不一样。批量充值适合"群体平等补偿"，文本批量适合"按 VIP 等级 / 投注金额阶梯发放"。
2.7 现金直充·待确认¶
- "接口充值" 的 API 文档 / 调用方 / 鉴权方式？
- 「成功充值总额」是否扣除"失败用户"那部分？
- 失败用户的常见原因（用户冻结、ID 不存在、余额不足扣减）❓
- 单次操作是否走"业主对系统厂商的 USDT 实时扣减"？还是只扣"平台余额"配额？
三、直充宝箱¶
3.1 列表页¶
列表页顶部红字提示（重要业务规则）：
⚠️ 注：系统直充宝箱不会累计，只能触发最新一个。
含义：同一用户被连续直充多个宝箱，只有最后一次有效，前面的会被覆盖（不能像现金那样累加）。因此宝箱直充必须等用户领取后再发下一个。
筛选区：
| 字段 | 含义 |
|---|---|
| 状态 | 全部 / ❓ 待确认（待领取 / 已领取 / 过期） |
| 时间 | 默认今天 |
右上 3 个按钮：
| 按钮 | 用途 |
|---|---|
| 查询（蓝） | 刷新 |
| 批量直充宝箱（绿） | §3.2 |
| 文本批量直充宝箱（绿） | §3.3 |
📌 截图未见"单人直充宝箱"按钮——可能宝箱只支持批量入口（即使发给 1 个人也走批量入口填 1 行 ID）。❓ 待确认。
列表字段：
| 字段 | 含义 |
|---|---|
| 时间（GMT+8:00） | 直充时间 |
| 操作人 | 后台账号 |
| 宝箱 ID | 本次创建的宝箱实例 ID |
| 操作类型 | 批量 / 文本批量 |
| 宝箱配置 | 基础金额 / 翻倍范围 / 打码倍数（汇总展示） |
| 发送用户 | 总用户数 |
| 成功用户 | 实际投递数 |
| 失败用户 | 失败数 |
| 状态 | 处理中 / 完成 / 失败 |
| 操作 | ❓ 可能是"详情 / 撤销" |
3.2 批量直充宝箱弹窗¶
字段说明：
| 字段 | 含义 |
|---|---|
| 宝箱基础金额 | 范围（最低 - 最高），系统在范围内随机选一个值作为"基础奖金" |
| 宝箱翻倍模式 | 下拉：「随机充值翻倍」（其他模式 ❓ 待确认） |
| 随机充值翻倍 | 倍数范围（最低倍 - 最高倍），玩家充值后基础奖金 × 随机倍数 |
| 不充值是否可直接领取 | 是 / 否 → "是"=保底奖金（玩家不充也能领基础值）；"否"=必须先充值才解锁宝箱 |
| 基础奖金打码 | 基础部分的打码倍数（如 1 倍 = 奖金 ₱10 需打 ₱10） |
| 翻倍奖金打码 | 翻倍部分的打码倍数（通常比基础高，如 2 倍） |
| 到账用户（多行文本框） | 一行一个用户 ID，每次最多 5 万个用户 |
| 谷歌验证码 | 必填 |
| 提交按钮 | 发送宝箱（蓝色椭圆，区别于"确定"，强调动作） |
💡 宝箱玩法逻辑： 1. 业主发宝箱 → 玩家看到一个"未开启的宝箱" 2. 玩家可选充值激活或直接领取（取决于"不充值是否可直接领取"配置） 3. 充值激活后：基础奖金 × 随机翻倍倍数 = 实际奖金 4. 奖金落到玩家账户，但绑定打码量门槛才能提
业务示例（菲律宾市场推荐参数）： - 基础金额：₱50 - ₱100 - 翻倍模式：随机充值翻倍 - 翻倍范围：1.5 - 3 倍 - 不充值可领：否（强制充值激活，提升 ARPU） - 基础打码：1 倍 - 翻倍打码：2 倍
3.3 文本批量直充宝箱¶
字段同 §2.6：Excel 文件 + 谷歌验证码 + 备注。
模板字段（8 列，每用户独立参数）：
| 列 | 字段 | 示例 1 (107551) | 示例 2 (104582) |
|---|---|---|---|
| A | 用户 id | 107551 | 104582 |
| B | 是否可直接领取（0=否，1=是） | 1（可直接领） | 0（必须充值） |
| C | 最低基础奖金 | 0.1 | 0.2 |
| D | 最高基础奖金 | 0.5 | 0.5 |
| E | 最低随机翻倍 | 1.2 | 1.3 |
| F | 最高随机翻倍 | 2.8 | 2.2 |
| G | 基础奖金打码倍数 | 1 | 1 |
| H | 翻倍奖金打码倍数 | 2 | 3 |
💡 文本批量比批量更精细：每个用户可独立设定金额范围、翻倍范围、能否直领、打码倍数——典型场景：对 VIP 高额范围、对普通玩家低额范围。
3.4 直充宝箱·待确认¶
- 状态下拉的具体值（待领取 / 已领取 / 过期 / 已撤销）？
- "翻倍模式"除了「随机充值翻倍」还有什么模式（如固定翻倍、阶梯翻倍）？
- 过期时间：宝箱发给玩家，几小时/几天不领自动失效？
- 不会累计机制：发第二个宝箱时第一个是被静默覆盖还是会有提示？
- 操作列的"操作"按钮支持什么动作（撤销 / 重发 / 详情）？
四、奖券直充¶
4.1 列表页¶
筛选区：
| 字段 | 含义 |
|---|---|
| 奖券类型 | 全部 / 白银 / ❓ 其他档次 |
| 时间 | 默认今天 |
右上按钮：
| 按钮 | 用途 |
|---|---|
| 查询（蓝） | 刷新 |
| 批量直充（绿） | §4.2 |
📌 奖券直充截图只有批量入口，没有单人 / 文本批量。说明奖券是统一模板的奖品（同档次奖券完全一致），不需要按用户差异化。
列表字段：
| 字段 | 含义 |
|---|---|
| 时间（GMT+8:00） | 操作时间 |
| 操作人 | 后台账号 |
| 奖券类型 | 白银 / ❓ 其他 |
| 数量 | 张数 |
| 直充用户 | 总人数 |
| 成功用户 | 成功数 |
| 失败用户 | 失败数 |
| 状态 | 处理中 / 完成 / 失败 |
| 备注 | 操作人填写 |
4.2 奖券批量直充弹窗¶
字段说明：
| 字段 | 含义 |
|---|---|
| 到账用户（多行文本框） | 一行一个用户 ID，每次最多 5 万个用户 |
| 奖券类型（下拉） | 默认「白银」，可选其他档次 |
| 数量 | 整数 + "张" 单位（如 1 张、5 张） |
| 谷歌验证码 | 必填 |
| 备注 | 选填 |
❓ 奖券档次体系：截图默认显示「白银」——推测可能还有「黄金」「钻石」「青铜」等其他档次。完整奖券档次定义、每档奖券价值、兑换方式（兑换什么奖品）需对接 09-活动记录 查看奖券池配置。
4.3 奖券直充·待确认¶
- 完整奖券档次列表（白银 / 黄金 / 钻石 / ...）？
- 奖券有效期多久？
- 奖券兑换什么（现金？宝箱？实物？）？
- 是否支持"奖券扣回"（玩家违规追回）？
五、打码量清空列表¶
5.1 模块定位¶
业务背景：iGaming 平台普遍有一个反套利机制——当玩家亏损达到一定比例（如本次充值的 80% 已经输完），系统自动清空该用户当前充值产生的剩余打码量要求，让玩家能直接提走剩下的钱（让其离场，避免回血翻盘后继续套利）。
💡 为什么要清空打码量： - 正常逻辑：玩家充 ₱100，打码门槛 ₱100，没打完不能提 → 玩家边输边打码。 - 当玩家已经输了 ₱80（亏损率 80%），按打码规则剩下 ₱20 不能提，玩家会继续投入翻本 → 平台风险（玩家追损过度）。 - 清空打码后：玩家直接提走 ₱20 离场，减少追损 / 投诉 / 客诉。 - 这是负责任博彩（Responsible Gaming）+ 平台 EV 优化的综合策略。
5.2 配置区（顶部卡片）¶
| 字段 | 当前值（截图） | 含义 |
|---|---|---|
| 自动清空打码量 | 已开启（绿色 tag） | 启用 / 关闭整个机制 |
| 触发清空的亏损比例 | 80% | 玩家亏损达到本次充值的 80% 时触发 |
按钮： - 设置关闭（红色）：关闭"自动清空"功能 — 谨慎使用 - 点击编辑（蓝色）：修改"亏损比例阈值"
⚠️ "80% 是行业惯例——意味着玩家每充 ₱100，最多输 ₱80 系统就让他离场。这个值往下调（如 70%）= 对玩家更友好（更早离场）；往上调（如 90%）= 平台更激进。改这个值需要 owner 签字（直接影响月度盈利）。
5.3 历史记录区¶
| 字段 | 含义 |
|---|---|
| 用户 ID | 筛选指定用户 |
| 时间 | 默认今天 |
列表字段：
| 字段 | 含义 |
|---|---|
| 时间（GMT+8:00） | 清空发生时间 |
| 用户 | 用户 ID + 用户名 |
| 清空打码量 | 本次清空的剩余打码量（数额） |
💡 副组长的关注点：每天扫一眼这个列表，异常用户（短时间内频繁触发清空 = 可能职业刷子 / 撸新）→ 联动 10-用户管理 风控初审。
5.4 打码量清空·待确认¶
- "亏损比例" 的精确定义：本次充值亏损 / 当日累计亏损 / 用户全周期亏损？
- 触发时机：实时（每笔投注后）还是周期（每小时扫一次）？
- 是否记录"清空前剩余打码 / 清空后剩余打码"两个值？
- 玩家手动申请清空有没有入口？还是只能等系统自动触发？
- 清空后是否给玩家站内消息通知（"您的打码量已清空，可申请提现"）？
六、副组长日常 SOP¶
6.1 补偿场景（系统故障 / 服务器宕机）¶
1. 客服 / 技术确认事件影响范围 → 影响用户列表（导出 ID）
2. 副组长 → 系统直充 → 现金直充
3. 按规模选入口：
- <50 人：单人充值（一个个核对）
- 50-5w 人统一金额：批量充值
- 需要差异化：文本批量充值（上传 Excel）
4. 备注必须写清：「YYYY-MM-DD 服务器宕机补偿，覆盖 N 人」
5. 操作完成截图 → 当日交班记录
6.2 风控扣款场景（撸新 / 撞库 / 刷码）¶
1. 风控初审 → 确认违规证据
2. 副组长 → 系统直充 → 现金直充 → 单人充值 → 充值类型选"扣款"
3. 余额 / 码量选"减少" + 填差额
4. 备注必须写清：「违规扣款·【证据编号】·【风控审核人】」
5. 完整证据归档（截图 + 审核结论 + 操作截图）
6.3 VIP 关怀场景（生日 / 大额充值后)¶
1. VIP 客服 → 名单（生日清单 / 高净值用户清单）
2. 副组长 → 系统直充 → 直充宝箱 → 批量直充宝箱
3. 设置宝箱：基础 ₱50-100 / 翻倍 1.5-3 倍 / 不充可领（VIP 关怀通常允许直领）
4. 谷歌验证码 → 发送
5. 副组长同步 → 客户端通知（[04-营销工具](./04-营销工具.zh.md#四客户端通知)） 通知 VIP 去 App 内领取
七、待确认清单（汇总）¶
- 接口充值 API 文档 / 鉴权方式
- 失败用户的常见原因清单
- 单次操作是否实时扣业主 USDT
- 直充宝箱「状态」字段的取值
- 宝箱「翻倍模式」其他选项
- 宝箱过期 / 撤销机制
- 奖券完整档次表（白银/黄金/...）
- 奖券兑换什么（现金/宝箱/实物）
- 打码量"亏损比例"的精确定义
- 打码量清空触发时机（实时/周期）
- 是否支持玩家手动申请清空
- 清空后是否自动发站内通知
八、相关文档¶
- 04-营销工具（兑换码 / 客户端通知 / 用户回访 ↔ 与"系统直充"互补的营销工具）
- 05-月度报表（现金直充累计字段的源头）
- 06-每日数据对比（半小时槽现金直充列源头）
- 08-订单管理（玩家自主充提 vs 系统直充的对比视角）
- 09-活动记录（奖券池配置 / 宝箱活动配置）
- 10-用户管理（异常清码用户 → 风控初审）
- 14-导出Excel列表（导出现金直充记录归档）
九、互动自测¶
:::quiz{id=gauth} 所有直充操作对谷歌验证码（Google Authenticator 2FA）的要求是？
- [ ] 只有扣款操作才需要填谷歌验证码
- [ ] 只有批量充值需要，单人充值不用
- [x] 所有直充操作（现金、宝箱、奖券）都强制要求
- [ ] 都不需要，备注写清楚即可
解析：直接动账风险极高，现金、宝箱、奖券所有直充操作都强制要求 Google Authenticator 2FA 二次确认。 :::
:::quiz{id=boxstack} 同一用户被连续直充多个宝箱，会怎样？
- [ ] 多个宝箱会叠加累计，玩家可全部领取
- [x] 不会累计，只能触发最新一个，前面的被覆盖
- [ ] 系统会拒绝第二次直充并报错
- [ ] 前一个宝箱优先，新宝箱进入排队
解析：系统直充宝箱不会累计，只能触发最新一个，所以宝箱直充必须等用户领取后再发下一个。 :::
:::quiz{id=cash multi=true} 关于现金直充的三种人工入口，以下哪些说法正确？（多选）
- [x] 批量充值单次最多 5 万个用户
- [x] 文本批量充值可以给每个用户设置不同的金额
- [ ] 单人充值一次可以填 100 个用户 ID
- [x] 批量充值时所有人共用同一个余额/码量变化值
解析：单人充值单次上限 1 人；批量充值上限 5 万人且所有人共用同一变化值；文本批量上传 Excel，每个用户金额可不一样。 :::
:::scenario{id=vipbox}
{"start":"n1","nodes":{"n1":{"text":"你要给一位 VIP 连续发两个直充宝箱，第一个宝箱玩家还没领取。此时该怎么做？","choices":[{"label":"直接再发第二个宝箱","next":"bad","feedback":"❌ 系统直充宝箱不会累计，只触发最新一个，第一个未领的宝箱会被静默覆盖。","good":false},{"label":"等玩家领取第一个宝箱后再发第二个","next":"good","feedback":"✅ 正确。宝箱不累计，必须等用户领取后再发下一个。","good":true}]},"bad":{"text":"第一个宝箱被覆盖，VIP 少领了一份奖金，可能引发客诉。","terminal":true},"good":{"text":"两个宝箱都被 VIP 正常领取，关怀到位。","terminal":true}}
:::flashcards{id=cards} - 批量充值单次用户上限 :: 5 万个用户 - 单人充值单次用户上限 :: 1 人 - 直充宝箱累计规则 :: 不会累计，只触发最新一个 - 打码量自动清空的触发亏损比例 :: 80% - 文本批量充值支持的文件格式 :: 仅 .xlsx - 奖券直充默认奖券档次 :: 白银 - 服务器时区 :: GMT +8:00 - 直充操作的强制安全要求 :: 谷歌验证码（Google Authenticator 2FA） :::
:::gate{id=done score=0.8 title=学完系统直充} 完成以上自测并达到 80% 正确率，即视为掌握「系统直充」核心操作与规则。 :::