支付宝当面付扫码支付功能详解

前言： 上篇呢主要是针对微信验证登录做了讲解，当然微信也是提供了很多的接口来供开发者进行调用，同样，微信也有支付，相信小伙伴们学习了上篇的登录之后，已经能够融汇贯通，做出微信的支付功能。那么本篇呢就讲解一下支付宝的支付功能，同样的，通过这一个例子，你就能使用支付宝其它的功能，还是那句老话，就当做是一个敲门砖吧，好了，下面就开始吧。

 

本篇为原创，转载请标出处：http://www.cnblogs.com/gudu1/p/8094197.html

 

　　微信有测试公众号测试，那么支付宝呢？他也有，不过名字是叫做支付宝沙箱环境，地址：https://sandbox.alipaydev.com/sms/receive.htm ，扫码登陆之后：

 

　　>> APPID，支付宝网关，以及应用网关 这些呢是固定不变的。

　　>> 我们已经知道微信使用的是 SHA-1 加密，那么支付宝使用的就是RSA 和 RSA2 加密，当然了，支付宝推荐使用RSA2加密，两个的区别就是RSA2 是2048 位，RSA 是1024位，所以RSA2加密更好，我们就使用它就好。

　　>> 授权回调地址就是用户扫码进行支付之后，支付宝服务器回调我们程序接口的地址，规则呢跟微信的是一样的，这里不多讲了，不明白的请看一下上篇微信验证登录的讲解 http://www.cnblogs.com/gudu1/p/8087130.html。

　　>> 接下来的就配置一下我们的密匙，使用哪个加密方式就配置哪个就好了，支付宝很周到，给我们提供了生成密匙的工具，下载位置：https://docs.open.alipay.com/291/105971 ，这个也是支付宝的官方文档，具体怎么使用，里面都很详细，这里就不占篇幅了，然后生成之后，就直接 copy 进去配置就好了，很简单的。

 

　　下面还是老样子，先贴出代码，然后讲解代码中的一些点，支付宝也提供了Java 、PHP、.NET  版本的支付代码，这点是非常到位的，所以我们只是站在巨人的肩膀上，前人栽树，后人乘凉，下载地址：https://docs.open.alipay.com/194/105201/ ，下载我们都会，下载之后把代码copy 出来，需要使用哪个功能就copy 哪个，因为我这里使用的支付宝生成二维码预下单的功能，然后：

Controller 

@Controller
@RequestMapping("/order/")
public class OrderController {
 @RequestMapping("pay.do")
    @ResponseBody
    private ServerResponse<Map<String, String>> pay(HttpSession session, Long orderNo, HttpServletRequest request) {
        Integer userId = ((User) session.getAttribute(Const.CURRENT_USER)).getId();
        String path = request.getSession().getServletContext().getRealPath(PropertiesUtil.getProperty("upload_image_path"));
        if (orderNo == null || orderNo == 0L) {
            return ServerResponse.createByErrorMessage("支付订单不能为空");
        }
        return orderService.pay(userId, orderNo, path);
    }
}

 

　Service 的pay 方法

@Service("iOrderService")
public class OrderServiceImpl implements IOrderService {

