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

本文是【淺析微信支付】系列文章的第十五篇，主要講解如何開通免充值產品功能流程和其中的注意事項，對於接口升級會重要講解，避免爬坑。

---

淺析微信支付系列已經更新十五篇了喲～，沒有看過的朋友們能夠看一下哦。

淺析微信支付：商戶平臺代金券或立減優惠開通、指定用戶代金券發放、查詢等

淺析微信支付：商戶平臺開通現金紅包、指定用戶發放、紅包記錄查詢

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

淺析微信支付：如何使用沙箱環境測試

上篇文章講解使用微信支付的代金券功能，咱們使用了預充值代金券、預充值立減和折扣，可是限制是商戶必須先充值足夠的預算金額纔可使用功能，若是想要免充值便可使用，須要開通免充值代金券、免充值立減和折扣，開通該兩項功能須要走免充值產品功能使用指引，該功能還須要接口升級。

簡單來講，預充值就是你須要作活動，就必須先充值足夠的活動預算，好比要發1000元的券，那你的帳戶裏面就必須有這1000塊錢，否則就不能建立活動，而免充值也很好理解，就是不須要帳戶裏面有足夠的錢也能夠建立活動，好比要發1000元券，滿十減一，直接先建立活動就行，用戶支付時，帳戶自動扣減。

免充值產品功能使用指引

首先來一波官方說明地址：

https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=23_15#

上面爲官方的開通步驟，注意，必定要按照步驟進行喲，不然可能會出現一些不可描述的問題！！！

重點來了，首先，這裏以普通商戶爲栗子，要開通免充值，必須進行接口升級，因此，下面是接口升級的流程。

接口升級

下面是重點！重點！重點！

Q1：爲何要進行接口升級？
A1：商戶開通免充值類產品功能後，微信支付接口和帳單格式會有調整，商戶內部系統須要適配升級後的接口參數。查看接口升級說明：

服務商或子商戶點擊下載；
普通商戶點擊下載

根據連接，咱們能夠下載微信官方給出的pdf文檔，文檔有這句話：開通免充值業務功能後，有 6 個支付業務接口部分參數將會按照如下表格變動，請確認是否優先進行內部系
統升級以適配新的接口參數（api 接口中，只有使用了免充值券纔會返回新增參數）；

說明，至少有六個接口是須要改變的，改變的是什麼呢？說白了就是接口的參數新增了幾個，具體的見以下圖：

Q2：如何進行接口升級？
A2：商戶的技術人員須要按照測試用例，逐個case進行測試。下載測試用例
若是你在升級過程當中遇到困難，請掃碼加入微信羣，會有微信支付技術人員答疑。

Q3：如何查詢接口升級進度？
A3：請點擊，查詢驗收進度

Q4：我公司同一集團/品牌旗下有多個商戶號，有無簡便的操做方案？
A4：同一品牌旗下多個商戶號，在接口升級、開通產品權限、配置活動等環節會面臨諸多重複操做，推薦你公司申請同品牌商戶號

（下載同品牌商戶號申請模板），會帶來以下便利：

1. 僅一個商戶號開通產品功能便可，其餘商戶號由微信支付代爲開通產品功能；
2. 同品牌組內商戶號可任意互相添加爲可覈銷優惠商戶；
3. 同品牌組建立的免充值優惠活動，活動可免審覈直接激活生效。

Q5：開通功能後，我能夠添加哪些商戶號爲可用（可覈銷優惠）商戶？
A5：

1. 普通商戶：可添加本身或本身的同品牌商戶（什麼是同品牌商戶，見上個問題Q4）；
2. 服務商子商戶：可添加本身或本身的同品牌商戶；
3. 銀行服務商：可直接添加旗下任意子商戶，不須要子商戶受權；
4. 普通服務商：可添加已受權的子商戶（一次受權，長期有效）。

（1）服務商查看已受權的子商戶。查看地址：產品中心-特約商戶受權產品-免充值代金券/免充值立減與折扣
（2）服務商查看並邀請未受權子商戶受權。查看邀請地址：產品中心-特約商戶受權產品-免充值代金券/免充值立減與折扣-未受權
（3）子商戶的管理員登陸並操做受權。受權地址：產品中心-我受權的產品

Q6：使用免充值優惠，若是發生退款，怎麼退？
A6：

1. 退款金額以商戶提交的訂單金額爲基準計算。退款金額=用戶申請退款商戶的訂單金額*（用戶實際支付金額/訂單總金額），即按訂單優惠比例退款。
2. 舉例說明：小王購買兩件商品每件50元，總訂單金額100元，使用微信支付免充值券抵消10元，實際支付金額90元；小王支付成功後，決定退貨一件商品，其對應收到的退款金額爲：50元*（90元/100元）=45元。

Q7：使用免充值優惠，財務人員須要重點關注哪些變化？
A7：首先是帳單下載：若是你是人工登陸商戶平臺手工下載帳單，那麼開通權限先後的帳單會因格式不一樣，分開兩份文件；若是你是API下載帳單，你公司技術人員對內部系統升級適配新的API字段便可，不須要財務特別關注。其次是新帳單字段定義：訂單金額=買單支付金額+充值券金額+免充值券金額；訂單金額=應結訂單金額+免充值券金額；代金券金額=充值券金額+免充值券金額。如需瞭解更詳細字段變化狀況，請諮詢你公司技術人員。

