在Laravel项目中整合微信支付和支付宝支付，不需要分别编写两套复杂的对接逻辑，借助成熟的支付扩展包可以大幅简化开发流程，同时保证两种支付方式的兼容性和后续维护便利性。
环境准备与依赖安装
首先需要确保Laravel项目运行环境满足PHP 7.2及以上版本，并且已经安装Composer包管理工具。我们推荐使用yansongda/pay扩展包，它已经封装了微信支付和支付宝支付的大部分接口，兼容性好且文档完善。
在项目根目录执行以下命令安装扩展包：
composer require yansongda/pay
配置支付参数
安装完成后需要配置两种支付平台的相关参数，首先在config目录下创建pay.php配置文件，内容如下：
<?php
return [
// 微信支付配置
'wechat' => [
'app_id' => env('WECHAT_APP_ID', ''), // 微信公众平台或开放平台的应用ID
'mch_id' => env('WECHAT_MCH_ID', ''), // 微信支付商户号
'key' => env('WECHAT_KEY', ''), // 微信支付商户密钥
'cert_client' => env('WECHAT_CERT_CLIENT', ''), // 客户端证书路径
'cert_key' => env('WECHAT_CERT_KEY', ''), // 客户端密钥路径
'notify_url' => env('WECHAT_NOTIFY_URL', ''), // 微信支付回调地址
],
// 支付宝支付配置
'alipay' => [
'app_id' => env('ALIPAY_APP_ID', ''), // 支付宝应用ID
'public_key' => env('ALIPAY_PUBLIC_KEY', ''), // 支付宝公钥
'private_key' => env('ALIPAY_PRIVATE_KEY', ''), // 应用私钥
'notify_url' => env('ALIPAY_NOTIFY_URL', ''), // 支付宝回调地址
'return_url' => env('ALIPAY_RETURN_URL', ''), // 支付宝同步跳转地址
],
];
然后在项目根目录的.env文件中添加对应的配置项，填入你从微信支付商户平台和支付宝开放平台获取的实际参数即可。
封装支付服务类
为了避免在控制器中重复编写支付逻辑，我们可以封装一个支付服务类，统一管理两种支付方式的调用。在app/Services目录下创建PayService.php文件：
<?php
namespace AppServices;
use YansongdaPayPay;
class PayService
{
// 初始化微信支付实例
public function initWechatPay()
{
$config = config('pay.wechat');
return Pay::wechat($config);
}
// 初始化支付宝支付实例
public function initAlipay()
{
$config = config('pay.alipay');
return Pay::alipay($config);
}
// 发起微信扫码支付
public function wechatQrPay($orderData)
{
$pay = $this->initWechatPay();
return $pay->scan($orderData);
}
// 发起支付宝网页支付
public function alipayWebPay($orderData)
{
$pay = $this->initAlipay();
return $pay->web($orderData);
}
// 处理微信支付回调
public function handleWechatNotify()
{
$pay = $this->initWechatPay();
return $pay->verify();
}
// 处理支付宝支付回调
public function handleAlipayNotify()
{
$pay = $this->initAlipay();
return $pay->verify();
}
}
控制器中调用支付接口
接下来在订单控制器中调用支付服务类，实现支付请求的发起。首先创建OrderController.php：
<?php
namespace AppHttpControllers;
use AppServicesPayService;
use IlluminateHttpRequest;
class OrderController extends Controller
{
protected $payService;
public function __construct(PayService $payService)
{
$this->payService = $payService;
}
// 发起支付
public function pay(Request $request)
{
$payType = $request->input('pay_type'); // 支付类型 wechat/alipay
$orderData = [
'out_trade_no' => time() . rand(1000, 9999), // 商户订单号
'total_fee' => 1, // 支付金额，单位为分，这里表示0.01元
'body' => '测试商品购买', // 订单描述
];
if ($payType == 'wechat') {
// 微信扫码支付，返回二维码链接
$result = $this->payService->wechatQrPay($orderData);
return response()->json(['qr_url' => $result['code_url']]);
} elseif ($payType == 'alipay') {
// 支付宝网页支付，返回跳转表单
$orderData['total_amount'] = 0.01; // 支付宝金额单位为元
return $this->payService->alipayWebPay($orderData);
}
return response()->json(['error' => '不支持的支付方式'], 400);
}
// 微信支付回调处理
public function wechatNotify()
{
$data = $this->payService->handleWechatNotify();
// 验证订单金额等信息，更新订单状态
// 这里省略订单状态更新的具体逻辑
return response()->xml([
'return_code' => 'SUCCESS',
'return_msg' => 'OK'
]);
}
// 支付宝支付回调处理
public function alipayNotify()
{
$data = $this->payService->handleAlipayNotify();
// 验证订单金额等信息，更新订单状态
// 这里省略订单状态更新的具体逻辑
return response()->json(['success' => true]);
}
}
路由配置
最后在routes/web.php中配置对应的路由，让支付接口可以被访问：
<?php
use IlluminateSupportFacadesRoute;
use AppHttpControllersOrderController;
Route::post('/order/pay', [OrderController::class, 'pay']);
Route::post('/notify/wechat', [OrderController::class, 'wechatNotify']);
Route::post('/notify/alipay', [OrderController::class, 'alipayNotify']);
注意事项
- 微信支付和支付宝支付的回调地址必须是公网可访问的地址，本地开发时可以使用内网穿透工具进行测试。
- 支付金额的单位两种平台不同，微信支付使用分，支付宝使用元，调用接口时需要注意转换，避免出现金额错误。
- 回调处理时一定要验证签名和订单信息的合法性，防止恶意请求伪造支付结果。
- 生产环境需要妥善保管支付相关的密钥和证书，不要提交到公开的代码仓库中。
通过以上步骤，就可以在Laravel项目中快速整合微信支付和支付宝支付，后续如果需要新增其他支付方式，只需要在配置和服务类中添加对应的逻辑即可，扩展性非常好。