摘要:本文是淺析微信支付系列文章的第九篇,主要講解商戶(hù)下載對(duì)賬單接口和資金賬單接口的實(shí)現(xiàn)和一些注意事項(xiàng)。注意微信側(cè)未成功下單的交易不會(huì)出現(xiàn)在對(duì)賬單中。
本文是【淺析微信支付】系列文章的第九篇,主要講解商戶(hù)下載對(duì)賬單接口和資金賬單接口的實(shí)現(xiàn)和一些注意事項(xiàng)。
淺析微信支付系列已經(jīng)更新九篇了喲~,沒(méi)有看過(guò)的朋友們可以看一下哦。
淺析微信支付:申請(qǐng)退款、退款回調(diào)接口、查詢(xún)退款
淺析微信支付:查詢(xún)訂單和關(guān)閉訂單
淺析微信支付:支付結(jié)果通知
在商戶(hù)平臺(tái)中,商家也可以下載資金對(duì)賬單,歷史的交易清單,具體位置:商戶(hù)平臺(tái) -> 交易中心 -> 賬單管理。
如果要查看實(shí)時(shí)的流水記錄,可以在微信APP中搜索小程序 微信支付商戶(hù)助手 即可查看。
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)容跟查詢(xún)訂單或退款結(jié)果一致,具體字段說(shuō)明可查閱相應(yīng)接口。
此接口方便商家在自身系統(tǒng)中下載,不依賴(lài)于微信商戶(hù)平臺(tái)。
1.1. 應(yīng)用場(chǎng)景商戶(hù)可以通過(guò)該接口下載歷史交易清單。比如掉單、系統(tǒng)錯(cuò)誤等導(dǎo)致商戶(hù)側(cè)和微信側(cè)數(shù)據(jù)不一致,通過(guò)對(duì)賬單核對(duì)后可校正支付狀態(tài)。
注意: 1、微信側(cè)未成功下單的交易不會(huì)出現(xiàn)在對(duì)賬單中。支付成功后撤銷(xiāo)的交易會(huì)出現(xiàn)在對(duì)賬單中,跟原支付單訂單號(hào)一致; 2、微信在次日9點(diǎn)啟動(dòng)生成前一天的對(duì)賬單,建議商戶(hù)10點(diǎn)后再獲取; 3、對(duì)賬單中涉及金額的字段單位為“元”。 4、對(duì)賬單接口只能下載三個(gè)月以?xún)?nèi)的賬單。 5、對(duì)賬單是以商戶(hù)號(hào)緯度來(lái)生成的,如一個(gè)商戶(hù)號(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/downloadbill1.3. 是否需要證書(shū)
不需要
1.4. 調(diào)用接口調(diào)用參數(shù):
字段名稱(chēng) | 變量名 | 必填 | 類(lèi)型 | 描述 |
---|---|---|---|---|
賬單日期 | bill_date | 是 | String(8) | 下載對(duì)賬單的日期,格式:20140603 |
賬單類(lèi)型 | 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() { HashMap1.5. 返回結(jié)果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(); } }
成功時(shí),數(shù)據(jù)以文本表格的方式返回,第一行為表頭,后面各行為對(duì)應(yīng)的字段內(nèi)容,字段內(nèi)容跟查詢(xún)訂單或退款結(jié)果一致,具體字段說(shuō)明可查閱相應(yīng)接口。
第一行為表頭,根據(jù)請(qǐng)求下載的對(duì)賬單類(lèi)型不同而不同(由bill_type決定),目前有:
當(dāng)日所有訂單
交易時(shí)間,公眾賬號(hào)ID,商戶(hù)號(hào),子商戶(hù)號(hào),設(shè)備號(hào),微信訂單號(hào),商戶(hù)訂單號(hào),用戶(hù)標(biāo)識(shí),交易類(lèi)型,交易狀態(tài),付款銀行,貨幣種類(lèi),總金額,代金券或立減優(yōu)惠金額,微信退款單號(hào),商戶(hù)退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額,退款類(lèi)型,退款狀態(tài),商品名稱(chēng),商戶(hù)數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率
當(dāng)日成功支付的訂單
交易時(shí)間,公眾賬號(hào)ID,商戶(hù)號(hào),子商戶(hù)號(hào),設(shè)備號(hào),微信訂單號(hào),商戶(hù)訂單號(hào),用戶(hù)標(biāo)識(shí),交易類(lèi)型,交易狀態(tài),付款銀行,貨幣種類(lèi),總金額,代金券或立減優(yōu)惠金額,商品名稱(chēng),商戶(hù)數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率
當(dāng)日退款的訂單
交易時(shí)間,公眾賬號(hào)ID,商戶(hù)號(hào),子商戶(hù)號(hào),設(shè)備號(hào),微信訂單號(hào),商戶(hù)訂單號(hào),用戶(hù)標(biāo)識(shí),交易類(lèi)型,交易狀態(tài),付款銀行,貨幣種類(lèi),總金額,代金券或立減優(yōu)惠金額,退款申請(qǐng)時(shí)間,退款成功時(shí)間,微信退款單號(hào),商戶(hù)退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額,退款類(lèi)型,退款狀態(tài),商品名稱(chēng),商戶(hù)數(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ù)號(hào),子商戶(hù)號(hào),設(shè)備號(hào),微信訂單號(hào),商戶(hù)訂單號(hào),用戶(hù)標(biāo)識(shí),交易類(lèi)型,交易狀態(tài),付款銀行,貨幣種類(lèi),總金額,代金券或立減優(yōu)惠金額,微信退款單號(hào),商戶(hù)退款單號(hào),退款金額,代金券或立減優(yōu)惠退款金額,退款類(lèi)型,退款狀態(tài),商品名稱(chēng),商戶(hù)數(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,`02、下載資金賬單接口
以下為微信官方的下載資金賬單文檔:
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_18&index=72.1. 應(yīng)用場(chǎng)景
商戶(hù)可以通過(guò)該接口下載自2017年6月1日起 的歷史資金流水賬單。
說(shuō)明:
1、資金賬單中的數(shù)據(jù)反映的是商戶(hù)微信賬戶(hù)資金變動(dòng)情況; 2、當(dāng)日賬單在次日上午9點(diǎn)開(kāi)始生成,建議商戶(hù)在上午10點(diǎn)以后獲??; 3、資金賬單中涉及金額的字段單位為“元”。2.2. 接口鏈接
https://api.mch.weixin.qq.com/pay/downloadfundflow2.3. 是否需要證書(shū)
請(qǐng)求需要雙向證書(shū)
2.4. 調(diào)用接口調(diào)用參數(shù):
字段名稱(chēng) | 變量名 | 必填 | 類(lèi)型 | 描述 |
---|---|---|---|---|
簽名類(lèi)型 | sign_type | 否 | String(32) | 簽名類(lèi)型,目前僅支持HMAC-SHA256 |
資金賬單日期 | bill_date | 是 | String(8) | 下載對(duì)賬單的日期,格式:20140603 |
資金賬戶(hù)類(lèi)型 | account_type | 是 | String(8) | 賬單的資金來(lái)源賬戶(hù):Basic 基本賬戶(hù)、Operation 運(yùn)營(yíng)賬戶(hù)、Fees 手續(xù)費(fèi)賬戶(hù) |
壓縮賬單 | tar_type | 否 | String(8) | 非必傳參數(shù),固定值:GZIP,返回格式為.gzip的壓縮包賬單。不傳則默認(rèn)為數(shù)據(jù)流形式。 |
此接口不常用,推薦使用微信商戶(hù)平臺(tái)下載。具體的實(shí)現(xiàn)請(qǐng)參考上面的官方文檔。
結(jié)語(yǔ)以上為下載對(duì)賬單、資金賬單相關(guān)的解釋和源碼,特別需要注意的是下載資金賬單接口需要特定的簽名類(lèi)型HMAC-SHA256,小伙伴們一定要注意哦,具體的源碼可以看作者的github,里面對(duì)每個(gè)方法有詳細(xì)的注釋。
預(yù)告:下一篇文章 如何使用沙箱環(huán)境測(cè)試,敬請(qǐng)期待?。?!
?如果想要提前一覽源碼的小伙伴,可以先看看我的 github,地址如下:
?
?`
?https://github.com/YClimb/wxp...
?`
關(guān)注作者微信公眾號(hào),點(diǎn)擊下方討論群,掃碼即可加入微信支付討論群與小伙伴一起探討哦~
到此本文就結(jié)束了,關(guān)注公眾號(hào)查看更多推送?。?!
文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請(qǐng)注明本文地址:http://www.ezyhdfw.cn/yun/72135.html
摘要:本文是淺析微信支付系列文章的第十篇,主要講解如何使用沙箱環(huán)境來(lái)測(cè)試微信支付。圖為微信支付仿真測(cè)試系統(tǒng)后簡(jiǎn)稱(chēng)仿真系統(tǒng)的簡(jiǎn)化原理圖。沙箱說(shuō)明微信支付沙箱環(huán)境,是提供給微信支付商戶(hù)的開(kāi)發(fā)者,用于模擬支付及回調(diào)通知。 本文是【淺析微信支付】系列文章的第十篇,主要講解如何使用沙箱環(huán)境來(lái)測(cè)試微信支付。 淺析微信支付系列已經(jīng)更新十篇了喲~,沒(méi)有看過(guò)的朋友們可以看一下。 淺析微信支付:下載對(duì)賬單和資...
摘要:淺析微信支付前篇大綱本文是淺析微信支付系列文章的第一篇,主要會(huì)介紹一下為何寫(xiě)下這個(gè)系列以及對(duì)于微信支付的一點(diǎn)小經(jīng)驗(yàn),與君共勉。下面講一下我是如何去學(xué)習(xí)微信支付的。 淺析微信支付:前篇大綱 本文是【淺析微信支付】系列文章的第一篇,主要會(huì)介紹一下為何寫(xiě)下這個(gè)系列以及對(duì)于微信支付的一點(diǎn)小經(jīng)驗(yàn),與君共勉。 以下會(huì)分幾個(gè)步驟講一下我學(xué)習(xí)微信支付的過(guò)程,也是一部辛酸史,也是希望朋友們不要再次跌進(jìn)...
摘要:本文是淺析微信支付系列文章的第十一篇,主要講解支付驗(yàn)收示例和驗(yàn)收指引。為保證商戶(hù)接入質(zhì)量,提升交易安全及用戶(hù)體驗(yàn),微信支付的合作服務(wù)商在正式上線(xiàn)交易前,必須先根據(jù)本文指引完成驗(yàn)收。 本文是【淺析微信支付】系列文章的第十一篇,主要講解支付驗(yàn)收示例和驗(yàn)收指引。 淺析微信支付系列已經(jīng)更新十一篇了喲~,沒(méi)有看過(guò)的朋友們可以看一下。 淺析微信支付:如何使用沙箱環(huán)境測(cè)試 淺析微信支付:下載對(duì)賬單...
摘要:本文是淺析微信支付系列文章的第十二篇,主要講解在商戶(hù)存在的提現(xiàn)商戶(hù)付款到微信用戶(hù)零錢(qián)或者銀行卡需求。應(yīng)用場(chǎng)景微信支付已上線(xiàn)企業(yè)付款至銀行卡功能。企業(yè)付款到銀行卡發(fā)票與交易手續(xù)費(fèi)發(fā)票為拆分單獨(dú)開(kāi)具。 本文是【淺析微信支付】系列文章的第十二篇,主要講解在商戶(hù)存在的提現(xiàn)、商戶(hù)付款到微信用戶(hù)零錢(qián)或者銀行卡需求。 淺析微信支付系列已經(jīng)更新十二篇了喲~,沒(méi)有看過(guò)的朋友們可以看一下哦。 淺析微信支...
摘要:本文是淺析微信支付系列文章的第十五篇,主要講解如何開(kāi)通免充值產(chǎn)品功能流程和其中的注意事項(xiàng),對(duì)于接口升級(jí)會(huì)重要講解,避免爬坑。 本文是【淺析微信支付】系列文章的第十五篇,主要講解如何開(kāi)通免充值產(chǎn)品功能流程和其中的注意事項(xiàng),對(duì)于接口升級(jí)會(huì)重要講解,避免爬坑。 淺析微信支付系列已經(jīng)更新十五篇了喲~,沒(méi)有看過(guò)的朋友們可以看一下哦。 淺析微信支付:商戶(hù)平臺(tái)代金券或立減優(yōu)惠開(kāi)通、指定用戶(hù)代金券發(fā)...
閱讀 2320·2021-11-22 09:34
閱讀 2189·2021-09-22 15:22
閱讀 2081·2019-08-29 15:05
閱讀 2178·2019-08-26 10:43
閱讀 3463·2019-08-26 10:26
閱讀 1049·2019-08-23 18:29
閱讀 3622·2019-08-23 16:42
閱讀 2057·2019-08-23 14:46