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

退款订单模型

退款订单模型

退款不是在原支付单上简单改一个金额,而是独立记录一次资金逆向操作。本课将建立退款单、原支付订单、退款金额与状态之间的完整关系,并用事务约束避免重复退款和超额退款。

学习目标

  • 设计支付订单与退款订单的一对多关系
  • 正确表达可退款金额、累计退款金额和退款状态
  • 使用唯一约束与行锁保证退款请求幂等且不超额

从业务约束确定模型边界

一笔支付成功后可以发生零次、一次或多次退款,因此支付订单与退款订单应是一对多关系。退款单必须保留平台退款号、商户退款号、原支付订单号、申请金额、成功金额、状态和通道返回信息,不能只在支付订单上增加一个 refund_amount 字段。

退款金额需要满足约束 0<refundAmount≤paidAmount−refundedAmount0 < refundAmount \le paidAmount - refundedAmount。其中 paidAmount 是原支付成功金额,refundedAmount 只统计已经退款成功的金额。处理中的退款不能直接计入成功退款额,但必须参与可用额度预占,否则并发请求可能同时通过校验。

支付订单与退款订单关系图

表结构与关键约束

下面使用 MySQL 8.0 建立最小可运行模型。金额统一使用最小货币单位的整数,例如人民币 10.50 元存为 1050,避免浮点误差。

sql
CREATE TABLE payment_order (
    id BIGINT PRIMARY KEY,
    payment_no VARCHAR(64) NOT NULL,
    merchant_no VARCHAR(32) NOT NULL,
    paid_amount BIGINT NOT NULL,
    currency CHAR(3) NOT NULL,
    status VARCHAR(20) NOT NULL,
    paid_at DATETIME NULL,
    UNIQUE KEY uk_payment_no (payment_no)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE refund_order (
    id BIGINT PRIMARY KEY,
    refund_no VARCHAR(64) NOT NULL,
    merchant_no VARCHAR(32) NOT NULL,
    merchant_refund_no VARCHAR(64) NOT NULL,
    payment_order_id BIGINT NOT NULL,
    payment_no VARCHAR(64) NOT NULL,
    refund_amount BIGINT NOT NULL,
    success_amount BIGINT NOT NULL DEFAULT 0,
    status VARCHAR(20) NOT NULL,
    channel_refund_no VARCHAR(64) NULL,
    fail_code VARCHAR(64) NULL,
    fail_message VARCHAR(255) NULL,
    created_at DATETIME NOT NULL,
    succeeded_at DATETIME NULL,
    UNIQUE KEY uk_refund_no (refund_no),
    UNIQUE KEY uk_merchant_refund (merchant_no, merchant_refund_no),
    KEY idx_payment_order (payment_order_id, status),
    CONSTRAINT fk_refund_payment
        FOREIGN KEY (payment_order_id) REFERENCES payment_order(id),
    CONSTRAINT chk_refund_amount CHECK (refund_amount > 0),
    CONSTRAINT chk_success_amount CHECK (
        success_amount >= 0 AND success_amount <= refund_amount
    )
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

生效后,同一商户不能重复提交相同的 merchant_refund_no,每张退款单也只能关联一张原支付订单。可通过 SHOW CREATE TABLE refund_order; 检查唯一键、外键和检查约束是否存在。

用事务控制可退款额度

仅依赖应用内存判断不安全。多个服务实例同时退款时,应锁定原支付订单,再汇总成功和处理中退款的金额,确认剩余额度后插入新退款单。下面示例假设两张表已经按上一节创建。

sql
INSERT INTO payment_order
(id, payment_no, merchant_no, paid_amount, currency, status, paid_at)
VALUES
(1001, 'P202608030001', 'M10001', 10000, 'CNY', 'SUCCESS', NOW());

START TRANSACTION;

SELECT id, paid_amount, status
FROM payment_order
WHERE id = 1001
FOR UPDATE;

SELECT COALESCE(SUM(refund_amount), 0) AS occupied_amount
FROM refund_order
WHERE payment_order_id = 1001
  AND status IN ('CREATED', 'PROCESSING', 'SUCCESS');

INSERT INTO refund_order
(id, refund_no, merchant_no, merchant_refund_no, payment_order_id,
 payment_no, refund_amount, success_amount, status, created_at)
VALUES
(2001, 'R202608030001', 'M10001', 'MR202608030001', 1001,
 'P202608030001', 3000, 0, 'CREATED', NOW());

COMMIT;

SELECT refund_no, refund_amount, success_amount, status
FROM refund_order
WHERE payment_order_id = 1001;

预期输出:

text
+-----------------+---------------+----------------+---------+
| refund_no       | refund_amount | success_amount | status  |
+-----------------+---------------+----------------+---------+
| R202608030001   | 3000          | 0              | CREATED |
+-----------------+---------------+----------------+---------+

实际服务应在插入前判断“已占用金额 + 本次退款金额”是否大于 paid_amount。如果超过,应回滚事务并返回“可退款余额不足”,而不是继续请求支付通道。

状态流转与回调处理

退款单可采用 CREATED → PROCESSING → SUCCESS 的主链路,通道明确拒绝时进入 FAILED,人工取消且尚未提交通道时进入 CLOSED。SUCCESS 和 CLOSED 是终态,不应被普通回调再次覆盖。

退款订单状态流转图

回调更新应同时校验退款号、通道退款号、金额和当前状态。收到重复成功回调时保持幂等,只在首次从非成功状态转为 SUCCESS 时写入成功时间、累计退款金额和资金流水。

Tips:不要把“请求通道成功”当作“退款成功”。只有同步响应明确成功,或异步回调确认成功后,才能把退款单置为 SUCCESS。

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

目录与阅读设置

阅读设置

17

记录一个想法

退款订单模型

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

登录哪都通