1. 程式人生 > 實用技巧 >微信小程式對接通聯支付

微信小程式對接通聯支付

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

到此,就差不多結束了,希望我踩過的坑能夠對你有所幫助!(下篇部落格,寫通聯支付如何退款申請。)