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

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

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

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

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

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

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

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

簡單來說,預充值就是你需要做活動,就必須先充值足夠的活動預算,比如要發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/wxp...
`

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

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


關注我的公衆號


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章