最新更新時間:2020.09.28 版本說明
電商平臺通過該接口查詢其提現(xiàn)結(jié)果,該查詢服務(wù)提供兩種查詢方式(兩種查詢方式返回結(jié)果一致):
方式1:微信支付提現(xiàn)單號查詢;
方式2:商戶提現(xiàn)單號查詢。
1. 本接口可查詢90日內(nèi)發(fā)起的提現(xiàn)單據(jù),發(fā)起時間以微信支付提現(xiàn)單創(chuàng)建時間為準(zhǔn)。
2. 若查到提現(xiàn)單狀態(tài)是SUCCESS,并不代表銀行入賬一定成功,部分情況下可能發(fā)生銀行退票(銀行預(yù)計在7個工作日內(nèi)處理退票)。
3. 若查詢到提現(xiàn)單狀態(tài)是REFUND,代表提現(xiàn)退票,此時應(yīng)檢查登記的賬戶信息是否有誤,退票后資金會自動退回發(fā)起時的商戶賬戶內(nèi)。
4. 若查詢到提現(xiàn)單狀態(tài)是INIT,請使用原單(所有請求參數(shù)保持不變)發(fā)起重試。
適用對象:電商平臺
請求URL:https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/withdraw-id/{withdraw_id}
請求方式:GET
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付提現(xiàn)單號 | withdraw_id | string[1, 128] | 是 | path電商平臺提交二級商戶提現(xiàn)申請后,由微信支付返回的申請單號,作為查詢申請狀態(tài)的唯一標(biāo)識。 示例值:12321937198237912739132791732123 |
https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/withdraw-id/12321937198237912739132791732123
適用對象:電商平臺
請求URL:https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/out-request-no/{out_request_no}
請求方式:GET
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
商戶提現(xiàn)單號 | out_request_no | string[1, 32] | 是 | path商戶提現(xiàn)單號,由商戶自定義生成。 示例值:20190611222222222200000000012122 |
https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/out-request-no/20190611222222222200000000012122
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
提現(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 |
微信支付提現(xiàn)單號 | withdraw_id | string[1, 128] | 是 | 電商平臺提交提現(xiàn)申請后,由微信支付返回的申請單號,作為查詢申請狀態(tài)的唯一標(biāo)識。 示例值:12321937198237912739132791732912793127931279317929791239112123 |
商戶提現(xiàn)單號 | out_request_no | string[1, 32] | 是 | 商戶提現(xiàn)單號,由商戶自定義生成。 示例值:20190611222222222200000000012122 |
提現(xiàn)金額 | amount | int | 是 | 單位:分 示例值:1 |
發(fā)起提現(xiàn)時間 | create_time | string[29, 29] | 是 | 遵循rfc3339標(biāo)準(zhǔn)格式,格式為yyyy-MM-DDTHH:mm:ss:sss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,HH:mm:ss:sss表示時分秒毫秒,TIMEZONE表示時區(qū)(+08:00表示東八區(qū)時間,領(lǐng)先UTC 8小時,即北京時間)。例如:2015-05-20T13:29:35+08:00表示,北京時間2015年5月20日13點29分35秒。 示例值:2015-05-20T13:29:35.120+08:00 |
提現(xiàn)狀態(tài)更新時間 | update_time | string[29, 29] | 是 | 遵循rfc3339標(biāo)準(zhǔn)格式,格式為yyyy-MM-DDTHH:mm:ss:sss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,HH:mm:ss:sss表示時分秒毫秒,TIMEZONE表示時區(qū)(+08:00表示東八區(qū)時間,領(lǐng)先UTC 8小時,即北京時間)。例如:2015-05-20T13:29:35+08:00表示,北京時間2015年5月20日13點29分35秒。 示例值:2015-05-20T13:29:35.120+08:00 |
失敗原因 | reason | string[1, 255] | 是 | 僅在提現(xiàn)失敗、退票、關(guān)單時有值 示例值:卡號錯誤 |
提現(xiàn)備注 | remark | string[1, 56] | 是 | 商戶對提現(xiàn)單的備注,若發(fā)起提現(xiàn)時未傳入相應(yīng)值或輸入不合法,則該值為空 示例值:交易提現(xiàn) |
銀行附言 | bank_memo | string[1, 32] | 是 | 展示在收款銀行系統(tǒng)中的附言,由數(shù)字、字母、漢字組成(能否成功展示依賴銀行系統(tǒng)支持)。若發(fā)起提現(xiàn)時未傳入相應(yīng)值或輸入不合法,則該值為空 示例值:微信提現(xiàn) |
出款賬戶類型 | account_type | string[1,16] | 是 | BASIC:基本戶 OPERATION:運(yùn)營賬戶 FEES:手續(xù)費(fèi)賬戶 示例值:BASIC |
提現(xiàn)失敗解決方案 | solution | string[1, 255] | 是 | 僅在提現(xiàn)失敗、退票、關(guān)單時有值 示例值:請修改結(jié)算銀行卡信息 |
{
"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": "卡號錯誤",
"remark": "交易提現(xiàn)",
"bank_memo": "微信提現(xiàn)",
"account_type": "BASIC",
"solution": "請修改結(jié)算銀行卡信息"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
403 | REQUEST_BLOCKED | 二級商戶未開啟手動提現(xiàn)權(quán)限 | 二級商戶號提現(xiàn)權(quán)限被凍結(jié),無法發(fā)起提現(xiàn) |
400 | PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調(diào)用 |
400 | PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調(diào)用,電商平臺提交相同商戶單號的請求但參數(shù)和歷史提交的參數(shù)不一致 |
404 | ORDER_NOT_EXIST | 提現(xiàn)單號不存在 | 請檢查訂單號是否正確 |
403 | NOT_ENOUGH | 二級商戶號賬戶可用余額不足 | 二級商戶號賬戶可用余額不足 |
403 | NO_AUTH | 無接口使用權(quán)限 | 請開通商戶號相關(guān)權(quán)限 |
400 | INVALID_REQUEST | 二級商戶未開啟手動提現(xiàn)權(quán)限 | 請確認(rèn)電商平臺商戶號和二級商戶商戶號是否存在受理關(guān)系 |
429 | FREQUENCY_LIMITED | 頻率限制 | 請降低頻率后重試 |
403 | CONTRACT_NOT_CONFIRM | 二級商戶未開啟手動提現(xiàn)權(quán)限 | 二級商戶號提現(xiàn)權(quán)限已關(guān)閉,無法發(fā)起提現(xiàn) |
403 | ACCOUNT_NOT_VERIFIED | 二級商戶下行打款未成功 | 二級商戶號結(jié)算銀行卡信息有誤,修改后重試 |
403 | ACCOUNT_ERROR | 二級商戶未綁卡 | 二級商戶號沒有綁定結(jié)算銀行卡,綁定后重試 |