下載賬單API為通用接口,交易/資金賬單都可以通過該接口獲取到對(duì)應(yīng)的賬單。
注意
- 賬單文件的下載地址的有效時(shí)間為30s。
- 強(qiáng)烈建議商戶將實(shí)際賬單文件的哈希值和之前從接口獲取到的哈希值進(jìn)行比對(duì),以確認(rèn)數(shù)據(jù)的完整性。
- 該接口響應(yīng)的信息請(qǐng)求頭中不包含微信接口響應(yīng)的簽名值,因此需要跳過驗(yàn)簽的流程。
- 微信在次日9點(diǎn)啟動(dòng)生成前一天的對(duì)賬單,建議商戶10點(diǎn)后再獲取。
# 接口說明
支持商戶: 【普通服務(wù)商】 【普通商戶】 【電商平臺(tái)】
請(qǐng)求方式: 【GET】
請(qǐng)求URL: 通過申請(qǐng)賬單接口獲取到“download_url”,URL有效期30s
# 請(qǐng)求步驟說明
- 使用申請(qǐng)賬單接口獲取download_url,參考下方申請(qǐng)賬單返回參數(shù)示例。
- 使用微信支付APIv3標(biāo)準(zhǔn)對(duì)download_url進(jìn)行簽名,并發(fā)起請(qǐng)求即可下載賬單文件的數(shù)據(jù)流,參考右側(cè)請(qǐng)求示例。
申請(qǐng)賬單返回參數(shù)示例
1{2 "hash_type": "SHA1",3 "hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",4 "download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"5}
請(qǐng)求示例
1$ curl https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx -H '2Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900009191",3nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",4signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r55wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI61XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al7LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/84nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'
# 返回參數(shù)
# 文件格式說明
賬單文件包括明細(xì)數(shù)據(jù)和匯總數(shù)據(jù)兩部分,每一部分都包含一行表頭和若干行具體數(shù)據(jù)。 明細(xì)數(shù)據(jù)每一行對(duì)應(yīng)所下載賬單的一條具體數(shù)據(jù),同時(shí)明細(xì)數(shù)據(jù)中每一個(gè)字段前都加入了`字符(重音符,為標(biāo)準(zhǔn)鍵盤1左邊鍵的字符),以避免數(shù)據(jù)被Excel按科學(xué)計(jì)數(shù)法處理。如需匯總金額等數(shù)據(jù),可以批量替換掉該字符。 不同類型的賬單文件的明細(xì)數(shù)據(jù)和匯總數(shù)據(jù)的格式是不同的,具體示例如下:
# 分賬賬單樣例
《分賬賬單.xlsx》 (opens new window)
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過 | 請(qǐng)參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請(qǐng)按第一步申請(qǐng)賬單的API指引,重新獲取賬單地址后再請(qǐng)求 |
403 | NO_AUTH | 權(quán)限異常 | 請(qǐng)檢查本次請(qǐng)求的商戶是否與第一步申請(qǐng)賬單API的請(qǐng)求商戶一致 |
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |