支付与钱包
平台通用商业能力:订单、账户、钱包、银行卡、货币。注意:托管(
escrow)不依赖这些模块完成资金划转。
模块范围
| 模块 | 作用 | 存储 |
|---|---|---|
order | 订单创建与状态 | MySQL |
account | 账户 | MySQL |
wallet | 钱包、地址、收款 | MySQL |
bankcard | 银行卡 | MySQL |
currency | 币种记录(不换算) | MySQL |
subscriber / member | 会员与订阅 | MySQL |
payment(应用入口) | 支付服务启动入口 | — |
当前定位
| 能力 | 状态 |
|---|---|
| 订单与会员计费 | ✅ 已有 |
| 钱包与银行卡管理 | ✅ 已有 |
| 托管状态与结算指令 | ✅ 在 escrow |
| 真实资金冻结 / 划转 | ❌ 未接入 |
| 多币种换算 | ❌ 只记录币种 |
平台对资金的处理原则:
托管层产出 EscrowSettlement(toAgent / toBuyer / toPlatform)
│
▼
资金体系(未来接入)
│
▼
真实账户变动托管与资金体系解耦,接入时只需消费结算指令。
接口概览
具体路径以 Swagger 为准(/api/api-docs/)。主要控制器:
| 控制器 | 前缀 |
|---|---|
order | /api/order |
account | /api/account |
wallet/address | /api/wallet/address |
wallet/collect | /api/wallet/collect |
bankcard | /api/bankcard |
currency | /api/currency |
边界与限制
| 限制 | 说明 |
|---|---|
| 不碰真钱 | 托管只到指令层 |
| 无牌照方案 | 真实托管需合规评估 |
| 无汇率 | 币种只记录 |
| 与履约跨库 | 资金在 MySQL,履约在 Mongo |
| 无对账 | 尚未实现自动对账 |
源码位置
libs/modules/src/{order,account,wallet,bankcard,currency,subscriber}/
apps/hushwork/src/payment/ # 支付入口(如存在)