退款结果通知

应用场景

当商户申请的退款有结果后（退款状态为：退款成功、退款关闭、退款异常），微信会把相关结果发送给商户，商户需要接收处理，并返回应答。
对后台通知交互时，如果微信收到商户的应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功（通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m）。
注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
特别说明：退款结果对重要的数据进行了加密，商户需要用商户密钥进行解密后才能获得结果通知的内容

解密方式

解密步骤如下：

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

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

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

接口链接

在申请退款接口中上传参数“notify_url”以开通该功能

如果链接无法访问，商户将无法接收到微信通知。

通知url必须为直接可访问的url，不能携带参数。公网域名必须为https，如果是走专线接入，使用专线NAT IP或者私有回调域名可使用http。示例：notify_url：“https://pay.weixin.qq.com/wxpay/pay.action”

<xml> <return_code>SUCCESS</return_code> <appid><![CDATA[wx8888888888888888]]></appid> <mch_id><![CDATA[1900000109]]></mch_id> <nonce_str><![CDATA[5K8264ILTKCH16CQ2502SI8ZNMTM67VS]]></nonce_str> <req_info><![CDATA[T87GAHG17TGAHG1TGHAHAHA1Y1CIOA9UGJH1GAHV871HAGAGQYQQPOOJMXNBCXBVNMNMAJAA]]></req_info> <return_msg><![CDATA[90]]></return_msg> </xml>

返回响应

🟢200成功

application/json

Body

return_code

string

返回状态码

必需

SUCCESS/FAIL SUCCESS表示商户接收通知成功并校验成功

return_msg

string

返回信息

可选

返回信息，如非空，为错误原因参数格式校验错误

appid

string

公众账号ID

必需

微信分配的公众账号ID（企业号corpid即为此appId）

mch_id

string

退款的商户号

必需

微信支付分配的商户号

nonce_str

string

随机字符串

必需

随机字符串，不长于32位。推荐随机数生成算法

req_info

string

加密信息

必需

加密信息请用商户密钥进行解密，详见解密方式

🟢200req_info解密后

🟢200失败

应用场景#

解密方式#

接口链接#

请求参数

返回响应

应用场景

解密方式

接口链接