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

通道配置模型

通道配置模型

支付平台不能把通道地址、机构号和产品开关散落在业务代码中。本课将建立“支付通道—通道商户—产品能力—渠道参数”四层模型,使同一通道可以接入多个商户、开放不同支付产品,并按环境安全维护差异化参数。

学习目标

  • 识别四类配置对象的职责与关联边界
  • 设计可扩展且避免重复数据的核心表结构
  • 使用约束和查询验证一条产品能力是否可用

四层模型如何分工

payment_channel 表示一个渠道接入方,例如某银行收单系统或第三方支付机构,只保存通道级身份、协议类型和启停状态。它回答“请求要发给谁”,不保存具体商户号。

channel_merchant 表示平台在该通道下开立的商户账户。同一个支付通道可以配置多个通道商户,用于不同法人、地区、币种或清算主体。业务订单最终应绑定到明确的通道商户,而不是只绑定通道。

channel_product 表示某个通道商户实际开放的产品能力,例如银行卡消费、二维码支付、退款或预授权。费率、限额、币种和产品状态应放在这一层,因为这些条件通常随商户和产品组合变化。

channel_parameter 保存不能直接建模为固定字段的渠道差异参数,例如接口地址、应用编号、证书引用和超时时间。参数表用于承接差异,不应替代已经稳定的结构化字段。

支付通道四层配置关系图

设计核心表结构

下面使用 MySQL 8.0 建立最小可用模型。敏感信息不直接保存明文,而是保存密钥或证书在安全存储中的引用;金额统一使用最小货币单位,避免浮点误差。

sql
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 至少包含主键索引、产品组合唯一索引和外键辅助索引;不同数据库版本显示的索引顺序可能略有差异。

text
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

判断产品能力是否可用

创建支付订单前,应一次性确认通道、通道商户和产品能力都处于启用状态,同时校验币种与金额范围。这样可以避免先选中失效配置,再在调用渠道接口时失败。

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

预期结果:配置完整且金额在范围内时返回一行;任意层被停用、币种不匹配或金额越界时返回空结果。

text
channel_code  merchant_code  product_code
BANK_A        M10001         CARD_PAY

参数模型的边界

稳定、可检索且参与业务判断的数据应使用明确字段,例如状态、币种、限额和产品编码。只有渠道间差异大、变化频率低且不参与复杂检索的内容,才适合放入键值参数表。

param_value 不应直接保存私钥、密码或证书正文。更安全的做法是保存 secret://payment/bank-a/client-key 之类的引用,由应用在运行时向密钥管理服务读取真实值,并对配置读取操作记录审计日志。

通道配置变更还应带版本或发布时间。生产系统可以增加配置快照表,让订单保存实际命中的配置版本,避免后续调整费率或接口地址后无法还原历史交易条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

通道配置模型

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

登录哪都通