微信开发之微信公众号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");
四、总结
总结的来说,微信支付坑还是不少尤其是是地址和参数,多注意一些还是可以避免的,其他的注意点在我在场景代码里面提出来了,第一次写文章如果有不好的地方,希望大家指出来,希望这篇文章能帮到大家。
文章纯手写,转载请带上作者。