1.场景
当交易发生之后一段时间内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付款退还给买家,微信支付将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家帐号上。
注意:
1、交易时间超过一年的订单无法提交退款
2、微信支付退款支持单笔交易分多次退款,多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交,请不要更换退款单号,请使用原商户退款单号
3、请求频率限制:150qps,即每秒钟正常的申请退款请求次数不超过150次
错误或无效请求频率限制:6qps,即每秒钟异常或错误的退款申请请求不超过6次
4、每个支付订单的部分退款次数不能超过50次
5、如果同一个用户有多笔退款,建议分不同批次进行退款,避免并发退款导致退款失败
2.返回的接口地址
https://api.mch.weixin.qq.com/secapi/pay/refund
3.需要证书
如果证书不是自己配置的,在微信支付平台管理的地方是下载不了的。也可以换一种方法去找你的经理要一份就好了。
4.请求参数 (以下截图是必填的参数,如有不明白请参考官方文档:https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_4)
5.代码部分
①.service方法
1 /** 2 * 3 * @param mchId 商户ID 4 * @param url 请求URL 5 * @param data 退款参数 6 * @return 7 * @throws Exception 8 */ 9 String doRefund(String mchId, String url, String data) throws Exception;
②.impl 此方法内要读取证书的位置
1 /** 2 * 3 * @param mchId 商户ID 4 * @param url 请求URL 5 * @param data 退款参数 6 * @return 7 * @throws Exception 8 */ 9 public String doRefund(String mchId, String url, String data) throws Exception { 10 /** 11 * 注意PKCS12证书 是从微信商户平台-》账户设置-》 API安全 中下载的 12 */ 13 KeyStore keyStore = KeyStore.getInstance("PKCS12"); 14 15 //这里读取.p12的文件是放在服务器中 使用nginx配置时指向的后端项目路径 16 FileInputStream inputStream = new FileInputStream(new File("apiclient_cert.p12"));//P12文件目录 17 try { 18 //这里写密码..默认是你的MCHID 19 keyStore.load(inputStream, mchId.toCharArray()); 20 } finally { 21 inputStream.close(); 22 } 23 SSLContext sslcontext = SSLContexts.custom() 24 //这里也是写密码的 25 .loadKeyMaterial(keyStore, mchId.toCharArray()) 26 .build(); 27 SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory( 28 sslcontext, 29 SSLConnectionSocketFactory.getDefaultHostnameVerifier()); 30 CloseableHttpClient httpclient = HttpClients.custom() 31 .setSSLSocketFactory(sslsf) 32 .build(); 33 try { 34 HttpPost httpost = new HttpPost(url); 35 httpost.setEntity(new StringEntity(data, "UTF-8")); 36 CloseableHttpResponse response = httpclient.execute(httpost); 37 try { 38 HttpEntity entity = response.getEntity(); 39 //接受到返回信息 40 String jsonStr = EntityUtils.toString(response.getEntity(), "UTF-8"); 41 System.out.println(jsonStr+"-====接收到返回的信息"); 42 EntityUtils.consume(entity); 43 return jsonStr; 44 } finally { 45 response.close(); 46 } 47 } finally { 48 httpclient.close(); 49 } 50 } 51 52
③.controller
1 @RequestMapping("/refund") 2 public String refund() throws Exception { 3 System.out.println("进入退款----"); 4 try { 5 //构建参数 6 Map<String, String> dataMap = new HashMap<>(); 7 dataMap.put("appid","公众账号ID"); 8 dataMap.put("mch_id","商户号"); 9 //自行实现该随机串 10 dataMap.put("nonce_str",WXPayUtil.generateNonceStr()); 11 //商户订单号 12 dataMap.put("out_trade_no","订单号"); 13 //商户退款单号 14 dataMap.put("out_refund_no","订单号"); 15 //订单金额 16 dataMap.put("total_fee","1"); 17 //退款金额 18 dataMap.put("refund_fee","1"); 19 //退款原因 (可写可不写) 20 dataMap.put("refund_desc","退款"); 21 //生成签名 22 String sign = WXPayUtil.generateSignature(dataMap, "商户密钥"); 23 dataMap.put("sign", sign); 24 System.out.println(dataMap+"=========dataMap"); 25 26 //map数据转xml 27 String xmlString = XMLBeanUtil.map2XmlString(dataMap); 28 System.out.println("--------------map-->xml转换------------"+xmlString); 29 30 //发起退款 31 String result= weixinPayService.doRefund("商户号", "https://api.mch.weixin.qq.com/secapi/pay/refund", xmlString); 32 System.out.println(result.toString()+"----结果"); 33 System.out.println("================退款==========="); 34 35 //这里需要将发起退款的xml格式转换为map 36 Map<String, String> returnMap = WXPayUtil.xmlToMap(result); 37 System.out.println("--------------xml-->map转换"+result); 38 //用map取值返回的状态码来判断是否退款成功 39 //判断是否退款成功 40 if (returnMap.get("return_code").equals("SUCCESS")) { 41 return "微信已成功退款"; 42 } 43 return "微信退款失败"; 44 } catch (Exception e) { 45 e.printStackTrace(); 46 } 47 return "失败"; 48 } 49 50
6.结语
第一次写博客,写的不太好,还希望大家多多包涵。同时也希望这篇博客可以帮助到正在做退款这一块的码友们。有不懂的可以评论哦看到必回。