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

YClimb發表於2019-02-02

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


淺析微信支付系列已經更新十五篇了喲~,沒有看過的朋友們可以看一下哦。

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

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

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

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

上篇文章講解使用微信支付的代金券功能,我們使用了預充值代金券預充值立減和折扣,但是限制是商戶必須先充值足夠的預算金額才可以使用功能,如果想要免充值即可使用,需要開通免充值代金券免充值立減和折扣,開通該兩項功能需要走免充值產品功能使用指引,該功能還需要介面升級。

簡單來說,預充值就是你需要做活動,就必須先充值足夠的活動預算,比如要發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. 查詢升級所需完成的用例(1001、1002、1005)、(1003、1004、1005)兩種組合,全部完成驗收最好
  4. 根據官方用例呼叫對應的介面,呼叫完成後再查詢驗收進度
  5. 完成驗收

查詢驗收進度

這裡第一步下載測試用例就跳過不說了,直接查詢驗收進度,點選上面連結可以跳轉到查詢頁面,如下圖:

免充值驗收進度查詢

這個驗收進度是實時的,當我們根據用例呼叫不同的介面後,查詢會顯示不同的完成狀態,幫助我們完成升級。

驗收用例

首先,介面升級根據刷卡和公眾號等分為兩組不同的介面升級,(1001、1002、1005)、(1003、1004、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/wxpay-sdk/blob/master/README.md ​

關注作者微信公眾號,點選下方討論群,掃碼即可加入微信支付討論群與小夥伴一起探討哦~

到此本文就結束了,關注公眾號檢視更多推送!!!


關注我的公眾號

相關文章