架构与系统设计 / 系统课时
退款订单模型
退款订单模型
退款不是在原支付单上简单改一个金额,而是独立记录一次资金逆向操作。本课将建立退款单、原支付订单、退款金额与状态之间的完整关系,并用事务约束避免重复退款和超额退款。
学习目标
- 设计支付订单与退款订单的一对多关系
- 正确表达可退款金额、累计退款金额和退款状态
- 使用唯一约束与行锁保证退款请求幂等且不超额
从业务约束确定模型边界
一笔支付成功后可以发生零次、一次或多次退款,因此支付订单与退款订单应是一对多关系。退款单必须保留平台退款号、商户退款号、原支付订单号、申请金额、成功金额、状态和通道返回信息,不能只在支付订单上增加一个 refund_amount 字段。
退款金额需要满足约束 。其中 paidAmount 是原支付成功金额,refundedAmount 只统计已经退款成功的金额。处理中的退款不能直接计入成功退款额,但必须参与可用额度预占,否则并发请求可能同时通过校验。

表结构与关键约束
下面使用 MySQL 8.0 建立最小可运行模型。金额统一使用最小货币单位的整数,例如人民币 10.50 元存为 1050,避免浮点误差。
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; 检查唯一键、外键和检查约束是否存在。
用事务控制可退款额度
仅依赖应用内存判断不安全。多个服务实例同时退款时,应锁定原支付订单,再汇总成功和处理中退款的金额,确认剩余额度后插入新退款单。下面示例假设两张表已经按上一节创建。
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;预期输出:
+-----------------+---------------+----------------+---------+
| refund_no | refund_amount | success_amount | status |
+-----------------+---------------+----------------+---------+
| R202608030001 | 3000 | 0 | CREATED |
+-----------------+---------------+----------------+---------+实际服务应在插入前判断“已占用金额 + 本次退款金额”是否大于 paid_amount。如果超过,应回滚事务并返回“可退款余额不足”,而不是继续请求支付通道。
状态流转与回调处理
退款单可采用 CREATED → PROCESSING → SUCCESS 的主链路,通道明确拒绝时进入 FAILED,人工取消且尚未提交通道时进入 CLOSED。SUCCESS 和 CLOSED 是终态,不应被普通回调再次覆盖。

回调更新应同时校验退款号、通道退款号、金额和当前状态。收到重复成功回调时保持幂等,只在首次从非成功状态转为 SUCCESS 时写入成功时间、累计退款金额和资金流水。
Tips:不要把“请求通道成功”当作“退款成功”。只有同步响应明确成功,或异步回调确认成功后,才能把退款单置为
SUCCESS。