微信小程序对接通联支付

1.首先拿到通联支付开发API：https://aipboss.allinpay.com/know/devhelp/main.php?pid=15#mid=92

 

2.如果注册通联或者企业认证工作请到：文档说明》对接说明中，查看并且配置。

3.前提工作都准备好之后：首先下载参考demo，这样有助于开发工作中的调试。

4.demo上：都有操作的步骤（统一下单，退款，查询等）

 

 

5.接下开始一步步详细的分析逻辑和合代码：

5.1.从小程序点击付款开始：

当点击去付款，会触发submitOrder事件。

 

 

5.2使用js，携带者参数，请求pay.payOrder方法。

 

 

 

5.3：重点来了！！api.PayPerpayId,是请求java后台通联支付的支付接口。

 

wx.requestParment({}),这个是支付成功后的回调接口（非常重要！！）

 

这个可以参考一下微信的支付api文档。https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5

 

 

 

 

6.前台的工作完毕，写后台Controller层的逻辑和代码：

   6.1首先看到文档上有请求的参数，请求地址

 

 

7.后台请求的代码：

注：代码中用到了通联支付的demo中封装的工具类。

  /**
     * 获取支付的请求参数
     */
    @ApiOperation(value = "获取支付的请求参数")
    @PostMapping("prepay")
    public Object payPrepay(@LoginUser UserVo loginUser, Integer orderId) {
        //查询订单及物流信息
        OrderVo orderInfo = orderService.queryObject(orderId);

        if (null == orderInfo) {
            return toResponsObject(400, "订单已取消", "");
        }

        if (orderInfo.getPay_status() == 2) {
            return toResponsObject(400, "订单已支付，请不要重复操作", "");
        }
        //获取随机字符串
        String nonceStr = CharUtil.getRandomString(32);

        //https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=3
        Map resultObj = new TreeMap();

        try {
            HttpConnectionUtil http = new HttpConnectionUtil(ResourceUtil.getConfigByName("wx.uniformorder"));
            http.init();
            Map parame = new TreeMap<>();
            // 商户号
            parame.put("cusid",ResourceUtil.getConfigByName("wx.mchId"));
            // 通联支付的appid
            parame.put("appid",ResourceUtil.getConfigByName("wx.sybAppid"));
            // 版本号
            parame.put("version", "11");
            // trxamt：交易金额
            //支付金额，单位为分
            parame.put("trxamt", String.valueOf(orderInfo.getActual_price().multiply(new BigDecimal(100)).intValue()));
            // 商户订单编号
            parame.put("reqsn", orderInfo.getOrder_sn());
            // 交易类型APP
            parame.put("paytype", ResourceUtil.getConfigByName("wx.tradeType"));
            String randomStr = SybUtil.getValidatecode(8);
            // 随机字符串
            parame.put("randomstr", randomStr);
            // body 订单标题
            Map orderGoodsParam = new HashMap();
            orderGoodsParam.put("order_id", orderId);
            //订单的商品nideshop_order_goods表
            List orderGoods = orderGoodsService.queryList(orderGoodsParam);
            if (null != orderGoods) {
                String body = "校服-";
                for (OrderGoodsVo goodsVo : orderGoods) {
                    body = body + goodsVo.getGoods_name() + "、";
                }
                if (body.length() > 0) {
                    body = body.substring(0, body.length() - 1);
                }
                // 商品描述
                parame.put("body", body);
            }else{
                parame.put("body", "校服");
            }
            parame.put("remark", "");
            // validtime   有效时间，不填写，默认为5分钟。
            parame.put("validtime", "30");

            // acct 支付平台用户标识
            parame.put("acct", loginUser.getWeixin_openid());
            // 回调地址
            parame.put("notify_url", ResourceUtil.getConfigByName("wx.notifyUrl"));
            //  支付限制 不能用信用卡支付  limit_pay
            parame.put("limit_pay", "");
            // sub_appid 微信子appid
            parame.put("sub_appid", ResourceUtil.getConfigByName("wx.appId"));
            // goods_tag  订单优惠标识
            parame.put("goods_tag", "");
            // benefitdetail 优惠信息
            parame.put("benefitdetail", "");
            //chnlstoreid 渠道门店编号
            parame.put("chnlstoreid", "");
            // subbranch       通联系统门店号
            parame.put("subbranch", "");
            parame.put("extendparams", "");
            //终端ip
            parame.put("cusip", getClientIp());
            parame.put("fqnum", "");
            parame.put("idno", "");
            parame.put("truename", "");
            parame.put("asinfo", "");
            // signtype  签名方式 不填默认MD5
            parame.put("signtype", "MD5");
            parame.put("sign", SybUtil.unionSign(parame,ResourceUtil.getConfigByName("wx.paySignKey"),"MD5"));
            // 数字签证
            byte[] bys = http.postParams(parame, true);
            String result = new String(bys,"UTF-8");
            Map map = SybUtil.json2Obj(result, Map.class);
            Map mapType = null;
            if(map!=null){
                for(Object key:map.keySet()){
                    if (key.equals("payinfo")){
                        mapType = JSON.parseObject((String) map.get(key),Map.class);
                    }
                }
            }
           // print(map);
            if(map == null){
                throw new Exception("返回数据错误");
            }
            String return_code = MapUtils.getString("retcode", map);
            String return_msg = MapUtils.getString("retmsg", map);
                if (return_code.equalsIgnoreCase("FAIL")) {
                    return toResponsFail("支付失败," + return_msg);
                } else if (return_code.equalsIgnoreCase("SUCCESS")) {
                    // 返回数据
                        String prepay_id = MapUtils.getString("prepay_id", mapType);
                        // 先生成paySign 参考https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5
                        resultObj.put("appId",MapUtils.getString("appId", mapType));
                        resultObj.put("timeStamp", MapUtils.getString("timeStamp", mapType));
                        resultObj.put("nonceStr",  MapUtils.getString("nonceStr", mapType));
                        resultObj.put("package",MapUtils.getString("package", mapType));
                        resultObj.put("signType", MapUtils.getString("signType", mapType));
                        String paySign =MapUtils.getString("paySign", mapType);
                        resultObj.put("paySign", paySign);
                        // 业务处理
                        orderInfo.setPay_id(prepay_id);
                        // 付款中
                        orderInfo.setPay_status(1);
                        //更新订单表
                        orderService.update(orderInfo);
                        return toResponsObject(0, "微信统一订单下单成功", resultObj);
                }
        } catch (Exception e) {
            e.printStackTrace();
            return toResponsFail("下单失败,error=" + e.getMessage());
        }
        return toResponsFail("下单失败");
    }

 7.2：代码解析：

 HttpConnectionUtil http = new HttpConnectionUtil(ResourceUtil.getConfigByName("wx.uniformorder"));

  1. HttpConnectionUtil ：用的是通联支付文档demo的代码。，目的是使用httpConnect，发送请求。

