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