Laravel集成Stripe和PayPal可通过官方SDK和第三方包实现。首先安装stripe/stripe-php或srmklive/paypal,配置API密钥于.env文件,并在服务配置中注册;接着创建支付控制器,分别调用Stripe Checkout或PayPal Express Checkout生成支付会话并跳转;前端引入Stripe.js或PayPal按钮触发支付;最后设置路由处理回调,验证结果并记录日志。推荐使用HTTPS、后端验证及Webhook签名检查以确保安全。

Laravel 集成 Stripe 或 PayPal 是构建现代电商应用的常见需求。这两个支付网关都提供了稳定的 API 和开发者工具,配合 Laravel 的生态可以快速实现安全、可靠的支付流程。下面分别介绍如何在 Laravel 项目中集成 Stripe 和 PayPal。
集成 Stripe 支付
Stripe 是开发者喜爱的支付平台,支持多种支付方式,文档清晰,Laravel 中可通过官方推荐的 laravel/cashier 包或直接调用 Stripe SDK 实现。
Invoice Ninja是一个免费且开源的发票、费用和时间跟踪应用,使用Laravel和Flutter构建。它提供了众多出色的功能,包括自定义品牌发票设计、定期发票和自动向客户收费、实时报价创建和自定义提案、费用报告等等!Invoice Ninja还能够处理来自40多个支付网关的在线支付,包括Stripe、PayPal和WePay。它还接受使用信用卡、ACH、比特币等进行支付。通过Invoice Ninja,您可以在线收款、使用看板板进行项目工作流程组织,并通过Webapp帐户在线跟踪时间。
通过 Composer 安装 Stripe 官方库: composer require stripe/stripe-php 2. 配置 API 密钥
在 .env 文件中添加你的 Stripe 密钥: STRIPE_KEY=your_publishable_key
STRIPE_SECRET=your_secret_key 然后在 config/services.php 中注册: 'stripe' => [
'key' => env('STRIPE_KEY'),
'secret' => env('STRIPE_SECRET'),
], 3. 创建支付控制器
生成控制器并处理支付请求: php artisan make:controller PaymentController 在控制器中使用 Stripe SDK 创建付款会话(适用于 Stripe Checkout):
use Stripe\Stripe;
use Stripe\Checkout\Session;
public function createCheckoutSession()
{
Stripe::setApiKey(config('services.stripe.secret'));
$session = Session::create([
'payment_method_types' => ['card'],
'line_items' => [[
'price_data' => [
'currency' => 'usd',
'product_data' => [
'name' => '商品名称',
],
'unit_amount' => 1000, // 金额,单位为分
],
'quantity' => 1,
]],
'mode' => 'payment',
'success_url' => route('payment.success'),
'cancel_url' => route('payment.cancel'),
]);
return response()->json(['id' => $session->id]);
}
4. 前端调用 Checkout在页面中引入 Stripe.js 并跳转到 Checkout 页面:
集成 PayPal 支付
PayPal 是全球广泛使用的支付方式,适合国际用户。Laravel 中常用第三方包如 Srmklive/PayPal 来简化集成。
1. 安装 srmklive/paypal 包composer require srmklive/paypal:~3.0 2. 发布配置文件
php artisan vendor:publish --provider="Srmklive\PayPal\Providers\PayPalServiceProvider" 配置文件将生成在 config/paypal.php。 3. 设置 PayPal 凭据
登录 PayPal Developer 获取沙箱或生产环境的 Client ID 和 Secret。 更新 .env: PAYPAL_SANDBOX_API_USERNAME=your_sandbox_username
PAYPAL_SANDBOX_API_PASSWORD=your_sandbox_password
PAYPAL_SANDBOX_API_SECRET=your_sandbox_signature
PAYPAL_MODE=sandbox 4. 创建 PayPal 支付流程
在控制器中发起支付请求:
use Srmklive\PayPal\Services\ExpressCheckout;
class PayPalController extends Controller
{
public function pay()
{
$provider = new ExpressCheckout();
$data = [];
$data['items'] = [
[
'name' => '商品名称',
'price' => 10.00,
'qty' => 1
]
];
$data['return_url'] = route('paypal.success');
$data['cancel_url'] = route('paypal.cancel');
$data['invoice_id'] = uniqid();
$data['invoice_description'] = "订单描述";
$data['total'] = 10.00;
$response = $provider->setExpressCheckout($data);
return redirect($response['paypal_link']);
}
public function success()
{
// 处理成功回调
}
public function cancel()
{
// 用户取消支付
}
}
5. 添加路由在 routes/web.php 中添加: Route::get('/pay-with-paypal', [PayPalController::class, 'pay']);
Route::get('/paypal/success', [PayPalController::class, 'success'])->name('paypal.success');
Route::get('/paypal/cancel', [PayPalController::class, 'cancel'])->name('paypal.cancel');
安全与最佳实践
- 始终在后端验证支付结果,不能仅依赖前端返回
- 使用 HTTPS 部署,保护敏感数据传输
- 记录支付日志,便于对账和调试
- 在生产环境关闭调试模式,避免密钥泄露
- 对 Webhook 回调进行签名验证(尤其是 Stripe)