2.ResourceUtil.getConfigByName("wx.uniformorder")：是我放到config.properties的参数，下面代码还有，我就不一一说明了。
其实就是接口地址：https://vsp.allinpay.com/apiweb/unitorder/pay

    // trxamt：交易金额
            //支付金额，单位为分
            parame.put("trxamt", String.valueOf(orderInfo.getActual_price().multiply(new BigDecimal(100)).intValue()));
            // 商户订单编号
            parame.put("reqsn", orderInfo.getOrder_sn());
            // 交易类型APP
            parame.put("paytype", ResourceUtil.getConfigByName("wx.tradeType"));
            String randomStr = SybUtil.getValidatecode(8);
            // 随机字符串
            parame.put("randomstr", randomStr);

3.trxamt:支付的金额，注意单位是分；

String.valueOf(orderInfo.getActual_price().multiply(new BigDecimal(100)).intValue())：首先map集合是String类型，orderInfo.getActual_price()
  是小程序前台传过来的金额参数，并且BigDecimal类型。

reqsn：订单编号，根据自己的系统怎样生成的编号就好。

paytype：交易类型。小程序是：W06
其他支付，具体类型参照通联api文档进行选择：

   parame.put("signtype", "MD5");
            parame.put("sign", SybUtil.unionSign(parame,ResourceUtil.getConfigByName("wx.paySignKey"),"MD5"));
            // 数字签证
            byte[] bys = http.postParams(parame, true);
            String result = new String(bys,"UTF-8");
            Map map = SybUtil.json2Obj(result, Map.class);

4.数字签名，运用通联的api文档SybUtil，一般是用MD5进行验证。

8.我在这总结一下我开发当中遇到的坑。。。。。

8.1.最好是用通联支付api文档上面demo代码，已经封装的工具类。以减少不必要的bug！！

8.2.在写统一下单的接口的时候最好和文档上的参数的顺修保持一致！

8.3.sign数字签证：如果说你也用的是通联支付的api中demo代码：当建立参数map集合的时候，一定要用TreeMap！！

 

要不然，它会一直报sign验证失败！！！

8.4：当retcode为SUCCESS时有返回值时候：

payinfo，很重要！！！在api附录中有说明。

 

 

如果成功就会返回如下形式：

 

