微信开发之微信公众号H5支付-JAVA版
引子
从事JAVA开发一年多了,一直都在看博客园,CSDN的博客,从很多前人哪里学习了很多,突然觉得自己也要尽一份力,写点博客自己给自己做做记录,也给要开发微信人提提醒少遇点坑。
很多人开发微信的时候,总是在抱怨微信的开发文档很坑,里面的参数和使用方式很含糊,其实有时候自己想想,如果自己去研发API的时候,是否能够做的比微信更好呢?,大师都有一颗虔诚学徒的心,希望这篇文档能给予从事微信公众号H5支付焦头烂额的朋友,一点帮助。
一、前言
先给大家提提从事微信开发,需要做的一些准备条件:1、去微信公共平台和微信商户平台注册一个账号,这里需要给微信交纳300块RMB成为一个开发者拥有开发资质 ,微信公共平台网址 、微信商户平台网址 2、申请一个服务号详细流程我就不提醒了,服务号是需要企业认证的(如果没有企业资格,又想练练手的朋友可以去申请一个微信公众号测试号,进行一些简单的开发,微信测试号网址) 。3、注意看文档,切记重要的事情说三遍!!!,做操作之前仔细理解文档里面的内容,参数里面的关系,请求的格式之类的,这种错误是最难发现的,微信公共号开发文档网址 ,微信支付文档。
二、思路
进行开发之前,先把思路理清楚了解,了解微信支付的类型,这里类型有很多,我们需要的是公众号支付,通过官网文档了解,这里需要注册一个微信商户,这个我就不解释了,按照官网的指示撸就行了,这里展示一个官网的业务流程图。
支付业务流程图
没有理解到的多看看流程图少吃很多亏,也可以带入自己的业务模式,来考虑怎么设计业务。
这里我们了解到,使用微信统一下单支付接口,前提是需要用户的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");
四、总结
总结的来说,微信支付坑还是不少尤其是是地址和参数,多注意一些还是可以避免的,其他的注意点在我在场景代码里面提出来了,第一次写文章如果有不好的地方,希望大家指出来,希望这篇文章能帮到大家。
文章纯手写,转载请带上作者。