最新更新時間：2020.2.18 版本說明
電商服務商按日查詢并下載提現(xiàn)狀態(tài)為異常的提現(xiàn)單，提現(xiàn)異常包括提現(xiàn)失敗和銀行退票。
? 每日09:00開始可以下載前一日的提現(xiàn)異常文件，支持下載90天內提現(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)單。
? 電商服務商查詢的結果包括電商服務商發(fā)起的提現(xiàn)和給電商二級商戶發(fā)起的提現(xiàn)。
? 同一筆提現(xiàn)的相同數據可能出現(xiàn)在不同日期。即提現(xiàn)單A的失敗數據，可能同時出現(xiàn)在1日和3日。
? 歷史數據如果有某一日遺漏，則系統(tǒng)會補入當天的賬單中。例如：今日為2019-11-15日，發(fā)現(xiàn)2019-11-12日某數據遺漏，則該數據會補入2019-11-15日。
適用對象：電商平臺
請求URL：https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/bill-type/{bill_type}
請求方式：GET
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數為路徑參數
query指該參數需在請求URL傳參
body指該參數需在請求JSON傳參
| 參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 賬單類型 | bill_type | string[1,8] | 是 | path
NO_SUCC：提現(xiàn)異常賬單，包括提現(xiàn)失敗和提現(xiàn)退票賬單。 示例值：NO_SUCC |
| 賬單日期 | bill_date | string[1,10] | 是 | query 表示所在日期的提現(xiàn)賬單，格式為yyyy-MM-DD。 例如：2008-01-01日發(fā)起的提現(xiàn)，2008-01-03日銀行返回提現(xiàn)失敗，則該提現(xiàn)數據將出現(xiàn)在bill_date為2008-01-03日的賬單中。 示例值：2019-08-17 |
| 壓縮格式 | tar_type | string[1,10] | 否 | query
不填則默認是數據流 枚舉值： GZIP：返回格式為.gzip的壓縮包賬單 示例值：GZIP |
https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/bill-type/NO_SUCC?bill_date=2019-08-17&tar_type=GZIP
| 參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 哈希類型 | hash_type | string[1,32] | 是 | 從download_url下載的文件的哈希類型，用于校驗文件的完整性。 示例值：SHA1 |
| 哈希值 | hash_value | string[1,1024] | 是 | 從download_url下載的文件的哈希值，用于校驗文件的完整性。 示例值：79bb0f45fc4c42234a918000b2668d689e2bde04 |
| 賬單下載地址 | download_url | string[1,2048] | 是 | 供下一步請求賬單文件的下載地址，該地址30s內有效。 示例值：https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx |
{
"hash_type": "SHA1",
"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
"download_url": "https://xxxx.xxx.xxx"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 403 | NO_AUTH | 當前商戶號沒有使用該接口的權限 | 請確認是否已經開通相關權限 |
| 400 | INVALID_REQUEST | 請求的賬單日期已過期 | 請檢查bill_date，并重新調用 |
| 400 | NO_STATEMENT_EXIST | 請求的賬單文件不存在 | 請檢查當前商戶號請求的微信支付賬戶在指定日期是否有資金操作 |
| 400 | STATEMENT_CREATING | 請求的賬單正在生成中 | 請先檢查當前商戶號的微信支付賬戶在指定日期內是否有資金操作，若有，則在T+1日上午10點后再重新下載 |
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數稍后重新調用 |
| 400 | PARAM_ERROR | 參數錯誤 | 請使用正確的參數重新調用 |