SuperAPI AI 工具集

laravel-billing

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:在 Laravel 项目中用 Laravel Cashier 实现订阅计费,包括订阅、发票、支付方式、Webhook 与账单门户,可选 Stripe 或 Paddle。

主要能力:提供 Stripe(laravel/cashier)与 Paddle(laravel/cashier-paddle)两套方案的配置、订阅创建/更换/取消/恢复、发票、支付方式、Checkout 与客户门户、Webhook 处理、计量计费、团队按席位计费、催缴(dunning)、基于套餐的功能开关。

使用方式:按强制工作流,先并行启动三类检查与调研(探索代码库、核实最新 Cashier 文档、查询具体 Stripe/Paddle 模式),实现后运行校验。数据库层在模型上使用 Billable trait;订阅检查用 $user->subscribed('default'),创建用 $user->newSubscription('default', 'price_monthly')->create($paymentMethodId),更换计划用 $subscription->swap('price_yearly'),取消用 cancel() 或 cancelNow(),恢复用 resume(),门户用 redirectToBillingPortal 或 billingPortalUrl。Laravel 13 下 Webhook 路由需通过 preventRequestForgery(except: [...]) 排除 CSRF。

适用场景:SaaS 订阅、全球销售税务合规、B2B 或 B2C 计费、用量计费与团队计费。

限制:必须依赖 Webhook 确认支付,不可信任客户端确认;不存储卡号;需校验 Webhook 签名;需处理 3D Secure 等未完成支付与宽限期;价格不要硬编码。Stripe 与 Paddle 在税务、发票、合规与费率上存在差异,需按需选型。Laravel 13 需 PHP 8.3+。具体价格数据与 FuseCore 细节以官方资料为准。