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