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

商户支付配置

商户支付配置

商户支付配置决定一笔订单能否使用某种支付方式、允许的金额区间、应收取的费率以及最终进入哪个通道。本课将建立最小配置模型,并用可执行 SQL 验证候选通道的筛选结果。

学习目标

  • 设计支付方式、限额、费率和路由规则的最小数据模型。
  • 理解“先过滤、再分优先级、最后按权重选择”的路由顺序。
  • 掌握配置发布、缓存失效和下单验收的关键检查项。

配置对象与生效边界

商户支付配置通常分为两层。第一层描述商户是否开通某种支付方式,以及币种、单笔限额和费率;第二层描述该支付方式可以走哪些通道,以及每个通道的优先级、权重和启停状态。

商户支付配置与路由决策流程

建议统一使用最小货币单位保存金额,例如港币 50.00 元保存为 5000 分;费率使用基点保存,例如 35 表示 0.35%。这样可以避免浮点数误差,并让限额比较保持整数运算。

最小数据模型与查询

下面 SQL 可直接在 MySQL 8.0 空库执行。示例为商户 M1001 开通 QR_PAY,允许 100 至 100000 分,并配置两个港币通道。

sql
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;

预期结果:

text
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%,但单笔结果不保证严格按比例出现。

费率可按 fee=round(amount×rateBps/10000)fee = round(amount × rateBps / 10000) 计算,但必须统一舍入规则、最低手续费和封顶金额。订单创建后应固化实际费率和通道,避免后续配置变更影响历史订单。

配置发布与缓存一致性

配置修改不应直接覆盖正在使用的数据后立即返回成功。较稳妥的顺序是:校验配置、写入数据库、提交事务、失效缓存,再由下一次请求重新加载。若使用本地缓存和 Redis,两级缓存都要按商户与支付方式维度清理。

发布前应拒绝以下配置:最小金额大于最大金额、费率为负数、启用路由的权重小于等于零、同一商户同一支付方式重复生效,以及所有候选通道均停用。配置表还应记录版本号、操作人和更新时间,便于回滚与审计。

下单验收清单

验收时分别测试低于下限、等于边界、正常金额和高于上限四类订单,并核对返回的拒绝原因。随后停用一个通道,确认候选集合立即变化;调整优先级后,确认低优先级数值的通道先被选择。

还要核对订单快照中的商户号、支付方式、币种、原始金额、费率、手续费、通道编码和配置版本。动态日志中的时间、订单号和请求 ID 可以使用 <TIME>、<ID> 等占位符,实际值会随运行环境变化。

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

目录与阅读设置

阅读设置

17

记录一个想法

商户支付配置

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

登录哪都通