支付结算

提供预付费余额模式的支付结算能力，支持充值、消费、提现、退款和审批流程。

概述

采用预付费余额模式，用户先充值到账户余额，使用产品时按动作消耗余额。所有产品的计费都通过余额系统统一管理，避免为每个产品单独设计支付方案。

核心能力

1. 余额管理

• 每个用户一个余额账户
• 余额 + 冻结余额双字段设计
• 所有变动通过交易流水记录

2. 充值

• 通过支付订单充值到余额
• 第三方支付集成（蓝兔支付/微信支付）

3. 消费

• 使用余额支付产品费用
• 按动作消耗余额

4. 提现

配置项	说明
最小提现金额	通过环境变量配置
提现手续费率	百分比配置
最低手续费	单笔最低手续费
到账时间	工作日数

5. 退款

• 消费退款处理
• 退款手续费配置
• 退款到账时间配置

6. 提现审批

• 提现申请提交
• 管理员审核流程
• 提现账户管理

数据库设计

表	说明	核心字段
balance_account	余额账户	user_id, balance, frozen_balance
balance_transaction	交易流水	user_id, transaction_type, amount, balance_snapshot
balance_withdraw_account	提现账户	user_id, account_type, account_info
balance_withdraw_audit	提现审批	user_id, amount, status, auditor_id

配置项

通过环境变量配置：

MIN_WITHDRAW_AMOUNT=10        # 最小提现金额（元）
WITHDRAW_FEE_PERCENT=0.01     # 提现手续费率（1%）
MIN_WITHDRAW_FEE=1            # 最低手续费（元）
MIN_REFUND_AMOUNT=1           # 最小退款金额（元）
REFUND_FEE_PERCENT=0.01       # 退款手续费率（1%）

相关文件

• src/services/balance.mts — 余额业务逻辑
• src/services/balanceWithdrawAudit.mts — 提现审批
• src/controllers/balance.mts — 余额接口控制器
• src/models/BalanceAccount.mts — 余额账户模型
• src/models/BalanceTransaction.mts — 交易流水模型