---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/marketplaces/createSubMerchantWithTransactions/index.md
description: >-
  随交易注册子商户功能允许在创建交易时附带子商户信息列表subOrderList，在交易完成后自动创建子商户。适用于市场平台场景，支持的关键参数包括子商户ID、订单金额、币种、店铺链接等，以及商品详情如名称、单价和数量。
---
## 随交易注册子商户

随交易注册子商户是指在交易创建时附带子商户信息列表`subOrderList`，在交易完成后自动创建子商户。
详见 <a href="/notes/zh/api/services/marketplaces/mpUniformly/">marketplaces下单并支付</a>。

**子商户信息收集列表-subOrder**

| 字段名                      | 类型          | 是否必填 | 描述                |
|--------------------------|-------------|------|-------------------|
| subMerchantId            | String(64)  | 是    | 商户平台的子商户号         |
| subMerchantTransactionId | String(64)  | 是    | 子商户订单号，子订单唯一标识    |
| amount                   | String(12)  | 是    | 子订单金额             |
| currency                 | String(3)   | 是    | 子订单金额币种           |
| subMerchantName          | String(255) | 否    | 子商户主体名称           |
| businessIdentityNumber   | String(64)  | 否    | 子商户营业执照编号         |
| subMerchantStoreUrl      | String(255) | 是    | 店铺链接              |
| subMerchantCountry       | String(64)  | 是    | 子商户主体所属国家         |
| subMerchantAddress       | String(255) | 否    | 子商户主体地址           |
| subMerchantMcc           | String(4)   | 是    | 商户经营主类目，MCC编码     |
| subMerchantBrand         | String(64)  | 否    | 商户经营品牌            |
| goods                    | Array       | 是    | 商品信息              |
| goods.name               | String(128) | 是    | 商品名称              |
| goods.unitPrice          | String(12)  | 是    | 商品单价              |
| goods.currency           | String(3)   | 是    | 商品金额币种            |
| goods.quantity           | String(12)  | 是    | 商品数量              |
| goods.imgUrl             | String(255) | 否    | 商品主图链接            |
| goods.mcc                | String(4)   | 否    | 商品类别，MCC编码        |
| goods.virtualProduct     | String(1)   | 否    | 是否是虚拟产品，虚拟商品（Y/N) |

:::note 注意
所有goods合计最大不能超过1000
:::

## 子商户创建工作流程

### 卡支付-子商户创建工作流程

```mermaid
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#E3F2FD',
    'primaryTextColor': '#0D47A1',
    'primaryBorderColor': '#1976D2',
    'lineColor': '#1565C0',
    'secondaryColor': '#BBDEFB',
    'tertiaryColor': '#90CAF9',
    'background': '#F8FBFF',
    'mainBkg': '#E3F2FD',
    'secondBkg': '#BBDEFB',
    'tertiaryBkg': '#90CAF9',
    'actorBkg': '#2196F3',
    'actorBorder': '#1976D2',
    'actorTextColor': '#FFFFFF',
    'actorLineColor': '#1565C0',
    'signalColor': '#0D47A1',
    'signalTextColor': '#0D47A1',
    'noteBkgColor': '#E1F5FE',
    'noteTextColor': '#01579B',
    'noteBorderColor': '#0288D1',
    'loopTextColor': '#0D47A1',
    'activationBkgColor': '#B3E5FC',
    'activationBorderColor': '#0277BD'
  }
}}%%

sequenceDiagram
    participant Cardholder as 👤 持卡人
    participant UserTerminal as 💻 用户终端
    participant Merchant as 🏪 商户/建站平台
    participant PP as 🔄 PingPongCheckout
    participant Issuer as 🏦 ISSUER

    Note over Cardholder,Issuer: 随交易注册子商户 - 卡支付流程

    Cardholder->>UserTerminal: 发起结账
    UserTerminal->>UserTerminal: 1. 初始化风控插件
    Cardholder->>UserTerminal: 2. 输入卡号、日期后触发 triggerThreeDsInit
    UserTerminal->>Merchant: 3. 点击支付，生成 jsGeneratedData、browserInfo 参数
    Merchant->>PP: 4. 下单并支付接口（包含 jsGeneratedData、browserInfo、subOrderList）
    PP->>Issuer: 5. 请求渠道接口
    Issuer-->>PP: 6. 渠道响应
    PP-->>Merchant: 7. 同步响应支付结果
    Merchant-->>UserTerminal: 8. 同步响应支付结果

    alt 无需 3D 验证
        UserTerminal->>UserTerminal: 8.1 跳转支付结果页
    else 需要 3D 验证
        UserTerminal->>UserTerminal: 8.2 跳转 3D 挑战页
        PP->>Issuer: 8.3 issuer 验证数据
        Issuer-->>PP: 8.4 响应验证结果
        PP-->>UserTerminal: 8.5 跳转支付结果页
    end

    PP-->>Merchant: 9. 异步通知
    Merchant-->>PP: 10. 响应 200
```

### APM支付-子商户创建工作流程

```mermaid
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#E3F2FD',
    'primaryTextColor': '#0D47A1',
    'primaryBorderColor': '#1976D2',
    'lineColor': '#1565C0',
    'secondaryColor': '#BBDEFB',
    'tertiaryColor': '#90CAF9',
    'background': '#F8FBFF',
    'mainBkg': '#E3F2FD',
    'secondBkg': '#BBDEFB',
    'tertiaryBkg': '#90CAF9',
    'actorBkg': '#2196F3',
    'actorBorder': '#1976D2',
    'actorTextColor': '#FFFFFF',
    'actorLineColor': '#1565C0',
    'signalColor': '#0D47A1',
    'signalTextColor': '#0D47A1',
    'noteBkgColor': '#E1F5FE',
    'noteTextColor': '#01579B',
    'noteBorderColor': '#0288D1',
    'loopTextColor': '#0D47A1',
    'activationBkgColor': '#B3E5FC',
    'activationBorderColor': '#0277BD'
  }
}}%%

sequenceDiagram
    participant Buyer as 👤 用户
    participant UserTerminal as 💻 用户终端
    participant Merchant as 🏪 商户/建站平台
    participant PP as 🔄 PingPongCheckout
    participant APM as 🧾 APM 支付通道

    Note over Buyer,APM: 随交易注册子商户 - APM 支付流程

    Buyer->>UserTerminal: 发起结账
    UserTerminal->>Merchant: 1. 提交订单
    Merchant->>PP: 2. 请求下单并支付接口
    PP-->>Merchant: 3.1 响应
    Merchant-->>UserTerminal: 3.2 响应
    UserTerminal->>APM: 4. 在 APM 渠道方完成支付

    PP-->>Merchant: 5. 异步通知
    Merchant-->>PP: 6. 响应 200
```