Spring Boot中的微信支付（小程序）

前言

微信支付是企業級項目中經常使用到的功能，作為後端開發人員，完整地掌握該技術是十分有必要的。

logo

一、申請流程和步驟

圖1-1

註冊微信支付賬號
獲取微信小程序APPID
獲取微信商家的商戶ID
獲取微信商家的API私鑰
配置微信支付回調地址
綁定微信小程序和微信支付的關係
搭建SpringBoot工程編寫後台支付接口
發佈部署接口服務項目
使用微信小程序或者UniAPP調用微信支付功能
支付接口的封裝
配置jwt或者openid的token派發
原生微信小程序完成支付對接

二、註冊商家

2.1商戶平台

商家或者企業想要通過微信支付來進行商品的銷售，必須先通過微信平台（pay.weixin.qq.com）去將商家進行註冊。註冊成功後將會有商戶信息等界面，包括商家的賬戶信息、企業信息等等。如圖2-1所示：

圖2-1

2.2商戶id

商戶id是項目開發中的唯一標識，是微信支付給予每個商戶或者企業的唯一id。也是客戶（消費者）在拉起微信支付時的憑據之一，在圖2-1中的「微信支付商戶號」就是商戶id。

三、API私鑰（支付密鑰）

在註冊商戶成功後，同樣在微信平台（pay.weixin.qq.com）可以對API私鑰進行設置。如圖3-1所示：

圖3-1

API私鑰也稱為支付密鑰，商戶id和API密鑰是用戶拉起微信支付時後台所必須獲取的。

四、商戶簽約微信支付產品

商戶可以根據需要簽約微信支付的產品，主要包括有：

JSAPI支付：商戶通過調用微信支付提供的JSAPI接口，在支付場景中調起微信支付模塊完成收款；
Native支付：商戶系統按微信支付協議生成支付二維碼，用戶再用微信「掃一掃」完成支付的模式；
小程序支付：通過好友分享或掃描二維碼在微信內打開小程序時，可以調用微信支付完成下單購買的流程；
付款碼支付：用戶出示微信錢包中的條碼、二維碼，商家通過掃描用戶條碼即可完成收款；
刷臉支付：用戶在集成微信刷臉支付SDK的線下機具上”刷臉”即可完成支付。

如圖4-1所示：

圖4-1

五、配置回調地址

支付回調地址是微信支付服務器返回給用戶支付信息（通知）的地址。如果商戶簽約的是微信小程序產品，那麼支付回調地址可以配置也可以不進行配置。該地址為公司的域名，或者不加以配置。

六、小程序獲取APPID

首先要登錄申請官網進行微信小程序的註冊：//mp.weixin.qq.com/，如圖6-1所示：

圖6-1

註冊成功後即可獲得小程序唯一的APPID。如圖6-2所示：

圖6-2

七、微信支付與小程序綁定

在微信支付平台對APPID進行綁定即可。如圖7-1所示：

圖7-1

八、實戰部分

8.1SpringBoot框架搭建

首先創建一個初始化SpringBoot項目；
在項目/模塊的resources文件夾下，編寫properties/yml配置文件；
- 配置文件中需隔離dev環境與prod環境；
- 配置文件中還包括了server、數據庫、spring、token、日誌、時區、json格式、mybatis-plus、swagger、redis、服務器配置、微信小程序配置（包括支付相關）等等全局統一配置。
項目基本架構（SSM：Spring+SpringMVC+MyBatis）
- controller
  - 後端接口，與前端數據交互
- config
  - 雲服務器配置
  - Swagger配置
  - 接口攔截器（路由）
  - 微信支付配置（引入微信相關服務）
- common
  - constant
  - enums
  - Ajaxresult
  - BaseController
  - BaseEntity
  - Page（Page與Table返回參數）
- domain
  - 接口與頁面所需參數（DTO、entity、req、res、VO等）
- mapper
  - mapper文件接口（SQL方法定義）
- service
  - Service：承接Controller層的接口方法定義
  - Impl（接口實現類）：接口的具體實現邏輯
- utils
  - 文件工具類
  - Json工具類
  - 時間格式工具類
  - 第三方登錄工具類

8.2微信支付相關接口

8.2.1小程序用戶登錄接口

用戶首先需要在小程序端進行微信用戶登錄授權，需調用接口獲取登錄憑證（code）。通過憑證進而換取用戶登錄態信息，包括用戶在當前小程序的唯一標識（openid）、微信開放平台帳號下的唯一標識（unionid，若當前小程序已綁定到微信開放平台帳號）及本次登錄的會話密鑰（session_key）等。

