收付通平臺(tái)通過(guò)查詢預(yù)約提現(xiàn)狀態(tài)API查詢二級(jí)商戶預(yù)約提現(xiàn)單的預(yù)約提現(xiàn)結(jié)果。 該查詢服務(wù)提供兩種查詢方式(兩種查詢方式返回結(jié)果一致): ????方式1:微信支付預(yù)約提現(xiàn)單號(hào)查詢; ????方式2:商戶預(yù)約提現(xiàn)單號(hào)查詢。
注意:
- 本接口可查詢90日內(nèi)發(fā)起的預(yù)約提現(xiàn)單據(jù),發(fā)起時(shí)間以微信支付預(yù)約提現(xiàn)單創(chuàng)建時(shí)間為準(zhǔn)。
- 若查到預(yù)約提現(xiàn)單狀態(tài)是'SUCCESS',并不代表銀行入賬一定成功,部分情況下可能發(fā)生銀行退票(銀行預(yù)計(jì)在7個(gè)工作日內(nèi)處理退票)。
- 若查詢到預(yù)約提現(xiàn)單狀態(tài)是'REFUND',代表預(yù)約提現(xiàn)退票,此時(shí)應(yīng)檢查登記的賬戶信息是否有誤,退票后資金會(huì)自動(dòng)退回發(fā)起時(shí)的商戶賬戶內(nèi)。
- 若查詢到預(yù)約提現(xiàn)單狀態(tài)是'INIT',請(qǐng)使用原單(所有請(qǐng)求參數(shù)保持不變)發(fā)起重試。
- 若查到預(yù)約提現(xiàn)單狀態(tài)是'CREATE_SUCCESS',代表預(yù)約提現(xiàn)單已創(chuàng)建,等待銀行返回最終結(jié)果中,最終結(jié)果請(qǐng)重試查詢。
- 返回參數(shù)可能會(huì)有新增,且順序可能不完全遵循此文檔規(guī)范,如果在解析回包的時(shí)候發(fā)生錯(cuò)誤,可以根據(jù)api文檔重新確認(rèn)返回內(nèi)容。
# 接口說(shuō)明
支持商戶:
【平臺(tái)商戶】
請(qǐng)求方式:
【GET】/v3/ecommerce/fund/withdraw/out-request-no/{out_request_no}
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問(wèn)就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問(wèn)異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
Header HTTP頭參數(shù)
- out_request_no 必填 string(32)【商戶預(yù)約提現(xiàn)單號(hào)】 商戶預(yù)約提現(xiàn)單號(hào),由商戶自定義生成,必須是字母數(shù)字
Path 路徑參數(shù)
- sub_mchid 必填 string【二級(jí)商戶號(hào)】 收付通平臺(tái)二級(jí)商戶號(hào),由微信支付生成并下發(fā)
Query 查詢參數(shù)
請(qǐng)求示例
GET
# 應(yīng)答參數(shù)
- sp_mchid 必填 string【收付通平臺(tái)商戶號(hào)】 收付通平臺(tái)商戶號(hào)
- sub_mchid 必填 string【二級(jí)商戶號(hào)】 收付通平臺(tái)二級(jí)商戶號(hào),由微信支付生成并下發(fā)
- status 必填 string【預(yù)約提現(xiàn)單狀態(tài)】 預(yù)約提現(xiàn)單據(jù)當(dāng)前的狀態(tài)
可選取值:CREATE_SUCCESS
: 受理成功SUCCESS
: 提現(xiàn)成功FAIL
: 提現(xiàn)失敗REFUND
: 提現(xiàn)退票CLOSE
: 關(guān)單INIT
: 業(yè)務(wù)單已創(chuàng)建
- withdraw_id 必填 string(128)【微信支付預(yù)約提現(xiàn)單號(hào)】 提交預(yù)約提現(xiàn)申請(qǐng)后,由微信支付返回的申請(qǐng)單號(hào),作為查詢申請(qǐng)狀態(tài)的唯一標(biāo)識(shí)
- out_request_no 必填 string(32)【商戶預(yù)約提現(xiàn)單號(hào)】 商戶預(yù)約提現(xiàn)單號(hào),由商戶自定義生成,必須是字母數(shù)字
- amount 必填 integer【提現(xiàn)金額】 提現(xiàn)金額,單位:分
- create_time 必填 string【提交預(yù)約時(shí)間】 提交預(yù)約時(shí)間。遵循rfc3339
標(biāo)準(zhǔn)格式,格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開(kāi)頭,HH:mm:ss表示時(shí)分秒,TIMEZONE表示時(shí)區(qū)(+08:00表示東八區(qū)時(shí)間,領(lǐng)先UTC 8小時(shí),即北京時(shí)間)。例如:2015-05-20T13:29:35+08:00表示,北京時(shí)間2015年5月20日13點(diǎn)29分35秒 - update_time 必填 string【提現(xiàn)狀態(tài)更新時(shí)間】 提現(xiàn)狀態(tài)更新時(shí)間。遵循rfc3339
標(biāo)準(zhǔn)格式,格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開(kāi)頭,HH:mm:ss表示時(shí)分秒,TIMEZONE表示時(shí)區(qū)(+08:00表示東八區(qū)時(shí)間,領(lǐng)先UTC 8小時(shí),即北京時(shí)間)。例如:2015-05-20T13:29:35+08:00表示,北京時(shí)間2015年5月20日13點(diǎn)29分35秒 - reason 必填 string(255)【失敗原因】 提現(xiàn)失敗原因,僅在提現(xiàn)失敗、退票、關(guān)單時(shí)有值
- remark 必填 string(255)【提現(xiàn)備注】 商戶對(duì)預(yù)約提現(xiàn)單的備注,若發(fā)起預(yù)約提現(xiàn)時(shí)未傳入相應(yīng)值或輸入不合法,則該值為空
- bank_memo 必填 string(32)【銀行附言】 展示在收款銀行系統(tǒng)中的附言,由數(shù)字、字母、漢字組成(能否成功展示依賴(lài)銀行系統(tǒng)支持)。若發(fā)起提現(xiàn)時(shí)未傳入相應(yīng)值或輸入不合法,則該值為空
- account_type 必填 string【出款賬戶類(lèi)型】 出款賬戶類(lèi)型
可選取值:BASIC
: 基本賬戶FEES
: 手續(xù)費(fèi)賬戶OPERATION
: 運(yùn)營(yíng)賬戶
- account_number 必填 string(4)【入賬銀行賬號(hào)后四位】 提現(xiàn)入賬的銀行賬號(hào),僅顯示后四位
- account_bank 必填 string(10)【入賬銀行】 提現(xiàn)入賬的開(kāi)戶銀行
- bank_name 選填 string(128)【入賬銀行全稱(chēng)(含支行)】 提現(xiàn)入賬的開(kāi)戶銀行全稱(chēng)(含支行)
200OK
應(yīng)答示例
200 OK
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過(guò) | 請(qǐng)參閱 簽名常見(jiàn)問(wèn)題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 二級(jí)商戶未開(kāi)啟預(yù)約提現(xiàn)權(quán)限 | 請(qǐng)確認(rèn)電商平臺(tái)商戶號(hào)和二級(jí)商戶商戶號(hào)是否存在受理關(guān)系 |
403 | ACCOUNT_ERROR | 二級(jí)商戶未綁卡 | 二級(jí)商戶號(hào)沒(méi)有綁定結(jié)算銀行卡,綁定后重試 |
403 | ACCOUNT_NOT_VERIFIED | 二級(jí)商戶下行打款未成功 | 二級(jí)商戶號(hào)結(jié)算銀行卡信息有誤,修改后重試 |
403 | CONTRACT_NOT_CONFIRMED | 二級(jí)商戶未開(kāi)啟預(yù)約提現(xiàn)權(quán)限 | 二級(jí)商戶號(hào)提現(xiàn)權(quán)限已關(guān)閉,無(wú)法發(fā)起提現(xiàn) |
403 | NO_AUTH | 無(wú)接口使用權(quán)限 | 請(qǐng)開(kāi)通商戶號(hào)相關(guān)權(quán)限 |
403 | NOT_ENOUGH | 二級(jí)商戶號(hào)賬戶可用余額不足 | 二級(jí)商戶號(hào)賬戶可用余額不足 |
403 | REQUEST_BLOCKED | 二級(jí)商戶未開(kāi)啟預(yù)約提現(xiàn)權(quán)限 | 二級(jí)商戶號(hào)預(yù)約提現(xiàn)權(quán)限被凍結(jié),無(wú)法發(fā)起預(yù)約提現(xiàn) |
404 | ORDER_NOT_EXIST | 預(yù)約提現(xiàn)單號(hào)不存在 | 請(qǐng)檢查預(yù)約提現(xiàn)單號(hào)是否正確 |
429 | FREQUENCY_LIMITED | 頻率限制 | 請(qǐng)降低頻率后重試 |
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |