服務商(銀行、支付機構、電商平臺不可用)使用該接口提交商家資料,幫助商家入駐成為微信支付的特約商戶。
流程指引請看:特約商戶進件流程
注意
# 接口說明
支持商戶:
【普通服務商】
請求方式:
【POST】/v3/applyment4sub/applyment/
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
頻率限制: 15/s
# 請求參數(shù)
Header HTTP頭參數(shù)
- business_code 必填 string(124)【業(yè)務申請編號】
1、只能由數(shù)字、字母或下劃線組成,建議前綴為服務商商戶號;
2、服務商自定義的唯一編號;
3、每個編號對應一個申請單,每個申請單審核通過后會生成一個微信支付商戶號。 - contact_info 必填 object【超級管理員信息】
超級管理員需在開戶后進行簽約,并可接收日常重要管理信息和進行資金操作,請確定其為商戶法定代表人或負責人。- 屬性
- subject_info 必填 object【主體資料】
請?zhí)顚懮碳业臓I業(yè)執(zhí)照/登記證書、經(jīng)營者/法人的證件等信息- 屬性
- business_info 必填 object【經(jīng)營資料】
請?zhí)顚懮碳业慕?jīng)營業(yè)務信息、售賣商品/提供服務場景信息- 屬性
- settlement_info 必填 object【結算規(guī)則】
請?zhí)顚懮碳业慕Y算費率規(guī)則、特殊資質(zhì)等信息- 屬性
- bank_account_info 必填 object【結算銀行賬戶】
請?zhí)顚懮碳姨岈F(xiàn)收款的銀行賬戶信息- 屬性
- addition_info 選填 object【補充材料】
根據(jù)實際審核情況,會額外要求商家提供指定的補充資料- 屬性
Body 包體參數(shù)
請求示例
POST
# 應答參數(shù)
- applyment_id 必填 integer【微信支付申請單號】
微信支付分配的申請單號
200OK
應答示例
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è)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | APPLYMENT_NOTEXIST | 申請單不存在 | 確認入?yún)ⅲ瑐魅胝_的申請單編號 |
400 | PARAM_ERROR | 圖片文件為空 | 商戶更換文件后,重新調(diào)用 |
400 | PROCESSING | 存在流程進行中的申請單,請檢查是否重入 | 可通過查詢申請單狀態(tài)查看此申請單的申請狀態(tài),或更換business_code提交新的申請單 |
403 | NO_AUTH | 商戶權限異常 | 請確認是否已經(jīng)開通相關權限 |
403 | REQUEST_BLOCKED | 未知圖片類型 | 圖片類型必須為JPG、BMP、PNG |
403 | REQUEST_BLOCKED | 圖片meta信息不一致 | 請檢查meta信息是否正確 |
403 | REQUEST_BLOCKED | 簽名信息不匹配 | 請檢查簽名信息 |
429 | RATE_LIMITED | 頻率限制 | 請降低調(diào)用頻率 |