本文是【淺析微信支付】系列文章的第九篇拱烁，主要講解商戶下載對(duì)賬單接口和資金賬單接口的實(shí)現(xiàn)和一些注意事項(xiàng)实愚。
淺析微信支付系列已經(jīng)更新九篇了喲～噪径，沒(méi)有看過(guò)的朋友們可以看一下哦换帜。
淺析微信支付：申請(qǐng)退款、退款回調(diào)接口烁落、查詢退款
在商戶平臺(tái)中乘粒，商家也可以下載資金對(duì)賬單，歷史的交易清單伤塌，具體位置：商戶平臺(tái) -> 交易中心 -> 賬單管理。
如果要查看實(shí)時(shí)的流水記錄轧铁，可以在微信APP中搜索小程序 微信支付商戶助手 即可查看每聪。
1、下載對(duì)賬單
以下為微信官方的下載對(duì)賬單文檔：
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_6
根據(jù)接口下載歷史的交易賬單齿风，數(shù)據(jù)以文本表格的方式返回药薯，第一行為表頭，后面各行為對(duì)應(yīng)的字段內(nèi)容救斑，字段內(nèi)容跟查詢訂單或退款結(jié)果一致童本，具體字段說(shuō)明可查閱相應(yīng)接口。
此接口方便商家在自身系統(tǒng)中下載脸候，不依賴于微信商戶平臺(tái)穷娱。
1.1. 應(yīng)用場(chǎng)景
商戶可以通過(guò)該接口下載歷史交易清單绑蔫。比如掉單、系統(tǒng)錯(cuò)誤等導(dǎo)致商戶側(cè)和微信側(cè)數(shù)據(jù)不一致泵额，通過(guò)對(duì)賬單核對(duì)后可校正支付狀態(tài)配深。
注意：
1、微信側(cè)未成功下單的交易不會(huì)出現(xiàn)在對(duì)賬單中嫁盲。支付成功后撤銷的交易會(huì)出現(xiàn)在對(duì)賬單中篓叶，跟原支付單訂單號(hào)一致；
2羞秤、微信在次日9點(diǎn)啟動(dòng)生成前一天的對(duì)賬單缸托，建議商戶10點(diǎn)后再獲取瘾蛋；
3俐镐、對(duì)賬單中涉及金額的字段單位為“元”。
4瘦黑、對(duì)賬單接口只能下載三個(gè)月以內(nèi)的賬單京革。
5、對(duì)賬單是以商戶號(hào)緯度來(lái)生成的幸斥，如一個(gè)商戶號(hào)與多個(gè)appid有綁定關(guān)系匹摇，則使用其中任何一個(gè)appid都可以請(qǐng)求下載對(duì)賬單。對(duì)賬單中的appid取自交易時(shí)候提交的appid甲葬，與請(qǐng)求下載對(duì)賬單時(shí)使用的appid無(wú)關(guān)廊勃。
1.2. 接口鏈接
https://api.mch.weixin.qq.com/pay/downloadbill
1.3. 是否需要證書(shū)
不需要
1.4. 調(diào)用接口
調(diào)用參數(shù)：
| 字段名稱 | 變量名 | 必填 | 類型 | 描述 |
|---|---|---|---|---|
| 賬單日期 | bill_date | 是 | String(8) | 下載對(duì)賬單的日期，格式：20140603 |
| 賬單類型 | bill_type | 是 | String(8) | ALL经窖，返回當(dāng)日所有訂單信息坡垫，默認(rèn)值SUCCESS，返回當(dāng)日成功支付的訂單REFUND画侣，返回當(dāng)日退款訂單RECHARGE_REFUND冰悠，返回當(dāng)日充值退款訂單 |
| 壓縮賬單 | tar_type | 否 | String(8) | 非必傳參數(shù)，固定值：GZIP配乱，返回格式為.gzip的壓縮包賬單溉卓。不傳則默認(rèn)為數(shù)據(jù)流形式。 |
以下為調(diào)用示例代碼：
/**
* 對(duì)賬單下載
*/
private void doDownloadBill() {
HashMap<String, String> data = new HashMap<String, String>();
data.put("bill_date", "20161102");
data.put("bill_type", "ALL");
try {
Map<String, String> r = wxpay.downloadBill(data);
System.out.println(r);
} catch (Exception e) {
e.printStackTrace();
}
}
1.5. 返回結(jié)果
成功時(shí)搬泥，數(shù)據(jù)以文本表格的方式返回桑寨，第一行為表頭，后面各行為對(duì)應(yīng)的字段內(nèi)容，字段內(nèi)容跟查詢訂單或退款結(jié)果一致，具體字段說(shuō)明可查閱相應(yīng)接口本缠。
第一行為表頭，根據(jù)請(qǐng)求下載的對(duì)賬單類型不同而不同(由bill_type決定),目前有：
當(dāng)日所有訂單
交易時(shí)間,公眾賬號(hào)ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,微信退款單號(hào),商戶退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額沙咏，退款類型辨图，退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率
當(dāng)日成功支付的訂單
交易時(shí)間,公眾賬號(hào)ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率
當(dāng)日退款的訂單
交易時(shí)間,公眾賬號(hào)ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,退款申請(qǐng)時(shí)間,退款成功時(shí)間,微信退款單號(hào),商戶退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率
從第二行起，為數(shù)據(jù)記錄芭碍，各參數(shù)以逗號(hào)分隔徒役，參數(shù)前增加`符號(hào)，為標(biāo)準(zhǔn)鍵盤(pán)1左邊鍵的字符窖壕，字段順序與表頭一致忧勿。
倒數(shù)第二行為訂單統(tǒng)計(jì)標(biāo)題，最后一行為統(tǒng)計(jì)數(shù)據(jù)
總交易單數(shù)瞻讽，總交易額鸳吸，總退款金額，總代金券或立減優(yōu)惠退款金額速勇，手續(xù)費(fèi)總金額
舉例如下：
交易時(shí)間,公眾賬號(hào)ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,貨幣種類,總金額,代金券或立減優(yōu)惠金額,微信退款單號(hào),商戶退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額,退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率
`2014-11-1016：33：45,`wx2421b1c4370ec43b,`10000100,`0,`1000,`1001690740201411100005734289,`1415640626,`085e9858e3ba5186aafcbaed1,`MICROPAY,`SUCCESS,`CFT,`CNY,`0.01,`0.0,`0,`0,`0,`0,`,`,`被掃支付測(cè)試,`訂單額外描述,`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,`,`,`被掃支付測(cè)試,`訂單額外描述,`0,`0.60%
總交易單數(shù),總交易額,總退款金額,總代金券或立減優(yōu)惠退款金額,手續(xù)費(fèi)總金額
`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)用場(chǎng)景
商戶可以通過(guò)該接口下載自2017年6月1日起 的歷史資金流水賬單。
說(shuō)明：
1烦磁、資金賬單中的數(shù)據(jù)反映的是商戶微信賬戶資金變動(dòng)情況养匈；
2、當(dāng)日賬單在次日上午9點(diǎn)開(kāi)始生成都伪，建議商戶在上午10點(diǎn)以后獲扰缓酢；
3陨晶、資金賬單中涉及金額的字段單位為“元”猬仁。
2.2. 接口鏈接
https://api.mch.weixin.qq.com/pay/downloadfundflow
2.3. 是否需要證書(shū)
請(qǐng)求需要雙向證書(shū)
2.4. 調(diào)用接口
調(diào)用參數(shù)：
| 字段名稱 | 變量名 | 必填 | 類型 | 描述 |
|---|---|---|---|---|
| 簽名類型 | sign_type | 否 | String(32) | 簽名類型，目前僅支持HMAC-SHA256 |
| 資金賬單日期 | bill_date | 是 | String(8) | 下載對(duì)賬單的日期先誉，格式：20140603 |
| 資金賬戶類型 | account_type | 是 | String(8) | 賬單的資金來(lái)源賬戶：Basic 基本賬戶湿刽、Operation 運(yùn)營(yíng)賬戶、Fees 手續(xù)費(fèi)賬戶 |
| 壓縮賬單 | tar_type | 否 | String(8) | 非必傳參數(shù)褐耳，固定值：GZIP诈闺，返回格式為.gzip的壓縮包賬單。不傳則默認(rèn)為數(shù)據(jù)流形式铃芦。 |
此接口不常用买雾，推薦使用微信商戶平臺(tái)下載。具體的實(shí)現(xiàn)請(qǐng)參考上面的官方文檔杨帽。
結(jié)語(yǔ)
以上為下載對(duì)賬單、資金賬單相關(guān)的解釋和源碼嗤军，特別需要注意的是下載資金賬單接口需要特定的簽名類型HMAC-SHA256注盈，小伙伴們一定要注意哦，具體的源碼可以看作者的github叙赚，里面對(duì)每個(gè)方法有詳細(xì)的注釋老客。
預(yù)告：下一篇文章 如何使用沙箱環(huán)境測(cè)試僚饭，敬請(qǐng)期待！ｋ逝椤鳍鸵！
?如果想要提前一覽源碼的小伙伴，可以先看看我的 github尉间，地址如下：
?
??https://github.com/YClimb/wxpay-sdk/blob/master/README.md ?
關(guān)注作者微信公眾號(hào)偿乖，點(diǎn)擊下方討論群，掃碼即可加入微信支付討論群與小伙伴一起探討哦～
到此本文就結(jié)束了哲嘲，關(guān)注公眾號(hào)查看更多推送Ｌ靶健！眠副！
