最新更新時(shí)間：2019.09.16 版本說(shuō)明
下載賬單API為通用接口，交易/資金賬單都可以通過(guò)該接口獲取到對(duì)應(yīng)的賬單。
? 賬單文件的下載地址的有效時(shí)間為30s。
? 強(qiáng)烈建議商戶(hù)將實(shí)際賬單文件的哈希值和之前從接口獲取到的哈希值進(jìn)行比對(duì)，以確認(rèn)數(shù)據(jù)的完整性。
適用對(duì)象：電商平臺(tái) 服務(wù)商 直連商戶(hù)
請(qǐng)求URL：通過(guò)申請(qǐng)賬單接口獲取到“download_url”，URL有效期30s
請(qǐng)求方式：GET
前置條件：調(diào)用申請(qǐng)賬單接口并獲取到“download_url”
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
當(dāng)獲取到賬單文件資源的下載地址信息后，如：
{
"hash_type": "SHA1",
"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
"download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"
}可以通過(guò)微信支付API v3標(biāo)準(zhǔn)對(duì)download_url進(jìn)行簽名，并發(fā)起請(qǐng)求，即可下載到賬單文件的數(shù)據(jù)流。
$?curl?https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx?-H?'
Authorization:WECHATPAY2-SHA256-RSA2048mchid="1900009191",
nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",
signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5
wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI
1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al
LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/
4nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'
賬單文件包括明細(xì)數(shù)據(jù)和匯總數(shù)據(jù)兩部分，每一部分都包含一行表頭和若干行具體數(shù)據(jù)。 明細(xì)數(shù)據(jù)每一行對(duì)應(yīng)所下載賬單的一條具體數(shù)據(jù)，同時(shí)明細(xì)數(shù)據(jù)中每一個(gè)字段前都加入了`字符（重音符，為標(biāo)準(zhǔn)鍵盤(pán)1左邊鍵的字符），以避免數(shù)據(jù)被Excel按科學(xué)計(jì)數(shù)法處理。如需匯總金額等數(shù)據(jù)，可以批量替換掉該字符。 不同類(lèi)型的賬單文件的明細(xì)數(shù)據(jù)和匯總數(shù)據(jù)的格式是不同的，具體示例如下：
交易賬單
《ALL.xlsx》、《REFUND.xlsx》、《SUCCESS.xlsx》
資金流水賬單
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
| 400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請(qǐng)檢查bill_date，并重新調(diào)用 |
| 參數(shù)錯(cuò)誤 | 請(qǐng)檢查sub_mchid，并重新調(diào)用 | ||
| 403 | NO_AUTH | 權(quán)限異常（無(wú)該子商戶(hù)賬單的權(quán)限） | 請(qǐng)使用正確的sub_mchid再重新調(diào)用 |
| 權(quán)限異常，小微商戶(hù)不單獨(dú)提供對(duì)賬單下載 | 可以不傳sub_mch_id，以獲取服務(wù)商下全量電商二級(jí)商戶(hù)（包括小微商戶(hù)和非小微商戶(hù)）的對(duì)賬單 | ||
| 400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請(qǐng)檢查當(dāng)前商戶(hù)號(hào)是否在指定日期有交易或退款發(fā)生 |
| 400 | STATEMENT_CREATING | 賬單生成中 | 請(qǐng)先檢查當(dāng)前商戶(hù)號(hào)在指定日期內(nèi)是否有成功的交易或退款，若有，則在T+1日上午8點(diǎn)后再重新下載 |
| 400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請(qǐng)檢查當(dāng)前商戶(hù)號(hào)請(qǐng)求的微信支付賬戶(hù)在指定日期是否有資金操作 |
| 400 | STATEMENT_CREATING | 賬單生成中 | 請(qǐng)先檢查當(dāng)前商戶(hù)號(hào)的微信支付賬戶(hù)在指定日期內(nèi)是否有資金操作，若有，則在T+1日上午10點(diǎn)后再重新下載 |
| 400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請(qǐng)按第一步申請(qǐng)賬單的API指引，重新獲取賬單地址后再請(qǐng)求 |
| 403 | NO_AUTH | 權(quán)限異常 | 請(qǐng)檢查本次請(qǐng)求的商戶(hù)是否與第一步申請(qǐng)賬單API的請(qǐng)求商戶(hù)一致 |