创建子商户
当商户需要使用不同的主体在Pyvio
中操作业务时，需要 进件子商户 (opens new window)的数据到Pyvio
系统中。个人类型只能开展 B2C。企业类型中，china-enterprise-limited、china-enterprise-investment、china-enterprise-self-employed、hk-enterprise、foreign-enterprise、vietnam-foreign-enterprise 可以开展 B2C 或 B2B。
提示
file_type: 文件类型说明，请 查看这里 (opens new window)。file_id: 用线下提供的 SFTP 账号按目录上传文件，成功后通过 获取文件ID 换取。
# 支持的子商户类型
中国大陆个人(china-individual)、中国香港个人(hk-individual)、海外个人(foreign-individual)、越南个人(vietnam-foreign-individual)、中国大陆企业(有限责任公司)(china-enterprise-limited)、中国大陆合资企业(china-enterprise-investment)、中国大陆个体户(china-enterprise-self-employed)、中国香港企业(hk-enterprise)、海外企业(foreign-enterprise)、越南企业(vietnam-foreign-enterprise)。
# 重点参数说明
| 参数名 | 说明 |
|---|---|
| partner_user_id | 商户唯一ID。 |
| client_id | 使用通过KYC审核的client_id 可以创建不同业务类型的Unit。 |
| merchant_type | 贸易业务。个人类型只能使用 B2C。企业类型中，china-enterprise-limited、china-enterprise-investment、china-enterprise-self-employed、hk-enterprise、foreign-enterprise、vietnam-foreign-enterprise 可以使用 B2C 或 B2B。这将影响到 开通收款账户 能创建的收款类型。 |
| kyc_type | 客户类型。 |
| industry | 所属行业类别。在同一个一级类目内可以多选，不能跨类目。实物类和无形服务类不能混选。库里的 Crafts 和 Arts Crafts 都可用。 |
| individual_info | 个人类型时使用：china-individual、hk-individual、foreign-individual、vietnam-foreign-individual。 |
| company_info | 企业类型时使用。 |
| company_name_en | 企业英文名称，常用于国际沟通和跨境业务。企业类型必填。 |
无法OCR的数据
当客户类型为
中国香港企业(hk-enterprise)、海外企业(foreign-enterprise)以及越南企业(vietnam-foreign-enterprise) 时，下面的参数为必填：
| 参数名 | 说明 |
|---|---|
| identify_no | 企业证件号码。 |
| company_name | 企业名称。 |
| establish_date | 企业成立日期。 |
| commencement_date | 企业证件有效期 起始日期。 |
| valid_period | 企业证件有效期 结束日期。 |
| register_address | 企业注册地址。 |
- 当法人|股东信息(legal_info)、受益人信息(ubo_list)为非大陆身份证时，下面的参数为必填:
| 参数名 | 说明 |
|---|---|
| name | 证件名字。 |
| name_en | 证据名字对应的英文名称。 |
| id_number | 证件号码。 |
| date_of_birth | 生日。格式(YYYYMMDD)。 |
| issue_date | 证件颁发日期。格式(YYYYMMDD)。 |
| expiration_date | 证件过期日期。格式(YYYYMMDD)。长期传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、股权结构图 | 经营场所照片 | ||
| 越南个人 | 越南身份证正反面或者护照和地址证明文件 |