jy_pay 支付模块

基于 微信支付 APIv3 的 Native 支付能力与支付日志记录。

功能

微信 Native 预下单：生成 code_url，供前台生成二维码，用户扫码支付。
支付结果回调：验签、解密并更新支付日志；可在此扩展订单状态等业务逻辑。
支付日志表 jy_pay_log：记录每笔预下单与支付结果，便于对账与排查。

依赖与接入

根工程 pom.xml 已加入模块：<module>jy_pay</module>，并在 dependencyManagement 中声明 jy_pay。
主应用（如 back）在 pom.xml 中增加对 jy_pay 的依赖后，会通过 @MapperScan("com.ruoyi.**.mapper") 与 classpath*:mapper/**/*Mapper.xml 自动扫描本模块的 Mapper 与 XML。

数据库

执行项目根目录下 sql/jy_pay.sql，创建表 jy_pay_log（与主库同库即可）。

配置

在 application-xxx.yml 中增加微信支付配置（可参考 jy_pay/src/main/resources/application-jypay.yml）：

wechat:
  pay:
    enabled: true
    merchant-id: "你的商户号"
    private-key-path: "/绝对路径/apiclient_key.pem"
    merchant-serial-number: "商户API证书序列号"
    api-v3-key: "32字节APIv3密钥"
    app-id: "公众号/开放平台appid"
    notify-url: "https://你的域名/pay/api/wechat/native/notify"

notify-url 需在微信商户平台配置，且公网可访问。未配置或 enabled: false 时，仅不创建微信 Config，不影响启动。

接口说明

说明	方法	路径
Native 预下单	POST	`/pay/api/wechat/native/prepay`
微信支付回调	POST	`/pay/api/wechat/native/notify`

预下单请求参数

outTradeNo（必填）：商户订单号，唯一。
description（必填）：商品描述。
totalFen（必填）：金额，单位：分。
bizType（可选）：业务类型，默认 ORDER。
bizId（可选）：业务主键，如订单 ID，默认与 outTradeNo 一致。

预下单响应

成功：{"codeUrl":"weixin://wxpay/...", "payLogId": 1}，前台用 codeUrl 生成二维码。
失败：{"errorCode":"xxx", "errorMsg":"xxx"}。

支付日志状态

0：待支付（预下单成功）
1：已支付
2：已关闭
3：已退款
4：失败

与订单联动

支付日志：回调中会调用 payLogService.updateToPaid(...) 更新 jy_pay_log。
订单表 shop_order：当预下单时 bizType=ORDER 且 outTradeNo 为订单的 order_number 时，回调中会调用 jy-shop 的 IOrderService，将对应订单更新为已支付：
- status = 1（待发货）
- is_payed = 1
- pay_time、update_time 为当前时间
  仅当订单当前为待付款（status=0）时才会更新，避免重复回调导致错误。
jy_pay 已依赖 jy-shop，主应用需同时引入 jy-shop 与 jy_pay，订单回写才会生效。

3.0 KiB Raw Blame History Unescape Escape