架构与系统设计 / 系统课时
支付订单模型
支付订单模型
本课设计一份可落地的支付订单模型,重点处理金额精度、币种、支付方式、业务状态和时间字段,并用状态迁移规则避免订单进入非法状态。
学习目标
- 能为金额、币种和支付方式选择稳定的数据类型
- 能设计可校验的支付订单状态迁移
- 能正确区分创建、过期、受理和支付完成时间
先确定订单的核心字段
支付订单至少需要平台订单号、商户订单号、金额、币种、支付方式、业务状态和时间字段。平台订单号用于平台内部唯一定位,商户订单号用于幂等和对账,两者不能互相替代。
金额不应使用 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 的状态迁移。
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());
}
}预期输出:
PAY-2001 | MER-ORDER-9001 | 199.00 CNY | WECHAT_PAY | SUCCEEDED | paidAt=2026-08-03T10:02:30Z示例中的 processingAt 没有直接打印,但它仍用于审计受理时间。真实系统还应在数据库层为平台订单号建立唯一约束,并对“商户号加商户订单号”建立联合唯一约束,阻止重复下单。
持久化与边界检查
金额字段使用整数时,应配合币种解释小数位;使用 BigDecimal 时,应在数据库中选择固定精度的 DECIMAL。无论采用哪种方案,都必须禁止负数、零金额和超出平台限额的值。
状态更新应携带当前状态作为条件,例如只允许把 PROCESSING 更新为 SUCCEEDED。这样即使重复回调或并发处理同时到达,也只有一次更新能够成功。
时间字段应由可信服务端生成,不直接采用客户端时间。支付成功时间通常以平台确认通道成功的时刻为准,并保留通道返回时间用于审计。