Laravel Cashier Paddle

Laravel Cashier Paddle is a Laravel package that provides a fluent interface to Paddle Billing. It wraps subscription management — swaps, pausing, quantities, cancellation grace periods — so you don't have to write the boilerplate.

Cashier Paddle is maintained by the Laravel team, not by Paddle. For support, use the Cashier Paddle issue tracker.

GitHub

View source code and report issues on GitHub.

Packagist package

View and install on Packagist.

Changelog

See recent releases and changes.

Install

Require the package via Composer:

Shell

composer require laravel/cashier-paddle

Follow the Laravel documentation for the full install — publishing migrations, configuring environment variables, and wiring up the Billable trait on your User model.

Configure

Cashier Paddle reads configuration from standard Laravel environment variables:

env

PADDLE_CLIENT_SIDE_TOKEN=your-paddle-client-side-token
PADDLE_API_KEY=your-paddle-api-key
PADDLE_WEBHOOK_SECRET="your-paddle-webhook-secret"
PADDLE_SANDBOX=true

Create the API key and client-side token in Paddle > Developer tools > Authentication and the webhook secret on your notification destination in Paddle > Developer tools > Notifications.

Quick example

Load Paddle.js by placing the @paddleJS Blade directive right before your application layout's closing </head> tag:

blade

<head>
    @paddleJS
</head>

Open a checkout for a single price inside a route:

PHP

use Illuminate\Http\Request;

Route::get('/buy', function (Request $request) {
    $checkout = $request->user()
        ->checkout('pri_01hsxyh9txq4rzbrhbyngkhy46')
        ->returnTo(route('dashboard'));

    return view('checkout', ['checkout' => $checkout]);
});

Render the checkout in a Blade template using the Paddle.js button component provided by Cashier: