---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/marketplaces/submerchant/insertSubmerchant/index.md
description: >-
  批量新增子商户接口用于在PingPongCheckout系统中创建新的子商户账户。适用于需要管理多个子商户的电商平台或企业。主要功能包括提交子商户信息及获取创建结果。关键参数有子商户名称、联系信息等。
---
# 批量新增子商户接口

```apidef
endpoint: POST /merchant/acquirer/subMerchant/api/insertSubMerchant
name: 批量新增子商户接口
```

批量新增子商户接口用于在PingPongCheckout系统中创建新的子商户账户。适用于需要管理多个子商户的电商平台或企业。主要功能包括提交子商户信息及获取创建结果。关键参数有子商户名称、联系信息等。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ subMerchants | array | O | 子商户集合 |
| └─ └─ subMerchantId | string | M | 商户平台的子商户号 |
| └─ └─ subMerchantName | string | M | 子商户名称 |
| └─ └─ businessIdentityNumber | string | O | 子商户机构代码 |
| └─ └─ subMerchantStoreUrl | string | M | 店铺链接 |
| └─ └─ subMerchantCountry | string | M | 子商户所属国家 |
| └─ └─ subMerchantAddress | string | O | 子商户地址 |
| └─ └─ subMerchantMcc | string | M | 商户经营类目，MCC编码 |
| └─ └─ subMerchantBrand | string | O | 商户经营品牌 |

### 请求示例

```json
{
  "clientId": "2022110717083010293",
  "bizContent": "{\"subMerchants\":[{\"businessIdNumber\":\"91110105MA01ABCD2E\",\"subMerchantAddress\":\"北京市朝阳区建国路88号\",\"subMerchantBrand\":\"TechBrand\",\"subMerchantCountry\":\"CN\",\"subMerchantId\":\"SM001_1\",\"subMerchantMcc\":\"5732\",\"subMerchantName\":\"电子科技有限公司\",\"subMerchantUrl\":\"https://www.tech-company.com\"},{\"businessIdNumber\":\"91310115MA01EFGH3F_update\",\"subMerchantAddress\":\"上海市浦东新区陆家嘴环路1000号_update\",\"subMerchantBrand\":\"FoodChain\",\"subMerchantCountry\":\"CN\",\"subMerchantId\":\"SM002_2\",\"subMerchantMcc\":\"5311\",\"subMerchantName\":\"全球贸易有限公司_update\",\"subMerchantUrl\":\"https://www.global-trade.com\"},{\"businessIdNumber\":\"91440300MA01IJKL4G_update\",\"subMerchantAddress\":\"广州市天河区天河路385号_update\",\"subMerchantBrand\":\"FoodChain\",\"subMerchantCountry\":\"CN\",\"subMerchantId\":\"SM003\",\"subMerchantMcc\":\"5812\",\"subMerchantName\":\"美食餐饮连锁有限公司_update\",\"subMerchantUrl\":\"https://www.food-chain.com\"},{\"businessIdNumber\":\"91510100MA01MNOP5H_update\",\"subMerchantAddress\":\"成都市武侯区人民南路四段27号_update\",\"subMerchantBrand\":\"EduGlobal\",\"subMerchantCountry\":\"CN\",\"subMerchantId\":\"SM004\",\"subMerchantMcc\":\"8299\",\"subMerchantName\":\"国际教育培训中心_update\",\"subMerchantUrl\":\"https://www.edu-global.com\"}]}",
  "sign": "CA38ADC3326A2AFCEBAC524EC7CFF295B742F8FB6E01238E62AB8C6C7629F9D1",
  "accId": "2022110717083010293542",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ subMerchants | array | 子商户集合 |
| └─ └─ subMerchantId | string | 商户平台的子商户号 |

### 响应示例

```json
{
  "clientId": "2022110717083010293",
  "accId": "2022110717083010293542",
  "signType": "SHA256",
  "sign": "61AA67FBA3D637E7A6F92833C721C3B3629C9CB3F5B007337573144B02708D32",
  "bizContent": "{\"subMerchants\":[{\"subMerchantId\":\"SM003\"},{\"subMerchantId\":\"SM004\"},{\"subMerchantId\":\"SM002_2\"},{\"subMerchantId\":\"SM001_1\"}]}",
  "code": "001000",
  "description": null
}
```