服務(wù)商/電商平臺(不包括支付機構(gòu)、銀行),可使用本接口,查詢其進件且已簽約特約商戶/二級商戶當前的結(jié)算賬戶信息(敏感信息掩碼)和驗證結(jié)果。
# 接口說明
支持商戶:
【普通服務(wù)商】【平臺商戶】
請求方式:
【GET】/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
請求域名:
【主域名】
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(10)【特約商戶/二級商戶號】 請輸入本服務(wù)商進件、已簽約的特約商戶/二級商戶號。
Path 路徑參數(shù)
請求示例
GET
# 應(yīng)答參數(shù)
- account_type 必填 string【賬戶類型】 返回特約商戶的結(jié)算賬戶類型。
可選取值:ACCOUNT_TYPE_BUSINESS
: 對公銀行賬戶ACCOUNT_TYPE_PRIVATE
: 經(jīng)營者個人銀行卡
- account_bank 必填 string(128)【開戶銀行】 返回特約商戶的結(jié)算賬戶-開戶銀行全稱。
- bank_name 選填 string(128)【開戶銀行全稱(含支行)】 返回特約商戶的結(jié)算賬戶-開戶銀行全稱(含支行)。
- bank_branch_id 選填 string(128)【開戶銀行聯(lián)行號】 返回特約商戶的結(jié)算賬戶-聯(lián)行號。
- account_number 必填 string(128)【銀行賬號】 返回特約商戶的結(jié)算賬戶-銀行賬號,掩碼顯示。
- verify_result 必填 string【驗證結(jié)果】 返回特約商戶的結(jié)算賬戶-驗證結(jié)果。
可選取值:VERIFY_SUCCESS
: 驗證成功,該賬戶可正常發(fā)起提現(xiàn)。VERIFY_FAIL
: 驗證失敗,該賬戶無法發(fā)起提現(xiàn),請檢查修改。VERIFYING
: 驗證中,商戶可發(fā)起提現(xiàn)嘗試。
- verify_fail_reason 選填 string(1024)【驗證失敗原因】 如果驗證成功則為空,驗證失敗則為具體原因。
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)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 商戶權(quán)限異常 | 該商戶不是本服務(wù)商進件的子商戶,無權(quán)限操作 |