最新更新時(shí)間：2022.03.15 版本說明
電商平臺(tái)通過查詢預(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)查詢。
1. 本接口可查詢90日內(nèi)發(fā)起的預(yù)約提現(xiàn)單據(jù)，發(fā)起時(shí)間以微信支付預(yù)約提現(xiàn)單創(chuàng)建時(shí)間為準(zhǔn)。
2. 若查到預(yù)約提現(xiàn)單狀態(tài)是SUCCESS，并不代表銀行入賬一定成功，部分情況下可能發(fā)生銀行退票(銀行預(yù)計(jì)在7個(gè)工作日內(nèi)處理退票)。
3. 若查詢到預(yù)約提現(xiàn)單狀態(tài)是REFUND，代表預(yù)約提現(xiàn)退票，此時(shí)應(yīng)檢查登記的賬戶信息是否有誤，退票后資金會(huì)自動(dòng)退回發(fā)起時(shí)的商戶賬戶內(nèi)。
4. 若查詢到預(yù)約提現(xiàn)單狀態(tài)是INIT，請(qǐng)使用原單(所有請(qǐng)求參數(shù)保持不變)發(fā)起重試。
5. 若查到預(yù)約提現(xiàn)單狀態(tài)是CREATE_SUCCESS，代表預(yù)約提現(xiàn)單已創(chuàng)建，等待銀行返回最終結(jié)果中，最終結(jié)果請(qǐng)重試查詢。
6. 返回參數(shù)可能會(huì)有新增，且順序可能不完全遵循此文檔規(guī)范，如果在解析回包的時(shí)候發(fā)生錯(cuò)誤，可以根據(jù)api文檔重新確認(rèn)返回內(nèi)容。
適用對(duì)象：電商平臺(tái)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/{withdraw_id}
請(qǐng)求方式：GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 是 | query電商平臺(tái)二級(jí)商戶號(hào)，由微信支付生成并下發(fā) 示例值：1900000109。 |
| 微信支付預(yù)約提現(xiàn)單號(hào)查詢 | withdraw_id | string[1, 128] | 是 | path電商平臺(tái)提交二級(jí)商戶預(yù)約提現(xiàn)申請(qǐng)后，由微信支付返回的申請(qǐng)單號(hào)，作為查詢申請(qǐng)狀態(tài)的唯一標(biāo)識(shí)。 示例值：1232193719823791273913279173291279 |
https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/32912793127931279317929791239112123?sub_mchid=1900000109
適用對(duì)象：電商平臺(tái)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/out-request-no/{out_request_no}
請(qǐng)求方式：GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 是 | query電商平臺(tái)二級(jí)商戶號(hào)，由微信支付生成并下發(fā)。 示例值：1900000109 |
| 商戶預(yù)約提現(xiàn)單號(hào) | out_request_no | string[1, 32] | 是 | path商戶預(yù)約提現(xiàn)單號(hào)，由商戶自定義生成 示例值：20190611222222222200 |
https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw/out-request-no/20190611222222222200?sub_mchid=1900000109
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 是 | 電商平臺(tái)二級(jí)商戶號(hào)，由微信支付生成并下發(fā)。 示例值：1900000109 |
| 電商平臺(tái)商戶號(hào) | sp_mchid | string[1, 32] | 是 | 電商平臺(tái)商戶號(hào) 示例值：1800000123 |
| 預(yù)約提現(xiàn)單狀態(tài) | status | string[1,16] | 是 | 枚舉值： CREATE_SUCCESS：受理成功 SUCCESS：提現(xiàn)成功 FAIL：提現(xiàn)失敗 REFUND：提現(xiàn)退票 CLOSE：關(guān)單 INIT：業(yè)務(wù)單已創(chuàng)建 示例值：CREATE_SUCCESS |
| 微信支付預(yù)約提現(xiàn)單號(hào) | withdraw_id | string[1, 128] | 是 | 提交預(yù)約提現(xiàn)申請(qǐng)后，由微信支付返回的申請(qǐng)單號(hào)，作為查詢申請(qǐng)狀態(tài)的唯一標(biāo)識(shí) 示例值：12321937198237912739132791732912793127931279317929791239112123 |
| 商戶預(yù)約提現(xiàn)單號(hào) | out_request_no | string[1, 32] | 是 | 商戶預(yù)約提現(xiàn)單號(hào)，由商戶自定義生成，必須是字母數(shù)字 示例值：20190611222222222200000000012122 |
| 提現(xiàn)金額 | amount | int | 是 | 單位：分 示例值：1 |
| 提交預(yù)約時(shí)間 | create_time | string[29, 29] | 是 | 遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，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秒。 示例值：2015-05-20T13:29:35+08:00 |
| 提現(xiàn)狀態(tài)更新時(shí)間 | update_time | string[29, 29] | 是 | 遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，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秒。 示例值：2015-05-20T13:29:35+08:00 |
| 失敗原因 | reason | string[1, 255] | 是 | 提現(xiàn)失敗原因，僅在提現(xiàn)失敗、退票、關(guān)單時(shí)有值 示例值：卡號(hào)錯(cuò)誤 |
| 提現(xiàn)備注 | remark | string[1, 255] | 是 | 商戶對(duì)預(yù)約提現(xiàn)單的備注，若發(fā)起預(yù)約提現(xiàn)時(shí)未傳入相應(yīng)值或輸入不合法，則該值為空 示例值：交易提現(xiàn) |
| 銀行附言 | bank_memo | string[1, 32] | 是 | 展示在收款銀行系統(tǒng)中的附言，由數(shù)字、字母、漢字組成（能否成功展示依賴銀行系統(tǒng)支持）。若發(fā)起提現(xiàn)時(shí)未傳入相應(yīng)值或輸入不合法，則該值為空 示例值：微信提現(xiàn) |
| 出款賬戶類型 | account_type | string[1,16] | 是 | BASIC：基本戶 OPERATION：運(yùn)營賬戶 FEES：手續(xù)費(fèi)賬戶 示例值：BASIC |
| 入賬銀行賬號(hào)后四位 | account_number | string[1, 4] | 是 | 服務(wù)商提現(xiàn)入賬的銀行賬號(hào)，僅顯示后四位。 示例值：1178 |
| 入賬銀行 | account_bank | string[1, 10] | 是 | 服務(wù)商提現(xiàn)入賬的開戶銀行 示例值：招商銀行 |
| 入賬銀行全稱（含支行） | bank_name | string[1, 128] | 否 | 服務(wù)商提現(xiàn)入賬的開戶銀行全稱（含支行） 示例值：中國工商銀行股份有限公司深圳軟件園支行 |
{
"sub_mchid": "1900000109",
"sp_mchid": "1800000123",
"status": "CREATE_SUCCESS",
"withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",
"out_request_no": "20190611222222222200000000012122",
"amount": 1,
"create_time": "2015-05-20T13:29:35.120+08:00",
"update_time": "2015-05-20T13:29:35.120+08:00",
"reason": "卡號(hào)錯(cuò)誤",
"remark": "交易提現(xiàn)",
"bank_memo": "微信提現(xiàn)",
"account_type": "BASIC",
"account_number": "1178",
"account_bank": "招商銀行",
"bank_name": "中國工商銀行股份有限公司深圳軟件園支行"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 403 | REQUEST_BLOCKED | 二級(jí)商戶未開啟預(yù)約提現(xiàn)權(quán)限 | 二級(jí)商戶號(hào)預(yù)約提現(xiàn)權(quán)限被凍結(jié)，無法發(fā)起預(yù)約提現(xiàn) |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用，電商平臺(tái)提交相同商戶單號(hào)的請(qǐng)求但參數(shù)和歷史提交的參數(shù)不一致 |
| 404 | ORDER_NOT_EXIST | 預(yù)約提現(xiàn)單號(hào)不存在 | 請(qǐng)檢查預(yù)約提現(xiàn)單號(hào)是否正確 |
| 403 | NOT_ENOUGH | 二級(jí)商戶號(hào)賬戶可用余額不足 | 二級(jí)商戶號(hào)賬戶可用余額不足 |
| 403 | NO_AUTH | 無接口使用權(quán)限 | 請(qǐng)開通商戶號(hào)相關(guān)權(quán)限 |
| 400 | INVALID_REQUEST | 二級(jí)商戶未開啟預(yù)約提現(xiàn)權(quán)限 | 請(qǐng)確認(rèn)電商平臺(tái)商戶號(hào)和二級(jí)商戶商戶號(hào)是否存在受理關(guān)系 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 請(qǐng)降低頻率后重試 |
| 403 | CONTRACT_NOT_CONFIRMED | 二級(jí)商戶未開啟預(yù)約提現(xiàn)權(quán)限 | 二級(jí)商戶號(hào)提現(xiàn)權(quán)限已關(guān)閉，無法發(fā)起提現(xiàn) |
| 403 | ACCOUNT_NOT_VERIFIED | 二級(jí)商戶下行打款未成功 | 二級(jí)商戶號(hào)結(jié)算銀行卡信息有誤，修改后重試 |
| 403 | ACCOUNT_ERROR | 二級(jí)商戶未綁卡 | 二級(jí)商戶號(hào)沒有綁定結(jié)算銀行卡，綁定后重試 |