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

对账数据标准化

对账数据标准化

本课把两种字段完全不同的渠道账单转换为统一交易记录,统一金额方向、交易状态、时间格式和幂等标识,使后续匹配逻辑只面向一种数据模型。

学习目标

  • 定义能够承载支付与退款的统一对账记录
  • 编写渠道适配器完成字段映射和状态归一
  • 识别金额符号、时间格式、重复记录等关键边界

统一模型与转换规则

标准记录至少需要渠道、渠道流水号、商户订单号、交易方向、绝对金额、币种、交易时间和标准状态。支付与退款不要仅依赖金额正负号判断,应优先读取渠道交易类型,再把金额统一保存为绝对值。

标准字段 统一规则
direction 归一为 PAYMENT 或 REFUND
amount 使用绝对值,禁止混用元和分
status 归一为 SUCCESS、FAILED、PENDING
tradeTime 转为同一时区的时间类型
standardKey 渠道、渠道流水号和方向组成稳定幂等键

多渠道账单标准化数据流

标准化层只负责“翻译”,不要在这里查询本地订单或判断是否对账成功。字段转换与业务匹配分离后,新增渠道时只需增加适配器,不必修改核心匹配引擎。

主示例:适配两种账单格式

下面示例使用 Java 17 的 record 表示统一记录,并分别解析渠道 A 与渠道 B 的一行 CSV。为突出映射逻辑,示例假设字段中不包含逗号;生产环境应使用成熟 CSV 库处理引号、转义和空列。将代码保存为 BillNormalizer.java,使用 javac BillNormalizer.java && java BillNormalizer 运行。

java
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class BillNormalizer {
    enum Direction { PAYMENT, REFUND }
    enum Status { SUCCESS, FAILED, PENDING }

    record StandardRecord(
            String channel,
            String channelTxnId,
            String merchantOrderNo,
            Direction direction,
            BigDecimal amount,
            String currency,
            LocalDateTime tradeTime,
            Status status,
            String standardKey
    ) {}

    public static void main(String[] args) {
        String channelALine = "TX1001,ORDER9001,PAY,12.50,HKD,2026-08-03 10:15:30,S";
        String channelBLine = "REFUND|RB2001|ORDER9001|-12.50|HKD|20260803102000|00";

        System.out.println(normalizeChannelA(channelALine));
        System.out.println(normalizeChannelB(channelBLine));
    }

    private static StandardRecord normalizeChannelA(String line) {
        String[] value = line.split(",", -1);
        Direction direction = "PAY".equals(value[2])
                ? Direction.PAYMENT : Direction.REFUND;
        Status status = switch (value[6]) {
            case "S" -> Status.SUCCESS;
            case "F" -> Status.FAILED;
            default -> Status.PENDING;
        };
        return build(
                "CHANNEL_A", value[0], value[1], direction,
                new BigDecimal(value[3]), value[4],
                LocalDateTime.parse(value[5],
                        DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")),
                status
        );
    }

    private static StandardRecord normalizeChannelB(String line) {
        String[] value = line.split("\\|", -1);
        Direction direction = "REFUND".equals(value[0])
                ? Direction.REFUND : Direction.PAYMENT;
        Status status = switch (value[6]) {
            case "00" -> Status.SUCCESS;
            case "99" -> Status.FAILED;
            default -> Status.PENDING;
        };
        return build(
                "CHANNEL_B", value[1], value[2], direction,
                new BigDecimal(value[3]), value[4],
                LocalDateTime.parse(value[5],
                        DateTimeFormatter.ofPattern("yyyyMMddHHmmss")),
                status
        );
    }

    private static StandardRecord build(
            String channel,
            String channelTxnId,
            String merchantOrderNo,
            Direction direction,
            BigDecimal rawAmount,
            String currency,
            LocalDateTime tradeTime,
            Status status
    ) {
        BigDecimal amount = rawAmount.abs().setScale(2);
        String standardKey = channel + "|" + channelTxnId + "|" + direction;
        return new StandardRecord(
                channel, channelTxnId, merchantOrderNo, direction,
                amount, currency, tradeTime, status, standardKey
        );
    }
}

预期输出

text
StandardRecord[channel=CHANNEL_A, channelTxnId=TX1001, merchantOrderNo=ORDER9001, direction=PAYMENT, amount=12.50, currency=HKD, tradeTime=2026-08-03T10:15:30, status=SUCCESS, standardKey=CHANNEL_A|TX1001|PAYMENT]
StandardRecord[channel=CHANNEL_B, channelTxnId=RB2001, merchantOrderNo=ORDER9001, direction=REFUND, amount=12.50, currency=HKD, tradeTime=2026-08-03T10:20, status=SUCCESS, standardKey=CHANNEL_B|RB2001|REFUND]

示例中渠道 B 的退款金额为负数,但标准记录中的金额被转换为 12.50,退款含义由 direction=REFUND 明确表达,避免后续统计同时处理类型和符号。

数据质量与幂等边界

入库前应校验渠道流水号、币种、交易时间和金额是否为空或非法。金额精度必须按币种规则处理,不能默认所有币种都有两位小数;渠道账单若使用最小货币单位,还要先按明确倍率转换。

standardKey 应建立唯一约束。重复导入同一账单时,系统可以忽略完全相同的记录;若相同键对应的金额或状态不同,应记录版本冲突并进入异常队列,不能静默覆盖原数据。

时间标准化要明确账单时区。无时区字段的本地时间必须结合渠道配置解释,再转换为平台统一时区或 UTC;否则跨日交易会被归入错误账单日期。

验收方法

准备一条支付、一条退款和一条未知状态记录,确认转换后金额均为绝对值,方向分别正确,未知状态进入 PENDING。随后重复执行同一批数据,数据库中标准记录数量不应增加,且冲突记录能够被单独识别。

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

目录与阅读设置

阅读设置

17

记录一个想法

对账数据标准化

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

登录哪都通