收付通平臺通過預(yù)約提現(xiàn)API幫助二級商戶發(fā)起賬戶預(yù)約提現(xiàn)申請,完成賬戶提現(xiàn)。
該預(yù)約提現(xiàn)申請?zhí)峤缓螅到y(tǒng)將在次日發(fā)起提現(xiàn),預(yù)計當(dāng)日到賬。具體到賬時間以實際銀行處理為準(zhǔn)。
注意:
- 單筆預(yù)約提現(xiàn)最大發(fā)起金額不能超過8億。
- 相同的“商戶預(yù)約提現(xiàn)單號”+“特約商戶商戶號”可以提供6天內(nèi)防重。
- 預(yù)約提現(xiàn)發(fā)起后,單據(jù)的實際狀態(tài)以查詢接口為準(zhǔn)。
- 若預(yù)約提現(xiàn)發(fā)起成功,預(yù)計會在下個工作日到賬。
- 當(dāng)API返回錯誤碼為SYSTEM_ERROR時,請務(wù)必不要換單重試,使用原單(所有請求參數(shù)保持不變)發(fā)起重試。
- 返回參數(shù)可能會有新增,且順序可能不完全遵循此文檔規(guī)范,如果在解析回包的時候發(fā)生錯誤,請務(wù)必不要換單重試,可以聯(lián)系客服或小助手確認(rèn)提現(xiàn)情況。
- 錯誤碼可能會有新增,如果遇到返回新的錯誤碼,請務(wù)必不要換單重試,可以聯(lián)系客服或小助手確認(rèn)提現(xiàn)情況。
# 接口說明
支持商戶:
【平臺商戶】
請求方式:
【POST】/v3/ecommerce/fund/withdraw
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請設(shè)置為
application/json
- Content-Type 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- sub_mchid 必填 string(32)【二級商戶號】 收付通平臺二級商戶號,由微信支付生成并下發(fā)
- out_request_no 必填 string(32)【商戶預(yù)約提現(xiàn)單號】 商戶預(yù)約提現(xiàn)單號,由商戶自定義生成,必須是字母數(shù)字
- amount 必填 integer【提現(xiàn)金額】 提現(xiàn)金額,單位:分,不能超過8億元
- remark 選填 string(56)【提現(xiàn)備注】 商戶對預(yù)約提現(xiàn)單的備注
- bank_memo 選填 string(32)【銀行附言】 展示在收款銀行系統(tǒng)中的附言,由數(shù)字、字母、漢字組成(能否成功展示依賴銀行系統(tǒng)支持)
- account_type 選填 string【出款賬戶類型】 出款賬戶類型
可選取值:BASIC
: 基本賬戶FEES
: 手續(xù)費賬戶OPERATION
: 運營賬戶
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- sub_mchid 必填 string(32)【二級商戶號】 收付通平臺二級商戶號,由微信支付生成并下發(fā)
- withdraw_id 必填 string(128)【微信支付預(yù)約提現(xiàn)單號】 提交預(yù)約提現(xiàn)申請后,由微信支付返回的申請單號,作為查詢申請狀態(tài)的唯一標(biāo)識
- out_request_no 必填 string(32)【商戶預(yù)約提現(xiàn)單號】 商戶預(yù)約提現(xiàn)單號,由商戶自定義生成,必須是字母數(shù)字
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)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 二級商戶未開啟預(yù)約提現(xiàn)權(quán)限 | 請確認(rèn)電商平臺商戶號和二級商戶商戶號是否存在受理關(guān)系 |
400 | INVALID_REQUEST | 商戶賬戶類型不存在或未開通 | 請確認(rèn)二級商戶賬戶類型有效 |
403 | ACCOUNT_ERROR | 二級商戶未綁卡 | 二級商戶號沒有綁定結(jié)算銀行卡,綁定后重試 |
403 | ACCOUNT_NOT_VERIFIED | 二級商戶下行打款未成功 | 二級商戶號結(jié)算銀行卡信息有誤,修改后重試 |
403 | CONTRACT_NOT_CONFIRMED | 二級商戶未開啟預(yù)約提現(xiàn)權(quán)限 | 二級商戶號預(yù)約提現(xiàn)權(quán)限已關(guān)閉,無法發(fā)起預(yù)約提現(xiàn) |
403 | NO_AUTH | 無接口使用權(quán)限 | 請開通商戶號相關(guān)權(quán)限 |
403 | NOT_ENOUGH | 二級商戶號賬戶可用余額不足 | 二級商戶號賬戶可用余額不足 |
403 | REQUEST_BLOCKED | 二級商戶未開啟預(yù)約提現(xiàn)權(quán)限 | 二級商戶號預(yù)約提現(xiàn)權(quán)限被凍結(jié),無法發(fā)起預(yù)約提現(xiàn) |
404 | ORDER_NOT_EXIST | 預(yù)約提現(xiàn)單號不存在 | 請檢查訂單號是否正確 |
429 | FREQUENCY_LIMITED | 頻率限制 | 請降低頻率后重試 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |