淺析微信支付：下載對賬單和資金賬單

Ethan815 發(fā)布于2019-08-16 13:40 / 844人閱讀

摘要：本文是淺析微信支付系列文章的第九篇，主要講解商戶下載對賬單接口和資金賬單接口的實現(xiàn)和一些注意事項。注意微信側(cè)未成功下單的交易不會出現(xiàn)在對賬單中。

本文是【淺析微信支付】系列文章的第九篇，主要講解商戶下載對賬單接口和資金賬單接口的實現(xiàn)和一些注意事項。

淺析微信支付系列已經(jīng)更新九篇了喲～，沒有看過的朋友們可以看一下哦。

淺析微信支付：申請退款、退款回調(diào)接口、查詢退款

淺析微信支付：查詢訂單和關(guān)閉訂單

淺析微信支付：支付結(jié)果通知

在商戶平臺中，商家也可以下載資金對賬單，歷史的交易清單，具體位置：商戶平臺 -> 交易中心 -> 賬單管理。

如果要查看實時的流水記錄，可以在微信APP中搜索小程序 微信支付商戶助手 即可查看。

1、下載對賬單

以下為微信官方的下載對賬單文檔：

https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_6

根據(jù)接口下載歷史的交易賬單，數(shù)據(jù)以文本表格的方式返回，第一行為表頭，后面各行為對應(yīng)的字段內(nèi)容，字段內(nèi)容跟查詢訂單或退款結(jié)果一致，具體字段說明可查閱相應(yīng)接口。

此接口方便商家在自身系統(tǒng)中下載，不依賴于微信商戶平臺。

1.1. 應(yīng)用場景

商戶可以通過該接口下載歷史交易清單。比如掉單、系統(tǒng)錯誤等導(dǎo)致商戶側(cè)和微信側(cè)數(shù)據(jù)不一致，通過對賬單核對后可校正支付狀態(tài)。

注意：
1、微信側(cè)未成功下單的交易不會出現(xiàn)在對賬單中。支付成功后撤銷的交易會出現(xiàn)在對賬單中，跟原支付單訂單號一致；
2、微信在次日9點啟動生成前一天的對賬單，建議商戶10點后再獲??；
3、對賬單中涉及金額的字段單位為“元”。
4、對賬單接口只能下載三個月以內(nèi)的賬單。
5、對賬單是以商戶號緯度來生成的，如一個商戶號與多個appid有綁定關(guān)系，則使用其中任何一個appid都可以請求下載對賬單。對賬單中的appid取自交易時候提交的appid，與請求下載對賬單時使用的appid無關(guān)。

1.2. 接口鏈接

https://api.mch.weixin.qq.com/pay/downloadbill

1.3. 是否需要證書

不需要

1.4. 調(diào)用接口

調(diào)用參數(shù)：

字段名稱	變量名	必填	類型	描述
賬單日期	bill_date	是	String(8)	下載對賬單的日期，格式：20140603
賬單類型	bill_type	是	String(8)	ALL，返回當(dāng)日所有訂單信息，默認值SUCCESS，返回當(dāng)日成功支付的訂單REFUND，返回當(dāng)日退款訂單RECHARGE_REFUND，返回當(dāng)日充值退款訂單
壓縮賬單	tar_type	否	String(8)	非必傳參數(shù)，固定值：GZIP，返回格式為.gzip的壓縮包賬單。不傳則默認為數(shù)據(jù)流形式。

以下為調(diào)用示例代碼：

/**
 * 對賬單下載
 */
private void doDownloadBill() {
    HashMap data = new HashMap();
    data.put("bill_date", "20161102");
    data.put("bill_type", "ALL");
    try {
        Map r = wxpay.downloadBill(data);
        System.out.println(r);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

1.5. 返回結(jié)果

成功時，數(shù)據(jù)以文本表格的方式返回，第一行為表頭，后面各行為對應(yīng)的字段內(nèi)容，字段內(nèi)容跟查詢訂單或退款結(jié)果一致，具體字段說明可查閱相應(yīng)接口。

第一行為表頭，根據(jù)請求下載的對賬單類型不同而不同(由bill_type決定),目前有：

當(dāng)日所有訂單
交易時間,公眾賬號ID,商戶號,子商戶號,設(shè)備號,微信訂單號,商戶訂單號,用戶標(biāo)識,交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,微信退款單號,商戶退款單號,退款金額,代金券或立減優(yōu)惠退款金額，退款類型，退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費,費率

當(dāng)日成功支付的訂單
交易時間,公眾賬號ID,商戶號,子商戶號,設(shè)備號,微信訂單號,商戶訂單號,用戶標(biāo)識,交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,商品名稱,商戶數(shù)據(jù)包,手續(xù)費,費率

當(dāng)日退款的訂單
交易時間,公眾賬號ID,商戶號,子商戶號,設(shè)備號,微信訂單號,商戶訂單號,用戶標(biāo)識,交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,退款申請時間,退款成功時間,微信退款單號,商戶退款單號,退款金額,代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費,費率

從第二行起，為數(shù)據(jù)記錄，各參數(shù)以逗號分隔，參數(shù)前增加`符號，為標(biāo)準鍵盤1左邊鍵的字符，字段順序與表頭一致。

倒數(shù)第二行為訂單統(tǒng)計標(biāo)題，最后一行為統(tǒng)計數(shù)據(jù)

總交易單數(shù)，總交易額，總退款金額，總代金券或立減優(yōu)惠退款金額，手續(xù)費總金額

舉例如下：

交易時間,公眾賬號ID,商戶號,子商戶號,設(shè)備號,微信訂單號,商戶訂單號,用戶標(biāo)識,交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,微信退款單號,商戶退款單號,退款金額,代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費,費率
`2014-11-1016：33：45,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1001690740201411100005734289,`1415640626,`085e9858e3ba5186aafcbaed1,`MICROPAY,`SUCCESS,`CFT,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被掃支付測試,`訂單額外描述,`0,`0.60%
`2014-11-1016：46：14,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1002780740201411100005729794,`1415635270,`085e9858e90ca40c0b5aee463,`MICROPAY,`SUCCESS,`CFT,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被掃支付測試,`訂單額外描述,`0,`0.60%
總交易單數(shù),總交易額,總退款金額,總代金券或立減優(yōu)惠退款金額,手續(xù)費總金額
`2,`0.02,`0.0,`0.0,`0

2、下載資金賬單接口

以下為微信官方的下載資金賬單文檔：

https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_18&index=7

2.1. 應(yīng)用場景

商戶可以通過該接口下載自2017年6月1日起的歷史資金流水賬單。

說明：

1、資金賬單中的數(shù)據(jù)反映的是商戶微信賬戶資金變動情況；
2、當(dāng)日賬單在次日上午9點開始生成，建議商戶在上午10點以后獲??；
3、資金賬單中涉及金額的字段單位為“元”。

2.2. 接口鏈接

https://api.mch.weixin.qq.com/pay/downloadfundflow

2.3. 是否需要證書

請求需要雙向證書

2.4. 調(diào)用接口

調(diào)用參數(shù)：

字段名稱	變量名	必填	類型	描述
簽名類型	sign_type	否	String(32)	簽名類型，目前僅支持HMAC-SHA256
資金賬單日期	bill_date	是	String(8)	下載對賬單的日期，格式：20140603
資金賬戶類型	account_type	是	String(8)	賬單的資金來源賬戶：Basic 基本賬戶、Operation 運營賬戶、Fees 手續(xù)費賬戶
壓縮賬單	tar_type	否	String(8)	非必傳參數(shù)，固定值：GZIP，返回格式為.gzip的壓縮包賬單。不傳則默認為數(shù)據(jù)流形式。

此接口不常用，推薦使用微信商戶平臺下載。具體的實現(xiàn)請參考上面的官方文檔。

結(jié)語

以上為下載對賬單、資金賬單相關(guān)的解釋和源碼，特別需要注意的是下載資金賬單接口需要特定的簽名類型HMAC-SHA256，小伙伴們一定要注意哦，具體的源碼可以看作者的github，里面對每個方法有詳細的注釋。

預(yù)告：下一篇文章 如何使用沙箱環(huán)境測試，敬請期待?。?！

?如果想要提前一覽源碼的小伙伴，可以先看看我的 github，地址如下：
?
?`
?https://github.com/YClimb/wxp...
?`

關(guān)注作者微信公眾號，點擊下方討論群，掃碼即可加入微信支付討論群與小伙伴一起探討哦～

到此本文就結(jié)束了，關(guān)注公眾號查看更多推送！?。?/p>

云服務(wù)器 GPU云服務(wù)器 java微信對賬單支付寶信用卡賬單導(dǎo)入 java手機對賬單結(jié)清賬單

文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請注明本文地址：http://systransis.cn/yun/72135.html

發(fā)表評論

登陸后可評論

0條評論

Ethan815

男|高級講師

我要關(guān)注我要私信

TA的文章

Python：這是一個樸實無華的爬蟲教程，就是有點養(yǎng)眼

閱讀 2260·2021-11-22 09:34
云主機怎么遠程連接-云主機怎么遠程操作？

閱讀 2035·2021-09-22 15:22
css布局：多列等高布局

閱讀 2032·2019-08-29 15:05
數(shù)組扁平化（將多維數(shù)組降維成一維數(shù)組）

閱讀 2122·2019-08-26 10:43
JS函數(shù)防抖動

閱讀 3420·2019-08-26 10:26
初學(xué)Vue(三) -- 前后端數(shù)據(jù)交互

閱讀 902·2019-08-23 18:29
JavaScript大師必須掌握的12個知識點

閱讀 3532·2019-08-23 16:42
vue編寫的移動端條件搜索條組件

閱讀 2007·2019-08-23 14:46

成人国产在线小视频_日韩寡妇人妻调教在线播放_色成人www永久在线观看_2018国产精品久久_亚洲欧美高清在线30p_亚洲少妇综合一区_黄色在线播放国产_亚洲另类技巧小说校园_国产主播xx日韩_a级毛片在线免费

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

淺析微信支付：下載對賬單和資金賬單

相關(guān)文章

淺析微信支付：如何使用沙箱環(huán)境測試

淺析微信支付：前篇大綱

淺析微信支付：支付驗收示例和驗收指引

淺析微信支付：(余額提現(xiàn))企業(yè)付款到微信用戶零錢或銀行卡賬戶

淺析微信支付：開通免充值產(chǎn)品功能及如何進行接口升級指引

發(fā)表評論

0條評論

Ethan815

男|高級講師

TA的文章

Python：這是一個樸實無華的爬蟲教程，就是有點養(yǎng)眼

云主機怎么遠程連接-云主機怎么遠程操作？

css布局：多列等高布局

數(shù)組扁平化（將多維數(shù)組降維成一維數(shù)組）

JS函數(shù)防抖動

初學(xué)Vue(三) -- 前后端數(shù)據(jù)交互

JavaScript大師必須掌握的12個知識點

vue編寫的移動端條件搜索條組件

最新活動

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

淺析微信支付：下載對賬單和資金賬單

相關(guān)文章

發(fā)表評論

0條評論

男|高級講師

TA的文章

最新活動

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！