liberusoftware/filament-cashier-billing-provider

Filament billing provider for Laravel Cashier

1.3 2024-02-27 21:21 UTC

This package is not auto-updated.

Last update: 2024-11-20 22:41:34 UTC


README

Latest Version on Packagist Tests Total Downloads

Integrate Laravel Cashier Stripe support into Filament's multi-tenant panels.

Support me

Model States for Filament

You can support me by buying Model States for Filament.

Installation

  1. Install the package via composer:

    composer require maartenpaauw/filament-cashier-billing-provider
  2. Make sure your Billable model is the same as your Filament tenant model.

Tip

For more information configuring a Billable model, refer to the official Laravel documentation.

Usage

Add plans to your cashier.php config file:

'plans' => [
    'default' => [
        'price_id' => ENV('CASHIER_STRIPE_SUBSCRIPTION_DEFAULT_PRICE_ID'),
        'trial_days' => 14, // Optional
        'allow_promotion_codes' => true, // Optional
        'collect_tax_ids' => true, // Optional
        'metered_price' => true, // Optional
    ],
],

Caution

The current implementation only supports recurring subscriptions.

Add the following code to your AdminPanelProvider (or other panel providers):

use Maartenpaauw\Filament\Cashier\Stripe\BillingProvider;

// ...

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->tenantBillingProvider(new BillingProvider('default'))
        ->requiresTenantSubscription()
        // ...
}

Note

Requiring tenant subscription is optional. You can remove ->requiresTenantSubscription() if you wish.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.