前言

这是博主的第一篇博客,刚刚毕业,打算把工作中遇到的一些比较普遍的问题记录下来,如果有写的不好的地方或者写错的地方欢迎指出,一定会改!嘿嘿嘿。先来立个flag,我希望三年之后能够成为一名不怕bug,热爱生活,健康快乐的富婆!

这篇博客主要介绍如何在Java web项目中集成支付宝的电脑支付接口(会稍微介绍一下服务器集成APP支付接口)。目前支付宝接口更新很快,在博主查找资料的时候,很多都是即时到账接口,APP支付则是移动支付接口等,所以想结合现在的电脑支付接口写一篇博文。如果项目要正式接入支付宝接口的话,是要企业与支付宝创建应用以及签约获取APPID等等的,如果我们只是个人想要学习或者测试的话,可以使用沙箱环境,不需要创建应用和签约,默认有很多应用!!正式环境的开发顺序是:创建应用—签约(电脑支付、APP支付、当面付、手机网站支付等等都需要单独签约!!)

配置沙箱环境

一、如果你是一个新手小白想要在项目中接入支付宝接口,首先你要做的是,进入支付宝官网开放平台。点击“快速开发”下的“开发接入”,跳转到新页面后点击“开发服务”下的“沙箱”。

二、新页面就是支付宝配置沙箱环境的文档以及使用说明,这里告诉我们沙箱环境默认给了我们一个APPID,需要我们自己配置RSA2(SHA256)的应用公钥,需要先下载支付宝生成秘钥的工具,如果是RSA2签名格式的话,记住要生成2048位的!!不要被示例图给迷惑了,当初博主就是这里弄错了!生成之后,进入沙箱应用,上传刚刚生成的应用公钥,上传成功后会生成支付宝公钥,应用私钥以及支付宝公钥会在代码配置中用到。如需要更改秘钥,使用下载的工具重新生成再上传即可!上传应用公钥并获取支付宝公钥,沙箱环境与链接中的示例图略有不同!

导入支付宝电脑支付的demo

一、在沙箱应用的链接中,点击最下面的功能中的电脑网站支付,选择左侧SDK&DEMO的菜单项,下载Java版的demo。

二、解压刚刚下载的demo,导入到eclipse中,目录结构如下图

Java 支付宝支付模块 设计一个 javaweb实现支付宝支付_bug

三、修改AlipayConfig.java文件,记住是商户私钥和支付宝公钥!不要写成应用公钥!应用私钥即商户私钥!

Java 支付宝支付模块 设计一个 javaweb实现支付宝支付_Java 支付宝支付模块 设计一个_02


这里的notify_url和return_url改成自己项目要返回页面的地址,由于是沙箱环境,所以支付宝网关也有修改。return_url是指付款成功之后返回给用户查看的界面,如付款成功之后返回到商品详情或者网站首页等等。notify_url则是支付包与服务器交互的页面,用户看不到,支付成功以notify_url返回的参数或者查询订单返回的参数为准。电脑网站支付快速接入。四、修改配置成功之后,运行项目。

页面如下:

1.

Java 支付宝支付模块 设计一个 javaweb实现支付宝支付_支付宝_03

2.

Java 支付宝支付模块 设计一个 javaweb实现支付宝支付_支付宝_04

3.使用沙箱应用下面的沙箱账号里的买家账号登录,付款!钱会直接打到卖家账户中!这里面的钱可以自己手动添加,很有满足感 !!!!瞬间变富婆啊!!如果想用二维码支付,则到沙箱应用中扫描二维码下载沙箱版的支付宝,再用沙箱的买家账号登录就可以付款了!目前支持安卓版。

4.由于博主并没有写页面,使用的是支付宝默认的,所以返回的是一串json数据。

Java 支付宝支付模块 设计一个 javaweb实现支付宝支付_支付宝_05

5.沙箱调试常见的错误如下图,如果报的错误不在这里面,请自行百度!

Java 支付宝支付模块 设计一个 javaweb实现支付宝支付_Java 支付宝支付模块 设计一个_06

到这里如果能够成功付款或者查询订单等等,就可以看出我们的配置是没有问题的!接下来就要与我们的Java web项目整合并且存订单数据到数据库中!

整合接口到Java web项目

一、博主的框架是公司同事搭的SSM框架,但是与我在网上看的也有点不太一样,不过没关系,整合起来就那么几个文件。首先把上面那个demo里的Alipayconfig.java放在项目中(目录随项目而定),然后导入alipay-sdk-javaXXX.jar、commons-logging-1.1.1.jar这两个jar包到WebContent\WEB-INF\lib中,(具体路径随项目不同而改变)。

二、写支付接口。这里面可以对自己项目中的订单表进行操作,先增加一条订单,但是状态为未付款。然后调用支付宝付款接口。