payinfo主要的作用：就是调起支付返回给小程序页面。

请参考微信的api文档：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5

 

 

 我们看到，小程序调起支付api中的参数，正好payinfo中有！所以，需要获取payinfo里的值。

Map mapType = null;
            if(map!=null){
                for(Object key:map.keySet()){
                    if (key.equals("payinfo")){
                        mapType = JSON.parseObject((String) map.get(key),Map.class);
                    }
                }
            }

因为payinfo是以json的形式储存在map集合中的，所以要把map集合中key是payinfo的给放到一个新的map集合。

  String return_code = MapUtils.getString("retcode", map);
            String return_msg = MapUtils.getString("retmsg", map);
                if (return_code.equalsIgnoreCase("FAIL")) {
                    return toResponsFail("支付失败," + return_msg);
                } else if (return_code.equalsIgnoreCase("SUCCESS")) { // 返回数据 String prepay_id = MapUtils.getString("prepay_id", mapType); // 先生成paySign 参考https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5 resultObj.put("appId",MapUtils.getString("appId", mapType)); resultObj.put("timeStamp", MapUtils.getString("timeStamp", mapType)); resultObj.put("nonceStr", MapUtils.getString("nonceStr", mapType)); resultObj.put("package",MapUtils.getString("package", mapType)); resultObj.put("signType", MapUtils.getString("signType", mapType)); String paySign =MapUtils.getString("paySign", mapType); resultObj.put("paySign", paySign); // 业务处理  orderInfo.setPay_id(prepay_id); // 付款中 orderInfo.setPay_status(1); //更新订单表  orderService.update(orderInfo); return toResponsObject(0, "微信统一订单下单成功", resultObj); }

MapUtils就是下面的代码，通过上面的，取出相应的必要的参数，prepay_id，appId，timeStamp，nonceStr，package，signType，paySign

 public static String getString(String key, Map map) {
        if (map == null || key == null)
            throw new IllegalArgumentException();
        if (!map.containsKey(key))
            return null;
        Object value = map.get(key);
        if (value == null)
            return null;
        return value.toString();
    }

注意：如果你缺少，prepay_id扫码后会出现：以下错误。

 

 8.5 写完之后，在小程序端，接收调起支付的参数。

9，回调接口：确认订单交易是否完成，并且改变订单状态。

 

注意：赋值的回调接口：必须是外网能访问到，必须是不能带参数的。

    /**
     * 微信订单回调接口
     *
     * @return
     */
    @ApiIgnore
    @IgnoreAuth
    @RequestMapping(value = "/notify", method = RequestMethod.POST, produces = "text/html;charset=UTF-8")
    public void notify(HttpServletRequest request, HttpServletResponse response) {
        try {
            request.setCharacterEncoding("UTF-8");//通知传输的编码为GBK
            response.setCharacterEncoding("UTF-8");
            Map params = getParams(request);
            String trxstatus = MapUtils.getString("trxstatus", params);
           if (trxstatus.equals("0000")) {
                //订单编号
                logger.error("订单" + MapUtils.getString("cusorderid",params) + "支付成功");
                // 业务处理
                OrderVo orderInfo = orderService.queryObjectByOrderSn(MapUtils.getString("cusorderid",params));
                orderInfo.setPay_status(2);
                orderInfo.setOrder_status(201);
                orderInfo.setShipping_status(0);
                orderInfo.setPay_time(new Date());
                orderService.update(orderInfo);
                response.getWriter().write(setXml("SUCCESS", "OK"));
            }else {
                //订单编号
                logger.error("订单" + MapUtils.getString("cusorderid",params) + "支付失败");
                response.getWriter().write(setXml("error", "OK"));
            }
        } catch (Exception e) {
            e.printStackTrace();
            return;
        }
    }

/**
 * 动态遍历获取所有收到的参数,此步非常关键,因为收银宝以后可能会加字段,动态获取可以兼容由于收银宝加字段而引起的签名异常
 * @param request
 * @return
 */
private TreeMap getParams(HttpServletRequest request){
    TreeMap map = new TreeMap<>();
    Map reqMap = request.getParameterMap();
    for(Object key:reqMap.keySet()){
        String value = ((String[])reqMap.get(key))[0];
        System.out.println(key+";"+value);
        map.put(key.toString(),value);
    }
    return map;
}

这里注意：最好用通联api文档demo中的代码。

trxstatus是返回的状态码：0000代表付款成功！，其他的参照api文档。

 

到此，就差不多结束了，希望我踩过的坑能够对你有所帮助！（下篇博客，写通联支付如何退款申请。）