接口說(shuō)明

適用對(duì)象：服務(wù)商 電商平臺(tái)

請(qǐng)求URL：通過(guò)申請(qǐng)賬單接口獲取到“download_url”，URL有效期30s

請(qǐng)求方式：GET

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

請(qǐng)求參數(shù)

當(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-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ù)

交易賬單格式說(shuō)明

1. 交易賬單介紹

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

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

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

2. 交易賬單的文件格式

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

2.1. ALL類(lèi)型賬單文件具體字段

2.2. SUCCESS和REFUND賬單

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

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

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

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

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

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

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

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

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

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

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

2.4. 補(bǔ)充說(shuō)明

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

3. 賬單樣例

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

資金流水賬單

《資金賬單.xlsx》

錯(cuò)誤碼公共錯(cuò)誤碼