架构与系统设计 / 系统课时
付款指令处理
付款指令处理
本课实现付款指令的完整状态链路:由已确认结算批次生成唯一指令,提交到付款通道,接收处理中与最终结果,并通过状态校验保证重复回调不会破坏已完成记录。
学习目标
- 区分付款指令各状态的业务含义
- 实现受控状态迁移和重复回调幂等
- 明确失败重试、终态保护与结果核对方式
状态机与处理边界
付款指令生成后处于 CREATED,成功提交通道后进入 SUBMITTED。通道已受理但尚未给出最终结果时使用 PROCESSING,最终只能进入 SUCCESS 或 FAILED。
SUBMITTED 只表示请求被接收,不等于资金已到账;只有通道最终结果、银行回执或可靠查询结果才能把指令置为 SUCCESS。终态记录不得被较晚到达的处理中回调覆盖。

失败只代表当前付款尝试失败。若错误可重试,应保留原指令和失败原因,再创建新的尝试号;不要把原记录从 FAILED 改回 SUBMITTED,否则会丢失审计轨迹。
实现受控状态迁移
下面是一个可直接使用 JDK 17 编译运行的最小示例。它演示成功链路、失败链路和重复成功回调。
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
public class PaymentInstructionDemo {
enum Status {
CREATED, SUBMITTED, PROCESSING, SUCCESS, FAILED
}
static final class Instruction {
private final String instructionNo;
private Status status = Status.CREATED;
Instruction(String instructionNo) {
this.instructionNo = instructionNo;
}
synchronized void transition(Status target) {
// 相同终态回调可能重复到达,直接幂等返回
if (status == target) {
System.out.printf(
"%s duplicate callback ignored: %s%n",
instructionNo, target
);
return;
}
// 只开放状态机允许的方向,禁止终态回退
boolean allowed = switch (status) {
case CREATED -> target == Status.SUBMITTED;
case SUBMITTED ->
target == Status.PROCESSING || target == Status.FAILED;
case PROCESSING ->
target == Status.SUCCESS || target == Status.FAILED;
case SUCCESS, FAILED -> false;
};
if (!allowed) {
throw new IllegalStateException(
"Invalid transition: " + status + " -> " + target
);
}
Status previous = status;
status = target;
System.out.printf(
"%s: %s -> %s%n",
instructionNo, previous, status
);
}
}
private static final Map<String, Instruction> STORE =
new ConcurrentHashMap<>();
static Instruction create(String batchNo) {
// 同一结算批次稳定映射到同一业务指令号
String instructionNo = "PI-" + batchNo;
return STORE.computeIfAbsent(
instructionNo,
key -> new Instruction(key)
);
}
public static void main(String[] args) {
// 分别验证成功、重复回调和失败三条路径
Instruction success = create("BATCH-20260803-001");
success.transition(Status.SUBMITTED);
success.transition(Status.PROCESSING);
success.transition(Status.SUCCESS);
success.transition(Status.SUCCESS);
Instruction failed = create("BATCH-20260803-002");
failed.transition(Status.SUBMITTED);
failed.transition(Status.FAILED);
}
}编译并运行:
javac PaymentInstructionDemo.java
java PaymentInstructionDemo预期输出:
PI-BATCH-20260803-001: CREATED -> SUBMITTED
PI-BATCH-20260803-001: SUBMITTED -> PROCESSING
PI-BATCH-20260803-001: PROCESSING -> SUCCESS
PI-BATCH-20260803-001 duplicate callback ignored: SUCCESS
PI-BATCH-20260803-002: CREATED -> SUBMITTED
PI-BATCH-20260803-002: SUBMITTED -> FAILED真实系统不能只依赖进程内的 synchronized。状态应持久化到数据库,并通过“当前状态匹配才更新”的条件更新实现跨节点并发控制;更新影响行数为零时,说明状态已经变化,需要重新读取后再判断。
提交、回调与主动查询
提交付款时应记录通道请求号、请求时间和请求摘要。网络超时不能直接判定失败,因为通道可能已经受理;此时应保留 SUBMITTED,使用原幂等号主动查询,禁止生成新的业务指令重复付款。
回调处理要先验签,再按通道流水号找到付款指令。对于重复的同状态回调直接返回成功;对于终态后的旧状态回调记录审计日志但不更新;对于无法识别的状态进入人工或补偿队列。
主动查询用于收敛长时间停留在 SUBMITTED 或 PROCESSING 的指令。查询任务应设置最大次数和退避间隔,超过阈值后标记为待人工核查,而不是在结果未知时直接改为 FAILED。
验收与异常检查
成功指令至少要核对指令金额、币种、收款账户标识和通道流水号。失败指令应保存标准化错误码、原始错误信息和是否可重试,便于后续生成新的付款尝试。
验收时重点测试三类场景:重复提交是否复用同一业务指令,成功回调重复到达是否保持终态,处理中回调晚于成功回调到达时是否被拒绝。实际时间、通道流水号和记录 ID 会因环境不同而变化。