架构与系统设计 / 系统课时
商户支付配置
商户支付配置
商户支付配置决定一笔订单能否使用某种支付方式、允许的金额区间、应收取的费率以及最终进入哪个通道。本课将建立最小配置模型,并用可执行 SQL 验证候选通道的筛选结果。
学习目标
- 设计支付方式、限额、费率和路由规则的最小数据模型。
- 理解“先过滤、再分优先级、最后按权重选择”的路由顺序。
- 掌握配置发布、缓存失效和下单验收的关键检查项。
配置对象与生效边界
商户支付配置通常分为两层。第一层描述商户是否开通某种支付方式,以及币种、单笔限额和费率;第二层描述该支付方式可以走哪些通道,以及每个通道的优先级、权重和启停状态。

建议统一使用最小货币单位保存金额,例如港币 50.00 元保存为 5000 分;费率使用基点保存,例如 35 表示 0.35%。这样可以避免浮点数误差,并让限额比较保持整数运算。
最小数据模型与查询
下面 SQL 可直接在 MySQL 8.0 空库执行。示例为商户 M1001 开通 QR_PAY,允许 100 至 100000 分,并配置两个港币通道。
DROP TABLE IF EXISTS channel_routing;
DROP TABLE IF EXISTS merchant_payment_method;
CREATE TABLE merchant_payment_method (
merchant_no VARCHAR(32) NOT NULL,
pay_method VARCHAR(32) NOT NULL,
currency CHAR(3) NOT NULL,
min_amount BIGINT NOT NULL,
max_amount BIGINT NOT NULL,
rate_bps INT NOT NULL,
status TINYINT NOT NULL,
PRIMARY KEY (merchant_no, pay_method, currency)
);
CREATE TABLE channel_routing (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
pay_method VARCHAR(32) NOT NULL,
currency CHAR(3) NOT NULL,
channel_code VARCHAR(32) NOT NULL,
priority INT NOT NULL,
weight INT NOT NULL,
status TINYINT NOT NULL,
UNIQUE KEY uk_route (pay_method, currency, channel_code)
);
INSERT INTO merchant_payment_method
(merchant_no, pay_method, currency, min_amount, max_amount, rate_bps, status)
VALUES
('M1001', 'QR_PAY', 'HKD', 100, 100000, 35, 1);
INSERT INTO channel_routing
(pay_method, currency, channel_code, priority, weight, status)
VALUES
('QR_PAY', 'HKD', 'CH_HK_A', 10, 70, 1),
('QR_PAY', 'HKD', 'CH_HK_B', 5, 30, 1),
('QR_PAY', 'HKD', 'CH_HK_C', 5, 50, 0);
SELECT
m.merchant_no,
m.pay_method,
m.rate_bps,
r.channel_code,
r.priority,
r.weight
FROM merchant_payment_method m
JOIN channel_routing r
ON r.pay_method = m.pay_method
AND r.currency = m.currency
WHERE m.merchant_no = 'M1001'
AND m.pay_method = 'QR_PAY'
AND m.currency = 'HKD'
AND m.status = 1
AND 5000 BETWEEN m.min_amount AND m.max_amount
AND r.status = 1
ORDER BY r.priority ASC, r.weight DESC;预期结果:
merchant_no | pay_method | rate_bps | channel_code | priority | weight
M1001 | QR_PAY | 35 | CH_HK_B | 5 | 30
M1001 | QR_PAY | 35 | CH_HK_A | 10 | 70结果中 CH_HK_C 因停用被排除。CH_HK_B 的优先级数值更小,因此应先进入候选组;CH_HK_A 即使权重更高,也不能跨优先级抢占。
路由决策顺序
一次下单应按固定顺序执行。先确认商户和支付方式处于启用状态,再校验币种、单笔最小金额和最大金额;通过后计算费率,并筛选状态正常、能力匹配的通道。
在候选通道中,先找到最小的 priority,只保留同一优先级组,再按 weight 做加权选择。权重只表达同组内的流量比例,不代表全局优先级。若同组权重分别为 70 和 30,长期流量应接近 70% 和 30%,但单笔结果不保证严格按比例出现。
费率可按 计算,但必须统一舍入规则、最低手续费和封顶金额。订单创建后应固化实际费率和通道,避免后续配置变更影响历史订单。
配置发布与缓存一致性
配置修改不应直接覆盖正在使用的数据后立即返回成功。较稳妥的顺序是:校验配置、写入数据库、提交事务、失效缓存,再由下一次请求重新加载。若使用本地缓存和 Redis,两级缓存都要按商户与支付方式维度清理。
发布前应拒绝以下配置:最小金额大于最大金额、费率为负数、启用路由的权重小于等于零、同一商户同一支付方式重复生效,以及所有候选通道均停用。配置表还应记录版本号、操作人和更新时间,便于回滚与审计。
下单验收清单
验收时分别测试低于下限、等于边界、正常金额和高于上限四类订单,并核对返回的拒绝原因。随后停用一个通道,确认候选集合立即变化;调整优先级后,确认低优先级数值的通道先被选择。
还要核对订单快照中的商户号、支付方式、币种、原始金额、费率、手续费、通道编码和配置版本。动态日志中的时间、订单号和请求 ID 可以使用 <TIME>、<ID> 等占位符,实际值会随运行环境变化。