微信支付04

还是接上文：订单查询 、我们获取到订单详情之后、接下来就要开始  退款接口了、在我们调运退款接口的时候、我们可以先调运订单查询接口、看订单状态是否正常或者订单是否存在，如果订单存在并且订单状态正常、那我们就可以调运退款借口了。

如下

 

---

     退款API

业务功能

商户针对某一个已经成功支付的订单发起退款，操作结果在同一会话中同步返回。

一、退款方式

目前只支持原路返回退款

说明：退到银行卡则是非实时的，每个银行的处理速度不同，一般发起退款后1-3个工作日内到账。

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

二、退款限制

商户在退款操作时应该注意退款限制，避免发起不会成功的退款请求，下面是主要的退款限制：

1.在平台中，只要退款累计金额不超过交易单支付总额，一笔交易单可以多次退款，退款申请单号（退款接口中有此参数）唯一确定一次退       款，而不是交易单号确定一次退款。退款申请单号由商户生成，所以商户一定要保证退款申请单的唯一性。商家在退款过程中要特别注 意，只有在能确定退款失败的情况下，才能重新发起另一笔退款。一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号。

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

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

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

交互模式

后台系统调用交互模式

请求参数列表

请求url：https://pay.swiftpass.cn/pay/gateway

POST XML 内容体进行请求

字段名	变量名	必填	类型	说明
接口类型	service	是	String(32)	接口类型：unified.trade.refund
版本号	version	否	String(8)	版本号，version默认值是1.0。
字符集	charset	否	String(8)	可选值 UTF-8 ，默认为 UTF-8。
签名方式	sign_type	否	String(8)	签名类型，取值：MD5默认：MD5
商户号	mch_id	是	String(32)	商户号，由平台分配
商户订单号	out_trade_no	否	String(32)	商户系统内部的订单号, out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先
平台订单号	transaction_id	否	String(32)	平台单号, out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先
商户退款单号	out_refund_no	是	String(32)	商户退款单号，32个字符内、可包含字母,确保在商户系统唯一。同个退款单号多次请求，平台当一个单处理，只会退一次款。如果出现退款不成功，请采用原退款单号重新发起，避免出现重复退款。
总金额	total_fee	是	Int	订单总金额，单位为分
退款金额	refund_fee	是	Int	退款总金额,单位为分,可以做部分退款
操作员	op_user_id	是	String(32)	操作员帐号,默认为商户号
退款渠道	refund_channel	否	String(16)	ORIGINAL-原路退款，默认
随机字符串	nonce_str	是	String(32)	随机字符串，不长于 32 位
签名	sign	是	String(32)	MD5签名结果，详见“安全规范”

返回结果

数据按XML的格式实时返回

字段名	变量名	必填	类型	说明
版本号	version	是	String(8)	版本号，version默认值是2.0。
字符集	charset	是	String(8)	可选值 UTF-8 ，默认为 UTF-8。
签名方式	sign_type	是	String(8)	签名类型，取值：MD5默认：MD5
返回状态码	status	是	String(16)	0表示成功，非0表示失败此字段是通信标识，非交易标识，交易是否成功需要查看 result_code 来判断
返回信息	message	否	String(128)	异常或错误时返回信息，具体描述请看文档最后返回信息列表
以下字段在 status 为 0的时候有返回
业务结果	result_code	是	String(16)	0表示成功，非0表示失败 注：此处返回0表示退款申请接收成功，实际的退款结果根据退款查询接口查询
商户号	mch_id	是	String(32)	商户号，由平台分配
设备号	device_info	否	String(32)	平台分配的终端设备号
随机字符串	nonce_str	是	String(32)	随机字符串，不长于 32 位
错误代码	err_code	否	String(32)	具体错误码请看文档最后错误码列表
签名	sign	是	String(32)	MD5签名结果，详见“安全规范”
以下字段在 status 和 result_code 都为 0的时候有返回
平台订单号	transaction_id	是	String(32)	平台订单号。
商户订单号	out_trade_no	是	String(32)	商户系统内部的订单号
商户退款单号	out_refund_no	是	String(32)	商户退款单号
平台退款单号	refund_id	是	String(32)	平台退款单号
退款渠道	refund_channel	是	String(16)	ORIGINAL—原路退款，默认
退款金额	refund_fee	是	Int	退款总金额,单位为分,可以做部分退款
现金券退款金额	coupon_refund_fee	否	Int	现金券退款金额 <= 退款金额， 退款金额-现金券退款金额为现金

 

 

---

由文档我们可以获取到我们需要传的参数和返回的参数、所以、最重要的、、突然想到、、要有一个自己的商户才好啊 ，，，，  不闲扯了

注意：文档中的必传参数

