# 支付模块

**类路径**：`PayController`
**前缀**：`/pay`

## 1. verifyReceipt

**接口路径**：`POST /pay/verifyReceipt`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：Apple客户端支付成功后调用此接口，服务端验证苹果收据

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| req | AppleVerifyRequest | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.verifyReceipt()  （https://api.ruletree.club/pay/verifyReceipt）

---

## 2. scancodepay

**接口路径**：`GET/POST /pay/scancodePay`

**权限**：需要登录（普通用户及以上）

**接口说明**：支付宝扫码支付 @return 支付宝生成的订单信息

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| num | String | 否 | - |  |
| token | String | 否 | - |  |
| packageId | Integer | 否 | 0 |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.scancodePay()  （https://api.ruletree.club/pay/scancodePay）
- 前端调用：this.$API.EPay()  （https://api.ruletree.club/pay/EPay）

---

## 3. notify

**接口路径**：`POST /pay/notify`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：支付宝扫码支付 @return 支付宝生成的订单信息

**请求参数**：

无请求参数

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 4. getQRCode

**接口路径**：`GET/POST /pay/qrCode`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：二维码生成

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| codeContent | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.qrCode()  （https://api.ruletree.club/pay/qrCode）

---

## 5. payLogList

**接口路径**：`GET/POST /pay/payLogList`

**权限**：需要登录（普通用户及以上）

**接口说明**：充值记录

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |
| page | Integer | 否 | 1 |  |
| searchKey | String | 否 | - |  |
| order | String | 否 | created |  |
| limit | Integer | 否 | 30 |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.payLogList()  （https://api.ruletree.club/pay/payLogList）

---

## 6. financeList

**接口路径**：`GET/POST /pay/financeList`

**权限**：需要超级管理员权限

**接口说明**：财务记录(管理员)

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| searchParams | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| token | String | 否 | - |  |
| searchKey | String | 否 | - |  |
| order | String | 否 | created |  |
| page | Integer | 否 | 1 |  |
| limit | Integer | 否 | 15 |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.financeList()  （https://api.ruletree.club/pay/financeList）

---

## 7. financeTotal

**接口路径**：`GET/POST /pay/financeTotal`

**权限**：需要超级管理员权限

**接口说明**：财务统计(管理员)

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.financeTotal()  （https://api.ruletree.club/pay/financeTotal）

---

## 8. wxAdd

**接口路径**：`GET/POST /pay/WxPay`

**权限**：需要登录（普通用户及以上）

**接口说明**：微信支付（支持 App / JSAPI / Native / H5）

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| price | Integer | 否 | - |  |
| token | String | 否 | - |  |
| packageId | Integer | 否 | 0 |  |
| tradeType | String | 否 | NATIVE |  |
| openidOrWapUrl | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.wxPay()  （https://api.ruletree.club/pay/WxPay）

---

## 9. wxPayNotify

**接口路径**：`GET/POST /pay/wxPayNotify`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：微信回调（支持 App、JSAPI、Native 扫码、H5）

**请求参数**：

无请求参数

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.wxPay()  （https://api.ruletree.club/pay/WxPay）

---

## 10. madetoken

**接口路径**：`GET/POST /pay/madetoken`

**权限**：需要超级管理员权限

**接口说明**：创建卡密

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| price | Integer | 否 | - |  |
| num | Integer | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.madetoken()  （https://api.ruletree.club/pay/madetoken）

---

## 11. tokenPayList

**接口路径**：`GET/POST /pay/tokenPayList`

**权限**：需要超级管理员权限

**接口说明**：卡密列表

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| searchParams | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| page | Integer | 否 | 1 |  |
| limit | Integer | 否 | 15 |  |
| searchKey | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.tokenPay()  （https://api.ruletree.club/pay/tokenPay）
- 前端调用：this.$API.tokenPayList()  （https://api.ruletree.club/pay/tokenPayList）

---

## 12. tokenPayExcel

**接口路径**：`GET/POST /pay/tokenPayExcel`

**权限**：需要超级管理员权限

**接口说明**：卡密列表

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| limit | Integer | 否 | 15 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.tokenPay()  （https://api.ruletree.club/pay/tokenPay）
- 前端调用：this.$API.tokenPayExcel()  （https://api.ruletree.club/pay/tokenPayExcel）

---

## 13. tokenPay

**接口路径**：`GET/POST /pay/tokenPay`

**权限**：需要登录（普通用户及以上）

**接口说明**：卡密充值

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| key | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.tokenPay()  （https://api.ruletree.club/pay/tokenPay）

---

## 14. EPay

**接口路径**：`GET/POST /pay/EPay`

**权限**：需要登录（普通用户及以上）

**接口说明**：彩虹易支付相关

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| type | String | 否 | - |  |
| money | Integer | 否 | - |  |
| device | String | 否 | - |  |
| token | String | 否 | - |  |
| packageId | Integer | 否 | 0 |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.EPay()  （https://api.ruletree.club/pay/EPay）

---

