创建子商户
当商户需要使用不同的主体在Pyvio
中操作业务时，需要 进件子商户 (opens new window)的数据到Pyvio
系统中。不同的子商户类型需要对应的数据各不相同，中国大陆个人(china-individual)只能开展B2C业务，其它均可开展B2C业务
和B2B业务。
提示
file_type: 文件类型说明，请 查看这里 (opens new window)。file_id: 需要把文件传到SFTP服务器后，通过 获取文件ID 进行获取。
# 支持的子商户类型
中国大陆个人(china-individual)、中国大陆企业(有限责任公司)(china-enterprise-limited)、中国大陆合资企业(
china-enterprise-investment)、中国大陆个体户(china-enterprise-self-employed)、中国香港企业(hk-enterprise)、海外企业(
foreign-enterprise)、越南企业(vietnam-foreign-enterprise)和越南个人(vietnam-foreign-individual)。
# 重点参数说明
| 参数名 | 说明 |
|---|---|
| partner_user_id | 商户唯一ID。 |
| client_id | 使用通过KYC审核的client_id 可以创建不同业务类型的Unit。 |
| merchant_type | 贸易业务。中国大陆个人(china-individual)只能使用B2C，其它的可以使用B2B或者B2C。这将影响到 开通收款账户 能创建的收款类型。 |
| kyc_type | 客户类型。 |
| industry | 所属行业类别。支持同一类别的多选。 |
| individual_info | 中国大陆个人(china-individual)时使用这个参数。 |
| company_info | 非中国大陆个人(china-individual)时，使用这个参数。 |
无法OCR的数据
当客户类型为
中国香港企业(hk-enterprise)、海外企业(foreign-enterprise)以及越南企业(vietnam-foreign-enterprise) 时，下面的参数为必填：
| 参数名 | 说明 |
|---|---|
| identify_no | 企业证件号码。 |
| company_name_en | 企业英文名称。 |
| company_name | 企业名称。 |
| establish_date | 企业成立日期。 |
| commencement_date | 企业证件有效期 起始日期。 |
| valid_period | 企业证件有效期 结束日期。 |
| register_address | 企业注册地址。 |
- 当法人|股东信息(legal_info)、受益人信息(ubo_list)为非大陆身份证时，下面的参数为必填:
| 参数名 | 说明 |
|---|---|
| name | 证件名字。 |
| name_en | 证据名字对应的英文名称。 |
| id_number | 证件号码。 |
| date_of_birth | 生日。格式(YYYYDDMM)。 |
| issue_date | 证件颁发日期。格式(YYYYDDMM)。 |
| expiration_date | 证件过期日期。格式(YYYYDDMM)。长期传29991231。 |
| country | 证件所在地对应的国家。国家二字码。 |
| state | 证件所在地对应的州、省。 |
| city | 证件所在地对应的城市。 |
| postcode | 证件所在地对应的邮编。 |
| line1 | 证件详细地址。 |
# 材料要求
提示
- 外资企业：指的是非大陆或者非HK的企业。
- 香港企业第一年可以不传NAR1或者使用NNC1作为NAR1上传。
- 股权结构图需要董事签字或用印。
- 建议提前提交所有文件（含选填），以避免后续合规风控审核时可能的补充要求，同时确保接口字段全面对齐。
| 认证主体 | 企业类型 | 必传文件 | 企业股权结构中有外资企业时必传文件 | 选填文件 |
|---|---|---|---|---|
| 大陆个人 | 大陆身份证正反面、手持身份证照片 | 经营场所照片 | ||
| 大陆企业 | 个体户 | 营业执照 | ||
| 大陆企业 | 有限责任公司/股份有限公司 | 营业执照 | 股权结构图 | 经营场所照片 |
| 大陆企业 | 合伙企业 | 营业执照 | 股权结构图 | 经营场所照片 |
| 香港企业 | Limited Company | CI、BR、NNC1、NAR1 | 股权结构图 | 经营场所照片 |
| 香港企业 | Partnership | CI、BR、NNC1、NAR1 | 股权结构图 | 经营场所照片 |
| 香港企业 | 其他 | CI、BR、NNC1、NAR1 | 股权结构图 | 经营场所照片 |
| 海外企业 | CI、公司章程、股权结构图 | 公司年检文件、经营场所照片 | ||
| 越南企业 | CI、股权结构图 | 经营场所照片 | ||
| 越南个人 | 越南身份证正反面或者护照和地址证明文件 |