微信支付-退款(v3版微信支付)

做完微信支付，如果遇到顾客需要退款的情况，我们就要调用微信的退款接口进行对款操作。下面大致介绍下微信支付中退款的流程、主要代码以及一些我测出的bug解决方法。

先说下我们需要哪些jar包以及微信给我们的证书。

证书：apiclient_cert.p12。

jar包:commons-codec-1.6.jar commons-logging-1.1.3.jar fluent-hc-4.3.4.jar httpclient-4.3.4.jar httpclient-cache-4.3.4.jar httpcore-4.3.2.jar httpmime-4.3.4.jar

上面7个jar包，微信官网文档对应的demo里面都有。官网下载地址：https://mp.weixin.qq.com/paymch/readtemplate?t=mp/business/course3_tmpl&lang=zh_CN。

不想去官网找的，下列地址直接下载即可（象征性要一分下载分）：http://download.csdn.net/detail/u011160656/8262955

注意：
1.交易时间超过1 年的订单无法提交退款；
2.支持部分退款，部分退需要设置相同的订单号和不同的out_refund_no。一笔退款失败后重新提交，要采用原来的out_refund_no。总退款金额丌能超过用户实际支付金额。

看看退款接口中需要哪些参数。

微信支付-退款(v3版微信支付)

特别注意：图中的refund_fee和total_fee官方文档写的类型为Int，其实我用string也是可以，其中原因不明。

代码如下：代码需要稍作修改，具体修改地方已在main方法中做了文字描述

public static void main(String[] args) throws Exception {
          SortedMap<Object,Object> parameters = new TreeMap<Object,Object>();
           parameters.put("appid", "wx0953bae287adfeee");
           parameters.put("mch_id", "你的微信支付商户号");
           parameters.put("nonce_str", CreateNoncestr());
           //在notify_url中解析微信返回的信息获取到 transaction_id，此项不是必填，详细请看上图文档
           parameters.put("transaction_id", "微信支付订单中调用统一接口后微信返回的 transaction_id");
           parameters.put("out_trade_no", "微信支付订单中的out_trade_no");
           parameters.put("out_refund_no", "No.QM20141215002");                              //我们自己设定的退款申请号，约束为UK
           parameters.put("total_fee", "1") ;                                                                          //单位为分
           parameters.put("refund_fee", "1");                                                                      //单位为分
           parameters.put("op_user_id", "你的微信支付商户号");
           String sign = createSign("utf-8", parameters);
           parameters.put("sign", sign);

           String reuqestXml = getRequestXml(parameters);
            KeyStore keyStore = KeyStore.getInstance("PKCS12");
            FileInputStream instream = new FileInputStream(new File("D:/apiclient_cert.p12"));//放退款证书的路径
            try {
                keyStore.load(instream, "你的微信支付商户号".toCharArray());
            } finally {
                instream.close();
            }

            SSLContext sslcontext = SSLContexts.custom().loadKeyMaterial(keyStore, "你的微信支付商户号".toCharArray()).build();
            SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory(
                    sslcontext,
                    new String[] { "TLSv1" },
                    null,
                    SSLConnectionSocketFactory.BROWSER_COMPATIBLE_HOSTNAME_VERIFIER);
            CloseableHttpClient httpclient = HttpClients.custom().setSSLSocketFactory(sslsf).build();
            try {

                HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/secapi/pay/refund");//退款接口

                System.out.println("executing request" + httpPost.getRequestLine());
                StringEntity reqEntity = new StringEntity(reuqestXml);
                // 设置类型
                reqEntity.setContentType("application/x-www-form-urlencoded");
                httpPost.setEntity(reqEntity);
                CloseableHttpResponse response = httpclient.execute(httpPost);
                try {
                    HttpEntity entity = response.getEntity();

                    System.out.println("----------------------------------------");
                    System.out.println(response.getStatusLine());
                    if (entity != null) {
                        System.out.println("Response content length: " + entity.getContentLength());
                        BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(entity.getContent(),"UTF-8"));
                        String text;
                        while ((text = bufferedReader.readLine()) != null) {
                            System.out.println(text);
                        }

                    }
                    EntityUtils.consume(entity);
                } finally {
                    response.close();
                }
            } finally {
                httpclient.close();
            }
}
public static String CreateNoncestr() {
           String chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
           String res = "";
           for (int i = 0; i < 16; i++) {
               Random rd = new Random();
               res += chars.charAt(rd.nextInt(chars.length() - 1));
           }
           return res;
}
public static String createSign(String charSet,SortedMap<Object,Object> parameters){
           StringBuffer sb = new StringBuffer();
           Set es = parameters.entrySet();
           Iterator it = es.iterator();
           while(it.hasNext()) {
               Map.Entry entry = (Map.Entry)it.next();
               String k = (String)entry.getKey();
               Object v = entry.getValue();
               if(null != v && !"".equals(v)
                       && !"sign".equals(k) && !"key".equals(k)) {
                   sb.append(k + "=" + v + "&");
               }
           }
           sb.append("key=" + "zhuhaizhongyuele4008866060liuboz");
           String sign = MD5Util.MD5Encode(sb.toString(), charSet).toUpperCase();
           return sign;
}
public static String getRequestXml(SortedMap<Object,Object> parameters){
       StringBuffer sb = new StringBuffer();
       sb.append("<xml>");
       Set es = parameters.entrySet();
       Iterator it = es.iterator();
       while(it.hasNext()) {
           Map.Entry entry = (Map.Entry)it.next();
           String k = (String)entry.getKey();
           String v = (String)entry.getValue();
           if ("attach".equalsIgnoreCase(k)||"body".equalsIgnoreCase(k)||"sign".equalsIgnoreCase(k)) {
               sb.append("<"+k+">"+"<![CDATA["+v+"]]></"+k+">");
           }else {
               sb.append("<"+k+">"+v+"</"+k+">");
           }
       }
       sb.append("</xml>");
       return sb.toString();
}
我们可以获得调用接口后返回的信息(上面main方法中，打印的text就是返回的信息)具体信息如下图：
微信支付-退款(v3版微信支付)

