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 凭据:
# StripeSTRIPE_KEY=your-stripe-public-keySTRIPE_SECRET=your-stripe-secret-key或者 Paddle
PADDLE_VENDOR_ID=your-vendor-idPADDLE_VENDOR_AUTH_CODE=your-auth-codePADDLE_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 极大简化了订阅系统的开发流程,只要按文档配置好凭证和模型,就能快速上线稳定的付费功能。
以上就是laravel怎么使用Cashier处理Stripe或Paddle的订阅支付_laravel Cashier Stripe/Paddle订阅支付方法的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/136935.html
微信扫一扫
支付宝扫一扫