Java微信支付开发之扫码支付模式一

官方文档
准备工作：已通过微信认证的公众号，必须通过ICP备案域名（否则会报支付失败）

借鉴了很多大神的文章，在此先谢过了

大体过程：先扫码(还没有确定实际要支付的金额)，这个码是商品的二维码，再生成订单，适用于自动贩卖机之类固定金额的。

 

模式一支付的流程如下图，稍微有点复杂

 

业务流程说明：

（1）商户后台系统根据微信支付规定格式生成二维码（规则见下文），展示给用户扫码。
（2）用户打开微信“扫一扫”扫描二维码，微信客户端将扫码内容发送到微信支付系统。
（3）微信支付系统收到客户端请求，发起对商户后台系统支付回调URL的调用。调用请求将带productid和用户的openid等参数，并要求商户系统返回交数据包

（4）商户后台系统收到微信支付系统的回调请求，根据productid生成商户系统的订单。

（5）商户系统调用微信支付【统一下单API】请求下单，获取交易会话标识（prepay_id）。
（6）微信支付系统根据商户系统的请求生成预支付交易，并返回交易会话标识（prepay_id）。
（7）商户后台系统得到交易会话标识prepay_id（2小时内有效）。
（8）商户后台系统将prepay_id返回给微信支付系统。
（9）微信支付系统根据交易会话标识，发起用户端授权支付流程。
（10）用户在微信客户端输入密码，确认支付后，微信客户端提交支付授权。
（11）微信支付系统验证后扣款，完成支付交易。
（12）微信支付系统完成支付交易后给微信客户端返回交易结果，并将交易结果通过短信、微信消息提示用户。微信客户端展示支付交易结果页面。
（13）微信支付系统通过发送异步消息通知商户后台系统支付结果。商户后台系统需回复接收情况，通知微信后台系统不再发送该单的支付通知。
（14）未收到支付通知的情况，商户后台系统调用【查询订单API】。
（15）商户确认订单已支付后给用户发货。

一、设置回调地址

商户后台系统根据微信支付规则链接生成二维码，链接中带固定参数productid（可定义为产品标识或订单号）。用户扫码后，微信支付系统将productid和用户唯一标识(openid)回调商户后台系统(需要设置支付回调URL)，商户后台系统根据productid生成支付交易，最后微信支付系统发起用户支付流程
商户支付回调URL设置指引：进入公众平台-->微信支付-->开发配置-->扫码支付-->修改，如下图所示。

这个支付回调的URL设置的作用是接收用户扫码后微信支付系统发送的数据，根据接收的数据生成商户系统的支付订单返回给微信支付系统，调用【统一下单API】提交支付交易。

 

二、生成微信支付二维码

参考文档https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_6

二维码长链接示例：

weixin：//wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX

这样太冗长了，转换成短链接 weixin://wxpay/bizpayurl?pr=XXXX

 /**
     * 扫码支付模式一生成二维码
     *
     * @param productId 商品ID
     * @throws IOException
     */
    @GetMapping("M1")
    public Map<String, Object> payone(HttpServletRequest request, String productId) {
        Map<String, Object> data = new HashMap<>();
        String nonce_str = PayHelper.createNonceStr();
        // String product_id = "product_001"; // 推荐根据商品ID生成
        TreeMap<String, Object> packageParams = new TreeMap<>();
        packageParams.put("appid", wechatAccountConfig.getAppid());
        packageParams.put("mch_id", PayConstant.MCH_ID);
        packageParams.put("product_id", productId);
        packageParams.put("time_stamp", PayHelper.createTimeStamp());
        packageParams.put("nonce_str", nonce_str);
        String str_url = PayHelper.createPayImageUrl(packageParams);
        String sign = SignatureUtil.md5Hex(packageParams, PayConstant.API_KEY, null);
        packageParams.put("sign", sign);
        String payurl = "weixin://wxpay/bizpayurl?sign=" + sign + str_url;
        log.debug("payurl is {}", payurl);
        /**** 转成短链接 ****/
        PayShortUrlParams payShortUrlParams = new PayShortUrlParams();
        payShortUrlParams.setAppid(wechatAccountConfig.getAppid());
        payShortUrlParams.setMch_id(PayConstant.MCH_ID);
        payShortUrlParams.setLong_url(payurl);
        payShortUrlParams.setNonce_str(nonce_str);
        String urlSign = SignatureUtil.md5Hex(payShortUrlParams, PayConstant.API_KEY,
                null);
        payShortUrlParams.setSign(urlSign);
        String longXml = XmlUtil.toXml(payShortUrlParams);
        String shortResult = HttpUtil.doPost(wechatPayConfig.getPayShortUrl(), null,
                longXml);
        PayShortUrlResult payShortUrlResult = XmlUtil.fromXml(shortResult, PayShortUrlResult.class);
        if (Objects.equals("SUCCESS", payShortUrlResult.getReturn_code())) {
            payurl = payShortUrlResult.getShort_url();
        } else {
            log.debug("错误信息" + payShortUrlResult.getReturn_msg());
        }
        /**** 生成 二维码图片自行实现 ****/
        //定义savePath
        ZXingCodeUtil.toQRCode(payurl, null, "savePath", null);
        return data;
    }

