微信小程序对接通联支付

1.首先拿到通联支付开发APIhttps://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<Object, Object> resultObj = new TreeMap();

        try {
            HttpConnectionUtil http = new HttpConnectionUtil(ResourceUtil.getConfigByName("wx.uniformorder"));
            http.init();
            Map<Object, Object> 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<OrderGoodsVo> 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<String,Object> 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<String,Object> 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<String, Object> 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<String, Object> 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<String, Object> getParams(HttpServletRequest request){
TreeMap<String, Object> 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文档。

 

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

 

 

 


 

 

 

 

 

posted @ 2020-08-12 18:44  胜过这首歌  阅读(9342)  评论(30编辑  收藏  举报
AmazingCounters.com