/**
     * 获取订单数据接口
     * @param request
     * @param response
     * @throws AlipayApiException 
     * @throws IOException 
     */
    @RequestMapping("viewOrder")
    public void viewOrder(HttpServletRequest req, Model mod, HttpServletResponse rep,
            @RequestParam(value = "goodId", required = true)Integer goodId) throws AlipayApiException, IOException{

        CommonResponse cr = new CommonResponse();   
        User cu = ViewSessionManager.getUserSession();
        if(cu == null){   //需要登录才能买东西
            cr.setMessage("未登录");
            cr.setData(null);
            cr.setCode(3109);
        }
        //系统下单
        OrderInfo  param = new OrderInfo();
        param.setGoodId(goodId);
        payService.alipayOrder(cu, param);   //生成订单信息,根据自己项目改动


      //获得初始化的AlipayClient
        AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, "json", AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);

        //设置请求参数
        AlipayTradePagePayRequest alipayRequest = new AlipayTradePagePayRequest();
        alipayRequest.setReturnUrl(AlipayConfig.return_url);
        alipayRequest.setNotifyUrl(AlipayConfig.notify_url);

        //商户订单号,商户网站订单系统中唯一订单号,必填
        String out_trade_no = param.getTradeCode();
        //付款金额,必填
        String total_amount = param.getMoney().toString();
        //订单名称,必填
        String subject = param.getSubject();
        //商品描述,可空
        String body = param.getRemark();

        alipayRequest.setBizContent("{\"out_trade_no\":\""+ out_trade_no +"\"," 
                + "\"total_amount\":\""+ total_amount +"\"," 
                + "\"subject\":\""+ subject +"\"," 
                + "\"body\":\""+ body +"\"," 
                + "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}");

        //请求
        String result = alipayClient.pageExecute(alipayRequest).getBody();

        rep.setContentType("text/html;charset=" + AlipayConfig.charset);
        rep.getWriter().write(result);//直接将完整的表单html输出到页面
        rep.getWriter().flush();
        rep.getWriter().close();
    }

三、写同步通知return_url接口。这里面可以更改订单状态,但是不以这个为准(若网速太卡或者用户付完款关掉页面,则不会跳到这个接口,所以订单状态可能就不会更改)

