接口說明

適用對象： 直連商戶

請求URL：通過申請賬單接口獲取到“download_url”，URL有效期30s

請求方式：GET

前置條件：調(diào)用申請賬單接口并獲取到“download_url”

請求參數(shù)

當(dāng)獲取到賬單文件資源的下載地址信息后，如：

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

可以通過微信支付API v3標(biāo)準(zhǔn)對download_url進(jìn)行簽名，并發(fā)起請求，即可下載到賬單文件的數(shù)據(jù)流。

$?curl?https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx?-H?'
Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900009191",
nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",
signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5
wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI
1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al
LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/
4nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'

返回參數(shù)

交易賬單格式說明

1. 交易賬單介紹

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

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

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

2. 交易賬單的文件格式

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

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

2.2. SUCCESS和REFUND賬單

SUCCESS和REFUND賬單的字段和ALL賬單內(nèi)略有不同

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

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

2.3. 特殊字符轉(zhuǎn)義

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

'轉(zhuǎn)換成為\'

"轉(zhuǎn)換成為\"

`轉(zhuǎn)換成為\`

,轉(zhuǎn)換成為\ （\+空格）

\r轉(zhuǎn)換成為\\r

\t轉(zhuǎn)換成為\\t

2.4. 補(bǔ)充說明

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

3. 賬單樣例

《ALL.xlsx》、《REFUND.xlsx》、《SUCCESS.xlsx》

資金流水賬單

《資金賬單.xlsx》

錯誤碼公共錯誤碼