最新更新時(shí)間：2022.03.15 版本說(shuō)明
電商平臺(tái)通過(guò)預(yù)約提現(xiàn)API幫助二級(jí)商戶(hù)發(fā)起賬戶(hù)預(yù)約提現(xiàn)申請(qǐng)，完成賬戶(hù)提現(xiàn)。
該預(yù)約提現(xiàn)申請(qǐng)?zhí)峤缓螅到y(tǒng)將在次日發(fā)起提現(xiàn)，預(yù)計(jì)當(dāng)日到賬。具體到賬時(shí)間以實(shí)際銀行處理為準(zhǔn)
1. 單筆預(yù)約提現(xiàn)最大發(fā)起金額不能超過(guò)8億
2. 相同的“商戶(hù)預(yù)約提現(xiàn)單號(hào)”+“特約商戶(hù)商戶(hù)號(hào)”可以提供6天內(nèi)防重。
3. 預(yù)約提現(xiàn)發(fā)起后，單據(jù)的實(shí)際狀態(tài)以查詢(xún)接口為準(zhǔn)。
4. 若預(yù)約提現(xiàn)發(fā)起成功，預(yù)計(jì)會(huì)在下個(gè)工作日到賬。
5. 當(dāng)API返回錯(cuò)誤碼為SYSTEM_ERROR時(shí)，請(qǐng)務(wù)必不要換單重試，使用原單(所有請(qǐng)求參數(shù)保持不變)發(fā)起重試。
6. 返回參數(shù)可能會(huì)有新增，且順序可能不完全遵循此文檔規(guī)范，如果在解析回包的時(shí)候發(fā)生錯(cuò)誤，請(qǐng)務(wù)必不要換單重試，可以聯(lián)系客服或小助手確認(rèn)提現(xiàn)情況。
7. 錯(cuò)誤碼可能會(huì)有新增，如果遇到返回新的錯(cuò)誤碼，請(qǐng)務(wù)必不要換單重試，可以聯(lián)系客服或小助手確認(rèn)預(yù)約提現(xiàn)情況。
適用對(duì)象：電商平臺(tái)
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw
請(qǐng)求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類(lèi)型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶(hù)號(hào) | sub_mchid | string[1,32] | 是 | body電商平臺(tái)二級(jí)商戶(hù)號(hào)，由微信支付生成并下發(fā) 示例值：1900000109 |
| 商戶(hù)預(yù)約提現(xiàn)單號(hào) | out_request_no | string[1, 32] | 是 | body商戶(hù)預(yù)約提現(xiàn)單號(hào)，由商戶(hù)自定義生成，必須是字母數(shù)字 示例值：20190611222222222200000000012122 |
| 提現(xiàn)金額 | amount | int | 是 | body單位：分，金額不能超過(guò)8億元 示例值：1 |
| 提現(xiàn)備注 | remark | string[1, 56] | 否 | body商戶(hù)對(duì)預(yù)約提現(xiàn)單的備注 示例值：交易提現(xiàn) |
| 銀行附言 | bank_memo | string[1, 32] | 否 | body展示在收款銀行系統(tǒng)中的附言，數(shù)字、字母最長(zhǎng)32個(gè)漢字（能否成功展示依賴(lài)銀行系統(tǒng)支持） 示例值：xx平臺(tái)提現(xiàn) |
| 出款賬戶(hù)類(lèi)型 | account_type | string | 否 | body BASIC：基本戶(hù) OPERATION：運(yùn)營(yíng)賬戶(hù) FEES：手續(xù)費(fèi)賬戶(hù) 示例值：BASIC |
{
"account_type": "BASIC",
"amount": 1,
"bank_memo": "xx平臺(tái)提現(xiàn)",
"out_request_no": "20190611222222222200000000012122",
"remark": "交易提現(xiàn)",
"sub_mchid": "1900000109"
}
| 參數(shù)名 | 變量 | 類(lèi)型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶(hù)號(hào) | sub_mchid | string[1,32] | 是 | 電商平臺(tái)二級(jí)商戶(hù)號(hào)，由微信支付生成并下發(fā) 示例值：1900000109 |
| 微信支付預(yù)約提現(xiàn)單號(hào) | withdraw_id | string[1, 128] | 是 | 提交預(yù)約提現(xiàn)申請(qǐng)后，由微信支付返回的申請(qǐng)單號(hào)，作為查詢(xún)申請(qǐng)狀態(tài)的唯一標(biāo)識(shí) 示例值：12321937198237912739132791732912793127931279317929791239112123 |
| 商戶(hù)預(yù)約提現(xiàn)單號(hào) | out_request_no | string[1, 32] | 是 | 商戶(hù)預(yù)約提現(xiàn)單號(hào)，由商戶(hù)自定義生成，必須是字母數(shù)字 示例值：20190611222222222200000000012122 |
{
"out_request_no": "20190611222222222200000000012122",
"sub_mchid": "1900000109",
"withdraw_id": "12321937198237912739132791732912793127931279317929791239112123"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 403 | REQUEST_BLOCKED | 二級(jí)商戶(hù)未開(kāi)啟預(yù)約提現(xiàn)權(quán)限 | 二級(jí)商戶(hù)號(hào)預(yù)約提現(xiàn)權(quán)限被凍結(jié)，無(wú)法發(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ù)單號(hào)的請(qǐng)求但參數(shù)和歷史提交的參數(shù)不一致 |
| 404 | ORDER_NOT_EXIST | 預(yù)約提現(xiàn)單號(hào)不存在 | 請(qǐng)檢查訂單號(hào)是否正確 |
| 403 | NOT_ENOUGH | 二級(jí)商戶(hù)號(hào)賬戶(hù)可用余額不足 | 二級(jí)商戶(hù)號(hào)賬戶(hù)可用余額不足 |
| 403 | NO_AUTH | 無(wú)接口使用權(quán)限 | 請(qǐng)開(kāi)通商戶(hù)號(hào)相關(guān)權(quán)限 |
| 400 | INVALID_REQUEST | 二級(jí)商戶(hù)未開(kāi)啟預(yù)約提現(xiàn)權(quán)限 | 請(qǐng)確認(rèn)電商平臺(tái)商戶(hù)號(hào)和二級(jí)商戶(hù)商戶(hù)號(hào)是否存在受理關(guān)系 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 請(qǐng)降低頻率后重試 |
| 403 | CONTRACT_NOT_CONFIRMED | 二級(jí)商戶(hù)未開(kāi)啟預(yù)約提現(xiàn)權(quán)限 | 二級(jí)商戶(hù)號(hào)預(yù)約提現(xiàn)權(quán)限已關(guān)閉，無(wú)法發(fā)起預(yù)約提現(xiàn) |
| 403 | ACCOUNT_NOT_VERIFIED | 二級(jí)商戶(hù)下行打款未成功 | 二級(jí)商戶(hù)號(hào)結(jié)算銀行卡信息有誤，修改后重試 |
| 403 | ACCOUNT_ERROR | 二級(jí)商戶(hù)未綁卡 | 二級(jí)商戶(hù)號(hào)沒(méi)有綁定結(jié)算銀行卡，綁定后重試 |
| 400 | INVALID_REQUEST | 商戶(hù)賬戶(hù)類(lèi)型不存在或未開(kāi)通 | 請(qǐng)確認(rèn)二級(jí)商戶(hù)賬戶(hù)類(lèi)型有效 |