C6-01钱包与账户2 分钟更新于 2026-11
钱包不是余额,是三层
一句话
钱包 = 账户 + 余额 + 额度,三层混成一个 `balance` 字段,就一定对不平。
钱包不是余额,是三层
三层各自是什么
| 层 | 内容 | 变化频率 |
|---|---|---|
| 账户 | 主体、币种、账户类型(储值/结算/保证金) | 很少 |
| 余额 | 可用、冻结、在途 | 每笔交易 |
| 额度 | 单笔/日累计限额、授信额度 | 配置变更时 |
一个用户可能同时有多个账户(人民币储值户、美元结算户), 每个账户有自己的余额和额度。用「用户余额」一个概念去覆盖,必然丢信息。
余额必须分「可用 / 冻结 / 在途」
- 可用:能立刻花或提的
- 冻结:已下单未支付、或风控冻结
- 在途:已发起提现/出款,钱还没到
只有「可用」才是用户能动的钱。很多产品把这三者加起来显示为「余额」, 用户提现时才发现不够——体验事故。
平台内转账与提现是两件事
- 内部转账:两个账户之间搬余额,不动钱,秒级,可冲正
- 提现:出款到银行,动真钱,T+N,可能退票
两者的幂等、状态机、对账口径完全不同。做成一个接口,退款和对账都会出问题。
清分:钱进来之后怎么分
平台型钱包常有清分需求:一笔收款要分给商户、平台、服务商。 这和分账是同一件事(见 分账的三种实现), 区别在于钱包场景下分的是「账户余额」,不一定要动真钱。
反例:一个 balance 字段走天下
某产品的用户表里只有 balance。上线「提现审核」后:
- 用户提交提现,余额先扣,但钱 3 天后才到
- 期间用户又下单,发现余额不足,投诉「钱被吞了」
- 提现失败退回,余额要加回来,但没有「在途」状态可回退
最后加了 frozen、in_transit 两个字段,本质是承认余额必须分状态。
自查清单
- 账户、余额、额度是三层还是揉在一起
- 余额分了可用/冻结/在途吗
- 内部转账和提现是两条链路吗
- 提现失败能准确退回冻结金额吗
- 多币种账户怎么建模
依据
相关阅读