/**
     * 生成支付二维码URL
     *
     * @param params
     * @return
     */
    public static String createPayImageUrl(TreeMap<String, Object> params) {
        StringBuilder buffer = new StringBuilder();
        for (Map.Entry<String, Object> entry : params.entrySet()) {
            if (entry.getValue() != null) {
                buffer.append("&").append(entry.getKey()).append("=").append(entry.getValue());
            }
        }
        return buffer.toString();
    }

 

三、回调商户支付URL

接收用户扫码后微信支付系统发送的数据，根据接收的数据生成商户系统的支付订单返回给微信支付系统，调用统一下单API提交支付交易

package com.phil.wechat.pay.controller;

import com.phil.modules.config.WechatAccountConfig;
import com.phil.modules.util.HttpUtil;
import com.phil.modules.util.SignatureUtil;
import com.phil.modules.util.XmlUtil;
import com.phil.wechat.pay.config.WechatPayConfig;
import com.phil.wechat.pay.constant.PayConstant;
import com.phil.wechat.pay.model.request.PayCallBackParams;
import com.phil.wechat.pay.model.request.UnifiedOrderParams;
import com.phil.wechat.pay.model.response.PayCallBackResult;
import com.phil.wechat.pay.model.response.UnifiedOrderResult;
import com.phil.wechat.pay.util.PayHelper;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.io.IOUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedOutputStream;
import java.util.Objects;

/**
 * 扫码模式一回调
 *
 * @author phil
 * @date 2017年6月27日
 */
@Controller
@RequestMapping("api/wxpay")
@Slf4j
public class WechatPayCallBackController {

    private final WechatPayConfig wechatPayConfig;

    private final WechatAccountConfig wechatAccountConfig;

    @Autowired
    public WechatPayCallBackController(WechatPayConfig wechatPayConfig, WechatAccountConfig wechatAccountConfig) {
        this.wechatPayConfig = wechatPayConfig;
        this.wechatAccountConfig = wechatAccountConfig;
    }

    @RequestMapping("callback") // 仅仅是扫码模式一的
    public void callBack(HttpServletRequest request, HttpServletResponse response) throws Exception {
        String resXml = "";// 反馈给微信服务器
        // 微信支付系统发送的数据（<![CDATA[product_001]]>格式）
        String xml = IOUtils.toString(request.getInputStream());
        // logger.info("微信支付系统发送的数据"+xml);
        /**** 微信支付系统发送的数据其实就是回调地址输入的参数Xml ****/
        // 验证签名
        if (SignatureUtil.checkValidPaySign(xml, PayConstant.API_KEY)) {
            // 转换成输入参数，
            PayCallBackParams payCallBackParams = XmlUtil.fromXml(xml, PayCallBackParams.class);
            // appid openid mch_id is_subscribe nonce_str product_id sign
            // 统一下单
            String openid = payCallBackParams.getOpenid();
            String product_id = payCallBackParams.getProduct_id();
            /**** product_id 等 生成自己系统的订单 ****/
            int total_fee = 1; // 根据product_id算出价格
            String out_trade_no = PayHelper.createOutTradeNo(); // 生成订单号
            String body = product_id; // 商品名称设置为product_id
            String attach = "XXX店"; // 附加数据
            String nonce_str = PayHelper.createNonceStr();
            String spbill_create_ip = HttpUtil.getRemortIP(request);
            // 组装统一下单的请求参数
            UnifiedOrderParams unifiedOrderParams = new UnifiedOrderParams();
//			unifiedOrderParams.setAppid(WechatConfig.APP_ID);// 必须
//			unifiedOrderParams.setMch_id(PayConstant.MCH_ID);// 必须
            unifiedOrderParams.setOut_trade_no(out_trade_no);
            unifiedOrderParams.setBody(body);
            unifiedOrderParams.setAttach(attach);
            unifiedOrderParams.setTotal_fee(total_fee);// 必须
            unifiedOrderParams.setNonce_str(nonce_str); // 必须
            unifiedOrderParams.setSpbill_create_ip(spbill_create_ip); // 必须
            unifiedOrderParams.setTrade_type("NATIVE");// 必须
            unifiedOrderParams.setOpenid(openid);
            unifiedOrderParams.setNotify_url(wechatPayConfig.getNotifyUrl()); // 异步通知URL
            // 签名
            String sign = SignatureUtil.md5Hex(unifiedOrderParams, PayConstant.API_KEY, new String[] {"serialVersionUID"});
            unifiedOrderParams.setSign(sign);
            // 统一下单 请求的Xml
            String unifiedXmL = XmlUtil.toXml(unifiedOrderParams);
            // 统一下单 返回的xml
            String unifiedOrderResultXmL = HttpUtil.doPost(
                    wechatPayConfig.getUnifiedOrderUrl(), null, unifiedXmL);
            // 统一下单返回 验证签名
            if (SignatureUtil.checkValidPaySign(unifiedOrderResultXmL, PayConstant.API_KEY)) {
                UnifiedOrderResult unifiedOrderResult = XmlUtil
                        .fromXml(unifiedOrderResultXmL, UnifiedOrderResult.class);
                if (Objects.equals("SUCCESS", unifiedOrderResult.getReturn_code())
                        && Objects.equals("SUCCESS", unifiedOrderResult.getResult_code())) {
                    PayCallBackResult payCallBackResult = new PayCallBackResult();
                    payCallBackResult.setReturn_code(unifiedOrderResult.getReturn_code());
                    payCallBackResult.setAppid(wechatAccountConfig.getAppid());
                    payCallBackResult.setMch_id(PayConstant.MCH_ID);
                    payCallBackResult.setNonce_str(unifiedOrderResult.getNonce_str());// 直接用微信返回的
                    /**** prepay_id 2小时内都有效，根据product_id再次支付方法自己写 ****/
                    payCallBackResult.setPrepay_id(unifiedOrderResult.getPrepay_id());
                    payCallBackResult.setResult_code(unifiedOrderResult.getResult_code());
                    String callsign = SignatureUtil.md5Hex(payCallBackResult, PayConstant.API_KEY, null);
                    payCallBackResult.setSign(callsign);
                    resXml = XmlUtil.toXml(payCallBackResult).replace("__", "_");
                    // 将数据包返回给微信支付系统处理
                }
            } else {
                log.error("签名验证错误");
                resXml = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>"
                        + "<return_msg><![CDATA[签名验证错误]]></return_msg>" + "</xml> ";
            }
        } else {
            log.error("签名验证错误");
            resXml = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>"
                    + "<return_msg><![CDATA[签名验证错误]]></return_msg>" + "</xml> ";
        }
        try (BufferedOutputStream out = new BufferedOutputStream(response.getOutputStream())) {
            out.write(resXml.getBytes());
            out.flush();
        } catch (Exception e) {
            log.error(e.getMessage());
        }
    }
}