## 15. EPayNotify

**接口路径**：`GET/POST /pay/EPayNotify`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：彩虹易支付相关

**请求参数**：

无请求参数

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.EPay()  （https://api.ruletree.club/pay/EPay）

---

## 16. payStatus

**接口路径**：`GET/POST /pay/payStatus`

**权限**：需要登录（普通用户及以上）

**接口说明**：支付状态查询，用于支付完成后立即查询支付状态

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| pid | Integer | 否 | 0 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.payStatus()  （https://api.ruletree.club/pay/payStatus）

---

## 17. scancodePayShop

**接口路径**：`GET/POST /pay/scancodePayShop`

**权限**：需要登录（普通用户及以上）

**接口说明**：支付宝扫码支付购买商品

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| sid | String | 否 | - |  |
| quantity | Integer | 否 | 1 |  |
| isIntegral | Integer | 否 | 0 |  |
| address | String | 否 | - |  |
| remark | String | 否 | - |  |
| model | Integer | 否 | 0 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.scancodePay()  （https://api.ruletree.club/pay/scancodePay）
- 前端调用：this.$API.scancodePayShop()  （https://api.ruletree.club/pay/scancodePayShop）
- 前端调用：this.$API.EPay()  （https://api.ruletree.club/pay/EPay）

---

## 18. wxPayShop

**接口路径**：`GET/POST /pay/WxPayShop`

**权限**：需要登录（普通用户及以上）

**接口说明**：微信支付购买商品

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| sid | String | 否 | - |  |
| quantity | Integer | 否 | 1 |  |
| isIntegral | Integer | 否 | 0 |  |
| address | String | 否 | - |  |
| remark | String | 否 | - |  |
| model | Integer | 否 | 0 |  |
| token | String | 否 | - |  |
| tradeType | String | 否 | NATIVE |  |
| openidOrWapUrl | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.wxPay()  （https://api.ruletree.club/pay/WxPay）
- 前端调用：this.$API.WxPayShop()  （https://api.ruletree.club/pay/WxPayShop）

---

## 19. scancodePayCart

**接口路径**：`GET/POST /pay/scancodePayCart`

**权限**：需要登录（普通用户及以上）

**接口说明**：支付宝扫码支付购物车结算

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| cartShop | String | 否 | - |  |
| isIntegral | Integer | 否 | 0 |  |
| address | String | 否 | - |  |
| remark | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.scancodePay()  （https://api.ruletree.club/pay/scancodePay）
- 前端调用：this.$API.scancodePayCart()  （https://api.ruletree.club/pay/scancodePayCart）
- 前端调用：this.$API.EPay()  （https://api.ruletree.club/pay/EPay）

---

## 20. wxPayCart

**接口路径**：`GET/POST /pay/WxPayCart`

**权限**：需要登录（普通用户及以上）

**接口说明**：微信支付购物车结算

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| cartShop | String | 否 | - |  |
| isIntegral | Integer | 否 | 0 |  |
| address | String | 否 | - |  |
| remark | String | 否 | - |  |
| token | String | 否 | - |  |
| tradeType | String | 否 | NATIVE |  |
| openidOrWapUrl | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.wxPay()  （https://api.ruletree.club/pay/WxPay）
- 前端调用：this.$API.WxPayCart()  （https://api.ruletree.club/pay/WxPayCart）

---

## 21. paypalPayShop

**接口路径**：`GET/POST /pay/PayPalPayShop`

**权限**：需要登录（普通用户及以上）

**接口说明**：PayPal支付购买商品

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| sid | String | 否 | - |  |
| quantity | Integer | 否 | 1 |  |
| isIntegral | Integer | 否 | 0 |  |
| address | String | 否 | - |  |
| remark | String | 否 | - |  |
| model | Integer | 否 | 0 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.PayPalPayShop()  （https://api.ruletree.club/pay/PayPalPayShop）

---

## 22. paypalPayCart

**接口路径**：`GET/POST /pay/PayPalPayCart`

**权限**：需要登录（普通用户及以上）

**接口说明**：PayPal支付购物车结算

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| cartShop | String | 否 | - |  |
| isIntegral | Integer | 否 | 0 |  |
| address | String | 否 | - |  |
| remark | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.PayPalPayCart()  （https://api.ruletree.club/pay/PayPalPayCart）

---

## 23. paypalNotify

**接口路径**：`GET/POST /pay/paypalNotify`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：PayPal支付回调（v2 Orders API） 支付成功跳转时携带 token 和 PayerID 参数

**请求参数**：

无请求参数

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 24. paypalPayRecharge

**接口路径**：`GET/POST /pay/PayPalPayRecharge`

**权限**：需要登录（普通用户及以上）

**接口说明**：PayPal充值余额（支持直接充值和套餐充值）

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| num | String | 否 | - |  |
| token | String | 否 | - |  |
| packageId | Integer | 否 | 0 |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.PayPalPayRecharge()  （https://api.ruletree.club/pay/PayPalPayRecharge）

---