Jeepay微信小程序支付：前端调起与后端处理

微信小程序支付（WX_LITE）是Jeepay支付系统框架中常用的支付方式之一，通过统一的接口规范实现前后端交互。以下从后端参数配置、接口调用流程到前端调起实现，完整介绍接入过程。

一、后端核心参数定义

Jeepay在常量类中定义微信小程序支付标识，作为支付方式的唯一识别码：

// 源码路径：[jeepay-core/src/main/java/com/jeequan/jeepay/core/constants/CS.java](https://gitcode.com/GitHub_Trending/je/jeepay/blob/f53cb2132934823389a8c9de8a4a049f7ab1cfb0/jeepay-core/src/main/java/com/jeequan/jeepay/core/constants/CS.java?utm_source=gitcode_repo_files)
String WX_LITE = "WX_LITE";  // 微信小程序支付

二、请求参数封装

微信小程序支付专用请求类WxLiteOrderRQ继承统一订单请求，新增微信用户标识参数：

// 源码路径：[jeepay-payment/src/main/java/com/jeequan/jeepay/pay/rqrs/payorder/payway/WxLiteOrderRQ.java](https://gitcode.com/GitHub_Trending/je/jeepay/blob/f53cb2132934823389a8c9de8a4a049f7ab1cfb0/jeepay-payment/src/main/java/com/jeequan/jeepay/pay/rqrs/payorder/payway/WxLiteOrderRQ.java?utm_source=gitcode_repo_files)
@Data
public class WxLiteOrderRQ extends UnifiedOrderRQ {
    @NotBlank(message = "openid不能为空")
    private String openid;  // 微信用户唯一标识
    private Byte isSubOpenId;  // 是否子商户openid标识
    
    public WxLiteOrderRQ(){
        this.setWayCode(CS.PAY_WAY_CODE.WX_LITE);  // 自动设置支付方式
    }
}

三、响应参数结构

支付结果通过WxLiteOrderRS返回，包含微信支付所需的预支付数据：

// 源码路径：[jeepay-payment/src/main/java/com/jeequan/jeepay/pay/rqrs/payorder/payway/WxLiteOrderRS.java](https://gitcode.com/GitHub_Trending/je/jeepay/blob/f53cb2132934823389a8c9de8a4a049f7ab1cfb0/jeepay-payment/src/main/java/com/jeequan/jeepay/pay/rqrs/payorder/payway/WxLiteOrderRS.java?utm_source=gitcode_repo_files)
@Data
public class WxLiteOrderRS extends UnifiedOrderRS {
    private String payInfo;  // 预支付数据包，JSON格式
    
    @Override
    public String buildPayDataType(){
        return CS.PAY_DATA_TYPE.WX_APP;  // 指定数据类型为微信应用
    }
}

四、支付流程处理

1. 接口路由：统一订单接口根据支付方式自动路由至微信小程序处理逻辑

// 源码路径：[jeepay-payment/src/main/java/com/jeequan/jeepay/pay/rqrs/payorder/UnifiedOrderRQ.java](https://gitcode.com/GitHub_Trending/je/jeepay/blob/f53cb2132934823389a8c9de8a4a049f7ab1cfb0/jeepay-payment/src/main/java/com/jeequan/jeepay/pay/rqrs/payorder/UnifiedOrderRQ.java?utm_source=gitcode_repo_files)
if(CS.PAY_WAY_CODE.WX_LITE.equals(wayCode)){
    return WxLiteOrderRQ.class;  // 匹配微信小程序支付请求类
}

2. 预支付数据生成：后端通过微信支付接口生成payInfo，典型结构如下：

{
  "appId": "wx8888888888888888",
  "timeStamp": "1623456789",
  "nonceStr": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
  "package": "prepay_id=wx201410272009395522657a690389285100",
  "signType": "MD5",
  "paySign": "C380BEC2BFD727A4B6845133519F3AD6"
}

五、前端调起实现

微信小程序通过wx.requestPayment接口调起支付，代码示例：

// 调用后端统一订单接口获取payInfo后执行
wx.requestPayment({
  timeStamp: res.payInfo.timeStamp,
  nonceStr: res.payInfo.nonceStr,
  package: res.payInfo.package,
  signType: res.payInfo.signType,
  paySign: res.payInfo.paySign,
  success (res) {
    console.log('支付成功', res)
  },
  fail (res) {
    console.log('支付失败', res)
  }
})

六、系统交互流程

sequenceDiagram
    participant 小程序
    participant Jeepay后端
    participant 微信支付网关
    
    小程序->>Jeepay后端: 提交订单信息(含openid)
    Jeepay后端->>Jeepay后端: 验证参数并创建订单
    Jeepay后端->>微信支付网关: 请求创建预支付订单
   微信支付网关-->>Jeepay后端: 返回prepay_id
    Jeepay后端-->>小程序: 返回payInfo(含签名数据)
    小程序->>微信支付网关: 发起支付请求
    微信支付网关-->>小程序: 返回支付结果

七、配置参考

支付渠道参数配置可参考：

• 微信支付接口配置：jeepay-service/src/main/java/com/jeequan/jeepay/service/impl/PayInterfaceConfigService.java
• 商户支付通道管理：jeepay-service/src/main/java/com/jeequan/jeepay/service/impl/MchPayPassageService.java

通过以上流程，可快速实现微信小程序支付功能，系统已内置完整的签名验证、订单状态同步等机制，开发者只需关注业务参数传递与结果处理即可。