四、完成支付并通知支付结果

package com.phil.wechat.pay.controller;

import com.phil.modules.result.ResultState;
import com.phil.modules.util.SignatureUtil;
import com.phil.modules.util.XmlUtil;
import com.phil.wechat.pay.model.response.PayNotifyResult;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.io.IOUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedOutputStream;
import java.util.Objects;

/**
 * 微信支付结果通知(统一下单参数的notify_url)
 *
 * @author phil
 * @date 2017年6月27日
 */
@RestController
@RequestMapping("api/wxpay")
@Slf4j
public class WechatPayNotifyController {

    @RequestMapping("notify")
    public ResultState notice(HttpServletRequest request, HttpServletResponse response) throws Exception {
        ResultState resultState = new ResultState();
        log.debug("开始处理支付返回的请求");
        String resXml = ""; // 反馈给微信服务器
        String notifyXml = IOUtils.toString(request.getInputStream());// 微信支付系统发送的数据（<![CDATA[product_001]]>格式）
        log.debug("微信支付系统发送的数据" + notifyXml);
        // 验证签名
        if (SignatureUtil.checkValidPaySign(notifyXml, null)) {
            PayNotifyResult notify = XmlUtil.fromXml(notifyXml, PayNotifyResult.class);
            log.debug("支付结果 {}", notify.toString());
            if (Objects.equals("SUCCESS", notify.getResult_code())) {
                resultState.setErrcode(0);// 表示成功
                resultState.setErrmsg(notify.getResult_code());
                /**** 业务逻辑 保存openid之类的 ****/
                // 通知微信.异步确认成功.必写.不然会一直通知后台.八次之后就认为交易失败了
                resXml = "<xml>" + "<return_code><![CDATA[SUCCESS]]></return_code>"
                        + "<return_msg><![CDATA[OK]]></return_msg>" + "</xml> ";
            } else {
                resultState.setErrcode(-1);// 支付失败
                resultState.setErrmsg(notify.getErr_code_des());
                log.debug("支付失败,错误信息：" + notify.getErr_code_des());
                resXml = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA["
                        + notify.getErr_code_des() + "]]></return_msg>" + "</xml> ";
            }
        } else {
            resultState.setErrcode(-1);// 支付失败
            resultState.setErrmsg("签名验证错误");
            log.debug("签名验证错误");
            resXml = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>"
                    + "<return_msg><![CDATA[签名验证错误]]></return_msg>" + "</xml> ";
        }
        try (BufferedOutputStream out = new BufferedOutputStream(response.getOutputStream())) {
            out.write(resXml.getBytes());out.flush();
        } catch (Exception e) {

            log.error(e.getMessage());
        }
        return resultState;
    }
}

具体源码： https://github.com/philjing/my_wechat/tree/master/src/main/java/com/phil/wechat/pay