在线支付系列【14】微信支付实战篇之Native支付下单

深藏阁楼爱情的钟 2023-10-09 15:28 283阅读 0赞

> **有道无术，术尚可求，有术无道，止于术。**

#### 文章目录 ####

*   *  Native支付
     *   *  产品介绍
         *  业务流程图
         *   *  1. 下单
             *  2. 支付
             *  3. 并行处理
     *  Native下单API
     *  案例演示
     *   *  1. 环境搭建
         *  2. 创建商户订单
         *  3. 集成微信支付下单API
         *  4. 测试

### Native支付 ###

#### 产品介绍 ####

`Native支付`是指商户系统按微信支付协议生成支付二维码，用户再用微信“**扫一扫**”完成支付的模式。

**开通流程**：在入驻时选择PC网站场景的商户系统默认开通此功能，其他商户如有需要，可以在入驻后前往**商户平台-产品中心-Native支付-申请开通**。

**应用场景**：适用于**PC网站、实体店单品或订单、媒体广告支付**等场景。

**具体操作流程如下：**

**步骤一：** 商户根据微信支付的规则，为不同商品生成不同的二维码（如图3.1），展示在各种场景，用于用户扫描购买。  
**步骤二：** 用户使用微信“扫一扫”（如图3.2）扫描二维码后，获取商品支付信息，引导用户完成支付（如图3.3）。  
![在这里插入图片描述][9d769260ef674c23ba2292236ef18a0c.png]  
**步骤三：** 用户确认支付，输入支付密码（如图3.4）。

**步骤四：** 支付完成后会提示用户支付成功（如图3.5），商户后台得到支付成功的通知，然后进行发货处理。  
![在这里插入图片描述][f7c2c65b6aa0448b8a29f60cc96b44bd.png]

#### 业务流程图 ####

##### 1. 下单 #####

![在这里插入图片描述][7f0d1277870b4ecd86a658bb117855c5.png]

用户在**PC网站**购买商品，选中后，提交订单，商户后台系统收到后，生成**商品订单**（1）。

生成订单后，商户后台系统调用**微信支付Native**下单[API][]（2）。

商户调用`Native`下单`API`后，分**正常返回**和**异常返回**情况：

*  **正常返回**：返回`code_url`，商户可根据返回的`code_url`来生成调用`OpenSDK`的签名以执行下一步。
 *  **异常返回**：返回`http code`或错误码，商户可根据`http code`[列表][API] 或[错误码说明][API]来排查原因并执行下一步操作

**微信支付**生成预支付交易订单，也就是微信那边的支付订单，并返回支付二维码链接`code_url`，（3）。

**商户**根据返回的`code_url`生成**二维码**供用户扫描。成功获取支付`二维码链接（code_url）`后，需要在前端生成二维码供用户扫描支付（4）。

**二维码链接对应格式**：

weixin：//weixin://pay.weixin.qq.com/bizpayurl/up?pr=NwY5Mz9&groupid=00

生成二维码见下图：  
![在这里插入图片描述][470b76c6d8294226835be470ae72e99b.png]  
**注意事项：**

*  该模式链接较短，生成的二维码打印到结账小票上的识别率较高。二维码的有效期是2小时。
 *  微信支付已经不支持通过长按识别二维码的方式或通过相册识别二维码的方式完成支付。

更多二维码的相关背景知识可参考[文档][Link 1]。

##### 2. 支付 #####

![在这里插入图片描述][b23eeb358e4a4724933cc22fcac0f297.png]  
生成二维码后，用户使用微信**扫一扫**二维码，提交扫码链接给微信支付（5）。

**微信支付**验证链接有效性，并返回需要用户支付授权（6）。

**用户**确认并输入密码支付，提交支付授权给微信支付（7）。

**微信支付**验证授权，完成支付交易（8）。

##### 3. 并行处理 #####

![在这里插入图片描述][25fdca6eb2594eeab27e5822b244ecbc.png]  
在完成支付交易后，微信会返回支付结果，发送微信消息提醒（9）。

用户支付是不经过商家的，商家需要通过以下两种方式获取订单状态：

*  **支付结果通知**：用户支付成功后，微信支付会将支付成功的结果以**回调通知**的形式同步给商户，商户的回调地址需要在调用下单API时传入`notify_url`参数（10）。
 *  **主动调用：当因网络抖动或本身`notify_url`存在问题等原因，导致无法接收到回调通知时，商户也可主动调用查询订单API**来获取订单状态（11）。

用户支付，商家收到支付成功消息，进行发货操作（12）。

### Native下单API ###

![在这里插入图片描述][093111e2d70c468aa5275686b59fc132.png]  
`商户Native`支付下单接口，微信后台系统返回链接参数`code_url`，商户后台系统将`code_url`值生成二维码图片，用户使用微信客户端扫码后发起支付。

