收付通平臺按日查詢并下載提現(xiàn)狀態(tài)為異常的提現(xiàn)單,提現(xiàn)異常包括提現(xiàn)失敗和銀行退票。
注意:
- 每日09:00開始可以下載前一日的提現(xiàn)異常文件,支持下載90天內(nèi)提現(xiàn)狀態(tài)變?yōu)樘岈F(xiàn)異常的提現(xiàn)單文件。
- 日期(date)字段為提現(xiàn)狀態(tài)變?yōu)樘岈F(xiàn)異常的日期。建議輸入日期為昨日,每天定時(早上9點后)查詢昨日是否有狀態(tài)為異常的提現(xiàn)單。
- 收付通平臺查詢的結(jié)果包括收付通平臺發(fā)起的提現(xiàn)和給二級商戶發(fā)起的提現(xiàn)。
- 同一筆提現(xiàn)的相同數(shù)據(jù)可能出現(xiàn)在不同日期。即提現(xiàn)單A的失敗數(shù)據(jù),可能同時出現(xiàn)在1日和3日。
- 歷史數(shù)據(jù)如果有某一日遺漏,則系統(tǒng)會補入當天的賬單中。例如:今日為2019-11-15日,發(fā)現(xiàn)2019-11-12日某數(shù)據(jù)遺漏,則該數(shù)據(jù)會補入2019-11-15日。
# 接口說明
支持商戶:
【平臺商戶】
請求方式:
【GET】/v3/merchant/fund/withdraw/bill-type/{bill_type}
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設置為
application/json
Header HTTP頭參數(shù)
- bill_type 必填 string【賬單類型】 賬單類型
可選取值:NO_SUCC
: 包括提現(xiàn)失敗和提現(xiàn)退票賬單
Path 路徑參數(shù)
- bill_date 必填 string(10)【賬單日期】 表示所在日期的提現(xiàn)賬單,格式Y(jié)YYY-MM-DD。例如:2008-01-01日發(fā)起的提現(xiàn),2008-01-03日銀行返回提現(xiàn)失敗,則該提現(xiàn)數(shù)據(jù)將出現(xiàn)在bill_date為2008-01-03日的賬單中
- tar_type 選填 string【壓縮格式】 壓縮格式
可選取值:GZIP
: 返回格式為.gzip的壓縮包賬單
Query 查詢參數(shù)
請求示例
GET
# 應答參數(shù)
- hash_type 必填 string【哈希類型】 哈希類型
可選取值:SHA1
:
- hash_value 必填 string【哈希值】 從download_url下載的文件的哈希值,用于校驗文件的完整性
- download_url 必填 string【下載地址】 下載地址,5分鐘內(nèi)有效
200OK
應答示例
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è)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 請求的賬單日期已過期 | 請檢查bill_date,并重新調(diào)用 |
400 | NO_STATEMENT_EXIST | 請求的賬單文件不存在 | 請檢查當前商戶號請求的微信支付賬戶在指定日期是否有資金操作 |
400 | STATEMENT_CREATING | 請求的賬單正在生成中 | 請先檢查當前商戶號的微信支付賬戶在指定日期內(nèi)是否有資金操作,若有,則在T+1日上午10點后再重新下載 |
403 | NO_AUTH | 當前商戶號沒有使用該接口的權(quán)限 | 請確認是否已經(jīng)開通相關權(quán)限 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |