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

付款指令处理

付款指令处理

本课实现付款指令的完整状态链路:由已确认结算批次生成唯一指令,提交到付款通道,接收处理中与最终结果,并通过状态校验保证重复回调不会破坏已完成记录。

学习目标

  • 区分付款指令各状态的业务含义
  • 实现受控状态迁移和重复回调幂等
  • 明确失败重试、终态保护与结果核对方式

状态机与处理边界

付款指令生成后处于 CREATED,成功提交通道后进入 SUBMITTED。通道已受理但尚未给出最终结果时使用 PROCESSING,最终只能进入 SUCCESS 或 FAILED。

SUBMITTED 只表示请求被接收,不等于资金已到账;只有通道最终结果、银行回执或可靠查询结果才能把指令置为 SUCCESS。终态记录不得被较晚到达的处理中回调覆盖。

付款指令状态迁移图

失败只代表当前付款尝试失败。若错误可重试,应保留原指令和失败原因,再创建新的尝试号;不要把原记录从 FAILED 改回 SUBMITTED,否则会丢失审计轨迹。

实现受控状态迁移

下面是一个可直接使用 JDK 17 编译运行的最小示例。它演示成功链路、失败链路和重复成功回调。

java
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);
    }
}

编译并运行:

bash
javac PaymentInstructionDemo.java
java PaymentInstructionDemo

预期输出:

text
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 会因环境不同而变化。

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

目录与阅读设置

阅读设置

17

记录一个想法

付款指令处理

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

登录哪都通