微信原生支付流程以及踩坑
阿新 • • 發佈：2020-08-10
本次記錄的是微信“JSAPI”的支付方式 也就是微信內H5頁面調起支付，其他支付方式也大同小異，總體的流程和思路大致是一樣的，基本配置方面就不詳細記錄，只需要商戶號和商戶Key，這個是配套的，還有跟商戶號繫結的appid,在商戶平臺就可以實現繫結。
//組織引數統一下單（key注意字母大小寫） TreeMap<String, String> treeMap = new TreeMap<>(); treeMap.put("appid",appid); //公眾號的appid treeMap.put("mch_id",mchId); //商戶號 treeMap.put("nonce_str",nonce_str); //32位隨機字串，，推薦隨機數生成演算法（每次下單不可重複） treeMap.put("body",body); //商品描述 treeMap.put("out_trade_no",orderNo); //商戶訂單號 32位隨機字串，推薦隨機數生成演算法（每次下單不可重複） treeMap.put("openid",openId); //微信使用者的openid，trade_type=JSAPI時（即JSAPI支付），此引數必傳（獲取方式微信公眾平臺有方式）treeMap.put("total_fee",total_fee); //下單金額（分） treeMap.put("spbill_create_ip","127.0.0.1"); //下單ip地址 treeMap.put("notify_url",notify_url); //非同步通知地址 treeMap.put("trade_type","JSAPI"); //交易型別 treeMap.put("sign_type","MD5"); //簽名方式String sign = MD5Util.createSign(treeMap, partnerkey); treeMap.put("sign",sign); String payUrl = WXPayConstants.UNIFIEDORDER_URL; //這裡的xml拼接需要按照字母順序先後拼接（引數都是統一下單存在的引數） //注意字母大小寫 String xml="<xml>"+ "<appid>"+appid+"</appid>"+ "<body>"+body+"</body>"+ "<mch_id>"+mchId+"</mch_id>"+ "<nonce_str>"+nonce_str+"</nonce_str>"+ "<notify_url>"+notify_url+"</notify_url>"+ "<out_trade_no>"+orderNo+"</out_trade_no>"+ "<openid>"+openId+"</openid>"+ "<spbill_create_ip>"+"127.0.0.1"+"</spbill_create_ip>"+ "<sign_type>"+"MD5"+"</sign_type>"+ "<total_fee>"+total_fee+"</total_fee>"+ "<trade_type>"+"JSAPI"+"</trade_type>"+ "<sign><![CDATA["+sign+"]]></sign>"+ "</xml>"; //請求統一下單介面 String result = HttpRequest.doPost(payUrl, xml); //將成功返回的xml格式轉為map格式（方便取值） Map<String, String> resultMap = XmlUtils.toMap(result.getBytes(), "UTF-8"); //判斷返回條件是否滿足 if(resultMap.get("return_code").equals("SUCCESS") && resultMap.containsKey("result_code") && resultMap.get("result_code").equals("SUCCESS")){ //下單成功，將訂單資訊存入庫中 PayTradeFlow tradeFlow = new PayTradeFlow(); tradeFlow.setOutTradeNo(orderNo); //訂單號 tradeFlow.setBody(""); //商品名稱 tradeFlow.setWxStatus("等待付款"); //訂單狀態 tradeFlow.setTradeTime(new Date()); //訂單發起時間 tradeFlow.setId(nonce_str); //訂單id tradeFlow.setOpenid(""); //openid tradeFlow.setTotalFee(Integer.parseInt(AmountUtils.changeY2F(total_fee))); //支付金額 tradeFlow.setTradeType("JSAPI"); tradeFlow.setPayResult("SUCCESS"); int insert_code = payTradeFlowDao.insertSelective(tradeFlow); if (insert_code > 0){ //組織引數返回前端調起支付 JSONObject obj = new JSONObject(); //package引數需按照 package ：prepay_id=123456789 格式拼接返回 obj.put("package","prepay_id="+resultMap.get("prepay_id"));//預支付交易標識 obj.put("nonceStr",resultMap.get("nonce_str")); //32位隨機字串 obj.put("appId",resultMap.get("appid")); //appid（統一下單時一樣的） obj.put("signType","MD5"); //簽名方式（跟統一下單時保持一致） obj.put("timeStamp",timeStamp); //時間戳（10位）不是當前毫秒值 //將調起支付的五個引數二次簽名得到paySign一起返回前端 TreeMap<String, String> map = new TreeMap<>(); map.put("appId",resultMap.get("appid")); map.put("timeStamp",timeStamp); map.put("nonceStr",resultMap.get("nonce_str")); map.put("package","prepay_id="+resultMap.get("prepay_id")); map.put("signType","MD5"); // obj.put("paySign",WXPayUtil.generateSignature(map,partnerkey).toUpperCase()); obj.put("paySign",MD5Util.createSign(map,partnerkey).toUpperCase()); //二次簽名paySign（需要轉為大小） return ResponseEntity.createNormalJsonResponse(obj); } }
統一下單介面文件相關引數地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1
前端調起支付相關引數及說明文件地址：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
前端接收引數調起支付：
function pay() { var inputName = document.getElementById("name"); name = inputName.value; var inputMoney = document.getElementById("money"); money = inputMoney.value; if (name === '') { layer.msg("商品名稱不能為空!"); return; } if (money === '') { layer.msg("充值金額不能為空!"); return; } $(function () { $.ajax({ url: "http://192.168.25.54:8083/services/wxPay/pay", //後臺介面地址 type:"post", async: true, data:"{\"body\":\""+name+"\",\"totalFee\":\""+money+"\"}", //後臺需要的引數 contentType: "application/json", Accept: "*/*", success: function (result) { var payInfo = eval("(" + result + ")"); if (payInfo.code == 0) { payInfo = payInfo.responseData; onBridgeReady(); function onBridgeReady() { WeixinJSBridge.invoke( 'getBrandWCPayRequest', {
//五個引數需要按照字母順序 "appId": payInfo.appId, //公眾號名稱，由商戶傳入 "timeStamp": payInfo.timeStamp, //時間戳（10位），自1970 年以來的秒數 "nonceStr": payInfo.nonceStr, //32位隨機串 "package": payInfo.package, //統一下單返回的prepay_id 預支付交易標識 "signType": payInfo.signType, //下單時簽名方式: "paySign": payInfo.paySign, //後臺二次簽名得到的,不是統一下單返回的sign }, function (res) { if (res.err_msg == "get_brand_wcpay_request:ok") { //支付成功跳轉頁面 window.location.href = 'reg_history.html?accountId='; alert("支付成功") } if (res.err_msg == "get_brand_wcpay_request:cancel") { alert("您取消了"); WeixinJSBridge.call('closeWindow'); } if (res.err_msg == "get_brand_wcpay_request:fail") { alert("支付失敗"); WeixinJSBridge.call('closeWindow'); } } ); } }else { layer.msg("系統錯誤!"); } } }); }) }
大致流程就是前端發起支付請求，後端統一下單生成預支付交易標識，然後組織5個引數二次簽名生成paySign 返回給前端調起支付，
過程中容易出現的錯誤有兩個地方：
1：前端接收到引數後簽名驗證失敗（這個問題是多方面的，還是要仔細檢查入參，字母大小寫（統一下單時入參是appid，調起支付時是appId），引數個數是否對應，生成的簽名需要轉為大寫字母）
2：前端調起支付時提示 -呼叫支付JSAPI缺少引數：total_fee（這個雖然提示是缺少金額，但實際上並不是，這個還是需要仔細檢查入參和二次簽名流程，字母大小寫，無非就是這些問題）