當服務(wù)商提交申請單后,需要定期調(diào)用此接口查詢申請單的審核狀態(tài)。
接口頻率:20QPS(商戶號維度)
# 接口說明
支持商戶:
【渠道商】【從業(yè)機構(gòu)(銀行)】【從業(yè)機構(gòu)(支付機構(gòu))】
請求方式:
【GET】/v3/apply4subject/applyment
請求域名:
【主域名】
https://api.mch.weixin.qq.com/
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- applyment_id 選填 integer【申請單編號】 1、微信支付分配的申請單號。申請單編號和業(yè)務(wù)申請編號至少傳一個。
2、該參數(shù)放在請求鏈接query或path中,不用寫到body - business_code 選填 string(128)【業(yè)務(wù)申請編號】 1、服務(wù)商自定義的唯一編號。每個編號對應(yīng)一個申請單。
2、該參數(shù)放在請求鏈接query或path中,不用寫到body
Query 查詢參數(shù)
請求示例
GET
# 應(yīng)答參數(shù)
- applyment_state 必填 string(64)【申請單狀態(tài)】
可選取值:APPLYMENT_STATE_EDITTING
: 如果查到申請單是編輯中的狀態(tài),可能是提交申請發(fā)生了錯誤導(dǎo)致的,可用同一個業(yè)務(wù)申請編號重新提交APPLYMENT_STATE_WAITTING_FOR_AUDIT
: 如果查到申請單是審核中的狀態(tài),請耐心等待1~2個工作日,微信支付將會完成審核APPLYMENT_STATE_WAITTING_FOR_CONFIRM_CONTACT
: 如果查到申請單是待確認聯(lián)系信息的狀態(tài),請掃描微信支付返回的小程序碼確認聯(lián)系信息(此過程可修改聯(lián)系人手機號)APPLYMENT_STATE_WAITTING_FOR_CONFIRM_LEGALPERSON
: 如果查到申請單是待賬戶驗證的狀態(tài),請掃描微信支付返回的小程序碼在小程序端完成賬戶驗證APPLYMENT_STATE_PASSED
: 如果查到申請單是審核通過狀態(tài),請掃描微信支付返回的小程序碼在小程序端完成授權(quán)流程APPLYMENT_STATE_REJECTED
: 如果查到申請單是審核駁回狀態(tài),請按照駁回原因修改申請資料,并更換業(yè)務(wù)申請編碼,重新提交申請APPLYMENT_STATE_FREEZED
: 如果查到申請單是已凍結(jié)狀態(tài),可能是該主體已完成過入駐,請查看駁回原因,并通知駁回原因中指定的聯(lián)系人掃描微信支付返回的小程序碼在小程序端完成授權(quán)流程APPLYMENT_STATE_CANCELED
: 如果查到申請單是已作廢狀態(tài),表示申請單已被撤銷,無需再對其進行操作
- qrcode_data 選填 string(30000)【小程序碼圖片】 1、當申請單狀態(tài)為APPLYMENT_STATE_WAITTING_FOR_CONFIRM_CONTACT、APPLYMENT_STATE_WAITTING_FOR_CONFIRM_LEGALPERSON、APPLYMENT_STATE_PASSED、APPLYMENT_STATE_FREEZED時,會返回小程序碼圖片
2、使用base64解碼該字段,可得到圖片二進制數(shù)據(jù)
3、可用img標簽直接加載該圖片,示例如下:
<img src="data:image/png;base64,iVBORw0KGgoAAAANSU=" style="display: block;"> - reject_param 選填 string(256)【駁回參數(shù)】 當申請單狀態(tài)為APPLYMENT_STATE_REJECTED、APPLYMENT_STATE_FREEZED時,會返回該字段,標識被駁回的字段名
- reject_reason 選填 string(1024)【駁回原因】 當申請單狀態(tài)為APPLYMENT_STATE_REJECTED、APPLYMENT_STATE_FREEZED時,會返回該字段,表示駁回原因
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)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
400 | INVALID_REQUEST | 無效請求 | 請查看返回的錯誤信息,根據(jù)錯誤信息進行操作 |
403 | NO_AUTH | 商戶權(quán)限異常 | 請確認是否已經(jīng)開通相關(guān)權(quán)限 |