更新
This commit is contained in:
Your Name
@@ -0,0 +1,406 @@
|
||||
# 订单系统 - 支付网关集成
|
||||
|
||||
## 功能说明
|
||||
|
||||
订单支付功能已升级为调用真实的支付网关，而不是直接标记为已支付。
|
||||
|
||||
支持的支付方式：
|
||||
- ✅ **支付宝支付** (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集成）
|
||||
|
||||
---
|
||||
|
||||
**框架实现完成** ✅
|
||||
Reference in New Issue
Block a user