微信公眾號H5支付-JAVA版
微信開發之微信公眾號H5支付-JAVA版
引子
從事JAVA開發一年多了,一直都在看部落格園,CSDN的部落格,從很多前人哪裡學習了很多,突然覺得自己也要盡一份力,寫點部落格自己給自己做做記錄,也給要開發微信人提提醒少遇點坑。
很多人開發微信的時候,總是在抱怨微信的開發文件很坑,裡面的引數和使用方式很含糊,其實有時候自己想想,如果自己去研發API的時候,是否能夠做的比微信更好呢?,大師都有一顆虔誠學徒的心,希望這篇文件能給予從事微信公眾號H5支付焦頭爛額的朋友,一點幫助。
一、前言
先給大家提提從事微信開發,需要做的一些準備條件:1、去微信公共平臺和微信商戶平臺註冊一個賬號,這裡需要給微信交納300塊RMB成為一個開發者擁有開發資質 ,
二、思路
進行開發之前,先把思路理清楚瞭解,瞭解微信支付的型別,這裡型別有很多,我們需要的是公眾號支付,通過官網文件瞭解,這裡需要註冊一個微信商戶,這個我就不解釋了,按照官網的指示擼就行了,這裡展示一個官網的業務流程圖。
支付業務流程圖
沒有理解到的多看看流程圖少吃很多虧,也可以帶入自己的業務模式,來考慮怎麼設計業務。
這裡我們瞭解到,使用微信統一下單支付介面,前提是需要使用者的openid,這裡又要設計微信的授權登入了,以後我會在微信開發的文章裡面,更新微信授權的文章
好了我們這裡提到微信支付流程第一步,統一下單支付介面,這裡貼上必填的引數:
欄位名 | 變數名 | 示例值 | 型別 | 描述 |
公眾賬號ID | appid | wxd678efh567hg6787 | String(32) | 微信支付分配的公眾賬號ID(企業號corpid即為此appId) |
商戶號 | mch_id | 1230000109 | String(32) | 微信支付分配的商戶號 |
隨機字串 | nonce_str | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | String(32) | 隨機字串,長度要求在32位以內。推薦隨機數生成演算法 |
簽名 | sign | C380BEC2BFD727A4B6845133519F3AD6 | String(32) | 通過簽名演算法計算得出的簽名值,詳見簽名生成演算法 |
商品描述 | body | 騰訊充值中心-QQ會員充值 | String(128) | 商品簡單描述,該欄位請按照規範傳遞,具體請見引數規定 |
商戶訂單號 | out_trade_no | 20150806125346 | String(32) | 商戶系統內部訂單號,要求32個字元內,只能是數字、大小寫字母_-|* 且在同一個商戶號下唯一。詳見商戶訂單號 |
標價金額 | total_fee | 88 | Int | 訂單總金額,單位為分,詳見支付金額 |
終端IP | spbill_create_ip | 123.12.12.123 | String(16) | APP和網頁支付提交使用者端ip,Native支付填呼叫微信支付API的機器IP |
通知地址 | notify_url | http://www.weixin.qq.com/wxpay/pay.php | String(256) | 非同步接收微信支付結果通知的回撥地址,通知url必須為外網可訪問的url,不能攜帶引數 |
交易型別 | trade_type | JSAPI | String(16) | JSAPI 公眾號支付 NATIVE 掃碼支付 APP APP支付 說明詳見引數規定 |
裡面要注意:簽名演算法,不建議自己手寫,可以用微信的支付工具類(微信官方工具類,裡面有很多的函式,例如生成sign,map組裝xml等實用功能,減少開發量),裡面有方法可以填入引數就可以生成sign
三、場景程式碼
貼上我自己的程式碼:
// 統一下單URL String unifiedorder_url = "https://api.mch.weixin.qq.com/pay/unifiedorder"; IWXPayConfig config = new IWXPayConfig(); Map<String, String> data = new HashMap<String, String>(); data.put("appid", config.getAppID());//微信支付分配的公眾賬號ID(企業號corpid即為此appId) data.put("mch_id", config.getMchID());//微信支付分配的商戶號 String str = WXPayUtil.generateNonceStr(); data.put("nonce_str", str); // 通過微信工具類生成 隨機字串 data.put("body", "超級商品");//商品描述 data.put("out_trade_no", order.getOrderSn()); // 訂單唯一編號, 不允許重複 data.put("total_fee", new BigDecimal(100).multiply(order.getAmount()).setScale(0,BigDecimal.ROUND_DOWN).toString()); // 訂單金額, 單位分 data.put("spbill_create_ip", GetIp.getTrueIpAddr(request)); // 下單ip data.put("openid", order.getOpenId()); // 微信公眾號統一標示openid data.put("notify_url", "URL這裡填寫,你的回撥域名"); // 訂單結果通知, 微信主動回撥此介面 data.put("trade_type", "JSAPI"); // 固定填寫 // 生成帶有 sign 的 XML 格式字串 String xmlparam = WXPayUtil.generateSignedXml(data, config.getKey()); // 傳送請求 String resultStr = HttpRequest.sendPost(unifiedorder_url, xmlparam); logger.info("返回訊息" + resultStr);
通過post請求微信會回撥一個json回撥資訊,如果裡面return_code 回覆為SUCCESS而且result_code 也為SUCCESS的話,恭喜你就成功了一半了。這個時候可以放鬆一下泡杯茶。
下一步,根據官方提示,需要把返回的json回撥資訊的,引數取出來進行二次封裝,組裝進map,然後返回前端發起支付請求(這裡有一個坑,頁面實際的支付路徑等於微信商戶平臺的設定支付目錄的下一級,切記!!!微信錯誤提示不足,導致我這裡卡了一下午)
這裡貼上我的程式碼:
// 時間戳 String timeStamp = new Long(WXPayUtil.getCurrentTimestamp()).toString(); // 建立返回值 //組裝二次簽名 Map<String, String> resultMap = new HashMap<String, String>(); resultMap.put("appId", wxResultMap.get("appid")); resultMap.put("timeStamp", timeStamp); resultMap.put("nonceStr", str); resultMap.put("package", "prepay_id=" + wxResultMap.get("prepay_id")); resultMap.put("signType", "MD5"); // 生成簽名 String paySign = WXPayUtil.generateSignature(resultMap, config.getKey()); resultMap.put("paySign", paySign); return MsgJson.getmsg(false, resultMap, "簽名生成成功");
注意一般出現錯誤的地方都是引數錯誤,如果前端執行報錯請檢查引數,是否有填寫錯,大小寫是否有問題。
貼上前端程式碼:
$.ajax({ type:"post", url: "/weixin/pay", dataType:"json", ontentType : "application/x-www-form-urlencoded", data:{orderId:'${orderId}'}, success:function(result) { console.log(result); var data = result; //var data = JSON.parse(result); if(data.status == '200'){ appId = data.data.appId; paySign = data.data.paySign; timeStamp = data.data.timeStamp; nonceStr = data.data.nonceStr; packageStr = data.data.package; signType = data.data.signType; callpay(); }else{ alert("統一下單失敗"); } } }); } function onBridgeReady(){ WeixinJSBridge.invoke( 'getBrandWCPayRequest', { "appId":appId, //公眾號名稱,由商戶傳入 "timeStamp":timeStamp, //時間戳,自1970年以來的秒數 "nonceStr":nonceStr , //隨機串 "package":packageStr, //預支付交易會話標識 "signType":signType, //微信簽名方式 "paySign":paySign //微信簽名 }, function(res){ if(res.err_msg == "get_brand_wcpay_request:ok" ) { alert('支付成功'); window.location.replace("/eby/index"); }else if(res.err_msg == "get_brand_wcpay_request:cancel"){ alert('支付取消'); }else if(res.err_msg == "get_brand_wcpay_request:fail" ){ alert('支付失敗'); } //使用以上方式判斷前端返回,微信團隊鄭重提示:res.err_msg將在使用者支付成功後返回 ok,但並不保證它絕對可靠。 } ); } function callpay(){ if (typeof WeixinJSBridge == "undefined"){ if( document.addEventListener ){ document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false); }else if (document.attachEvent){ document.attachEvent('WeixinJSBridgeReady', onBridgeReady); document.attachEvent('onWeixinJSBridgeReady', onBridgeReady); } }else{ onBridgeReady(); }
前端做完,這一步順利調出來微信支付的彈框
這裡就基本大功告成了,還有差一步處理支付的回撥,根據微信官方提示前端返回的支付成功是不靠譜的,需要微信非同步回撥來驗證,一共有8次注意通知的延遲重複性,通過生成sign比對成功後才可以確保這次支付成功了,下面貼上我的處理回撥程式碼:
HashMap map = new HashMap(); IWXPayConfig config = new IWXPayConfig(); try { InputStream inStream = request.getInputStream(); ByteArrayOutputStream outSteam = new ByteArrayOutputStream(); byte[] buffer = new byte[1024]; int len = 0; while ((len = inStream.read(buffer)) != -1) { outSteam.write(buffer, 0, len); } outSteam.close(); inStream.close(); String resultStr = new String(outSteam.toByteArray(), "utf-8"); Map<String, String> resultMap = WXPayUtil.xmlToMap(resultStr);//將xml轉成排序之後的map logger.info("微信支付回撥地址請求引數=requst:{}", resultMap.toString()); String result_code = resultMap.get("result_code");//業務結果 String is_subscribe = resultMap.get("is_subscribe");//是否關注了微信公眾號 String out_trade_no = resultMap.get("out_trade_no");//訂單號 String transaction_id = resultMap.get("transaction_id");//微信支付訂單號 類似於支付寶的交易號 String sign = resultMap.get("sign");//簽名 String total_fee = resultMap.get("total_fee");//訂單總金額 單位為 分 String openid = resultMap.get("openid");//使用者在商戶appid下的唯一標識 String time_end = resultMap.get("time_end"); String bank_type = resultMap.get("bank_type"); //簽名驗證 resultMap.remove("sign"); String signStr = WXPayUtil.generateSignature(resultMap,config.getKey()); logger.warn("驗證= signStr:{},sign:{}", signStr, sign); if (!signStr.equals(sign)) { logger.warn("微信支付回撥地址請求引數簽名驗證失敗= signStr:{},sign:{}", signStr, sign); map.put("return_code", "FAIL"); map.put("return_msg", "sign不正確"); return WXPayUtil.mapToXml(map); } if (result_code.equals("SUCCESS")) { logger.info("支付成功= 訂單號:{},交易號:{}", out_trade_no, transaction_id); BigDecimal bigDecimal_total_fee = new BigDecimal(total_fee); BigDecimal bigDecimal = bigDecimal_total_fee.divide(new BigDecimal(100)); // 支付成功處理業務邏輯 } //通知微信.非同步確認成功.必寫.不然會一直通知後臺.八次之後就認為交易失敗了. map.put("return_code","SUCCESS"); map.put("return_msg","OK");
四、總結
總結的來說,微信支付坑還是不少尤其是是地址和引數,多注意一些還是可以避免的,其他的注意點在我在場景程式碼裡面提出來了,第一次寫文章如果有不好的地方,希望大家指出來,希望這篇文章能幫到大家。
文章純手寫,轉載請帶上作者。