使用yansongda/pay可快速集成支付宝、微信支付,通过composer安装并发布配置文件,填写app_id、密钥等参数后,利用Pay门面发起支付,处理notify异步通知验证签名并更新订单状态,return回调用于页面提示,建议日志记录、沙箱测试及敏感信息存.env。

在 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 门面发起支付。
萌次元商城是一个针对二次元的开源发卡系统。系统免费开源、界面美观、功能丰富。 (存在与第三方服务器连接的付费增值服务,但自身免费功能能够满足基本需求) 版权:遵循MIT协议从lizhipay处获得授权进行再分发 特色功能: 1.可以分发密钥,作为发卡网使用 2.可以关联快递单号,作为微商自建电商平台使用 3.支持多种支付方式,包括微信、支付宝、银联和国际
示例:创建支付宝网页支付
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 能大幅降低接入成本,关键是配置准确、处理好异步通知和异常情况。










