當服務(wù)商需要確認微信支付子商戶號是否完成確認時，如果調(diào)用此接口提到“已授權(quán)”狀態(tài)，則說明該商戶號已完成開戶意愿確認。
# 接口說明
支持商戶：
【渠道商】【從業(yè)機構(gòu)（銀行）】【從業(yè)機構(gòu)（支付機構(gòu)）】
請求方式：
【GET】/v3/apply4subject/applyment/merchants/{sub_mchid}/state
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- sub_mchid 必填 string(9)【特約商戶號】 1、微信支付分配的特約商戶唯一標識
2、該參數(shù)放在請求鏈接path中，不用寫到body
Path 路徑參數(shù)
請求示例
GET
# 應(yīng)答參數(shù)
- authorize_state 必填 string【授權(quán)狀態(tài)】
可選取值：AUTHORIZE_STATE_UNAUTHORIZED: 未授權(quán)，特約商戶號還未完成實名認證AUTHORIZE_STATE_AUTHORIZED: 已授權(quán)，特約商戶號已完成實名認證
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ù)錯誤信息進行操作 |
| 403 | NO_AUTH | 商戶權(quán)限異常 | 請確認是否已經(jīng)開通相關(guān)權(quán)限 |
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