/**
     * 回调路径return_url
     * @param request
     * @param response
     * @throws AlipayApiException 
     * @throws UnsupportedEncodingException 
     */
    @RequestMapping("return_url.view")
    public String returnUrl(HttpServletRequest request, HttpServletResponse response) throws AlipayApiException, UnsupportedEncodingException{
        //获取支付宝POST过来反馈信息
        Map<String,String> params = new HashMap<String,String>();
        Map requestParams = request.getParameterMap();
        for (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) {
            String name = (String) iter.next();
            String[] values = (String[]) requestParams.get(name);
            String valueStr = "";
            for (int i = 0; i < values.length; i++) {
                valueStr = (i == values.length - 1) ? valueStr + values[i]
                            : valueStr + values[i] + ",";
            }
            //乱码解决,这段代码在出现乱码时使用。
            //valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
            params.put(name, valueStr);
        }
        //切记alipaypublickey是支付宝的公钥,请去open.alipay.com对应应用下查看。
        //boolean AlipaySignature.rsaCheckV1(Map<String, String> params, String publicKey, String charset, String sign_type)
        boolean signVerified = AlipaySignature.rsaCheckV1(params, AlipayConfig.alipay_public_key, AlipayConfig.charset,AlipayConfig.sign_type);
        if(signVerified) {
            //商户订单号
            String out_trade_no = new String(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");

            //支付宝交易号
            String trade_no = new String(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");

            //付款金额
            String total_amount = new String(request.getParameter("total_amount").getBytes("ISO-8859-1"),"UTF-8");

            request.setAttribute("out_trade_no", out_trade_no);
            request.setAttribute("trade_no", trade_no);
            request.setAttribute("total_amount", total_amount);


            log.info("订单处理:系统订单号" + out_trade_no + "支付宝交易号:" + trade_no);
            //系统处理根据支付宝回调更改订单状态或者其他关联表的数据
            OrderInfo order = payService.findOneByTradeCode(out_trade_no);
            if(order == null){
                signVerified = false;
                request.setAttribute("signVerified", signVerified); 
                request.setAttribute("reason", "商户订单号不存在");
                log.error("系统订单:"+ out_trade_no + "不存在。");
            }else{
                if(!order.getMoney().toString().equals(total_amount)){
                    signVerified = false;
                    request.setAttribute("signVerified", signVerified); 
                    request.setAttribute("reason", "付款金额不对");
                    return "notify_url";
                }


                if(order.getTradeStatus() == 1){//判断当前订单是否已处理,避免重复处理
                    log.info("系统订单:"+ out_trade_no + "无需重复处理。");
                }else{
                    order.setTradeStatus(1);//修改订单状态为已支付
                    Date payedAt = new Date();
                    order.setTransactionId(trade_no);
                    order.setPayedAt(payedAt);
                    payService.payOrder(order);
                    log.info("系统订单:"+ out_trade_no + "成功支付。");
                }

            }
        }else{
            request.setAttribute("reason", "验签失败");
        }
        request.setAttribute("signVerified", signVerified);
        return "return_url";
    }

四、异步通知notify_url接口,与上面return_url的几乎相同,只是最后输出:

response.setContentType("text/html;charset=" + AlipayConfig.charset);
            response.getWriter().write("success");//直接将完整的表单html输出到页面
            response.getWriter().flush();
            response.getWriter().close();

方法为void,还有一点需要注意的是:必须保证服务器异步通知页面(notify_url)上无任何字符,如空格、HTML标签、开发系统自带抛出的异常提示信息等
电脑网站支付结果异步通知
数据库中订单状态的更新以这个接口中的为准!

五、查询订单接口。这里的返回类型CommonResponse 是我们公司自己的,你们改成自己的返回类型就好.我们这个是ajax调用接口,然后将orderString的数据返回,实际上是json数据。

/**
     * 支付宝交易查询接口
     * @param request
     * @param response
     * @throws UnsupportedEncodingException 
     * @throws AlipayApiException 
     */
    @RequestMapping("queryOrder")
    @ResponseBody
    public CommonResponse queryOrder(HttpServletRequest req, Model mod, HttpServletResponse rep,
            @RequestParam(value = "tradeCode", required = true)String tradeCode,
            @RequestParam(value = "tradeNo", required = true)String tradeNo) throws UnsupportedEncodingException, AlipayApiException{

        CommonResponse cr = new CommonResponse();
        AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, "json", AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type); //获得初始化的AlipayClient
        AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();//创建API对应的request类
        request.setBizContent("{" +
                "   \"out_trade_no\":\""+tradeCode+"\"," +
                "   \"trade_no\":\""+tradeNo+"\"" +
                "  }");//设置业务参数
        //根据response中的结果继续业务逻辑处理
        String orderString = null;  
        try {
                //调用查询方法
                AlipayTradeQueryResponse response = alipayClient.execute(request);//通过alipayClient调用API,获得对应的response类
                orderString = response.getBody();//就是orderString 可以直接给客户端请求,无需再做处理。
            } catch (AlipayApiException e) {
                e.printStackTrace();
        }
        cr.setData(orderString);    //返回orderString
        return cr;
    }

服务器端添加APP支付接口

与电脑支付接口类似,可以直接使用同一个jar包,不过在付款接口的入参里需要添加token。下面是部分代码。我相信你们足够聪明能够改成自己的!

CommonResponse cr = new CommonResponse();   
        Cache<String, User> apiAccessTokenCache = cacheManager.getCache("apiAccessTokenCache");
        User cu = apiAccessTokenCache.get(token);//登录时候产生的token,通过token获得User
        if(cu == null){
            cr.setMessage("token值不对或已失效");
            cr.setData(null);
            cr.setCode(3109);
            return cr;
        }
        //系统下单
        OrderInfo  param = new OrderInfo();
        param.setGoodId(goodId);
        payService.order(cu, param);   //生成订单信息

        //实例化客户端
        AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, "json", AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
        //实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.trade.app.pay
        AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
        //SDK已经封装掉了公共参数,这里只需要传入业务参数。以下方法为sdk的model入参方式(model和biz_content同时存在的情况下取biz_content)。
        AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
        String time = Long.toString(System.currentTimeMillis()/1000);
        model.setBody(param.getRemark());
        model.setSubject(param.getSubject());
        model.setOutTradeNo(param.getTradeCode());
        model.setTimeoutExpress(time);
        model.setTotalAmount(param.getMoney()+"");
        model.setProductCode("QUICK_MSECURITY_PAY");
        request.setBizModel(model);
        request.setReturnUrl(AlipayConfig.return_url);
        request.setNotifyUrl(AlipayConfig.notify_url);
        String orderString = null;  
        try {
                //这里和普通的接口调用不同,使用的是sdkExecute
                AlipayTradeAppPayResponse response = alipayClient.sdkExecute(request);
                orderString = response.getBody();//就是orderString 可以直接给客户端请求,无需再做处理。
            } catch (AlipayApiException e) {
                e.printStackTrace();
        }
        cr.setData(orderString);    //返回orderString
        return cr;

转换成正式环境

需要修改配置文件中的APPID,支付宝公钥,应用私钥,以及支付宝网关!有时改了网关之后跳转的还是沙箱环境的网关,需要clean一下服务器(我的是Tomcat)

结语

上面就是博主总结的Java web项目集成支付宝电脑支付接口!希望这一篇博文能够解决你的问题,祝好运!如果有疑问可以给我留言,看到了如果我会的问题就会回答!☺☺