Appearance
04 — 提现模块
提现模块负责将用户在系统中积累的收益兑现到其钱包。提现需在规定时间窗口内发起，经人工审核通过后，由系统自动完成链上打款。
一、提现类型
| 类型 | 来源 | 操作入口 |
|---|---|---|
| 个人收益提现（单笔） | 单个理财订单的累计个人收益 | 用户自助申请 |
| 个人收益提现（一键） | 汇总所有有效订单的个人收益 | 用户自助申请 |
| 团队收益提现 | 节点团队钱包余额 | 用户自助申请 |
| V8/V9 提现 | 高等级用户收益 | 禁止自助，需联系客服处理 |
二、提现流程
三、前置校验规则
提现时间窗口
提现不是随时可以申请，系统按等级配置可提现的日期范围：
| 条件 | 说明 |
|---|---|
| 提现日期 | 必须在本月 day_start 至 day_end（自然日）范围内 |
| 窗口配置 | 按用户等级在后台分别配置，不同等级窗口可不同 |
提现次数限制
每月可提现次数有上限，分为：
- 个人提现次数：按订单维度统计本月已成功提现的次数
- 团队提现次数：按节点统计本月团队类型提现次数
- 系统取
节点配置上限与系统默认上限中的较大值作为实际限额
V8/V9 特殊限制
等级为 V8（level 5）、V9（level 6）的用户禁止通过用户端自助发起提现，系统直接拒绝请求，需通过客服或财务人员操作处理。
四、审核状态流转
| 状态值 | 说明 |
|---|---|
| 1 | 待审核（用户已提交） |
| 2 | 审核通过，等待打款 |
| 3 | 打款成功（已到账） |
| 4 | 已驳回 |
| 5 | 已导出打款名单（批量打款中间态） |
驳回后处理
- 个人收益：收益金额退回该订单的待提现余额
- 团队收益：金额退回团队钱包余额
- 若提现时已有关联的量化队列记录，同步撤销量化队列中的记录
五、汽车订单特殊规则（gid=1）
汽车订单（gid=1）类型的理财收益在提现时采用分流机制：
| 分配 | 比例 | 去向 |
|---|---|---|
| 现金部分 | 50% | 正常链上提现，打到用户钱包 |
| 量化部分 | 50% | 转入量化队列，生成量化订单按期释放 FTG |
汇率（CNY/FTG）在提现时实时从区块链服务获取，确保转换公允。
六、后台审核操作
| 操作 | 说明 |
|---|---|
| 查看列表 | 按状态、时间、用户筛选提现记录 |
| 审核通过（单笔） | state 从 1 改为 2 |
| 批量审核通过 | 批量操作，一次通过多笔 |
| 驳回 | state 改为 4，触发退回逻辑 |
| 导出打款名单 | 导出为文件，用于批量打款，导出后标记为 state=5 |
七、关键规则汇总
| 规则 | 说明 |
|---|---|
| 时间窗口限制 | 每月仅特定日期范围内可提现，杜绝随意提现 |
| 次数限制 | 每月上限，防止频繁小额套现 |
| 审核人工把关 | 所有提现均须人工审核，资金安全有保障 |
| V8/V9 禁止自助 | 高等级用户收益金额大，走特殊流程处理 |
| 汽车订单分流 | 鼓励高价值用户参与量化生态 |
| 驳回可回退 | 驳回操作完整回退余额，用户可重新申请 |
所属文件：backend/modules/invest/v1/controllers/WithdrawController.php、backend/services/invest/FtgInvestWithdrawService.php、backend/services/invest/FtgInvestOrderService.php、backend/modules/admin/v1/controllers/FtgInvestWithdrawController.php