本文是【浅析微信支付】系列文章的第五篇,主要讲解如何调用统一下单接口生成预支付单及调起支付页面。
浅析微信支付系列已经更新四篇了哟~,没有看过的朋友们可以看一下哦。
上面是本文的前置文章,有前面几篇文章的基础以后看会更加明了,如果已经看过的小伙伴可以忽略。
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