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

支付订单模型

支付订单模型

本课设计一份可落地的支付订单模型,重点处理金额精度、币种、支付方式、业务状态和时间字段,并用状态迁移规则避免订单进入非法状态。

学习目标

  • 能为金额、币种和支付方式选择稳定的数据类型
  • 能设计可校验的支付订单状态迁移
  • 能正确区分创建、过期、受理和支付完成时间

先确定订单的核心字段

支付订单至少需要平台订单号、商户订单号、金额、币种、支付方式、业务状态和时间字段。平台订单号用于平台内部唯一定位,商户订单号用于幂等和对账,两者不能互相替代。

金额不应使用 double,因为二进制浮点数无法精确表示多数十进制金额。常见做法是使用最小货币单位的整数,或使用明确精度和舍入规则的 BigDecimal。本课采用最小单位整数,例如人民币 19900 表示 199.00 元。

币种使用 ISO 4217 三位代码,例如 CNY、USD、JPY。支付方式应使用受控枚举,避免自由字符串产生 WECHAT、WechatPay、wxpay 等多种写法。

用状态机约束业务过程

支付状态不是普通展示字段,而是业务流程的控制点。最小模型可以包含 CREATED、PROCESSING、SUCCEEDED、FAILED、CANCELLED 和 EXPIRED。

支付订单状态迁移图

状态变化必须通过有业务语义的方法完成,例如 startProcessing、markSucceeded,而不是公开 setStatus。聚合根在方法内部校验当前状态,非法迁移立即失败。

时间字段表达不同事实

createdAt 表示订单创建时间,expiredAt 表示允许发起支付的截止时间,processingAt 表示平台开始受理支付的时间,paidAt 表示确认支付成功的时间。

这些字段应使用带时区语义的时间类型,例如 Java 的 Instant,数据库中统一保存 UTC。展示时再转换为用户所在时区,避免不同服务或不同机房使用本地时间造成排序和对账偏差。

可运行模型示例

下面的 Java 程序使用最小货币单位保存金额,并通过方法约束 CREATED → PROCESSING → SUCCEEDED 的状态迁移。

java
import java.math.BigDecimal;
import java.time.Instant;
import java.util.Currency;

public class PaymentOrderModelDemo {

    enum PaymentMethod {
        CARD, WECHAT_PAY, ALIPAY
    }

    enum PaymentStatus {
        CREATED, PROCESSING, SUCCEEDED, FAILED, CANCELLED, EXPIRED
    }

    static final class PaymentOrder {
        private final String orderId;
        private final String merchantOrderNo;
        private final long amountMinor;
        private final Currency currency;
        private final PaymentMethod paymentMethod;
        private final Instant createdAt;
        private final Instant expiredAt;
        private PaymentStatus status = PaymentStatus.CREATED;
        private Instant processingAt;
        private Instant paidAt;

        PaymentOrder(
                String orderId,
                String merchantOrderNo,
                long amountMinor,
                Currency currency,
                PaymentMethod paymentMethod,
                Instant createdAt,
                Instant expiredAt
        ) {
            if (amountMinor <= 0) {
                throw new IllegalArgumentException("amountMinor must be positive");
            }
            if (!expiredAt.isAfter(createdAt)) {
                throw new IllegalArgumentException("expiredAt must be after createdAt");
            }
            this.orderId = orderId;
            this.merchantOrderNo = merchantOrderNo;
            this.amountMinor = amountMinor;
            this.currency = currency;
            this.paymentMethod = paymentMethod;
            this.createdAt = createdAt;
            this.expiredAt = expiredAt;
        }

        void startProcessing(Instant now) {
            if (status != PaymentStatus.CREATED) {
                throw new IllegalStateException("order is not in CREATED state");
            }
            if (!now.isBefore(expiredAt)) {
                status = PaymentStatus.EXPIRED;
                throw new IllegalStateException("order has expired");
            }
            status = PaymentStatus.PROCESSING;
            processingAt = now;
        }

        void markSucceeded(Instant now) {
            if (status != PaymentStatus.PROCESSING) {
                throw new IllegalStateException("order is not processing");
            }
            status = PaymentStatus.SUCCEEDED;
            paidAt = now;
        }

        BigDecimal displayAmount() {
            int scale = currency.getDefaultFractionDigits();
            return BigDecimal.valueOf(amountMinor, scale);
        }

        String summary() {
            return orderId + " | " + merchantOrderNo + " | "
                    + displayAmount() + " " + currency.getCurrencyCode()
                    + " | " + paymentMethod + " | " + status
                    + " | paidAt=" + paidAt;
        }
    }

    public static void main(String[] args) {
        PaymentOrder order = new PaymentOrder(
                "PAY-2001",
                "MER-ORDER-9001",
                19900,
                Currency.getInstance("CNY"),
                PaymentMethod.WECHAT_PAY,
                Instant.parse("2026-08-03T10:00:00Z"),
                Instant.parse("2026-08-03T10:15:00Z")
        );

        order.startProcessing(Instant.parse("2026-08-03T10:01:00Z"));
        order.markSucceeded(Instant.parse("2026-08-03T10:02:30Z"));

        System.out.println(order.summary());
    }
}

预期输出:

text
PAY-2001 | MER-ORDER-9001 | 199.00 CNY | WECHAT_PAY | SUCCEEDED | paidAt=2026-08-03T10:02:30Z

示例中的 processingAt 没有直接打印,但它仍用于审计受理时间。真实系统还应在数据库层为平台订单号建立唯一约束,并对“商户号加商户订单号”建立联合唯一约束,阻止重复下单。

持久化与边界检查

金额字段使用整数时,应配合币种解释小数位;使用 BigDecimal 时,应在数据库中选择固定精度的 DECIMAL。无论采用哪种方案,都必须禁止负数、零金额和超出平台限额的值。

状态更新应携带当前状态作为条件,例如只允许把 PROCESSING 更新为 SUCCEEDED。这样即使重复回调或并发处理同时到达,也只有一次更新能够成功。

时间字段应由可信服务端生成,不直接采用客户端时间。支付成功时间通常以平台确认通道成功的时刻为准,并保留通道返回时间用于审计。

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

目录与阅读设置

阅读设置

17

记录一个想法

支付订单模型

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

登录哪都通