ZYT/zyt
2
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity
Files
08dd9cd30784b7fc59f23ea5f66704af74fdc173
zyt/admin/ORDER_PAYMENT_GATEWAY.md
T
Your Name 08dd9cd307 更新
2026-03-11 14:33:49 +08:00

8.8 KiB
Raw Blame History

订单系统 - 支付网关集成

功能说明

订单支付功能已升级为调用真实的支付网关，而不是直接标记为已支付。

支持的支付方式：

  • ✅ 支付宝支付 (Alipay)
  • ✅ 微信支付 (WeChat Pay)

前端实现

支付API

在 admin/src/api/order.ts 中添加了两个支付网关API：

// 支付宝支付
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() 方法中实现了支付流程：

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 中添加了两个支付网关端点：

支付宝支付

/**
 * @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]);
}

微信支付

/**
 * @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 中添加了支付网关方法：

支付宝支付

/**
 * @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;
}

微信支付

/**
 * @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 中配置支付宝参数：

'alipay' => [
    'app_id' => 'your_alipay_app_id',
    'merchant_private_key' => 'your_merchant_private_key',
    'alipay_public_key' => 'your_alipay_public_key',
],

微信配置

在 config/pay.php 中配置微信参数：

'wechat' => [
    'app_id' => 'your_wechat_app_id',
    'mch_id' => 'your_mch_id',
    'api_key' => 'your_api_key',
],

API 端点

支付宝支付

POST /order.order/alipay
{
  "id": 1,
  "payment_method": "alipay"
}

响应:

{
  "code": 0,
  "msg": "success",
  "data": {
    "pay_url": "https://openapi.alipay.com/gateway.do?..."
  }
}

微信支付

POST /order.order/wechat
{
  "id": 1,
  "payment_method": "wechat"
}

响应:

{
  "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 View Git Blame Copy Permalink