渠道商可以通過該接口向微信支付提交商戶的聯(lián)系人、主體等信息,根據(jù)指引完成商戶開戶意愿確認(rèn)。
功能接入可看產(chǎn)品流程指引。
注意
- 商戶上送敏感信息時使用微信支付平臺公鑰加密,證書序列號包含在請求HTTP頭部的Wechatpay-Serial,詳見接口規(guī)則
# 接口說明
支持商戶:
【渠道商】【從業(yè)機(jī)構(gòu)(銀行)】【從業(yè)機(jī)構(gòu)(支付機(jī)構(gòu))】
請求方式:
【POST】/v3/apply4subject/applyment/
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
接口頻率: 5QPS(商戶號維度)
是否支持冪等: 是
# 請求參數(shù)
Header HTTP頭參數(shù)
- channel_id 選填 string(9)【渠道商戶號】
1、微信支付分配的渠道商戶唯一標(biāo)識
2、當(dāng)從業(yè)機(jī)構(gòu)調(diào)用時,改字段必填,需填寫從業(yè)機(jī)構(gòu)下的渠道商戶號
3、當(dāng)渠道商戶調(diào)用時,該字段無需填寫 - business_code 必填 string(128)【業(yè)務(wù)申請編號】
1、只能由數(shù)字、字母或下劃線組成
2、服務(wù)商自定義的唯一編號。每個編號對應(yīng)一個申請單
3、建議前綴帶上服務(wù)商商戶號,參看示例值 - contact_info 必填 object【聯(lián)系人信息】
聯(lián)系人信息,聯(lián)系人是商戶的聯(lián)系人,將接收開戶信息及日常重要管理信息,請確定聯(lián)系人為商戶法定代表人或經(jīng)營者再進(jìn)行操作。如聯(lián)系人非商戶法定代表人或經(jīng)營者,請?zhí)峤唤?jīng)辦人身份證件和業(yè)務(wù)辦理授權(quán)函。- 屬性
- subject_info 必填 object【主體信息】
主體信息- 屬性
- identification_info 必填 object【法人身份信息】
法人身份信息- 屬性
- ubo_info_list 選填 array【最終受益人信息列表(UBO)】
僅企業(yè)需要填寫。
若經(jīng)營者/法人不是最終受益所有人,則需提填寫受益所有人信息,最多上傳4個。
若經(jīng)營者/法人是最終受益所有人之一,可在此填寫其他受益所有人信息,最多上傳3個。
根據(jù)國家相關(guān)法律法規(guī),需要提供公司受益所有人信息,受益所有人需符合至少以下條件之一:
1、直接或者間接擁有超過25%公司股權(quán)或者表決權(quán)的自然人。
2、通過人事、財務(wù)等其他方式對公司進(jìn)行控制的自然人。
3、公司的高級管理人員,包括公司的經(jīng)理、副經(jīng)理、財務(wù)負(fù)責(zé)人、上市公司董事會秘書和公司章程規(guī)定的其他人員。- 數(shù)組
- addition_info 選填 object【補(bǔ)充材料】
根據(jù)實際審核情況,額外要求商家提供指定的補(bǔ)充資料。- 屬性
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- applyment_id 必填 integer【申請單編號】
微信支付分配的申請單號
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 無效請求 | 請查看返回的錯誤信息,根據(jù)錯誤信息進(jìn)行操作 |
403 | NO_AUTH | 商戶權(quán)限異常 | 請確認(rèn)是否已經(jīng)開通相關(guān)權(quán)限 |