---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/marketplaces/createSubMerchantWithKYB/index.md
description: >-
  PingPongCheckout KYB API Used to create and manage sub-merchants, ensuring
  their legal compliance. Suitable for marketplace platforms, supporting batch
  addition and modification of sub-merchant information. Key parameters include
  sub-merchant ID, name, country, store URL, and MCC code.
---
## Register Sub-Merchants via PingPongCheckout KYB API

The KYB API is an API interface provided by PingPongCheckout for creating sub-merchants. Through the KYB API, merchants can create sub-merchants.
KYB is a process where payment institutions or banks verify merchant identity and assess risks to ensure merchant legitimacy and compliance. Similar to KYC (Know Your Customer) for individual users, but targeted at corporate customers.

## Add Sub-Merchant Interface

<a href="/en/notes/api/services/marketplaces/submerchant/insertSubmerchant/">Add Sub-Merchant</a> can create multiple sub-merchants simultaneously by uploading the **sub-merchant information collection list - subMerchantList**.

**Key Information for Adding Single subMerchant**

| Field Name               | Type        | Required | Description                        |
|--------------------------|-------------|----------|------------------------------------|
| subMerchantId            | String(64)  | Yes      | Sub-merchant ID on merchant platform |
| subMerchantName          | String(255) | Yes      | Sub-merchant name                  |
| businessIdentityNumber   | String(64)  | No       | Sub-merchant organization code     |
| subMerchantStoreUrl      | String(255) | Yes      | Store URL                          |
| subMerchantCountry       | String(64)  | Yes      | Country of sub-merchant            |
| subMerchantAddress       | String(255) | No       | Sub-merchant address               |
| subMerchantMcc           | String(64)  | Yes      | Merchant category, MCC code        |
| subMerchantBrand         | String(64)  | No       | Merchant operating brand           |

## Batch Modify Sub-Merchant Interface

<a href="/en/notes/api/services/marketplaces/submerchant/updateSubmerchant/">Batch Modify Sub-Merchant</a>

**Key Information for Modifying Single subMerchant**

| Field Name               | Type        | Required | Description                        |
|--------------------------|-------------|----------|------------------------------------|
| subMerchantId            | String(64)  | Yes      | Sub-merchant ID on merchant platform |
| subMerchantName          | String(255) | Yes      | Sub-merchant name                  |
| businessIdentityNumber   | String(64)  | No       | Sub-merchant organization code     |
| subMerchantStoreUrl      | String(255) | Yes      | Store URL                          |
| subMerchantCountry       | String(64)  | Yes      | Country of sub-merchant            |
| subMerchantAddress       | String(255) | No       | Sub-merchant address               |
| subMerchantMcc           | String(64)  | Yes      | Merchant category, MCC code        |
| subMerchantBrand         | String(64)  | No       | Merchant operating brand           |