---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/api/services/marketplaces/submerchant/insertSubmerchant/index.md
description: >-
  The Create Sub-Merchant API is used to create new sub-merchant accounts in the
  PingPongCheckout system. It is suitable for e-commerce platforms or
  enterprises that need to manage multiple sub-merchants. Main functions include
  submitting sub-merchant information and obtaining creation results. Key
  parameters include sub-merchant name, contact information, etc.
---
# Create Sub-Merchant

```apidef
endpoint: POST /merchant/acquirer/subMerchant/api/insertSubMerchant
name: Create Sub-Merchant API
```

The Create Sub-Merchant API is used to create new sub-merchant accounts in the PingPongCheckout system. It is suitable for e-commerce platforms or enterprises that need to manage multiple sub-merchants. Main functions include submitting sub-merchant information and obtaining creation results. Key parameters include sub-merchant name, contact information, etc.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| accId | string | M | Unique identifier for the store, which will appear in the response message after creation; inputting it means modifying the data |
| clientId | string | M | PingPong Merchant ID |
| signType | string | M | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document |
| sign | string | M | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature |
| version | string | M | Version number, currently fixed at 1.0, may be adjusted with changes to the interface in the future |
| bizContent | string | M | Collection of request parameters, with no limit on maximum length. Except for common request parameters, all other request parameters must be passed within this parameter, format: JSON string |
| └─ subMerchants | array | O | Sub-merchant collection |
| └─ └─ subMerchantId | string | M | Sub-merchant number of the merchant platform |
| └─ └─ subMerchantName | string | M | Sub-merchant name |
| └─ └─ businessIdentityNumber | string | O | Sub-merchant organization code |
| └─ └─ subMerchantStoreUrl | string | M | Store link |
| └─ └─ subMerchantCountry | string | M | Country of sub-merchant |
| └─ └─ subMerchantAddress | string | O | Sub-merchant address |
| └─ └─ subMerchantMcc | string | M | Merchant business category, MCC code |
| └─ └─ subMerchantBrand | string | O | Merchant operating brand |

### Request Example

```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"
}
```

## Response Parameters

| Parameter | Type | Description |
|--------|------|------|
| accId | string | Unique store identifier, which will appear in the response message after being added; inputting it means modifying the data |
| clientId | string | PingPong merchant number |
| signType | string | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document |
| sign | string | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature |
| code | string | Result status code, see the appendix Status Code Table: /en/notes/appendix/successCodeList/ |
| description | string | Result description |
| bizContent | string | Business response parameters |
| └─ subMerchants | array | Sub-merchant collection |
| └─ └─ subMerchantId | string | Sub-merchant number of the merchant platform |

### Response Example

```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
}
```