升級示例

若是上面的文字都已經看過了，那麼如今能夠跟着做者一塊兒來進行接口升級了，主要分爲如下幾步：

1. 下載測試用例
2. 查詢驗收進度
3. 查詢升級所需完成的用例（100一、100二、1005）、（100三、100四、1005）兩種組合，所有完成驗收最好
4. 根據官方用例調用對應的接口，調用完成後再查詢驗收進度
5. 完成驗收

查詢驗收進度

這裏第一步下載測試用例就跳過不說了，直接查詢驗收進度，點擊上面連接能夠跳轉到查詢頁面，以下圖：

這個驗收進度是實時的，當咱們根據用例調用不一樣的接口後，查詢會顯示不一樣的完成狀態，幫助咱們完成升級。

驗收用例

首先，接口升級根據刷卡和公衆號等分爲兩組不一樣的接口升級，（100一、100二、1005）、（100三、100四、1005）兩種組合，升級完成任何一組都視爲完成升級，好比上圖就是完成了公衆號接口升級，並無完成刷卡支付的升級。

PS：最好完成全部示例升級，保證安全及對接口有了解。

調用示例接口

小夥伴參考官方示例會發現，示例中的接口都是調用沙箱環境，若是有不明白什麼是沙箱環境的小夥伴，能夠參考做者的這兩篇文章：
支付驗收示例和驗收指引、如何使用沙箱環境測試

根據用例升級會發現，其實很簡單，根據官方示例傳入對應的參數，而後調用接口便可，而後查看一下文檔中返回的參數是否有官方文檔標紅的參數便可，舉個栗子：

3.3 【1003-可選用例-公衆號/APP/掃碼正常支付】 
3.3.1 用例簡述
訂單金額 5.51 元，其中 0.01 元使用免充值券，實際支付 5.50 元。 驗證正常支付流程，商戶使用免充值代金券支付。

3.3.2 測試準備
(1)開通公衆號/AP/掃描支付;
(2)注意該用例不產生實際扣款;
(3)確保程序中全部調微信支付的 api 都增長了/sandboxnew/路徑，已對接仿真系統。 

3.3.3 測試步驟 
(1)用客戶端掃碼,選擇商品下單(此操做可選，若掃碼時出現二維碼過時等提示，則忽略該 提示，不影響測試結果)，調起微信支付交易確認頁(支付時出現收銀臺 total_fee 錯誤可忽
略，由於微信支付生產環境裏不存在此筆沙箱訂單，因此會有此錯誤提示)，或直接組包調用 統一下單 api(https://api.mch.weixin.qq.com/sandboxnew/pay/unifiedorder); (2)根據商戶內部單號(out_trade_no)，調用查單 api (https://api.mch.weixin.qq.com/sandboxnew/pay/orderquery)查詢訂單狀態，與商戶 自有訂單的關鍵信息進行覈對。

3.3.4 預期返回
下載用例後參考

以上爲公衆號jsapi支付的升級用例，須要注意的是，官方的訂單金額5.51不能修改，不然不經過，對於0.01等券的金額不須要理會，調用接口後返回結果中會提現。

第二步查詢訂單是和第一步下單綁定的，小夥伴必定要注意根據下單時的訂單號去查詢，不然升級不經過。

第一步調用後就能夠去查詢驗收進度，這時查詢會看到進度狀態欄顯示：已經調用支付接口，還未調用查詢單接口，這是咋們調用查詢訂單接口以後就會顯示已完成狀態，說明一個用例就升級完成了。

退款接口、交易對帳單和上面相似，只要根據官方文檔一步步操做就行。

開通免充值產品

驗收完成後，就能夠在微信支付商戶平臺開通免充值代金券、免充值立減和折扣產品功能了，地址：商戶平臺 - 產品中心 - 免充值xxx - 開通便可

開通後便可體驗免充值產品功能了。

這裏說點題外話，免充值產品開通前接口升級的變動參數，小夥伴們必定要寫入程序流程中，這個接口升級最主要的做用就是幫助咱們理解免充值的產品對於微信支付的接口變更，根據用例能夠更好的修正現有的接口參數，也是挺好的功能。

結語

本文沒有貼出具體如何調用升級用例的源碼，由於在做者前面文章 支付驗收示例和驗收指引 已經有相關的栗子了，若是不知道如何操做的小夥伴能夠先看一下，已經看過的小夥伴相信大家確定已經明白了，哈哈哈。

若是小夥伴有遇到解決不了的問題，能夠關注做者微信公衆號，加入討論羣中發出疑問，和小夥伴們一塊兒解決哦～

預告：下一篇文章會講公衆平臺的卡券 公衆平臺卡券功能開通、HTML5線上發券（JS-SDK接口）、查看卡券詳情，敬請期待！！！

​若是想要提早一覽源碼的小夥伴，能夠先看看個人 github，地址以下：
​
​`
​https://github.com/YClimb/wxp...
​`

關注做者微信公衆號，點擊下方討論羣，掃碼便可加入微信支付討論羣與小夥伴一塊兒探討哦～

到此本文就結束了，關注公衆號查看更多推送！！！

---