下面我们看demo

 protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        req.setCharacterEncoding("utf-8");
        resp.setCharacterEncoding("utf-8");
        
        SortedMap<String,String> map = XmlUtils.getParameterMap(req);
        System.out.println(XmlUtils.toXml(map));
        String key = SwiftpassConfig.key;
        String res = null;
        String reqUrl = SwiftpassConfig.req_url;
        map.put("mch_id", SwiftpassConfig.mch_id);
        map.put("op_user_id", SwiftpassConfig.mch_id);
        map.put("nonce_str", String.valueOf(new Date().getTime()));
        
        Map<String,String> params = SignUtils.paraFilter(map);
        StringBuilder buf = new StringBuilder((params.size() +1) * 10);
        SignUtils.buildPayParams(buf,params,false);
        String preStr = buf.toString();
        String sign = MD5.sign(preStr, "&key=" + key, "utf-8");
        map.put("sign", sign);
        
        System.out.println("reqUrl:" + reqUrl);
        
        CloseableHttpResponse response = null;
        CloseableHttpClient client = null;
        try {
            HttpPost httpPost = new HttpPost(reqUrl);
            StringEntity entityParams = new StringEntity(XmlUtils.parseXML(map),"utf-8");
            httpPost.setEntity(entityParams);
            httpPost.setHeader("Content-Type", "text/xml;charset=ISO-8859-1");
            client = HttpClients.createDefault();
            response = client.execute(httpPost);
            if(response != null && response.getEntity() != null){
                Map<String,String> resultMap = XmlUtils.toMap(EntityUtils.toByteArray(response.getEntity()), "utf-8");
                res = XmlUtils.toXml(resultMap);
                System.out.println("请求结果：" + res);
                
                if(resultMap.containsKey("sign") && !SignUtils.checkParam(resultMap, key)){
                    res = "验证签名不通过";
                }
            }else{
                res = "操作失败!";
            }
        } catch (Exception e) {
            e.printStackTrace();
            res = "操作失败";
        } finally {
            if(response != null){
                response.close();
            }
            if(client != null){
                client.close();
            }
        }
        if(res.startsWith("<")){
            resp.setHeader("Content-type", "text/xml;charset=UTF-8");
        }else{
            resp.setHeader("Content-type", "text/html;charset=UTF-8");
        }
        resp.getWriter().write(res);
    }

 demo中直接是把返回结果打印在了页面、response掉了、所以、我们需要拿到那个    resultMap  这里面就是返回的各种数据 --  上面文档中的返回数据

注意：1. 第5行的那个map 、那里面已经从req里面获取到了很多参数、比如service之类的、如果我们要开发的话、我们就要把那儿改一下、下面会讲到：

现在是我们本地的demo：

public Pair<Boolean, Map<String,String>> doOrderRefund(Payparams paramss) throws Exception {
        boolean result = false;
        Map<String,String> resultMap = new HashMap<String, String>();
        HashMap<String, String> rspData = new HashMap<String,String>();
        logger.info("---退款开始---");
        String orderId = paramss.getOrderId();
        String merId = paramss.getMerId();
        String merOrderId = paramss.getMerOrderId();
        String txnAmt = paramss.getTxnAmt();
        String refundOrderId = "TK" + orderId;  //退款单号 = TK + 订单号
        
        //组织请求报文
        SortedMap<String,String> map = new TreeMap<String, String>();  //  标志02  下面解释
        System.out.println(XmlUtils.toXml(map));
        String key = SwiftpassConfig.key;
        String res = null;
        String reqUrl = SwiftpassConfig.req_url;
        map.put("out_trade_no",orderId); //订单号
19         map.put("out_refund_no", refundOrderId); //商户退单号
20         map.put("service", "unified.trade.refund"); //接口类型   
21         map.put("mch_id", merId);
22         map.put("op_user_id", merId);
23         map.put("total_fee", txnAmt); //int 总金额  单位是分
24         map.put("refund_fee", txnAmt);  //int  退款金额  单位是分
        
        map.put("nonce_str", String.valueOf(new Date().getTime())); //随机字符串
        
        Map<String,String> params = SignUtils.paraFilter(map);
        StringBuilder buf = new StringBuilder((params.size() +1) * 10);
        SignUtils.buildPayParams(buf,params,false);
        String preStr = buf.toString();
        String sign = MD5.sign(preStr, "&key=" + key, "utf-8");
        map.put("sign", sign);
        
        logger.info("reqUrl:" + reqUrl);
        
        CloseableHttpResponse response = null;
        CloseableHttpClient client = null;
        try {
            HttpPost httpPost = new HttpPost(reqUrl);
            StringEntity entityParams = new StringEntity(XmlUtils.parseXML(map),"utf-8");
            httpPost.setEntity(entityParams);
            httpPost.setHeader("Content-Type", "text/xml;charset=ISO-8859-1");
            client = HttpClients.createDefault();
            response = client.execute(httpPost);
            if(response != null && response.getEntity() != null){
                resultMap = XmlUtils.toMap(EntityUtils.toByteArray(response.getEntity()), "utf-8");
                res = XmlUtils.toXml(resultMap);
                System.out.println("请求结果：" + res);
                
                if(resultMap.containsKey("sign") && !SignUtils.checkParam(resultMap, key)){
                    res = "验证签名不通过";
                }
            }else{
                res = "操作失败!";
            }
        } catch (Exception e) {
            e.printStackTrace();
            res = "操作失败";
        } finally {
            if(response != null){
                response.close();
            }
            if(client != null){
                client.close();
            }
        }
        
        //转换成json对象
        JSONObject respJson = JSONObject.fromObject(resultMap); //标志 03 下面解释
        Assert.notNull(respJson, "微信退款返回信息解析 json 字串为空");
        //解析json
        Assert.notNull(respJson.get("result_code"), "微信退款返回码异常");
        String respCode = respJson.getString("result_code");
        
        PayRes payRes = PayReturnCode.getPayRes(Contents.WX_CODE, respCode);
        logger.info("退款结果，返回码：" + respCode + "， 退款信息：" + payRes.getMsg());
        
        if(respCode.equals("SUCCESS")){
            result=true;
        }
        
        return new Pair<Boolean, Map<String,String>>(result, rspData);
    }

 

注释：标识02 ： 因为在demo示例中那个sortMap是将request的参数排序取出来了、所以在这里我们没有request的情况下、我们就new一个TreeMap()； 然后将下面红色的那部分参数传进来、放到map里面、请求微信的接口

            标识03 ： 我们获取到的是一个map<String , String> 类型的map、而微信的整个参数都在这个map中、我们在这里把map转换为json之后、就方便了我们下面对数据的处理。

 

 

 

今天在开发的时候、微信测试的商家都超过测试限额了、、、尴尬的啊、明天再说吧。