本接口適用于下載交易賬單和資金賬單。

# 接口說明

支持商戶： 【普通服務商】 【普通商戶】

請求方式： 【GET】

請求URL： 調用申請賬單接口，返回參數“download_url”對應的URL

# 請求步驟說明

1{
2 "hash_type": "SHA1",
3 "hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
4 "download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"
5}

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+nGzX3hfZg6r5
5wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI
61XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al
7LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/
84nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'

# 返回信息

# 1. 交易賬單

# 1.1. 交易賬單介紹

微信支付每天提供前一天的交易賬單文件，用于商戶核對訂單、退款、營銷、手續(xù)費等信息。賬單內的數據包括：

（1）當天支付成功的訂單，下單成功但用戶未支付的訂單不會出賬。

（2）當天發(fā)起退款成功的退款單，退款發(fā)起成功就會出賬，出賬后退款狀態(tài)不會更新。如果需要獲取最新退款狀態(tài)，請使用查詢單筆退款API查詢。

微信支付提供了3份不同類型的賬單文件：

• ALL，包含了當天支付成功的訂單和發(fā)起成功的退款單
• SUCCESS，僅包含支付成功的訂單
• REFUND，僅包含發(fā)起成功的退款單

# 1.2. 交易賬單文件格式

交易賬單文件內包含：明細數據表頭、明細數據內容、匯總數據表頭、匯總數據四個部分，每個字段使用英文逗號 , 間隔，明細數據內容每個字段前會增加1個字符 ` 用于避免獲取的內容被excel展示為科學計數法的格式、丟失數據細節(jié)。3份不同類型的賬單文件字段內容略有差異。

# 1.2.1. ALL類型賬單文件具體字段

# 1.2.2. SUCCESS和REFUND賬單

SUCCESS和REFUND賬單的字段和ALL賬單內略有不同：

SUCCESS賬單字段：交易時間,公眾賬號ID,商戶號,特約商戶號,設備號,微信訂單號,商戶訂單號,用戶標識,交易類型,交易狀態(tài),付款銀行,貨幣種類,應結訂單金額,代金券金額,商品名稱,商戶數據包,手續(xù)費,費率,訂單金額,費率備注

REFUND賬單字段：交易時間,公眾賬號ID,商戶號,特約商戶號,設備號,微信訂單號,商戶訂單號,用戶標識,交易類型,交易狀態(tài),付款銀行,貨幣種類,應結訂單金額,代金券金額,退款申請時間,退款成功時間,微信退款單號,商戶退款單號,退款金額,充值券退款金額,退款類型,退款狀態(tài),商品名稱,商戶數據包,手續(xù)費,費率,訂單金額,申請退款金額,費率備注

# 1.2.3. 特殊字符轉義

賬單處理過程會對商品名稱、商戶數據包、設備號等商戶自定義字段進行特殊字符轉義，具體規(guī)則包括：

# 1.2.4. 補充說明

少部分商戶目前的賬單格式停留在歷史早期版本，具體表現為：沒有應結算訂單金額字段、對應的是總金額字段，沒有代金券金額字段、對應的是企業(yè)紅包金額字段。如需調整為最新格式的賬單，可以通過在產品中心中開通免充值優(yōu)惠券功能，次日開始的賬單格式即會完成變更。

# 1.3. 賬單樣例

• 《ALL》 (opens new window)
• 《REFUND》 (opens new window)
• 《SUCCESS》 (opens new window)

# 2. 資金賬單

# 2.1. 賬單樣例

• 《資金賬單》 (opens new window)

# 錯誤碼

# 公共錯誤碼

# 業(yè)務錯誤碼