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

结算批次生成

结算批次生成

本课完成一条可落地的结算批次生成链路:从待结算明细中按商户、币种和结算日期分组,计算应结金额,写入批次并绑定明细,同时用唯一约束和事务避免重复生成。

学习目标

  • 明确结算批次的分组键与金额口径
  • 使用 SQL 汇总明细并生成可追溯批次
  • 处理重复执行、迟到退款和异常金额等边界

批次边界与金额口径

一个结算批次只应覆盖同一商户、同一币种和同一结算日期的数据。推荐使用 merchant_no + currency + settlement_date 作为业务唯一键,避免不同币种混算,也避免同一天重复生成多个正式批次。

批次应结金额通常按“支付金额减退款、减手续费、加调整项”计算。调整项用于承接补差、冲正或上一周期遗留,不应直接修改已经确认的历史明细。

结算批次生成流程

批次编号只负责标识,不应承担幂等判断。真正的幂等保障应来自业务唯一键和数据库唯一索引,任务锁只能减少并发,不能替代数据库约束。

使用 SQL 生成批次

下面示例可直接在 MySQL 8.0 执行。它先准备批次表和明细表,再汇总 READY 明细,最后把明细绑定到对应批次。

sql
DROP TABLE IF EXISTS settlement_detail;
DROP TABLE IF EXISTS settlement_batch;

CREATE TABLE settlement_batch (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    batch_no VARCHAR(64) NOT NULL,
    merchant_no VARCHAR(32) NOT NULL,
    currency CHAR(3) NOT NULL,
    settlement_date DATE NOT NULL,
    gross_amount DECIMAL(18, 2) NOT NULL,
    refund_amount DECIMAL(18, 2) NOT NULL,
    fee_amount DECIMAL(18, 2) NOT NULL,
    adjustment_amount DECIMAL(18, 2) NOT NULL,
    settlement_amount DECIMAL(18, 2) NOT NULL,
    detail_count INT NOT NULL,
    status VARCHAR(16) NOT NULL DEFAULT 'CREATED',
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
        ON UPDATE CURRENT_TIMESTAMP,
    -- 业务唯一键是最终幂等防线
    UNIQUE KEY uk_batch_scope (merchant_no, currency, settlement_date),
    UNIQUE KEY uk_batch_no (batch_no)
);

CREATE TABLE settlement_detail (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    merchant_no VARCHAR(32) NOT NULL,
    currency CHAR(3) NOT NULL,
    settlement_date DATE NOT NULL,
    pay_amount DECIMAL(18, 2) NOT NULL,
    refund_amount DECIMAL(18, 2) NOT NULL,
    fee_amount DECIMAL(18, 2) NOT NULL,
    adjustment_amount DECIMAL(18, 2) NOT NULL DEFAULT 0,
    status VARCHAR(16) NOT NULL DEFAULT 'READY',
    batch_no VARCHAR(64) NULL
);

-- 准备两组商户的待结算明细
INSERT INTO settlement_detail
(merchant_no, currency, settlement_date, pay_amount, refund_amount, fee_amount)
VALUES
('M1001', 'HKD', '2026-08-03', 100.00, 0.00, 2.00),
('M1001', 'HKD', '2026-08-03', 200.00, 10.00, 4.00),
('M2001', 'HKD', '2026-08-03', 80.00, 0.00, 1.60);

-- 批次与明细绑定必须处于同一事务
START TRANSACTION;

INSERT INTO settlement_batch (
    batch_no, merchant_no, currency, settlement_date,
    gross_amount, refund_amount, fee_amount,
    adjustment_amount, settlement_amount, detail_count
)
SELECT
    -- 示例使用可读编号;生产环境也可改为号段生成器
    CONCAT(
        'SB', DATE_FORMAT(settlement_date, '%Y%m%d'),
        '-', merchant_no, '-', currency
    ),
    merchant_no,
    currency,
    settlement_date,
    SUM(pay_amount),
    SUM(refund_amount),
    SUM(fee_amount),
    SUM(adjustment_amount),
    SUM(pay_amount - refund_amount - fee_amount + adjustment_amount),
    COUNT(*)
FROM settlement_detail
WHERE settlement_date = '2026-08-03'
  AND status = 'READY'
GROUP BY merchant_no, currency, settlement_date;

UPDATE settlement_detail d
JOIN settlement_batch b
  ON b.merchant_no = d.merchant_no
 AND b.currency = d.currency
 AND b.settlement_date = d.settlement_date
SET d.batch_no = b.batch_no,
    d.status = 'BATCHED'
WHERE d.settlement_date = '2026-08-03'
  AND d.status = 'READY';

COMMIT;

SELECT batch_no, merchant_no, currency,
       settlement_amount, detail_count
FROM settlement_batch
ORDER BY merchant_no;

预期结果:

text
batch_no                  merchant_no  currency  settlement_amount  detail_count
SB20260803-M1001-HKD       M1001        HKD       284.00             2
SB20260803-M2001-HKD       M2001        HKD        78.40             1

再次执行同一段生成逻辑时,唯一索引会阻止重复批次,已变为 BATCHED 的明细也不会再次汇总。实际环境中的日期、批次号和主键会不同。

并发与异常边界

生产任务开始前可以按结算日期申请分布式锁,但数据库仍需保留唯一索引。并发节点同时执行时,应先通过条件更新把明细从 READY 抢占为 PROCESSING,再汇总本节点成功抢占的数据,避免一个明细被两个节点读取。

应结金额为零时可以生成零金额批次,也可以按业务规则跳过;应结金额为负数时通常进入人工审核。结算日之后才到达的退款,不应回写已确认批次,而应在下一批次中生成负向明细或调整项。

批次确认前要校验明细数量、金额合计和币种一致性。确认后禁止直接删除或重算,应通过冲正批次保留审计链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

结算批次生成

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

登录哪都通