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

商户与门店模型

商户与门店模型

商户模型决定了支付能力如何被组织、授权和结算。本课将拆分商户、门店、应用、结算信息与支付产品配置,明确各对象的归属关系,并建立可扩展的关系型数据库结构。

学习目标

  • 区分商户、门店和接入应用的职责边界
  • 设计结算信息与支付产品配置的关联方式
  • 使用主外键、唯一键和状态字段保证模型一致性

先确定五类核心对象

商户是签约、风控和结算的主体;门店是实际经营场所;应用代表调用开放接口的客户端;结算信息描述资金应结算到哪里;支付产品配置决定某商户可以使用哪些支付方式、费率和限额。

一个商户可以拥有多个门店、多个应用和多条结算信息。支付产品通常由平台统一定义,再通过商户产品配置表分配给具体商户。门店默认继承商户能力,只有确实存在门店差异时,才增加门店级覆盖配置,避免一开始就制造重复数据。

商户领域核心关系图

建立关系型表结构

下面使用 MySQL 8.0 建立最小模型。示例省略审计人员、软删除和版本号字段,实际项目可按统一规范补充。

sql
CREATE TABLE merchant (
    id BIGINT PRIMARY KEY,
    merchant_no VARCHAR(32) NOT NULL,
    merchant_name VARCHAR(128) NOT NULL,
    status VARCHAR(20) NOT NULL,
    country_code CHAR(2) NOT NULL,
    created_at DATETIME NOT NULL,
    UNIQUE KEY uk_merchant_no (merchant_no)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE store (
    id BIGINT PRIMARY KEY,
    merchant_id BIGINT NOT NULL,
    store_no VARCHAR(32) NOT NULL,
    store_name VARCHAR(128) NOT NULL,
    status VARCHAR(20) NOT NULL,
    address VARCHAR(255) NULL,
    UNIQUE KEY uk_merchant_store_no (merchant_id, store_no),
    KEY idx_store_merchant (merchant_id, status),
    CONSTRAINT fk_store_merchant
        FOREIGN KEY (merchant_id) REFERENCES merchant(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE merchant_app (
    id BIGINT PRIMARY KEY,
    merchant_id BIGINT NOT NULL,
    app_id VARCHAR(64) NOT NULL,
    app_secret_ciphertext VARCHAR(512) NOT NULL,
    status VARCHAR(20) NOT NULL,
    callback_url VARCHAR(512) NULL,
    UNIQUE KEY uk_app_id (app_id),
    KEY idx_app_merchant (merchant_id, status),
    CONSTRAINT fk_app_merchant
        FOREIGN KEY (merchant_id) REFERENCES merchant(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE merchant_settlement_account (
    id BIGINT PRIMARY KEY,
    merchant_id BIGINT NOT NULL,
    account_type VARCHAR(20) NOT NULL,
    account_name VARCHAR(128) NOT NULL,
    account_no_ciphertext VARCHAR(512) NOT NULL,
    bank_code VARCHAR(32) NOT NULL,
    currency CHAR(3) NOT NULL,
    is_default TINYINT NOT NULL DEFAULT 0,
    status VARCHAR(20) NOT NULL,
    KEY idx_settlement_merchant (merchant_id, status),
    UNIQUE KEY uk_settlement_owner (id, merchant_id),
    CONSTRAINT fk_settlement_merchant
        FOREIGN KEY (merchant_id) REFERENCES merchant(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE payment_product (
    id BIGINT PRIMARY KEY,
    product_code VARCHAR(32) NOT NULL,
    product_name VARCHAR(64) NOT NULL,
    status VARCHAR(20) NOT NULL,
    UNIQUE KEY uk_product_code (product_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE merchant_product_config (
    id BIGINT PRIMARY KEY,
    merchant_id BIGINT NOT NULL,
    product_id BIGINT NOT NULL,
    status VARCHAR(20) NOT NULL,
    fee_rate DECIMAL(10, 6) NOT NULL,
    min_amount BIGINT NOT NULL,
    max_amount BIGINT NOT NULL,
    settlement_account_id BIGINT NOT NULL,
    UNIQUE KEY uk_merchant_product (merchant_id, product_id),
    KEY idx_product_config_status (merchant_id, status),
    CONSTRAINT fk_config_merchant
        FOREIGN KEY (merchant_id) REFERENCES merchant(id),
    CONSTRAINT fk_config_product
        FOREIGN KEY (product_id) REFERENCES payment_product(id),
    CONSTRAINT fk_config_settlement_owner
        FOREIGN KEY (settlement_account_id, merchant_id)
        REFERENCES merchant_settlement_account(id, merchant_id),
    CONSTRAINT chk_amount_range CHECK (
        min_amount >= 0 AND max_amount >= min_amount
    )
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

该结构保证门店、应用、结算账户和产品配置都不能脱离商户存在。app_secret_ciphertext 与 account_no_ciphertext 表示密文存储,查询列表时还应只返回脱敏值。

写入样例并验证关系

下面插入一个商户、一个门店、一个应用、一条默认结算账户和一个已开通产品,再通过联表查询验证归属关系。

sql
INSERT INTO merchant
VALUES (1, 'M10001', '示例科技有限公司', 'ACTIVE', 'CN', NOW());

INSERT INTO store
VALUES (11, 1, 'S001', '深圳一店', 'ACTIVE', '深圳市南山区');

INSERT INTO merchant_app
VALUES (21, 1, 'app_demo_001', '<CIPHERTEXT>', 'ACTIVE',
        'https://merchant.example.com/payment/callback');

INSERT INTO merchant_settlement_account
VALUES (31, 1, 'BANK', '示例科技有限公司', '<CIPHERTEXT>',
        'CMB', 'CNY', 1, 'ACTIVE');

INSERT INTO payment_product
VALUES (41, 'WECHAT_QR', '微信二维码支付', 'ACTIVE');

INSERT INTO merchant_product_config
VALUES (51, 1, 41, 'ACTIVE', 0.003800, 1, 5000000, 31);

SELECT
    m.merchant_no,
    s.store_no,
    a.app_id,
    p.product_code,
    c.fee_rate,
    sa.currency
FROM merchant m
JOIN store s ON s.merchant_id = m.id
JOIN merchant_app a ON a.merchant_id = m.id
JOIN merchant_product_config c ON c.merchant_id = m.id
JOIN payment_product p ON p.id = c.product_id
JOIN merchant_settlement_account sa
  ON sa.id = c.settlement_account_id
WHERE m.merchant_no = 'M10001';

预期输出:

text
+-------------+----------+--------------+--------------+----------+----------+
| merchant_no | store_no | app_id       | product_code | fee_rate | currency |
+-------------+----------+--------------+--------------+----------+----------+
| M10001      | S001     | app_demo_001 | WECHAT_QR    | 0.003800 | CNY      |
+-------------+----------+--------------+--------------+----------+----------+

<CIPHERTEXT> 是示例占位符,实际值由密钥管理系统或应用加密组件生成。动态主键也可以由数据库自增或分布式 ID 服务提供,只要全局策略一致即可。

处理继承与覆盖关系

商户级产品配置应作为默认能力来源。支付请求进入某个门店后,先读取商户产品配置;若系统存在门店级差异,再读取单独的 store_product_override 覆盖费率、限额或启停状态。覆盖表只保存差异字段,不复制整行配置。

结算账户也不应直接写入门店表。产品配置通过 settlement_account_id 指向同一商户的结算账户,复合外键可阻止跨商户误绑。更换默认账户时应新增记录并切换引用,保留历史订单使用过的旧账户;同一商户、币种只允许一个默认账户,这项条件应在事务中校验。

Tips:应用属于商户,但不等于门店。一个后台应用可能服务多个门店,门店也可能被收银台、H5 和小程序等多个应用共同使用。

状态与数据安全边界

商户、门店、应用、产品配置均应独立维护状态。支付鉴权时至少同时检查商户为 ACTIVE、应用为 ACTIVE、目标门店可用、产品配置已启用,不能只验证 app_id 和签名。

结算账号、证件号和应用密钥属于敏感数据。数据库保存密文,日志禁止输出原值,管理端只展示掩码;密钥轮换时应保留版本号,使旧请求在过渡期内仍能验签。

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

目录与阅读设置

阅读设置

17

记录一个想法

商户与门店模型

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

登录哪都通