    private static final Logger logger = LoggerFactory.getLogger(OrderServiceImpl.class);
    // 支付宝当面付2.0服务
    private static AlipayTradeService tradeService;
    static {
        /** 一定要在创建AlipayTradeService之前调用Configs.init()设置默认参数
         *  Configs会读取classpath下的zfbinfo.properties文件配置信息，如果找不到该文件则确认该文件是否在classpath目录
         */
        Configs.init("zfbinfo.properties");

        /** 使用Configs提供的默认参数
         *  AlipayTradeService可以使用单例或者为静态成员对象，不需要反复new
         */
        tradeService = new AlipayTradeServiceImpl.ClientBuilder().build();
    }
/**
     * 支付宝预创建支付订单，生成支付的二维码用户用户扫码支付
     *
     * @param userId  用户ID
     * @param orderNo 订单号
     * @param path    本地上传图片地址
     * @return
     */
    @Transactional
    public ServerResponse pay(Integer userId, Long orderNo, String path) {
        Map<String, String> mapResult = Maps.newHashMap();
        Order order = orderMapper.selectOrderByOrderNo(orderNo);
        if (order == null) {
            return ServerResponse.createBySuccessMessage("该订单不存在");
        }
        // (必填) 商户网站订单系统中唯一订单号，64个字符以内，只能包含字母、数字、下划线，
        // 需保证商户系统端不能重复，建议通过数据库sequence生成，
        String outTradeNo = order.getOrderNo().toString();

        // (必填) 订单标题，粗略描述用户的支付目的。如“xxx品牌xxx门店当面付扫码消费”
        String subject = "Happy_mmall 扫码付款";

        // (必填) 订单总金额，单位为元，不能超过1亿元
        // 如果同时传入了【打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【打折金额】+【不可打折金额】
        String totalAmount = order.getPayment().toString();

        // (可选) 订单不可打折金额，可以配合商家平台配置折扣活动，如果酒水不参与打折，则将对应金额填写至此字段
        // 如果该值未传入,但传入了【订单总金额】,【打折金额】,则该值默认为【订单总金额】-【打折金额】
        String undiscountableAmount = "0";

        // 卖家支付宝账号ID，用于支持一个签约账号下支持打款到不同的收款账号，(打款到sellerId对应的支付宝账号)
        // 如果该字段为空，则默认为与支付宝签约的商户的PID，也就是appid对应的PID
        String sellerId = "";

        // 订单描述，可以对交易或商品进行一个详细地描述，比如填写"购买商品2件共15.00元"
        String body = new StringBuffer().append("订单:").append(order.getOrderNo()).append(",共花费").append(order.getPayment()).append("元").toString();

        // 商户操作员编号，添加此参数可以为商户操作员做销售统计
        String operatorId = "test_operator_id";

        // (必填) 商户门店编号，通过门店号和商家后台可以配置精准到门店的折扣信息，详询支付宝技术支持
        String storeId = "test_store_id";

        // 业务扩展参数，目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法)，详情请咨询支付宝技术支持
        ExtendParams extendParams = new ExtendParams();
        extendParams.setSysServiceProviderId("2088100200300400500");

        // 支付超时，定义为120分钟
        String timeoutExpress = "120m";

        // 商品明细列表，需填写购买商品详细信息，
        List<GoodsDetail> goodsDetailList = new ArrayList<GoodsDetail>();

        // 添加 用户 预支付的订单中的商品
        List<OrderItem> orderItemList = orderItemMapper.selectListByUserIdAndOrderNo(orderNo, userId);
        for (OrderItem orderItem : orderItemList) {
            GoodsDetail goods1 = GoodsDetail.newInstance(orderItem.getProductId().toString(), orderItem.getProductName(),
                    BigDecimalUtil.mul(orderItem.getCurrentUnitPrice().doubleValue(), new Double(100)).longValue(),
                    orderItem.getQuantity());
            goodsDetailList.add(goods1);
        }

        // 创建扫码支付请求builder，设置请求参数
        AlipayTradePrecreateRequestBuilder builder = new AlipayTradePrecreateRequestBuilder()
                .setSubject(subject).setTotalAmount(totalAmount).setOutTradeNo(outTradeNo)
                .setUndiscountableAmount(undiscountableAmount).setSellerId(sellerId).setBody(body)
                .setOperatorId(operatorId).setStoreId(storeId).setExtendParams(extendParams)
                .setTimeoutExpress(timeoutExpress)
                .setNotifyUrl(PropertiesUtil.getProperty("alipay.callback.url"))//支付宝服务器主动通知商户服务器里指定的页面http路径,根据需要设置
                .setGoodsDetailList(goodsDetailList);

        // 创建预支付订单对象
        AlipayF2FPrecreateResult result = tradeService.tradePrecreate(builder);
        switch (result.getTradeStatus()) {
            case SUCCESS:
                logger.info("支付宝预下单成功: )");
                // 获取响应 Response
                AlipayTradePrecreateResponse response = result.getResponse();
                //  简单打印一下日志
                dumpResponse(response);
                // 创建本地上传图片的文件夹，不存在则创建
                File folder = new File(path);
                if (!folder.exists()) {
                    folder.setWritable(true);
                    folder.mkdirs();
                }
                // 需要修改为运行机器上的路径,
                String filePath = String.format(path + "/qr-%s.png",
                        response.getOutTradeNo());
                // %s 是一种占位符，即后面的response.getOutTradeNo() ，只是生成额随机字符串，防止重名
                String fileName = String.format("/qr-%s.png", response.getOutTradeNo());

                logger.info("filePath:" + filePath);
                // 上传到本地服务器
                ZxingUtils.getQRCodeImge(response.getQrCode(), 256, filePath);
                File targetFile = new File(path, fileName);
                try {
                    // 上传图片到FTP服务器，上传FTP完毕之后，删除本地存储的图片
                    FTPUtil.upload(Lists.newArrayList(targetFile));
                } catch (IOException e) {
                    logger.error("上传二维码失败", e);
                    e.printStackTrace();
                }
                // 刚刚上传到FTP的图片地址URL
                String qrPathUrl = PathUtil.getFTPImgPath(targetFile.getName());
                mapResult.put("qrPath", qrPathUrl);
                mapResult.put("orderNo", orderNo.toString());
                return ServerResponse.createBySuccess(mapResult);
            case FAILED:
                logger.error("支付宝预下单失败!!!");
                return ServerResponse.createByErrorMessage("支付宝预下单失败!!!");

            case UNKNOWN:
                logger.error("系统异常，预下单状态未知!!!");
                return ServerResponse.createByErrorMessage("系统异常，预下单状态未知!!!");

            default:
                logger.error("不支持的交易状态，交易返回异常!!!");
                return ServerResponse.createByErrorMessage("不支持的交易状态，交易返回异常!!!");
        }
    }
}

 

