最新更新时间：2023.6.16 版本说明
渠道商可以通过该接口向微信支付提交商户的联系人、主体等信息，根据指引完成商户开户意愿确认。
功能接入可看产品流程指引
1. 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则
适用对象：渠道商 从业机构
请求URL：https://api.mch.weixin.qq.com/v3/apply4subject/applyment
请求方式：POST
接口频率：5QPS(商户号维度)
是否支持幂等：是
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 渠道商户号 | channel_id | string[8, 9] | 否 | body1、微信支付分配的渠道商户唯一标识 2、当从业机构调用时，该字段必填，需填写从业机构下的渠道商户号 3、当渠道商户调用时，该字段无需填写 示例值：20001111 |
| 业务申请编号 | business_code | string[1, 128] | 是 | body1、只能由数字、字母或下划线组成 2、服务商自定义的唯一编号。每个编号对应一个申请单 3、建议前缀带上服务商商户号，参看示例值 示例值：1900013511_10000 |
| + 联系人信息 | contact_info | object | 是 | body联系人信息，联系人是商户的联系人，将接收开户信息及日常重要管理信息，请确定联系人为商户法定代表人或经营者再进行操作。如联系人非商户法定代表人或经营者，请提交经办人身份证件和业务办理授权函。 |
| + 主体信息 | subject_info | object | 是 | body主体信息 |
| + 法人身份信息 | identification_info | object | 是 | body法人身份信息 |
| + 最终受益人信息列表(UBO) | ubo_info_list | array | 条件选填 | body仅企业需要填写。 若经营者/法人不是最终受益所有人，则需提填写受益所有人信息，最多上传4个。 若经营者/法人是最终受益所有人之一，可在此填写其他受益所有人信息，最多上传3个。 根据国家相关法律法规，需要提供公司受益所有人信息，受益所有人需符合至少以下条件之一： 1、直接或者间接拥有超过25%公司股权或者表决权的自然人。 2、通过人事、财务等其他方式对公司进行控制的自然人。 3、公司的高级管理人员，包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。 |
| + 补充材料 | addition_info | object | 否 | body根据实际审核情况，额外要求商家提供指定的补充资料。 |
{
"channel_id": "20001111",
"business_code": "1900013511_10000",
"contact_info": {
"name": "X/8KWvNPULFmbdM1oU/w58gd1Jv75z+qStfT018ms25FGlVGMR2An5yGhVEHTp509zscN9PKjhi+Q+VBGpy2ei6HY5DbXU3m74Q96IpHw7w==",
"mobile": "Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLm8mdsohkuR9jSiwXyHyVQD1OA1t+6Pb+Xn0q2HAJYLsNjh8O4S1iQgMrFohyaNms4IlDxJzujb9VA==",
"id_card_number": "rjbq82xBwMixDGAviRajNvdDah00E7jIA/jtnj+Wk5jjM+yyjn9BU8qUBZga+mKqQ==",
"contact_type": "LEGAL",
"contact_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
"contact_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"contact_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"contact_period_begin": "2019-06-06",
"contact_period_end": "2026-06-06"
},
"subject_info": {
"subject_type": "SUBJECT_TYPE_ENTERPRISE",
"is_finance_institution": false,
"business_licence_info": {
"licence_number": "914201123033363296",
"licence_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
"merchant_name": "李四网络有限公司",
"legal_person": "李四",
"company_address": "广东省深圳市南山区xx路xx号",
"licence_valid_date": "[\"2017-10-28\",\"2037-10-28\"]"
},
"certificate_info": {
"cert_type": "CERTIFICATE_TYPE_2388",
"cert_number": "111111111111",
"cert_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
"merchant_name": "xx公益团体",
"legal_person": "李四",
"company_address": "广东省深圳市南山区xx路xx号",
"cert_valid_date": "[\"2017-10-28\",\"2037-10-28\"]"
},
"company_prove_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
"special_operation_list": [{
"category_id": 100,
"operation_copy_list": [
"0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
]
}],
"finance_institution_info": {
"finance_type": "BANK_AGENT",
"finance_license_pics": [
"0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
]
}
},
"identification_info": {
"id_holder_type": "LEGAL",
"identification_type": "IDENTIFICATION_TYPE_IDCARD",
"identification_name": "X/8KWvNPULFmbdM1oU/w58gd1Jv75z+qStfT018ms25FGlVGMR2An5yGhVEHTp509zscN9PKjhi+Q+VBGpy2ei6HY5DbXU3m74Q96IpHw7w==",
"identification_number": "rjbq82xBwMixDGAviRajNvdDah00E7jIA/jtnj+Wk5jjM+yyjn9BU8qUBZga+mKqQ==",
"identification_valid_date": "[\"2017-10-28\",\"forever\"]",
"identification_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ib0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"identification_front_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
"identification_back_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
"owner": false
},
"ubo_info_list": [{
"ubo_id_doc_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"ubo_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"ubo_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"ubo_id_doc_name": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"ubo_id_doc_number": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"ubo_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
"ubo_period_begin": "2019-06-06",
"ubo_period_end": "2026-06-06"
}]
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 申请单编号 | applyment_id | int | 是 | 微信支付分配的申请单号 示例值：20000000011111 |
{
"applyment_id": 20000000011111
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEMERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| 400 | INVALID_REQUEST | 无效请求 | 请查看返回的错误信息，根据错误信息进行操作 |
| 403 | NOAUTH | 商户权限异常 | 请确认是否已经开通相关权限 |