---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/marketplaces/createSubMerchantWithKYB/index.md
description: >-
  PingPongCheckout KYB API
  用于创建和管理子商户，确保其合法合规。适用于市场平台，支持批量新增和修改子商户信息，关键参数包括子商户号、名称、国家、店铺链接及MCC编码等。
---
## 通过 PingPongCheckout KYB API 注册子商户

KYB API 是 PingPongCheckout 提供的用于创建子商户的 API 接口。通过 KYB API，商户可以创建子商户。
KYB 是支付机构或银行对商户进行身份核验和风险评估的流程，确保商户合法合规。类似于个人用户的 KYC（Know Your Customer），但针对企业客户。

## 新增子商户接口

<a href="/notes/zh/api/services/marketplaces/submerchant/insertSubmerchant/">新增子商户</a>可以通过上传**子商户信息收集列表-subMerchantList**，同时创建多个子商户。

**新增单个subMerchant关键信息**

| 字段名                    | 类型          | 是否必填 | 描述           |
|------------------------|-------------|------|--------------|
| subMerchantId          | String(64)  | 是    | 商户平台的子商户号    |
| subMerchantName        | String(255) | 是    | 子商户名称        |
| businessIdentityNumber | String(64)  | 否    | 子商户机构代码      |
| subMerchantStoreUrl    | String(255) | 是    | 店铺链接         |
| subMerchantCountry     | String(64)  | 是    | 子商户所属国家      |
| subMerchantAddress     | String(255) | 否    | 子商户地址        |
| subMerchantMcc         | String(64)  | 是    | 商户经营类目，MCC编码 |
| subMerchantBrand       | String(64)  | 否    | 商户经营品牌       |

## 批量修改子商户接口

<a href="/notes/zh/api/services/marketplaces/submerchant/updateSubmerchant/">批量修改子商户</a>

**修改单个subMerchant关键信息**

| 字段名                    | 类型          | 是否必填 | 描述           |
|------------------------|-------------|------|--------------|
| subMerchantId          | String(64)  | 是    | 商户平台的子商户号    |
| subMerchantName        | String(255) | 是    | 子商户名称        |
| businessIdentityNumber | String(64)  | 否    | 子商户机构代码      |
| subMerchantStoreUrl    | String(255) | 是    | 店铺链接         |
| subMerchantCountry     | String(64)  | 是    | 子商户所属国家      |
| subMerchantAddress     | String(255) | 否    | 子商户地址        |
| subMerchantMcc         | String(64)  | 是    | 商户经营类目，MCC编码 |
| subMerchantBrand       | String(64)  | 否    | 商户经营品牌       |