laravel-cashier-paddle

用途：为 Laravel 应用集成 Paddle 订阅计费与支付能力，覆盖从基础配置到订阅生命周期管理的常见场景，并作为代码参考技能快速给出实现模式。主要能力：在 Eloquent 模型上引入 Billable trait；创建单次商品与订阅结账会话（含多商品与数量）；查询订阅状态（试用、宽限期、已取消、逾期）；计划切换与按比例计费（swap、swapAndInvoice、noProrate）；数量增减与更新；暂停、立即暂停、定时暂停与恢复；预览含税费的价格；处理交易、部分或全额退款、下载发票 PDF；接收并处理 Paddle Webhook 事件，如 TransactionCompleted、SubscriptionCreated 等。使用方式：模型使用 Billable trait 并定义 paddleName、paddleEmail；通过 $user->checkout(...) 或 $user->subscribe(...) 创建结账，配合 <x-paddle-button> 展示；订阅操作用 $user->subscription() 链式方法；Webhook 通过 Laravel 事件监听；环境变量含 PADDLE_CLIENT_SIDE_TOKEN、PADDLE_API_KEY、PADDLE_RETAIN_KEY、PADDLE_WEBHOOK_SECRET、PADDLE_SANDBOX，货币区域用 CASHIER_CURRENCY_LOCALE。适用场景：需要快速接入 Paddle 订阅、试用、多商品计费、退款与发票流程的 Laravel 项目，以及排查集成问题。限制：资料未提供完整安装与配置步骤细节，价格与收费信息暂未提供，实际 API 行为以官方文档为准。