laravel怎么使用Cashier处理Stripe或Paddle的订阅支付_laravel Cashier Stripe/Paddle订阅支付方法

Laravel Cashier 支持 Stripe 和 Paddle，通过 Billable trait 实现订阅管理，需安装对应包并配置 API 凭据，创建订阅时引用价格 ID 或计划 ID，支持试用期、发票生成与 webhook 事件处理，简化了支付集成流程。

Laravel Cashier 提供了一套简洁的接口来处理订阅支付服务，支持 Stripe 和 Paddle 两种主流支付网关。通过 Cashier，你可以轻松实现创建订阅、管理账单周期、处理试用期、发票生成等常见功能。以下是使用 Laravel Cashier 处理 Stripe 或 Paddle 订阅支付的具体方法。

安装与配置 Cashier

根据你使用的支付平台选择对应的安装方式：

• 对于 Stripe： 运行 composer require laravel/cashier，然后发布迁移文件并运行迁移：
  php artisan cashier:install。确保在 User 模型中使用 Billable trait。
• 对于 Paddle： 使用 composer require laravel/cashier-paddle，同样执行 php artisan cashier-paddle:install 来生成必要的数据库字段，并在用户模型中引入 Billable。

接着在 .env 文件中设置对应平台的 API 凭据：

# Stripe
STRIPE_KEY=your-stripe-public-key
STRIPE_SECRET=your-stripe-secret-key
<h1>或者 Paddle</h1><p>PADDLE_VENDOR_ID=your-vendor-id
PADDLE_VENDOR_AUTH_CODE=your-auth-code
PADDLE_SANDBOX=true # 开发环境建议开启沙箱</p>

创建订阅计划与启动用户订阅

Stripe 和 Paddle 的定价模式略有不同，但 Cashier 封装了大部分逻辑。

• Stripe： 需提前在 Stripe 控制台创建价格（Price），然后在代码中引用该价格 ID 启动订阅。
  例如：
  $user->newSubscription('default', 'price_monthly')->create($paymentMethod);
• Paddle： 可直接使用预设的订阅计划 ID（如 12345）或套餐链接 ID 启动订阅：
  $user->newSubscription('default', 12345)->create();

如果需要试用期，添加 trialDays(7) 方法即可：

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

处理订阅状态与页面跳转

Paddle 会自动跳转到其支付页面完成交易，而 Stripe 支持多种支付方式（包括信用卡、SEPA 等），通常结合 Payment Intents API 在前端收集支付方式后再提交。

• 订阅成功后，Cashier 会将相关信息存入数据库中的 subscriptions 表。
• 可通过 $user->subscribed('default') 判断用户是否处于活跃订阅状态。
• 检查是否在试用期：$user->subscription('default')->onTrial()。
• 取消订阅：$user->subscription('default')->cancel();，还可调用 cancelNow() 立即终止。

发票与 webhook 处理

Cashier 自动记录每次付款生成的发票，可通过以下方式获取：

对于异步事件（如支付失败、订阅续订、用户取消），需配置 webhook 接收通知：

你可以监听 Cashier 提供的事件，如 InvoicePaid、SubscriptionCancelled 等，进行自定义逻辑处理。

基本上就这些，Laravel Cashier 极大简化了订阅系统的开发流程，只要按文档配置好凭证和模型，就能快速上线稳定的付费功能。

以上就是laravel怎么使用Cashier处理Stripe或Paddle的订阅支付_laravel Cashier Stripe/Paddle订阅支付方法的详细内容，更多请关注php中文网其它相关文章！