退款成功的返回信息如下：

<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx0953bae287adfeee]]></appid>
<mch_id><![CDATA[10032574]]></mch_id>
<sub_mch_id><![CDATA[]]></sub_mch_id>
<nonce_str><![CDATA[3ILl3mJupKAVrPdU]]></nonce_str>
<sign><![CDATA[1B213B3EFC73C40DFFAC5AAC777DF08D]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<transaction_id><![CDATA[1008010446201412020006419926]]></transaction_id>
<out_trade_no><![CDATA[1706467782]]></out_trade_no>
<out_refund_no><![CDATA[No.QM20141205002]]></out_refund_no>
<refund_id><![CDATA[2008010446201412050000255624]]></refund_id>
<refund_channel><![CDATA[]]></refund_channel>
<refund_fee>1</refund_fee>
<coupon_refund_fee>0</coupon_refund_fee>
</xml>

下面罗列下我测试遇到的bug：
同一账单进行二次退款操作返回信息如下

<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx0953bae287adfeee]]></appid>
<mch_id><![CDATA[10032574]]></mch_id>
<sub_mch_id><![CDATA[]]></sub_mch_id>
<nonce_str><![CDATA[H7gbRloPIJq5zk6S]]></nonce_str>
<sign><![CDATA[295234A53534EB345C7189E31A2C422D]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<transaction_id><![CDATA[1008010446201412030006453329]]></transaction_id>
<out_trade_no><![CDATA[1406539982]]></out_trade_no>
<out_refund_no><![CDATA[20141205001]]></out_refund_no>
<refund_id><![CDATA[2008010446201412050000262217]]></refund_id>
<refund_channel><![CDATA[]]></refund_channel>
<refund_fee>1</refund_fee>
<coupon_refund_fee>0</coupon_refund_fee>
</xml>

<span style="color:#FF0000;">（仍然显示退款成功，但是只退款一次），所以我们要根据自己的订单退款状态进行判断是否进行数据库操作。</span>

退款金额( refund_fee)大于总金额( total_fee)的返回信息

<xml><return_code><![CDATA[FAIL]]></return_code><return_msg><![CDATA[invalid refund_fee]]></return_msg>
</xml>

退款中的总金额( total_fee)与微信支付订单总金额不一致

<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg><appid><![CDATA[wx0953bae287adfeee]]></appid><mch_id><![CDATA[10032574]]></mch_id><sub_mch_id><![CDATA[]]></sub_mch_id><nonce_str><![CDATA[pt4JUHwVzYEtLzyh]]></nonce_str><sign><![CDATA[6193D0EECEE231BEDA427AABAA8A20DF]]></sign><result_code><![CDATA[FAIL]]></result_code><err_code><![CDATA[REFUND_FEE_MISMATCH]]></err_code><err_code_des><![CDATA[同一个out_refund_no退款金额要一致]]></err_code_des></xml>

退款单号（ out_refund_no）不唯一

<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx0953bae287adfeee]]></appid>
<mch_id><![CDATA[10032574]]></mch_id>
<sub_mch_id><![CDATA[]]></sub_mch_id>
<nonce_str><![CDATA[T4tZ3GhGasjEszIl]]></nonce_str>
<sign><![CDATA[2A38E0FAF22FEAB10049C9D020EECE02]]></sign>
<result_code><![CDATA[FAIL]]></result_code>
<err_code><![CDATA[REFUND_ID_INVALID]]></err_code>
<err_code_des><![CDATA[退款单号非法]]></err_code_des>
</xml>

仍有不明之处，可留言给我。

秒客网

微信支付-退款(v3版微信支付)

相关文章