浅析微信支付：开通免充值产品功能及如何进行接口升级指引

本文是【浅析微信支付】系列文章的第十五篇，主要讲解如何开通免充值产品功能流程和其中的注意事项，对于接口升级会重要讲解，避免爬坑。

---

浅析微信支付系列已经更新十五篇了哟～，没有看过的朋友们能够看一下哦。

浅析微信支付：商户平台代金券或立减优惠开通、指定用户代金券发放、查询等

浅析微信支付：商户平台开通现金红包、指定用户发放、红包记录查询

浅析微信支付：支付验收示例和验收指引

浅析微信支付：如何使用沙箱环境测试

上篇文章讲解使用微信支付的代金券功能，咱们使用了预充值代金券、预充值立减和折扣，可是限制是商户必须先充值足够的预算金额才可使用功能，若是想要免充值便可使用，须要开通免充值代金券、免充值立减和折扣，开通该两项功能须要走免充值产品功能使用指引，该功能还须要接口升级。

简单来讲，预充值就是你须要作活动，就必须先充值足够的活动预算，好比要发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/wxpay-sdk/blob/master/README.md ​

关注做者公众号，点击下方讨论群，扫码便可加入微信支付讨论群与小伙伴一块儿探讨哦～

到此本文就结束了，关注公众号查看更多推送！！！

---