浅析微信支付：统一下单接口

本文是【浅析微信支付】系列文章的第五篇，主要讲解如何调用统一下单接口生成预支付单及调起支付页面。

---

浅析微信支付系列已经更新四篇了哟～，没有看过的朋友们可以看一下哦。

浅析微信支付：微信公众号网页授权

浅析微信支付：开发前的准备

上面是本文的前置文章，有前面几篇文章的基础以后看会更加明了，如果已经看过的小伙伴可以忽略。

1、什么是[统一下单接口]？

首先我们要明白这个问题，需要先行看一下微信的官方文档：
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1

官方解释如下：

除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。

什么意思？简单理解：就是说我们要在调起微信支付窗口之前，需要先生成一个 预支付交易单，这个单子相当于和我们自身系统的 支付交易单 一一对应，也就是我们每次支付需要记录的订单支付交易单。

从上面我们可以得到，在调用此接口之前，首先，我们系统中肯定已经需要有以下步骤：订单提交 -> 生成订单 -> 生成订单对应的支付单 -> 调用统一下单接口

好了，假设系统现在已经生成支付交易单，准备调用统一下单接口，我们来看一下具体的实现方式。

PS：调用统一下单接口时，需要注意的是必须传入异步接收微信支付结果通知的回调地址，通知url必须为外网可访问的url，不能携带参数。示例如下：

https://xxx.com/v1/weixin/pay/wxnotify

2、调用接口

示例代码：

/**
 * [微信支付统一下单] - 保存调用的相关记录 <p>
 * [微信支付小程序] - 返回支付唤醒参数
 * @param payment 付款对象
 * @param user 当前用户
 * @return map
 * @throws Exception e
 *
 * @author yclimb
 * @date 2018/6/15
 */
public Map<String, String> saveWxPayUnifiedOrder(Payment payment, User user) throws Exception {
    if (payment == null || user == null) {
        return null;
    }

    // 1.调用微信统一下单接口
    WXPay wxPay = new WXPay(WXPayConfigImpl.getInstance());
    Map<String, String> resultMap = wxPay.unifiedOrder(...);

    // 1.1.记录付款流水
    ...

    // 下单失败，进行处理
    if (WXPayConstants.FAIL.equals(resultMap.get(WXPayConstants.RETURN_CODE)) ||
            WXPayConstants.FAIL.equals(resultMap.get(WXPayConstants.RESULT_CODE))) {

        // 处理结果返回，无需继续执行
        resultMap.put(WXPayConstants.RESULT_CODE, WXPayConstants.FAIL);
        resultMap.put(WXPayConstants.ERR_CODE_DES, resultMap.get(WXPayConstants.RETURN_MSG));
        return resultMap;
    }

    // 1.2.获取prepay_id、nonce_str
    String prepay_id = resultMap.get("prepay_id");
    String nonce_str = r