　　>> 在此之前呢不要忘记添加支付宝的集成依赖jar包。

　　>> 为了方便理解，代码中的每一步都添加了注释，代码比较多，但是大多数的代码都是直接copy支付宝 提供的Demo，然后根据我们自己的业务需求修改。

　　>> 由于篇幅问题，请注意静态代码块中的代码，会加载一个配置文件，这个配置文件支付宝同样有提供，我们只要修改一下其中的参数值，APPID、PID（商户UID）、以及加密的公钥和私钥。

　　>> 我们程序支付整体的思路是这样：用户确认下单后，点击支付，然后会调用我们pay.do 这个接口，然后我们的程序在向支付宝服务器发送请求之前会添加一些参数，就是商品的订单号、收款平台信息、以及购买商品需要支付的总价格，需要修改的一处是 创建AlipayTradePrecreateRequestBuilder对象的时候，把call_back的URL修改成我们自己程序的接口，然后程序就向支付宝发送消息，因为这里支付宝集成做的特别好，只需要创建一个预支付对象，把需要的参数传进去，就可以发起预支付请求，返回二维码字节流，我们把二维码进行保存，然后展示给用户，进行扫码支付，用户扫码之后，不管是支付成功或者支付失败都会回调我们的call_back中配置的URL，进行处理。

 

 接下来就是我们的 call_back ：

@Controller
@RequestMapping("/order/")
public class OrderController {
    @RequestMapping("alipay_callback.do")
    @ResponseBody
    private ServerResponse callBack(HttpServletRequest request) throws AlipayApiException {
        // 取出支付宝回调携带的所有参数并进行转换，数组转换为字符串
        Map<String, String[]> tempParams = request.getParameterMap();
        //  参数存放 Map
        Map<String, String> requestParams = Maps.newHashMap();
        for (Iterator<String> iterator = tempParams.keySet().iterator(); iterator.hasNext(); ) {
            String key = iterator.next();
            String[] strs = tempParams.get(key);
            String str = "";
            // 这里如果数组的长度是1，说明只有一个，直接赋值就好，如果超过一个，后面加一个逗号来隔离
            for (int i = 0; i < strs.length; i++) {
                str = strs.length - 1 == i ? str + strs[i] : str + strs[i] + ",";
            }
            requestParams.put(key, str);
        }
        // 去除sign_type
        requestParams.remove("sign_type");
        try {
            // 验证签名
            boolean result = AlipaySignature.rsaCheckV2(requestParams, Configs.getPublicKey(), "utf-8", Configs.getSignType());
            if (!result) {
                return ServerResponse.createByErrorMessage("非法请求,再恶意请求我就报警找网警了");
            }
        } catch (AlipayApiException e) {
            logger.error("支付宝回调验证异常", e);
            e.printStackTrace();
            throw e;
        }
        // 调用Service 方法进行处理
        ServerResponse serverResponse = orderService.alipayCallBack(requestParams);
        if (!serverResponse.isSuccess()) {
            logger.error("OrderController.callBack()","数据操作失败");
            return ServerResponse.createBySuccess(Const.AlipayCallback.RESPONSE_FAILED);
        }
        logger.info("支付宝支付回调完成，没有异常");
        return ServerResponse.createBySuccess(Const.AlipayCallback.RESPONSE_SUCCESS);
    }
}

 

　

　　>> 这个支付宝回调URL是这样：http://smyang.s1.natapp.cc/order/alipay_callback.do，对应我们的Controller 的RequestMapping中的路由，代码中都有添加注释，还是很清晰的。

　　>> 支付宝的验证签名的规则是怎样的呢？在通知返回的参数中除了sign_type和sign，其余的都是待验签的参数，详细请看 https://docs.open.alipay.com/194/103296/ ，但是这里只remove 掉了sign_type，通过查看源码发现，在支付宝集成代码中需要获取一下sign，然后它才remove 掉了sign，所以这里我们只需要remove掉sign_type就好，而且是必须的。

　　>> 在 rsaCheckV2() 方法中我们加入的参数sign_type，指定了使用哪种加密方式来验签，如果通过就确定这个支付过程是安全的，同时 Configs 这个类也是支付宝给我们提供的，很到位的吧！

　　>> 最后调用了Service方法进行我们的代码逻辑，比如：更新数据库中用户的支付状态，这个就是我们自己的业务需求了，在我们的业务代码中主要是通过支付宝回调参数中的 tradeStatus 这个字段来判断用户是否支付成功，具体的tradeStatus的状态，可以自行查看支付宝官方文档。

 

当然，支付宝不止这一种支付方式，另外还有好多，可以自行去查看，官方文档才是我们最好的老师。好了，到这里就先结束了，后续如果有不足的地方再另行修改。

 

　　　　　　　　The End。。。。。