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

结算周期设计

结算周期设计

结算周期设计要回答两个问题:一笔交易何时进入结算批次,以及遇到周末、节假日和截止时间后应顺延到哪一天。本课将把实时、T+1、T+2 等规则整理成可落库、可计算、可验证的统一模型。

学习目标

  • 区分实时结算、自然日结算和工作日结算的适用边界
  • 设计包含截止时间、时区与节假日顺延的结算规则
  • 编写并验证一个可运行的结算日期计算器

先统一结算口径

实时结算通常表示交易成功后立即发起资金划拨,但不等于资金一定即时到账;银行处理窗口、风控审核和账户状态仍可能造成延迟。日结则先按账务日归集交易,再在指定日期生成结算批次。

企业支付平台应明确使用自然日还是工作日。T+1 若按自然日计算,周五交易可在周六结算;若按工作日计算,则需要跳过周末和配置的法定节假日。规则名称相同而口径不同,是最常见的结算争议来源。

周期 典型含义 适用场景
实时 交易成功后立即尝试出款 高时效、低风险商户
T+1 交易账务日后的第 1 个有效结算日 常规商户日结
T+2 交易账务日后的第 2 个有效结算日 需延迟核验或渠道到账较慢

从交易时间推导结算日

计算顺序应固定为:先把交易时间转换到商户或结算主体的时区,再判断是否超过日切截止时间,然后确定账务日,最后叠加周期并跳过不可结算日。节假日表应按国家或地区、币种、通道维度维护,避免所有业务共用一张简单日期表。

交易时间到结算日的计算链路

规则配置至少应包含 cycleType、businessDayOnly、cutoffTime、zoneId 和节假日日历标识。实时周期可以返回当前账务日;延迟周期则逐日递增,只在有效工作日减少剩余天数。

实现结算日期计算器

下面示例使用固定日期演示工作日顺延。示例中的 2026 年 10 月 12 日被配置为假日,因此 10 月 9 日周五的 T+1 结算日会顺延到 10 月 13 日周二。

java
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.util.Set;

public class SettlementCycleDemo {

    enum Cycle {
        REAL_TIME, T1, T2
    }

    static LocalDate calculate(
            LocalDate accountingDate,
            Cycle cycle,
            Set<LocalDate> holidays) {

        int remainingDays = switch (cycle) {
            case REAL_TIME -> 0;
            case T1 -> 1;
            case T2 -> 2;
        };

        LocalDate result = accountingDate;
        while (remainingDays > 0) {
            result = result.plusDays(1);
            // 只有有效工作日才消耗一个结算周期天数
            if (isBusinessDay(result, holidays)) {
                remainingDays--;
            }
        }
        return result;
    }

    static boolean isBusinessDay(
            LocalDate date,
            Set<LocalDate> holidays) {

        DayOfWeek day = date.getDayOfWeek();
        boolean weekend = day == DayOfWeek.SATURDAY
                || day == DayOfWeek.SUNDAY;
        return !weekend && !holidays.contains(date);
    }

    public static void main(String[] args) {
        LocalDate accountingDate = LocalDate.of(2026, 10, 9);
        Set<LocalDate> holidays = Set.of(
                LocalDate.of(2026, 10, 12)
        );

        for (Cycle cycle : Cycle.values()) {
            System.out.println(
                    cycle + "=" + calculate(accountingDate, cycle, holidays)
            );
        }
    }
}

预期输出

text
REAL_TIME=2026-10-09
T1=2026-10-13
T2=2026-10-14

生产实现还应先根据交易时间和截止时间计算 accountingDate。例如日切时间为 23:00,交易在当地时间 23:15 成功,则账务日通常归入次日,再从次日开始计算 T+N。

验收规则与关键边界

测试时至少覆盖日切前后、周五交易、连续节假日、跨年、闰日和时区切换。规则变更不能直接覆盖历史配置,应保存版本号和生效时间,使旧交易继续使用下单或入账时绑定的规则版本。

结算任务应以“商户、币种、结算日、规则版本”作为批次维度,并通过唯一约束防止重复建批。若节假日配置临时调整,只重算尚未锁定的批次,已出款批次不得回滚日期。

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

目录与阅读设置

阅读设置

17

记录一个想法

结算周期设计

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

登录哪都通