接口適用場景：當(dāng)服務(wù)商提交申請單后，需要定期調(diào)用此接口查詢申請單的審核狀態(tài)。
# 接口說明
支持商戶：
【平臺(tái)商戶】
請求方式：
【GET】/v3/ecommerce/applyments/out-request-no/{out_request_no}
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ，指引點(diǎn)擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請?jiān)O(shè)置為
application/json
Header HTTP頭參數(shù)
- out_request_no 必填 string(124)【業(yè)務(wù)申請編號(hào)】 1、服務(wù)商自定義的商戶唯一編號(hào)。
2、每個(gè)編號(hào)對應(yīng)一個(gè)申請單，每個(gè)申請單審核通過后會(huì)生成一個(gè)微信支付商戶號(hào)。
Path 路徑參數(shù)
請求示例
GET
# 應(yīng)答參數(shù)
- applyment_state 必填 string(32)【申請狀態(tài)】 枚舉值：
CHECKING：資料校驗(yàn)中
ACCOUNT_NEED_VERIFY：待賬戶驗(yàn)證
AUDITING：審核中
REJECTED：已駁回
NEED_SIGN：待簽約
FINISH：完成
FROZEN：已凍結(jié)
CANCELED：已作廢 - applyment_state_desc 必填 string(1024)【申請狀態(tài)描述】 申請狀態(tài)描述, 示例："審核中"
- sign_url 選填 string(256)【簽約鏈接】 1、當(dāng)申請狀態(tài)為NEED_SIGN時(shí)才返回。
2、建議將鏈接轉(zhuǎn)為二維碼展示，需讓申請單-管理者用微信掃碼打開，完成簽約。 - sub_mchid 選填 string(32)【電商平臺(tái)二級(jí)商戶號(hào)】 當(dāng)申請狀態(tài)為NEED_SIGN或FINISH時(shí)才返回。
- account_validation 選填 UpwardBankValidate【匯款賬戶驗(yàn)證信息】 當(dāng)申請狀態(tài)為ACCOUNT_NEED_VERIFY 時(shí)有返回，可根據(jù)指引匯款，完成賬戶驗(yàn)證
- 屬性
- audit_detail 選填 array[AuditDetail]【駁回原因詳情】 各項(xiàng)資料的審核情況。當(dāng)申請狀態(tài)為REJECTED或 FROZEN時(shí)才返回。
- 屬性
- legal_validation_url 選填 string(256)【法人驗(yàn)證鏈接】 1、當(dāng)申請狀態(tài)為
ACCOUNT_NEED_VERIFY，且通過系統(tǒng)校驗(yàn)的申請單，將返回鏈接。
2、建議將鏈接轉(zhuǎn)為二維碼展示，讓商戶法人用微信掃碼打開，完成賬戶驗(yàn)證。 - out_request_no 必填 string(128)【業(yè)務(wù)申請編號(hào)】 提交接口填寫的業(yè)務(wù)申請編號(hào)
- applyment_id 必填 integer【微信支付申請單號(hào)】 微信支付分配的申請單號(hào)
- sign_state 選填 string(32)【簽約狀態(tài)】 1、未簽約-UNSIGNED：該狀態(tài)下，電商平臺(tái)可查詢獲取簽約鏈接，引導(dǎo)二級(jí)商戶的超級(jí)管理員完成簽約；
2、已簽約-SIGNED ：指二級(jí)商戶的超級(jí)管理員已完成簽約。注意：若申請單被駁回，商戶修改了商戶主體名稱、法人名稱、超級(jí)管理員信息、主體類型等信息，則需重新簽約。
3、不可簽約-NOT_SIGNABLE：該狀態(tài)下，暫不支持超級(jí)管理員簽約。一般為申請單處于已駁回、已凍結(jié)、機(jī)器校驗(yàn)中狀態(tài)，無法簽約。
200OK
應(yīng)答示例
200 OK
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
| 400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
| 401 | SIGN_ERROR | 驗(yàn)證不通過 | 請參閱 簽名常見問題 |
| 500 | SYSTEM_ERROR | 系統(tǒng)異常，請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | RESOURCE_ALREADY_EXISTS | 存在流程進(jìn)行中的申請單，請檢查是否重入 | 可通過查詢申請狀態(tài)查看此申請單的申請狀態(tài)，或更換out_request_no提交新的申請單 |
| 403 | NO_AUTH | 商戶權(quán)限異常 | 請確認(rèn)是否已經(jīng)開通相關(guān)權(quán)限 |
| 404 | RESOURCE_NOT_EXISTS | 申請單不存在 | 確認(rèn)入?yún)ⅲ瑐魅胝_的申請單編號(hào) |
| 500 | RATELIMIT_EXCEEDED | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
