Skip to content

Laravel Cashier (Paddle)

简介

WARNING

本文档适用于 Cashier Paddle 2.x 与 Paddle Billing 的集成。如果你仍在使用 Paddle Classic,应该使用 Cashier Paddle 1.x

Laravel Cashier PaddlePaddle 的订阅计费服务提供了一个表达性强、流畅的接口。它处理几乎所有你担心的样板订阅计费代码。除了基本的订阅管理,Cashier 还可以处理:交换订阅、订阅「数量」、暂停订阅、取消宽限期等。

在深入了解 Cashier Paddle 之前,我们建议你也查看 Paddle 的概念指南API 文档

升级 Cashier

升级到新版本的 Cashier 时,仔细查看升级指南非常重要。

安装

首先,使用 Composer 包管理器安装 Cashier Paddle 包:

shell
composer require laravel/cashier-paddle

接下来,你应该使用 vendor:publish Artisan 命令发布 Cashier 迁移文件:

shell
php artisan vendor:publish --tag="cashier-migrations"

然后,你应该运行应用程序的数据库迁移。Cashier 迁移将创建一个新的 customers 表。此外,将创建新的 subscriptionssubscription_items 表来存储所有客户的订阅。最后,将创建一个新的 transactions 表来存储与客户相关的所有 Paddle 交易:

shell
php artisan migrate

WARNING

为确保 Cashier 正确处理所有 Paddle 事件,请记住设置 Cashier 的 webhook 处理

Paddle 沙盒

在本地和暂存开发期间,你应该注册一个 Paddle 沙盒账户。此账户将为你提供一个沙盒环境来测试和开发你的应用程序,而无需进行实际付款。你可以使用 Paddle 的测试卡号来模拟各种支付场景。

使用 Paddle 沙盒环境时,你应该在应用程序的 .env 文件中将 PADDLE_SANDBOX 环境变量设置为 true

ini
PADDLE_SANDBOX=true