在 Laravel 中集成第三方支付网关（如支付宝、微信支付）是电商类项目常见的需求。虽然这些平台没有官方的 Laravel 包，但社区提供了成熟且稳定的扩展包，能快速实现支付功能。

选择合适的支付 SDK 包

推荐使用 yansongda/pay，这是目前 Laravel 社区最流行的支付 SDK，支持支付宝、微信支付、银联等主流渠道，兼容 Laravel 服务容器，易于集成。

安装方式：

• composer require yansongda/laravel-pay

安装完成后，发布配置文件：

• php artisan vendor:publish --provider="Yansongda\\LaravelPay\\PayServiceProvider"

该命令会在 config/ 目录下生成 pay.php 配置文件。

配置支付宝与微信支付参数

打开 config/pay.php，根据实际平台填写密钥和应用信息。

示例配置（以支付宝为例）：

'alipay' => [
    'default' => [
        'app_id' => 'your_app_id',
        'notify_url' => '/pay/alipay/notify',
        'return_url' => '/pay/return',
        'ali_public_key' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...',
        'private_key' => 'MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...',
        'log' => [
            'file' => storage_path('logs/alipay.log'),
            'level' => 'debug'
        ],
        'mode' => 'normal', // 'dev' 或 'normal'
    ],
],

微信支付配置类似，需填写 app_id、mch_id、key、证书路径等。

发起支付请求

在控制器中使用 Pay 门面发起支付。

示例：创建支付宝网页支付

use Yansongda\LaravelPay\Facades\Pay;

public function pay() {
    $order = [
        'out_trade_no' => time(),
        'total_amount' => '100.00',
        'subject' => '测试商品',
        'product_code' => 'FAST_INSTANT_TRADE_PAY',
    ];

    return Pay::alipay()->web($order);
}

该方法会自动跳转到支付宝收银台页面。

处理异步通知（Notify）

支付结果通过服务器异步通知（notify_url）返回，需验证签名并处理业务逻辑。

示例路由：

Route::post('/pay/alipay/notify', [PayController::class, 'alipayNotify']);

控制器方法：

public function alipayNotify() {
    $data = Pay::alipay()->verify();

    if ($data->trade_status == 'TRADE_SUCCESS') {
        // 更新订单状态
        Order::where('no', $data->out_trade_no)->update(['paid' => true]);
    }

    return Pay::alipay()->success();
}

success() 方法会输出支付宝要求的响应内容，防止重复通知。

处理同步回调（Return）

用户支付后会被重定向到 return_url，此处可做展示性提示。

public function alipayReturn() {
    $data = Pay::alipay()->verify();

    // 可再次调用查询接口确认支付状态
    return view('pay.success', compact('data'));
}

常见问题与建议

• 确保服务器时间准确，避免签名错误
• notify 接口不要有重定向或 HTML 输出
• 敏感信息（如密钥）应存于 .env 文件
• 上线前在沙箱环境充分测试
• 记录日志便于排查问题

基本上就这些。使用成熟的 SDK 能大幅降低接入成本，关键是配置准确、处理好异步通知和异常情况。