微信小程序對接通聯支付

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<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文檔。

 

到此，就差不多結束了，希望我踩過的坑能夠對你有所幫助！（下篇博客，寫通聯支付如何退款申請。）