具體的登錄流程如圖8-1所示：

圖8-1

此時調用服務端接口，請求參數如圖8-2所示：

圖8-2

用戶登錄後的返回參數，如圖8-3所示：

圖8-3

8.2.2統一下單接口

用戶登錄小程序後，在小程序頁面拉起支付請求時，會調用統一的下單接口。

在拉起支付請求時，下單接口參數需要兩部分：一是商戶、小程序相關的openid，appid等，二是需要商品相關的價格，名稱，數量等參數。

以下將用代碼來對微信支付接口做詳細的講解，代碼以REST風格API接口的形式編寫。

統一下單接口

@ApiOperation(value = "統一下單接口")
@RequestMapping(value = "/unifiedOrder",method = RequestMethod.POST)
public AjaxResult unifiedOrder(HttpServletRequest req,@RequestBody){
    //校驗小程序（微信）用戶登錄
    //查詢數據庫訂單信息（狀態）
    //只有未支付訂單才能發起支付
    //0元購買不調支付
    /**
     * 設置商戶、小程序相關請求參數
     * */
    //獲取小程序的appId
    String appId = WxMaUtil.getAppId(request);
    WxPayUnifiedOrderRequest wxPayUnifiedOrderRequest = new WxPayUnifiedOrderRequest();
    wxPayUnifiedOrderRequest.setAppid(appId);
    //商品名稱
    String body = sysOrdersCourse.getCourseName();
    body =body.length() > 40 ? body.substring(0,39) : body;
    wxPayUnifiedOrderRequest.setBody(body);
    //訂單編號
    wxPayUnifiedOrderRequest.setOutTradeNo(sysOrders.getOrderNo());
    //訂單金額
    wxPayUnifiedOrderRequest.setTotalFee(sysOrders.getOrderAmount().multiply(new             BigDecimal(100)).intValue());
    //交易類型
    wxPayUnifiedOrderRequest.setTradeType("JSAPI");
    //支付回調地址
         wxPayUnifiedOrderRequest.setNotifyUrl(env.getProperty("notify-host")+"/wx/api/order/notify-order");
    wxPayUnifiedOrderRequest.setSpbillCreateIp("127.0.0.1");
    //用戶在當前小程序中的唯一標識
    wxPayUnifiedOrderRequest.setOpenid(wxUser.getOpenId());
    //調用微信服務類
    WxPayService wxPayService = WxPayConfiguration.getPayService();
    return AjaxResult.success(JSONUtils.parse(wxPayService.createOrder(wxPayUnifiedOrderRequest)));
}

8.2.3創建訂單接口

創建訂單接口

用戶可以在商品頁面對某個商品進行下單，此時需要創建該用戶購買某個商品的訂單。

該過程主要是通過接口去請求用戶信息、商品信息等參數，經過邏輯判斷（是否存在已購買的訂單）後創建（數據庫插入相關信息）新的訂單，最後返回該訂單的所需數據。

@ApiOperation(value = "創建訂單")
    @RequestMapping(value = "/create",method = RequestMethod.POST)
    public AjaxResult create(@RequestBody WxOrderRequest wxOrderRequest){
        //微信用戶信息
        //判斷是否購買過相同商品，若已經購買過，則無法創建新的訂單
        //滿足條件後將數據插入數據庫
         WxOrderResponse wxOrderResponse = orderService.add(wxOrderRequest);
        //如果新增失敗，則返回提示
         if (wxOrderResponse == null){
             return AjaxResult.error("訂單創建失敗");
         }
         return AjaxResult.success(wxOrderResponse);
     }

8.2.4取消訂單接口

取消訂單接口

當用戶拉起微信支付時，如果在付款界面點擊×取消付款（但此時訂單已經創建），則該操作視為取消訂單支付，同時在訂單頁面應當顯示此時該訂單的支付狀態。

該接口可以通過訂單id來作為請求參數，首先判斷數據庫中是否存在該訂單信息，接着對可以取消支付的訂單類型進行限制，最後更新數據庫表（訂單、商品和聲明周期）狀態。

@ApiOperation(value = "取消訂單")
@RequestMapping(value = "/cancel/{orderId}",method = RequestMethod.PUT)
    public AjaxResult cancel(@PathVariable Long orderId){
        //判斷訂單是否存在
        SysOrders sysOrders = sysOrdersService.getById(orderId);
        if(sysOrders==null){
            return AjaxResult.error("訂單不存在");
        }
        //只有未支付的訂單能取消
        if(!CommonConstants.NO.equals(sysOrders.getIsPay())){
            return AjaxResult.error(MyReturnCode.ERR_70001.getCode(), MyReturnCode.ERR_70001.getMsg());
        }
        sysOrdersService.orderCancel(sysOrders);
        return AjaxResult.success();
    }

