架构与系统设计 / 系统课时
通道配置模型
通道配置模型
支付平台不能把通道地址、机构号和产品开关散落在业务代码中。本课将建立“支付通道—通道商户—产品能力—渠道参数”四层模型,使同一通道可以接入多个商户、开放不同支付产品,并按环境安全维护差异化参数。
学习目标
- 识别四类配置对象的职责与关联边界
- 设计可扩展且避免重复数据的核心表结构
- 使用约束和查询验证一条产品能力是否可用
四层模型如何分工
payment_channel 表示一个渠道接入方,例如某银行收单系统或第三方支付机构,只保存通道级身份、协议类型和启停状态。它回答“请求要发给谁”,不保存具体商户号。
channel_merchant 表示平台在该通道下开立的商户账户。同一个支付通道可以配置多个通道商户,用于不同法人、地区、币种或清算主体。业务订单最终应绑定到明确的通道商户,而不是只绑定通道。
channel_product 表示某个通道商户实际开放的产品能力,例如银行卡消费、二维码支付、退款或预授权。费率、限额、币种和产品状态应放在这一层,因为这些条件通常随商户和产品组合变化。
channel_parameter 保存不能直接建模为固定字段的渠道差异参数,例如接口地址、应用编号、证书引用和超时时间。参数表用于承接差异,不应替代已经稳定的结构化字段。

设计核心表结构
下面使用 MySQL 8.0 建立最小可用模型。敏感信息不直接保存明文,而是保存密钥或证书在安全存储中的引用;金额统一使用最小货币单位,避免浮点误差。
CREATE TABLE payment_channel (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
channel_code VARCHAR(32) NOT NULL,
channel_name VARCHAR(64) NOT NULL,
protocol_type VARCHAR(32) NOT NULL,
status TINYINT NOT NULL DEFAULT 1,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
UNIQUE KEY uk_channel_code (channel_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE channel_merchant (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
channel_id BIGINT UNSIGNED NOT NULL,
merchant_code VARCHAR(64) NOT NULL,
settlement_currency CHAR(3) NOT NULL,
status TINYINT NOT NULL DEFAULT 1,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
UNIQUE KEY uk_channel_merchant (channel_id, merchant_code),
CONSTRAINT fk_cm_channel
FOREIGN KEY (channel_id) REFERENCES payment_channel(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE channel_product (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
channel_merchant_id BIGINT UNSIGNED NOT NULL,
product_code VARCHAR(32) NOT NULL,
currency CHAR(3) NOT NULL,
min_amount BIGINT UNSIGNED NOT NULL DEFAULT 1,
max_amount BIGINT UNSIGNED NOT NULL,
status TINYINT NOT NULL DEFAULT 1,
UNIQUE KEY uk_merchant_product (
channel_merchant_id, product_code, currency
),
CONSTRAINT fk_cp_merchant
FOREIGN KEY (channel_merchant_id) REFERENCES channel_merchant(id),
CONSTRAINT ck_amount_range CHECK (max_amount >= min_amount)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE channel_parameter (
id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
owner_type VARCHAR(16) NOT NULL,
owner_id BIGINT UNSIGNED NOT NULL,
param_key VARCHAR(64) NOT NULL,
param_value VARCHAR(512) NOT NULL,
secret_flag TINYINT NOT NULL DEFAULT 0,
UNIQUE KEY uk_owner_param (owner_type, owner_id, param_key),
CONSTRAINT ck_owner_type CHECK (
owner_type IN ('CHANNEL', 'MERCHANT')
)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
SHOW INDEX FROM channel_product;预期结果:四张表创建成功,channel_product 至少包含主键索引、产品组合唯一索引和外键辅助索引;不同数据库版本显示的索引顺序可能略有差异。
Table Key_name Column_name
channel_product PRIMARY id
channel_product uk_merchant_product channel_merchant_id
channel_product uk_merchant_product product_code
channel_product uk_merchant_product currency判断产品能力是否可用
创建支付订单前,应一次性确认通道、通道商户和产品能力都处于启用状态,同时校验币种与金额范围。这样可以避免先选中失效配置,再在调用渠道接口时失败。
SELECT
c.channel_code,
cm.merchant_code,
cp.product_code
FROM payment_channel c
JOIN channel_merchant cm
ON cm.channel_id = c.id
JOIN channel_product cp
ON cp.channel_merchant_id = cm.id
WHERE c.channel_code = 'BANK_A'
AND cp.product_code = 'CARD_PAY'
AND cp.currency = 'HKD'
AND 10000 BETWEEN cp.min_amount AND cp.max_amount
AND c.status = 1
AND cm.status = 1
AND cp.status = 1;预期结果:配置完整且金额在范围内时返回一行;任意层被停用、币种不匹配或金额越界时返回空结果。
channel_code merchant_code product_code
BANK_A M10001 CARD_PAY参数模型的边界
稳定、可检索且参与业务判断的数据应使用明确字段,例如状态、币种、限额和产品编码。只有渠道间差异大、变化频率低且不参与复杂检索的内容,才适合放入键值参数表。
param_value 不应直接保存私钥、密码或证书正文。更安全的做法是保存 secret://payment/bank-a/client-key 之类的引用,由应用在运行时向密钥管理服务读取真实值,并对配置读取操作记录审计日志。
通道配置变更还应带版本或发布时间。生产系统可以增加配置快照表,让订单保存实际命中的配置版本,避免后续调整费率或接口地址后无法还原历史交易条件。