# 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`）：

```yaml
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，订单回写才会生效。