---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/marketplaces/createSubMerchantWithTransactions/index.md
description: >-
  The create sub-merchant with transaction feature allows attaching a
  sub-merchant information list subOrderList when creating a transaction,
  automatically creating sub-merchants after transaction completion. Suitable
  for marketplace scenarios, key parameters include sub-merchant ID, order
  amount, currency, store link, etc., as well as product details such as name,
  unit price, and quantity.
---
## Create Sub-Merchant with Transaction

Creating a sub-merchant with transaction refers to attaching a sub-merchant information list `subOrderList` during transaction creation, automatically creating sub-merchants after transaction completion.
See details in <a href="/en/notes/api/services/marketplaces/mpUniformly/">marketplaces place order and pay</a>.

**Sub-Merchant Information Collection List - subOrder**

| Field Name                 | Type        | Required | Description                           |
|---------------------------|-------------|----------|---------------------------------------|
| subMerchantId            | String(64)  | Yes      | Sub-merchant number of merchant platform |
| subMerchantTransactionId | String(64)  | Yes      | Sub-merchant order number, unique identifier for sub-order |
| amount                   | String(12)  | Yes      | Sub-order amount                      |
| currency                 | String(3)   | Yes      | Currency of sub-order amount          |
| subMerchantName          | String(255) | No       | Sub-merchant entity name              |
| businessIdentityNumber   | String(64)  | No       | Sub-merchant business license number  |
| subMerchantStoreUrl      | String(255) | Yes      | Store link                            |
| subMerchantCountry       | String(64)  | Yes      | Country of sub-merchant entity        |
| subMerchantAddress       | String(255) | No       | Address of sub-merchant entity        |
| subMerchantMcc           | String(4)   | Yes      | Merchant main category, MCC code      |
| subMerchantBrand         | String(64)  | No       | Merchant operating brand              |
| goods                    | Array       | Yes      | Product information                   |
| goods.name               | String(128) | Yes      | Product name                          |
| goods.unitPrice          | String(12)  | Yes      | Product unit price                    |
| goods.currency           | String(3)   | Yes      | Currency of product amount            |
| goods.quantity           | String(12)  | Yes      | Product quantity                      |
| goods.imgUrl             | String(255) | No       | Product main image link               |
| goods.mcc                | String(4)   | No       | Product category, MCC code            |
| goods.virtualProduct     | String(1)   | No       | Whether virtual product, virtual goods (Y/N) |

:::note Note
The total of all goods cannot exceed 1000
:::

## Sub-Merchant Creation Workflow

### Card Payment - Sub-Merchant Creation Workflow

<v4-iImage src = "/marketplaces/marketplaces-v4-card.png" name = "Create Sub-Merchant with Transaction Card Payment S2S Sequence Diagram" ></v4-iImage>

### APM Payment - Sub-Merchant Creation Workflow

<v4-iImage src = "/marketplaces/marketplaces-v4APM.png" name = "Create Sub-Merchant with Transaction Local Payment S2S Sequence Diagram" ></v4-iImage>