微信公众号H5支付-JAVA版

微信开发之微信公众号H5支付-JAVA版

  引子

  从事JAVA开发一年多了,一直都在看博客园,CSDN的博客,从很多前人哪里学习了很多,突然觉得自己也要尽一份力,写点博客自己给自己做做记录,也给要开发微信人提提醒少遇点坑。

  很多人开发微信的时候,总是在抱怨微信的开发文档很坑,里面的参数和使用方式很含糊,其实有时候自己想想,如果自己去研发API的时候,是否能够做的比微信更好呢?,大师都有一颗虔诚学徒的心,希望这篇文档能给予从事微信公众号H5支付焦头烂额的朋友,一点帮助。

  一、前言

  先给大家提提从事微信开发,需要做的一些准备条件:1、去微信公共平台和微信商户平台注册一个账号,这里需要给微信交纳300块RMB成为一个开发者拥有开发资质 ,微信公共平台网址 、微信商户平台网址 2、申请一个服务号详细流程我就不提醒了,服务号是需要企业认证的(如果没有企业资格,又想练练手的朋友可以去申请一个微信公众号测试号,进行一些简单的开发,微信测试号网址) 。3、注意看文档,切记重要的事情说三遍!!!,做操作之前仔细理解文档里面的内容,参数里面的关系,请求的格式之类的,这种错误是最难发现的,微信公共号开发文档网址 ,微信支付文档

  二、思路

 进行开发之前,先把思路理清楚了解,了解微信支付的类型,微信公众号H5支付-JAVA版这里类型有很多,我们需要的是公众号支付,通过官网文档了解,这里需要注册一个微信商户,这个我就不解释了,按照官网的指示撸就行了,这里展示一个官网的业务流程图。

  支付业务流程图

微信公众号H5支付-JAVA版

  没有理解到的多看看流程图少吃很多亏,也可以带入自己的业务模式,来考虑怎么设计业务。

  这里我们了解到,使用微信统一下单支付接口,前提是需要用户的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();
        }

前端做完,这一步顺利调出来微信支付的弹框

微信公众号H5支付-JAVA版

 

 这里就基本大功告成了,还有差一步处理支付的回调,根据微信官方提示前端返回的支付成功是不靠谱的,需要微信异步回调来验证,一共有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");

四、总结

总结的来说,微信支付坑还是不少尤其是是地址和参数,多注意一些还是可以避免的,其他的注意点在我在场景代码里面提出来了,第一次写文章如果有不好的地方,希望大家指出来,希望这篇文章能帮到大家。

文章纯手写,转载请带上作者。

  

  

 

微信公众号H5支付-JAVA版

上一篇:微信小程序swiper 前后边距的使用


下一篇:微信小程序避坑指南