8.2.5訂單詳情接口

訂單詳情接口

當訂單生成後，用戶可以在頁面查看該商品訂單的詳情。

該接口通過訂單id即可從數據庫獲取詳情信息，而該頁面展示的數據由業務需求確定。

@ApiOperation(value = "訂單詳情")
@RequestMapping(value = "/myOrderDetail/{orderId}",method = RequestMethod.GET)
@ApiImplicitParams({@ApiImplicitParam(name = "orderId", value = "訂單Id")})
     public AjaxResult myOrderDetail(@PathVariable Long orderId){
     //從數據庫獲取詳情參數
     SysOrderDetailResponse detailResponse = sysOrdersService.getDetail(orderId);
     return AjaxResult.success(detailResponse);
     }

訂單詳情邏輯

    /**
     * 訂單詳情頁面參數處理
     * @param orderId
     * @return sysOrderDetailResponse
     */
    @Override
    public SysOrderDetailResponse getDetail(Long orderId) {
        SysOrderDetailResponse sysOrderDetailResponse =  orderMapper.getDetail(orderId);
        //對頁面的手機號做處理
        String phoneNum = sysOrderDetailResponse.getMobile();
        sysOrderDetailResponse.setMobile(phoneNum.substring(0,3) + "****" +       phoneNum.substring(7,phoneNum.length()));
        //根據訂單狀態不同，顯示不同的數據
        //計算剩餘待支付時間並展示
        return sysOrderDetailResponse;
    }

8.2.6支付回調接口

微信支付回調是用戶在對商品進行支付操作後，將數據發送至微信服務器，微信服務器再將支付的結果返回（通知）給用戶和商家的過程。

其中，主要關注的是用戶支付-微信回調判斷-修改數據庫這個過程。

支付回調接口

@ApiOperation("支付回調")
@RequestMapping(value = "notify-order", method = RequestMethod.POST)
    public String notifyOrder(@RequestBody String xmlData) throws WxPayException {
        log.info("支付回調：" + xmlData);
        //微信支付服務
        WxPayService wxPayService = WxPayConfiguration.getPayService();
        WxPayOrderNotifyResult notifyResult = wxPayService.parseOrderNotifyResult(xmlData);
        log.info("支付回調解析結果" + notifyResult);
        //對創建的訂單進行支付
        SysOrders sysOrders = orderService.getOne(notifyResult.getOutTradeNo());
        if (sysOrders != null) {
            if (sysOrders.getOrderAmount().multiply(new BigDecimal(100)).intValue() == notifyResult.getTotalFee()){
                 String timeEnd = notifyResult.getTimeEnd();
                 LocalDateTime paymentTime = LocalDateTimeUtils.parse(timeEnd);
                 //支付時間
                 sysOrders.setPaymentTime(paymentTime);
                 sysOrders.setOrderAmount(sysOrders.getOrderAmount());
                 //微信訂單編號
                 sysOrders.setTransactionId(notifyResult.getTransactionId());
                 //更新數據庫
                 orderService.notifyOrder(sysOrders);
                 log.info("支付回調成功通知：" + sysOrders.getOrderNo());
                 return WxPayNotifyResponse.success("支付成功");
            } else {
                 return WxPayNotifyResponse.fail("付款金額與訂單金額不符");
            }
        } else {
            return WxPayNotifyResponse.fail("無此訂單");
        }
    }

其中，notifyOrder方法的作用是在支付成功後在數據庫更新訂單的狀態。

notifyOrder(SysOrders sysOrders)方法

@Override
    @Transactional(rollbackFor = Exception.class)
    public void notifyOrder(SysOrders sysOrders) {
       //只有未支付訂單能操作，即is_pay字段為0的訂單
       if(CommonConstants.NO.equals(sysOrders.getIsPay())) {
       //更新訂單支付狀態
       sysOrders.setIsPay(CommonConstants.YES);
       sysOrders.setStatus(OrderInfoEnum.STATUS_1.getValue());
       sysOrdersMapper.updateById(sysOrders);
       //更新商品表狀態
       //更新訂單生命周期表
       }
    }

至此，Spring Boot中的微信支付全過程已經分享完成。如有不足，望大家指正。

Tags: JAVA spring Spring Boot 微信支付第三方支付