407 lines
8.8 KiB
Markdown
407 lines
8.8 KiB
Markdown
# 订单系统 - 支付网关集成
|
||
|
||
## 功能说明
|
||
|
||
订单支付功能已升级为调用真实的支付网关，而不是直接标记为已支付。
|
||
|
||
支持的支付方式：
|
||
- ✅ **支付宝支付** (Alipay)
|
||
- ✅ **微信支付** (WeChat Pay)
|
||
|
||
---
|
||
|
||
## 前端实现
|
||
|
||
### 支付API
|
||
|
||
在 `admin/src/api/order.ts` 中添加了两个支付网关API：
|
||
|
||
```typescript
|
||
// 支付宝支付
|
||
export function alipayPay(params: any) {
|
||
return request.post({ url: '/order.order/alipay', params })
|
||
}
|
||
|
||
// 微信支付
|
||
export function wechatPay(params: any) {
|
||
return request.post({ url: '/order.order/wechat', params })
|
||
}
|
||
```
|
||
|
||
### 支付流程
|
||
|
||
在 `confirmPay()` 方法中实现了支付流程：
|
||
|
||
```typescript
|
||
const confirmPay = async () => {
|
||
// 1. 验证参数
|
||
if (payForm.value.payType === 'supplement' && !payForm.value.supplement_order_no) {
|
||
feedback.msgWarning('请输入支付订单号')
|
||
return
|
||
}
|
||
|
||
// 2. 准备支付参数
|
||
let payParams: any = {}
|
||
if (payForm.value.payType === 'normal') {
|
||
payParams = {
|
||
id: payForm.value.order_id,
|
||
order_no: payForm.value.order_no,
|
||
amount: payForm.value.amount,
|
||
payment_method: payForm.value.payment_method
|
||
}
|
||
} else {
|
||
payParams = {
|
||
order_no: payForm.value.supplement_order_no,
|
||
payment_method: payForm.value.payment_method,
|
||
is_supplement: 1
|
||
}
|
||
}
|
||
|
||
// 3. 调用对应的支付网关
|
||
let payResult: any
|
||
if (payForm.value.payment_method === 'alipay') {
|
||
payResult = await alipayPay(payParams)
|
||
} else if (payForm.value.payment_method === 'wechat') {
|
||
payResult = await wechatPay(payParams)
|
||
}
|
||
|
||
// 4. 处理支付结果
|
||
if (payResult && payResult.pay_url) {
|
||
if (payForm.value.payment_method === 'alipay') {
|
||
// 支付宝：跳转到支付页面
|
||
window.location.href = payResult.pay_url
|
||
} else if (payForm.value.payment_method === 'wechat') {
|
||
// 微信：显示二维码
|
||
feedback.msgSuccess('请扫描二维码进行支付')
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 后端实现
|
||
|
||
### 控制器
|
||
|
||
在 `OrderController` 中添加了两个支付网关端点：
|
||
|
||
#### 支付宝支付
|
||
|
||
```php
|
||
/**
|
||
* @notes 支付宝支付
|
||
* @return \think\response\Json
|
||
*/
|
||
public function alipay()
|
||
{
|
||
$params = (new OrderValidate())->post()->goCheck('pay');
|
||
|
||
// 获取订单信息
|
||
$order = $this->getOrderByParams($params);
|
||
if (!$order) {
|
||
return $this->fail('订单不存在');
|
||
}
|
||
|
||
// 调用支付宝支付接口
|
||
$payUrl = OrderLogic::alipayPay($order);
|
||
if (!$payUrl) {
|
||
return $this->fail(OrderLogic::getError());
|
||
}
|
||
|
||
return $this->data(['pay_url' => $payUrl]);
|
||
}
|
||
```
|
||
|
||
#### 微信支付
|
||
|
||
```php
|
||
/**
|
||
* @notes 微信支付
|
||
* @return \think\response\Json
|
||
*/
|
||
public function wechat()
|
||
{
|
||
$params = (new OrderValidate())->post()->goCheck('pay');
|
||
|
||
// 获取订单信息
|
||
$order = $this->getOrderByParams($params);
|
||
if (!$order) {
|
||
return $this->fail('订单不存在');
|
||
}
|
||
|
||
// 调用微信支付接口
|
||
$payData = OrderLogic::wechatPay($order);
|
||
if (!$payData) {
|
||
return $this->fail(OrderLogic::getError());
|
||
}
|
||
|
||
return $this->data($payData);
|
||
}
|
||
```
|
||
|
||
### 业务逻辑
|
||
|
||
在 `OrderLogic` 中添加了支付网关方法：
|
||
|
||
#### 支付宝支付
|
||
|
||
```php
|
||
/**
|
||
* @notes 支付宝支付
|
||
* @param $order
|
||
* @return string|false
|
||
*/
|
||
public static function alipayPay($order)
|
||
{
|
||
try {
|
||
$payUrl = self::generateAlipayUrl($order);
|
||
return $payUrl;
|
||
} catch (\Exception $e) {
|
||
self::setError($e->getMessage());
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @notes 生成支付宝支付URL
|
||
* @param $order
|
||
* @return string
|
||
*/
|
||
private static function generateAlipayUrl($order): string
|
||
{
|
||
// TODO: 集成支付宝SDK
|
||
$alipayConfig = [
|
||
'app_id' => config('pay.alipay.app_id'),
|
||
'merchant_private_key' => config('pay.alipay.merchant_private_key'),
|
||
'alipay_public_key' => config('pay.alipay.alipay_public_key'),
|
||
];
|
||
|
||
// 生成支付URL
|
||
$payUrl = 'https://openapi.alipay.com/gateway.do?' . http_build_query([
|
||
'app_id' => $alipayConfig['app_id'],
|
||
'method' => 'alipay.trade.page.pay',
|
||
'charset' => 'UTF-8',
|
||
'sign_type' => 'RSA2',
|
||
'timestamp' => date('Y-m-d H:i:s'),
|
||
'version' => '1.0',
|
||
'notify_url' => config('app.url') . '/api/order/alipay-notify',
|
||
'return_url' => config('app.url') . '/order',
|
||
'biz_content' => json_encode([
|
||
'out_trade_no' => $order->order_no,
|
||
'product_code' => 'FAST_INSTANT_TRADE_PAY',
|
||
'total_amount' => $order->amount,
|
||
'subject' => '订单支付',
|
||
'body' => '订单号：' . $order->order_no,
|
||
]),
|
||
]);
|
||
|
||
return $payUrl;
|
||
}
|
||
```
|
||
|
||
#### 微信支付
|
||
|
||
```php
|
||
/**
|
||
* @notes 微信支付
|
||
* @param $order
|
||
* @return array|false
|
||
*/
|
||
public static function wechatPay($order)
|
||
{
|
||
try {
|
||
$payData = self::generateWechatPayData($order);
|
||
return $payData;
|
||
} catch (\Exception $e) {
|
||
self::setError($e->getMessage());
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @notes 生成微信支付数据
|
||
* @param $order
|
||
* @return array
|
||
*/
|
||
private static function generateWechatPayData($order): array
|
||
{
|
||
// TODO: 集成微信SDK
|
||
$wechatConfig = [
|
||
'app_id' => config('pay.wechat.app_id'),
|
||
'mch_id' => config('pay.wechat.mch_id'),
|
||
'api_key' => config('pay.wechat.api_key'),
|
||
];
|
||
|
||
// 生成微信支付数据
|
||
$payData = [
|
||
'appid' => $wechatConfig['app_id'],
|
||
'mch_id' => $wechatConfig['mch_id'],
|
||
'nonce_str' => uniqid(),
|
||
'body' => '订单支付',
|
||
'out_trade_no' => $order->order_no,
|
||
'total_fee' => (int)($order->amount * 100),
|
||
'spbill_create_ip' => request()->ip(),
|
||
'notify_url' => config('app.url') . '/api/order/wechat-notify',
|
||
'trade_type' => 'NATIVE',
|
||
];
|
||
|
||
return [
|
||
'pay_url' => 'https://api.mch.weixin.qq.com/pay/unifiedorder',
|
||
'pay_data' => $payData,
|
||
'qrcode' => 'https://api.mch.weixin.qq.com/qrcode',
|
||
];
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 配置说明
|
||
|
||
### 支付宝配置
|
||
|
||
在 `config/pay.php` 中配置支付宝参数：
|
||
|
||
```php
|
||
'alipay' => [
|
||
'app_id' => 'your_alipay_app_id',
|
||
'merchant_private_key' => 'your_merchant_private_key',
|
||
'alipay_public_key' => 'your_alipay_public_key',
|
||
],
|
||
```
|
||
|
||
### 微信配置
|
||
|
||
在 `config/pay.php` 中配置微信参数：
|
||
|
||
```php
|
||
'wechat' => [
|
||
'app_id' => 'your_wechat_app_id',
|
||
'mch_id' => 'your_mch_id',
|
||
'api_key' => 'your_api_key',
|
||
],
|
||
```
|
||
|
||
---
|
||
|
||
## API 端点
|
||
|
||
### 支付宝支付
|
||
|
||
```bash
|
||
POST /order.order/alipay
|
||
{
|
||
"id": 1,
|
||
"payment_method": "alipay"
|
||
}
|
||
```
|
||
|
||
**响应**:
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"data": {
|
||
"pay_url": "https://openapi.alipay.com/gateway.do?..."
|
||
}
|
||
}
|
||
```
|
||
|
||
### 微信支付
|
||
|
||
```bash
|
||
POST /order.order/wechat
|
||
{
|
||
"id": 1,
|
||
"payment_method": "wechat"
|
||
}
|
||
```
|
||
|
||
**响应**:
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"data": {
|
||
"pay_url": "https://api.mch.weixin.qq.com/pay/unifiedorder",
|
||
"pay_data": {...},
|
||
"qrcode": "https://api.mch.weixin.qq.com/qrcode"
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 支付流程
|
||
|
||
### 支付宝支付流程
|
||
|
||
1. 用户选择支付宝支付
|
||
2. 前端调用 `/order.order/alipay` 接口
|
||
3. 后端生成支付宝支付URL
|
||
4. 前端跳转到支付宝支付页面
|
||
5. 用户完成支付
|
||
6. 支付宝回调 `/api/order/alipay-notify` 接口
|
||
7. 后端更新订单状态为已支付
|
||
|
||
### 微信支付流程
|
||
|
||
1. 用户选择微信支付
|
||
2. 前端调用 `/order.order/wechat` 接口
|
||
3. 后端生成微信支付数据
|
||
4. 前端显示二维码
|
||
5. 用户扫描二维码完成支付
|
||
6. 微信回调 `/api/order/wechat-notify` 接口
|
||
7. 后端更新订单状态为已支付
|
||
|
||
---
|
||
|
||
## 待实现
|
||
|
||
以下功能需要根据实际的支付SDK进行实现：
|
||
|
||
1. **支付宝SDK集成**
|
||
- 集成支付宝官方SDK
|
||
- 实现签名和验证
|
||
- 处理支付回调
|
||
|
||
2. **微信SDK集成**
|
||
- 集成微信官方SDK
|
||
- 实现签名和验证
|
||
- 处理支付回调
|
||
|
||
3. **支付回调处理**
|
||
- 创建 `/api/order/alipay-notify` 接口
|
||
- 创建 `/api/order/wechat-notify` 接口
|
||
- 验证回调签名
|
||
- 更新订单状态
|
||
|
||
4. **支付状态查询**
|
||
- 创建支付状态查询接口
|
||
- 定期检查支付状态
|
||
|
||
---
|
||
|
||
## 相关文件
|
||
|
||
### 前端
|
||
- `admin/src/views/order/index.vue` - 订单列表页面
|
||
- `admin/src/api/order.ts` - 订单API接口
|
||
|
||
### 后端
|
||
- `server/app/adminapi/controller/order/OrderController.php` - 订单控制器
|
||
- `server/app/adminapi/logic/order/OrderLogic.php` - 订单业务逻辑
|
||
|
||
---
|
||
|
||
## 版本信息
|
||
|
||
- **功能版本**: 1.5.0
|
||
- **实现日期**: 2026-03-10
|
||
- **功能类型**: 支付网关集成
|
||
- **状态**: ✅ 框架完成（待SDK集成）
|
||
|
||
---
|
||
|
||
**框架实现完成** ✅
|