浅析微信支付：申请退款、退款回调接口、查询退款

PS：原路返回的意思就是，从你支付时的关联支付单中扣款，微信会记录相关数据，可以在客户端通知中展示。

1、申请退款接口

以下为微信官方的 申请退款文档：

1. https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4

1.1. 应用场景

当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。

1. 注意：

2. 1、交易时间超过一年的订单无法提交退款

3. 2、微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号

4. 3、请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次

5. 错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次

6. 4、每个支付订单的部分退款次数不能超过50次

PS：以上限制一般情况下不会出现，但我们也必须写入系统异常场景处理中，请求频率可以使用队列或增加延迟等方式来处理，部分退款此时不要超过微信的限制。

1.2. 接口链接

1. https://api.mch.weixin.qq.com/secapi/pay/refund

1.3. 是否需要证书

请求需要双向证书。

PS：关于微信证书，可以在 [商户平台-账户中心-API安全] 去下载，此证书很多支付接口均需要使用，请将证书地址配置为常量，具体实现可以参考作者github源码。

1.4. 调用接口

先看源码

以上为sdk退款调用示例代码，有几个参数需要我们注意：

PS：推荐以上的参数都必填， notify_url参数可配置为环境常量，根据环境的不同配置调用不会的回调地址。

下面为具体的实际sdk wxPay.refund

以上已经详细说明的具体的字段含义，有不明白的同学可以查看微信的官方文档，具体的源码可以查看作者的github。

这里有一个比较需要注意的点，在我们调用退款之后，会返回一些异常处理情况，官方文档中收录了一系列错误码code，我们可以在系统中对其进行处理，这里就不细说了。

2、退款回调接口

以下为微信官方的 退款结果通知文档：

1. https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_16&index=10

2.1. 应用场景

当商户申请的退款有结果后，微信会把相关结果发送给商户，商户需要接收处理，并返回应答。 对后台通知交互时，如果微信收到商户的应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。

（通知频率为15/15/30/180/1800/1800/1800/1800/3600，单位：秒）

注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。

特别说明：退款结果对重要的数据进行了加密，商户需要用商户秘钥进行解密后才能获得结果通知的内容

2.2. 接口链接

在申请退款接口中上传参数“notify_url”以开通该功能 如果链接无法访问，商户将无法接收到微信通知。 通知url必须为直接可访问的url，不能携带参数。

1. 示例：notify_url：“https://pay.weixin.qq.com/wxpay/pay.action”

2.3. 解密方式

1. 解密步骤如下：

2. （1）对加密串A做base64解码，得到加密串B

3. （2）对商户key做md5，得到32位小写key* ( key设置路径：微信商户平台-->账户设置-->API安全-->密钥设置 )

4. （3）用key*对加密串B做AES-256-ECB解密（PKCS7Padding）

PS：特别注意，如果要进行微信AES解密，因为GJ的进口管制限制，Java发布的运行环境包中的加解密有一定的限制。默认不允许256位密钥的AES加解密，解决方法就是修改策略文件，我们需要从官方网站下载无限制权限策略文件，注意自己JDK的版本别下错了。

jdk8的jce下载地址： https://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html

将localpolicy.jar和USexportpolicy.jar这两个文件替换%JREHOME%\lib\security和%JDK_HOME%\jre\lib\security下原来的文件，注意先备份原文件。

如果是jdk8，可能会遇到安全目录下有 policy文件夹的情况，拿作者的电脑举例，jdk路径为 /opt/jdk1.8.0_152/jre/lib/security/policy，此目录下有两个子文件夹 limited、 limited，需要替换 limited文件夹下的文件 local_policy.jar、 US_export_policy.jar这两个，最好先备份哦～！！！替换后重启项目即可。

2.4. 调用接口

因为退款回调接口是咋们系统被动接收微信的消息，所以此处和支付回调接口一致，也是使用了流的方式，格式为xml

以上代码详细解释了如何接收微信回调数据和解码数据，具体的 AESUtil.decryptData(req_info)请参考作者源码，文末有地址，这里就不细讲了。

具体的退款接收参数请参考微信官方文档，需要注意的是 商户退款单号和 微信退款单号，此两个参数是修改和记录退款的必要凭证。

3、查询退款

以下为微信官方的 查询退款文档：

1. https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_5

3.1. 应用场景

提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。

注意：如果单个支付订单部分退款次数超过20次请使用退款单号查询

3.2. 接口链接

1. https://api.mch.weixin.qq.com/pay/refundquery

3.3. 是否需要证书

不需要

3.4. 调用接口

注意：当一个订单部分退款超过10笔后，商户用微信订单号或商户订单号调退款查询API查询退款时，默认返回前10笔和 total_refund_count（订单总退款次数）。商户需要查询同一订单下超过10笔的退款单时，可传入订单号及offset来查询，微信支付会返回offset及后面的10笔，以此类推。当商户传入的offset超过 total_refund_count，则系统会返回报错 PARAM_ERROR。

举例：

1. 一笔订单下的退款单有36笔，当商户想查询第25笔时，可传入订单号及offset=24，微信支付平台会返回第25笔到第35笔的退款单信息，或商户可直接传入退款单号查询退款

以下为调用方式

PS：微信订单号查询的优先级是： refundid > outrefundno > transactionid > outtradeno

需要注意的是，查询退款时，需要注意退款返回的错误码，如果出现错误，需要及时同步商户系统中的退款数据。

结语

以上为 申请退款、退款回调接口、查询退款相关的解释和源码，特别需要注意的是接收退款时的解密方式和替换安全文件

下载说明