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模型中使用Billabletrait。 -
对于 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或者 Paddle
PADDLE_VENDOR_ID=your-vendor-id PADDLE_VENDOR_AUTH_CODE=your-auth-code PADDLE_SANDBOX=true # 开发环境建议开启沙箱
创建订阅计划与启动用户订阅
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) 方法即可：
$user->newSubscription('pro', 'price_monthly')->trialDays(7)->create($paymentMethod);处理订阅状态与页面跳转
Paddle 会自动跳转到其支付页面完成交易，而 Stripe 支持多种支付方式（包括信用卡、SEPA 等），通常结合 Payment Intents API 在前端收集支付方式后再提交。
- 订阅成功后，Cashier 会将相关信息存入数据库中的
subscriptions表。 - 可通过
$user->subscribed('default')判断用户是否处于活跃订阅状态。 - 检查是否在试用期：
$user->subscription('default')->onTrial()。 - 取消订阅：
$user->subscription('default')->cancel();，还可调用cancelNow()立即终止。
发票与 webhook 处理
Cashier 自动记录每次付款生成的发票，可通过以下方式获取：
$invoices = $user->invoices();对于异步事件（如支付失败、订阅续订、用户取消），需配置 webhook 接收通知：
-
Stripe： 设置
webhook路由并使用cashier:webhook命令验证签名。 - Paddle： 配置 Paddle 后台的 Webhook URL，Cashier 会自动验证请求来源并触发相应事件。
你可以监听 Cashier 提供的事件，如 InvoicePaid、SubscriptionCancelled 等，进行自定义逻辑处理。
基本上就这些，Laravel Cashier 极大简化了订阅系统的开发流程，只要按文档配置好凭证和模型，就能快速上线稳定的付费功能。
