数据模型 - 商户

商户概述

商户数据模型定义了支付交易中商户识别和层级信息的结构。此模型封装了商户凭据、层级关系和商业实体信息。

数据模型结构

参数	类型	描述
merchantId	String	平台分配的主要商户标识符 格式：字母数字字符串 用途：商户认证和交易路由的唯一标识符 示例："20001"、"20011"
merchantName	String	主要商户商业名称 格式：UTF-8编码字符串 用途：商户识别和报告的显示名称 示例："Betty"、"ABC Corporation"
subMerchantId	String	层级结构的子商户标识符 格式：字母数字字符串 用途：识别主要商户层级内的子商户 示例："2000101"、"2000102"
subMerchantName	String	子商户商业名称 格式：UTF-8编码字符串 用途：子商户识别和报告的显示名称 示例："Devin"、"XYZ Subsidiary"

商户层级结构

主要商户

• 角色: 在平台注册的主要商业实体
• 职责: 主要账户持有人、结算收款人、合规管理
• 识别: 平台分配的唯一merchantId

子商户

• 角色: 主要商户下的子公司或分支机构
• 职责: 交易处理、本地运营、客户服务
• 识别: 链接到主要merchantId的subMerchantId

实现示例

{
  "merchantId": "20001",
  "merchantName": "Betty"
}

{
  "merchantId": "20001",
  "merchantName": "Betty",
  "subMerchantId": "2000101",
  "subMerchantName": "Devin"
}

{
  "merchantId": "20001",
  "merchantName": "ABC Corporation",
  "subMerchantId": "2000102",
  "subMerchantName": "XYZ Subsidiary"
}

商业用例

单一商户运营

• 小型企业: 直接商户注册和运营
• 简单结构: 单一联系点和结算
• 实施: 仅使用merchantId和merchantName

多层商户运营

• 特许经营: 单一母公司下的多个地点
• 代理网络: 在主要商户下运营的独立代理
• 实施: 使用子商户结构进行层级管理

平台集成

• API认证: merchantId用于请求认证
• 交易路由: subMerchantId用于特定业务单元路由
• 结算管理: 层级结算结构支持

安全和合规

商户认证

• ID验证: 所有商户ID必须预先注册和验证
• 访问控制: 子商户继承主要商户的权限
• 审计跟踪: 商户层级变更的完整跟踪

数据管理

• 层级完整性: 维护适当的父子关系
• 名称一致性: 确保商户名称与官方注册匹配
• 更新程序: 商户信息更新的适当程序

监管合规

• 商业注册: 所有商户必须具有有效的商业注册
• KYC要求: 所有商户级别的了解客户合规
• 报告要求: 监管合规的层级报告