微信支付退款接口开发案例(转)

2017年08月21日 17:08 | 4944次浏览 作者原创 版权保护

关于微信支付,如果遇到顾客需要退款的情况,我们就要调用微信的退款接口进行对款操作。下面大致介绍下微信支付中退款的流程、主要代码以及一些我测出的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。

注意:

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

2.支持部分退款, 部分退需要设置相同的订单号和不同的 out_refund_no。一笔退款失败后重新提交,要采用原来的 out_refund_no。总退款金额丌能超过用户实际支付金额。

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

特别注意:图中的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就是返回的信息)具体信息如下图:

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

<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]]><nce_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)的返回信息view plain copy

<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]]><nce_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]]><nce_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>


上述案例问题集锦

1,显示api.mch.weixin.qq.com:443 failed to respond异常

原因:证书没放对,密码错误导致的

2,退款单号(out_refund_no)不唯一

原因:退款单用uuid或者只要保持退款的唯一即可。


小说《我是全球混乱的源头》
此文章本站原创,地址 https://www.vxzsk.com/127.html   转载请注明出处!谢谢!

感觉本站内容不错,读后有收获?小额赞助,鼓励网站分享出更好的教程