最新更新時(shí)間：2022.06.16 版本說明
渠道商可以通過該接口向微信支付提交商戶的聯(lián)系人、主體等信息，根據(jù)指引完成商戶開戶意愿確認(rèn)。
功能接入可看產(chǎn)品流程指引
1. 商戶上送敏感信息時(shí)使用微信支付平臺(tái)公鑰加密，證書序列號(hào)包含在請(qǐng)求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則
適用對(duì)象：渠道商 從業(yè)機(jī)構(gòu)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/apply4subject/applyment
請(qǐng)求方式：POST
接口頻率：5QPS(商戶號(hào)維度)
是否支持冪等：是
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 渠道商戶號(hào) | channel_id | string[8, 9] | 否 | body1、微信支付分配的渠道商戶唯一標(biāo)識(shí) 2、當(dāng)從業(yè)機(jī)構(gòu)調(diào)用時(shí)，該字段必填，需填寫從業(yè)機(jī)構(gòu)下的渠道商戶號(hào) 3、當(dāng)渠道商戶調(diào)用時(shí)，該字段無需填寫 示例值：20001111 |
| 業(yè)務(wù)申請(qǐng)編號(hào) | business_code | string[1, 128] | 是 | body1、只能由數(shù)字、字母或下劃線組成 2、服務(wù)商自定義的唯一編號(hào)。每個(gè)編號(hào)對(duì)應(yīng)一個(gè)申請(qǐng)單 3、建議前綴帶上服務(wù)商商戶號(hào)，參看示例值 示例值：1900013511_10000 |
| + 聯(lián)系人信息 | contact_info | object | 是 | body聯(lián)系人信息，聯(lián)系人是商戶的聯(lián)系人，將接收開戶信息及日常重要管理信息，請(qǐng)確定聯(lián)系人為商戶法定代表人或經(jīng)營(yíng)者再進(jìn)行操作。如聯(lián)系人非商戶法定代表人或經(jīng)營(yíng)者，請(qǐng)?zhí)峤唤?jīng)辦人身份證件和業(yè)務(wù)辦理授權(quán)函。 |
| + 主體信息 | subject_info | object | 是 | body主體信息 |
| + 法人身份信息 | identification_info | object | 是 | body法人身份信息 |
| + 最終受益人信息列表(UBO) | ubo_info_list | array | 條件選填 | body僅企業(yè)需要填寫。 若經(jīng)營(yíng)者/法人不是最終受益所有人，則需提填寫受益所有人信息，最多上傳4個(gè)。 若經(jīng)營(yíng)者/法人是最終受益所有人之一，可在此填寫其他受益所有人信息，最多上傳3個(gè)。 根據(jù)國(guó)家相關(guān)法律法規(guī)，需要提供公司受益所有人信息，受益所有人需符合至少以下條件之一： 1、直接或者間接擁有超過25%公司股權(quán)或者表決權(quán)的自然人。 2、通過人事、財(cái)務(wù)等其他方式對(duì)公司進(jìn)行控制的自然人。 3、公司的高級(jí)管理人員，包括公司的經(jīng)理、副經(jīng)理、財(cái)務(wù)負(fù)責(zé)人、上市公司董事會(huì)秘書和公司章程規(guī)定的其他人員。 |
| + 補(bǔ)充材料 | addition_info | object | 否 | body根據(jù)實(shí)際審核情況，額外要求商家提供指定的補(bǔ)充資料。 |
{
"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": "李四網(wǎng)絡(luò)有限公司",
"legal_person": "李四",
"company_address": "廣東省深圳市南山區(qū)xx路xx號(hào)",
"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公益團(tuán)體",
"legal_person": "李四",
"company_address": "廣東省深圳市南山區(qū)xx路xx號(hào)",
"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\",\"2037-10-28\"]",
"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"
}]
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 申請(qǐng)單編號(hào) | applyment_id | int | 是 | 微信支付分配的申請(qǐng)單號(hào) 示例值：20000000011111 |
{
"applyment_id": 20000000011111
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEMERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
| 400 | INVALID_REQUEST | 無效請(qǐng)求 | 請(qǐng)查看返回的錯(cuò)誤信息，根據(jù)錯(cuò)誤信息進(jìn)行操作 |
| 403 | NOAUTH | 商戶權(quán)限異常 | 請(qǐng)確認(rèn)是否已經(jīng)開通相關(guān)權(quán)限 |