Spring Boot 微信小程序支付指南

随着移动支付的普及，越来越多的企业选择在微信小程序中集成支付功能，以提供更便捷的购物体验。本文将介绍如何使用 Spring Boot 在微信小程序中实现支付功能。

1. 准备工作

首先，你需要拥有一个微信支付商户账号，并且获得相关的商户 ID 和密钥。然后，你需要在微信开放平台注册一个小程序，并获取到小程序的 AppID。

2. 导入依赖

在你的 Spring Boot 项目中，需要导入微信支付相关的依赖。你可以在 Maven 或 Gradle 配置文件中添加以下依赖：

<dependency>
    <groupId>com.github.wxpay</groupId>
    <artifactId>wx-pay-sdk</artifactId>
    <version>6.0.0</version>
</dependency>

3. 配置参数

在 application.properties（或 application.yml）文件中，添加微信支付所需的参数：

wxpay.appId=your_appId
wxpay.mchId=your_mchId
wxpay.notifyUrl=your_notifyUrl
wxpay.key=your_key

4. 编写支付接口

使用 Spring Boot，你可以轻松地创建一个支付接口来处理用户的支付请求。首先，你需要创建一个控制器类，例如：

@RestController
public class PaymentController {

    @Autowired
    private WxPayService wxPayService;

    @PostMapping("/payment")
    public String pay(@RequestBody PaymentRequest paymentRequest) {
        // 处理支付逻辑
        String prepayId = wxPayService.createUnifiedOrder(paymentRequest);
        // 返回预支付 ID
        return prepayId;
    }

}

5. 调用微信支付 API

在 WxPayService 类中，你需要调用微信支付的统一下单 API 来获取预支付 ID。可以使用官方提供的 SDK 或其他第三方库来完成这一步骤。

@Service
public class WxPayService {

    @Value("${wxpay.appId}")
    private String appId;

    @Value("${wxpay.mchId}")
    private String mchId;

    // 其他依赖注入

    public String createUnifiedOrder(PaymentRequest paymentRequest) {
        // 构造统一下单请求对象
        UnifiedOrderRequest request = new UnifiedOrderRequest();
        request.setAppid(appId);
        request.setMchId(mchId);
        // 设置其他参数
        // ...

        // 发送请求并解析响应结果
        UnifiedOrderResponse response = sendRequest(request);

        // 获取预支付 ID
        String prepayId = response.getPrepayId();

        return prepayId;
    }

    // 发送请求的方法
    // ...

}

6. 处理支付结果

在微信支付成功后，微信服务器将会异步通知你的支付结果。你需要创建一个回调接口来接收并处理这些通知。可以使用 Spring Boot 中的消息队列或异步任务来完成这一步骤。

@RestController
public class NotifyController {

    @PostMapping("/notify")
    public String notify(@RequestBody NotifyRequest notifyRequest) {
        // 处理支付结果
        // ...

        // 返回给微信服务器的响应
        return "success";
    }

}

7. 验证签名

在处理支付结果时，你需要验证微信服务器通知中的签名是否正确。可以使用微信支付提供的工具类来进行验签。

@Service
public class SignatureService {

    @Value("${wxpay.key}")
    private String key;

    public boolean verifySign(NotifyRequest notifyRequest) {
        Map<String, String> params = BeanUtils.beanToMap(notifyRequest);
        String sign = params.get("sign");
        // 去除 sign 参数
        params.remove("sign");

        // 生成签名并与传入的签名进行比较
        String calculatedSign = SignatureUtils.generate(params, key);

        return calculatedSign.equals(sign);
    }

}

通过按照以上步骤操作，你就可以实现微信小程序的支付功能了。记得在每个关键步骤中添加必要的异常处理和日志记录，以保证系统的稳定性和可维护性。

请注意，本文只是简单介绍了实现支付功能的基本步骤，实际操作中可能还需要考虑更多的业务逻辑和安全性问题。