**适用对象**： 直连商户

**请求URL**：`https://api.mch.weixin.qq.com/v3/pay/transactions/native`

**请求方式**：POST

详细接口描述，参考[官方Native下单API][API]。

### 案例演示 ###

#### 1. 环境搭建 ####

**引入以下框架**：

*  hutool
 *  mybatis-plus
 *  springdoc

创建商品表、订单表。（注：在上篇[微信支付之Spring Boot集成官方SDK][Spring Boot_SDK]文档基础上进行操作）

使用[代码生成器][Link 2]生成基础代码。

#### 2. 创建商户订单 ####

创建**订单状态枚举类**：

@AllArgsConstructor
    @Getter
    public enum OrderStatusEnum {
        
    
        SUCCESS(0, "支付成功"),
        NOT_PAY(1, "未支付"),
        CLOSED(2, "超时已关闭"),
        CANCEL(3, "用户已取消"),
        REFUND_PROCESSING(4, "退款中"),
        REFUND_SUCCESS(5, "已退款"),
        REFUND_ABNORMAL(6, "退款异常");
        /**
         * 状态码
         */
        private final int code;
    
        /**
         * 描述
         */
        private final String desc;
    }

在商户订单服务层编写**创建商户订单**逻辑：

@Transactional
        public OrderEntity saveOrder(String userId, String goodsId) {
        
            GoodsEntity goods = goodsService.getById(goodsId);
            if (ObjectUtil.isNull(goods)) {
        
                throw new IllegalArgumentException("未查询到当前商品信息");
            }
            OrderEntity order = new OrderEntity();
            order.setCount(1);
            order.setMoney(1);// 1分
            order.setUserId(userId);
            order.setGoodId(goodsId);
            order.setStatus(OrderStatusEnum.NOT_PAY.getCode());// 1 未支付
            order.setOutTradeNo(IdUtil.fastSimpleUUID()); // 商户订单号 商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一
            save(order); // 保存订单
            log.info("订单创建成功：" + order);
            return order;
        }

#### 3. 集成微信支付下单API ####

创建**Native支付 API**枚举类，封装所有`API`接口地址。

