架构与系统设计 / 系统课时

账务流水设计

账务流水设计

本课完成一套可落地的账务流水模型:把支付、退款、手续费和调账统一记录为不可修改的借贷分录,并通过业务单号、凭证号与账户余额建立可追溯关系。

学习目标

  • 理解不可变流水、凭证与分录之间的职责边界
  • 设计支持支付、退款、手续费和调账的核心表结构
  • 掌握流水入账、冲正和幂等控制的关键规则

从资金变化拆分账务对象

业务订单描述“发生了什么”,账务凭证描述“为什么记账”,账务分录描述“哪些账户发生了多少变化”。三者不能合并成一张表,否则退款、部分退款和调账会不断覆盖原始数据,最终失去审计依据。

一笔业务事件通常生成一张凭证,一张凭证包含两条或更多分录。每条分录只表达某个账户的一次借方或贷方变化,已入账分录禁止更新金额、方向和账户;发现错误时,应追加冲正凭证,而不是修改旧流水。

业务事件到不可变账务流水的数据关系

建立凭证、分录与余额账户

核心模型可拆为账户表、凭证表和分录表。账户表保存当前余额,凭证表承载业务幂等键,分录表保存不可变明细。下面示例采用“借方减少、贷方增加”的简化账户规则,生产系统还应明确不同账户类型的余额方向。

sql
CREATE TABLE account_balance (
    account_no VARCHAR(64) PRIMARY KEY,
    account_type VARCHAR(32) NOT NULL,
    balance BIGINT NOT NULL DEFAULT 0,
    version BIGINT NOT NULL DEFAULT 0,
    updated_at DATETIME(3) NOT NULL
);

CREATE TABLE ledger_voucher (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    voucher_no VARCHAR(64) NOT NULL,
    biz_type VARCHAR(32) NOT NULL,
    biz_order_no VARCHAR(64) NOT NULL,
    request_id VARCHAR(64) NOT NULL,
    status VARCHAR(16) NOT NULL,
    created_at DATETIME(3) NOT NULL,
    UNIQUE KEY uk_voucher_no (voucher_no),
    UNIQUE KEY uk_biz_request (biz_type, biz_order_no, request_id)
);

CREATE TABLE ledger_entry (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    voucher_id BIGINT NOT NULL,
    account_no VARCHAR(64) NOT NULL,
    direction VARCHAR(8) NOT NULL,
    amount BIGINT NOT NULL,
    currency CHAR(3) NOT NULL,
    created_at DATETIME(3) NOT NULL,
    CHECK (direction IN ('DEBIT', 'CREDIT')),
    CHECK (amount > 0),
    KEY idx_entry_account_time (account_no, created_at),
    KEY idx_entry_voucher (voucher_id)
);

INSERT INTO ledger_voucher
(voucher_no, biz_type, biz_order_no, request_id, status, created_at)
VALUES
('V202608030001', 'PAYMENT', 'P202608030001', 'REQ-001', 'POSTED', NOW(3));

SET @voucher_id = LAST_INSERT_ID();

INSERT INTO ledger_entry
(voucher_id, account_no, direction, amount, currency, created_at)
VALUES
(@voucher_id, 'PLATFORM_CLEARING', 'DEBIT', 10000, 'CNY', NOW(3)),
(@voucher_id, 'MERCHANT_1001', 'CREDIT', 10000, 'CNY', NOW(3));

预期结果

text
ledger_voucher 新增 1 行
ledger_entry 新增 2 行
同一凭证借方合计 10000,贷方合计 10000

金额应使用最小货币单位,例如人民币 100.00 元保存为 10000 分,避免浮点误差。uk_biz_request 用于阻止同一业务请求重复入账,idx_entry_account_time 用于按账户和时间范围查询明细。

统一表达四类资金事件

支付成功通常增加商户待结算余额;退款成功减少商户余额或形成应收;手续费可在支付时同步扣除,也可独立生成手续费凭证;人工调账必须保存原因、操作人和审批记录。

事件 典型分录 是否修改原流水
支付成功 平台清算账户借记,商户账户贷记 否
退款成功 商户账户借记,平台清算账户贷记 否
手续费 商户账户借记,手续费收入账户贷记 否
调账或冲正 按原分录反向记账,再记录正确分录 否

部分退款必须生成独立退款凭证,并关联原支付订单。多次部分退款的累计金额不得超过原支付金额,但每次退款仍保留独立的业务单号和账务凭证。

保证入账原子性与不可变性

创建凭证、插入分录和更新余额必须位于同一数据库事务中。入账前先校验借贷合计相等,再按固定账户顺序加锁并更新余额,避免并发交易产生死锁或余额覆盖。

不可变并不代表数据库绝对禁止任何更新。凭证可以从 INIT 更新为 POSTED 或 FAILED,但已经入账的分录金额、方向、币种和账户不得修改或删除。生产环境可通过权限隔离、审计日志和数据库触发器进一步限制直接变更。

调账也要遵守幂等规则。重复提交相同 request_id 时,应返回已存在的凭证结果,而不是再次生成分录。这样即使消息重复投递或接口超时重试,账务余额也只变化一次。

验收检查

完成设计后,应至少验证以下结果:

  • 每张已入账凭证的借方总额等于贷方总额
  • 同一业务请求无法生成第二张凭证
  • 任意退款和调账都能追溯到原业务订单或原凭证
  • 删除或修改已入账分录的操作被应用层和数据库权限共同阻止
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

账务流水设计

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通