@AllArgsConstructor
    @Getter
    public enum WechatPayNativeApiEnum {
        
    
        PLACE_ORDER("https://api.mch.weixin.qq.com/v3/pay/transactions/native", "下单");
            /**
         * API地址
         */
        private final String address;
    
        /**
         * 描述
         */
        private final String desc;

创建**微信支付服务层**接口，集成所有**微信支付API**的逻辑都在这里。

public interface WechatPayService {
        
    
        /**
         * Native下单并支付
         *
         * @param userId  用户ID
         * @param goodsId 商品ID
         * @return 二维码Base64字符串
         */
        String saveOrderAndPay(String userId, String goodsId) throws Exception;
    
        /**
         * Native下单，返回支付二维码链接
         */
        String nativePay(String merchantId, String appId, String description, String outTradeNo, String notifyUrl, Integer total) throws Exception;
    
    }

编写**微信支付服务层**实现类，实现**下单并生成支付二维码**功能。

@Slf4j
    @Service
    @RequiredArgsConstructor
    public class WechatPayServiceImpl implements WechatPayService {
        
    
        private final OrderService orderService;
    
        private final GoodsService goodsService;
    
        private final WechatPayProperties wechatPayProperties;
    
        private final ObjectMapper objectMapper;
    
        private final CloseableHttpClient httpClient;
    
        @Override
        public String saveOrderAndPay(String userId, String goodsId) throws Exception {
        
            // 1. 新增订单
            OrderEntity order = orderService.saveOrder(userId, goodsId);
            GoodsEntity goods = goodsService.getById(order.getGoodId());
            // 2. 调用微信Native下单
            String codeUrl = nativePay(wechatPayProperties.getMerchantId(),
                    wechatPayProperties.getAppId(),
                    goods.getShopName() + "-" + goods.getName(),
                    order.getOutTradeNo(),
                    "https://www.weixin.qq.com/wxpay/pay.php",
                    order.getMoney());
            order.setCodeUrl(codeUrl);
            orderService.updateById(order);// 保存订单二维码
            // 3. 返回二维码图片
            QrConfig qrConfig = new QrConfig(300, 300);
            return QrCodeUtil.generateAsBase64(codeUrl, qrConfig, "png");
        }
    
        @Override
        public String nativePay(String merchantId, String appId, String description, String outTradeNo, String notifyUrl, Integer total) throws Exception {
        
            // 构建POST请求
            HttpPost httpPost = new HttpPost(WechatPayNativeApiEnum.PLACE_ORDER.getAddress());
            httpPost.addHeader("Accept", "application/json");
            httpPost.addHeader("Content-type", "application/json; charset=utf-8");
            // 使用JSON库，构建请求参数对象
            ByteArrayOutputStream bos = new ByteArrayOutputStream();
            ObjectNode rootNode = objectMapper.createObjectNode();
            rootNode.put("mchid", merchantId) // 直连商户号
                    .put("appid", appId) // 应用ID
                    .put("description", description)// 商品描述
                    .put("notify_url", notifyUrl) // 通知地址
                    .put("out_trade_no", outTradeNo);// 商户订单号
            rootNode.putObject("amount") // 订单金额对象
                    .put("total", total); // 总金额，单位为分
            objectMapper.writeValue(bos, rootNode);
            httpPost.setEntity(new StringEntity(bos.toString("UTF-8"), "UTF-8"));
            // 执行请求
            CloseableHttpResponse response = httpClient.execute(httpPost);
            // 获取响应
            String bodyAsString = EntityUtils.toString(response.getEntity());
            int statusCode = response.getStatusLine().getStatusCode();// 响应状态码
            if (statusCode != 200) {
        
                throw new RuntimeException("下单失败");
            }
            // 返回二维码
            Map<String, String> resultMap = objectMapper.readValue(bodyAsString, Map.class);
            return resultMap.get("code_url");
        }
    }

添加商户下单访问接口。

@RestController
    @RequestMapping("/pay/wechat")
    @RequiredArgsConstructor
    @Tag(name = "WechatPayController")
    public class WechatPayController {
        
    
        private final WechatPayService wechatPayService;
    
        @Operation(summary = "下单")
        @PostMapping("/native")
        public R<String> nativeOrder(String userId, String goodsId) throws Exception {
        
            String pay = wechatPayService.saveOrderAndPay(userId, goodsId);
            return R.success(pay);
        }
    }

#### 4. 测试 ####

启动项目，`Swagger`访问下单接口。  
![在这里插入图片描述][371f31c4861f4fe08a466c518a4091c4.png]  
**返回响应如下**：  
![在这里插入图片描述][49ef480a3f3a4a669d49c461a04cee15.png]  
打开`Base64`[转图片工具][Link 3]，输入`Base64`字符串转为图片（实际开发时前端负责生成二维码）。  
![在这里插入图片描述][2bfec53f044d4d0281bba17c5da1616a.png]

打开**微信扫一扫**，弹出支付页面，输入密码，交易成功。  
![在这里插入图片描述][b23fdceb2beb4498abeac14471674c90.png]

[9d769260ef674c23ba2292236ef18a0c.png]: https://img-blog.csdnimg.cn/9d769260ef674c23ba2292236ef18a0c.png
[f7c2c65b6aa0448b8a29f60cc96b44bd.png]: https://img-blog.csdnimg.cn/f7c2c65b6aa0448b8a29f60cc96b44bd.png
[7f0d1277870b4ecd86a658bb117855c5.png]: https://img-blog.csdnimg.cn/7f0d1277870b4ecd86a658bb117855c5.png
[API]: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_4_1.shtml
[470b76c6d8294226835be470ae72e99b.png]: https://img-blog.csdnimg.cn/470b76c6d8294226835be470ae72e99b.png
[Link 1]: https://www.qrcode.com/zh/index.html
[b23eeb358e4a4724933cc22fcac0f297.png]: https://img-blog.csdnimg.cn/b23eeb358e4a4724933cc22fcac0f297.png
[25fdca6eb2594eeab27e5822b244ecbc.png]: https://img-blog.csdnimg.cn/25fdca6eb2594eeab27e5822b244ecbc.png
[093111e2d70c468aa5275686b59fc132.png]: https://img-blog.csdnimg.cn/093111e2d70c468aa5275686b59fc132.png
[Spring Boot_SDK]: https://yunyanchengyu.blog.csdn.net/article/details/128790154
[Link 2]: https://gitee.com/pearl-organization/pearl-code-generator
[371f31c4861f4fe08a466c518a4091c4.png]: https://img-blog.csdnimg.cn/371f31c4861f4fe08a466c518a4091c4.png
[49ef480a3f3a4a669d49c461a04cee15.png]: https://img-blog.csdnimg.cn/49ef480a3f3a4a669d49c461a04cee15.png
[Link 3]: https://imgtobase64.d777.com/
[2bfec53f044d4d0281bba17c5da1616a.png]: https://img-blog.csdnimg.cn/2bfec53f044d4d0281bba17c5da1616a.png
[b23fdceb2beb4498abeac14471674c90.png]: https://img-blog.csdnimg.cn/b23fdceb2beb4498abeac14471674c90.png