Search by

pushery / billing-for-laravel

pushery

Provider-neutral billing for Laravel: subscriptions, invoices, metered usage, dunning, tax and e-invoicing. Two drivers, one set of contracts.

Package info

github.com/pushery/billing-for-laravel

Documentation

pkg:composer/pushery/billing-for-laravel

Security

Advisories: 0

Security Policy

Aikido package health analysis

Transparency log

Statistics

Installs: 1 548

Dependents: 0

Suggesters: 0

Stars: 2

Open Issues: 0

v0.44.0 2026-10-06 05:32 UTC

Requires

Requires (Dev)

Suggests

  • ext-intl: Writes the amounts in the package's mails the way the reader's language does, through ICU. Without it an amount keeps its currency code and takes the language's decimal mark, as in 29,00 EUR.
  • ext-posix: Names the system user that billing:reporting:file records as the submitter of a filing when --by is not given. Without it the name comes from the USER, LOGNAME or USERNAME environment variable.
  • adyen/php-api-library: Required only for the Adyen driver -- no other driver and no local engine touches it. Deliberately not a hard dependency, the same reasoning that keeps mollie/mollie-api-php optional: an install that never selects Adyen would otherwise carry an API client it never calls. Without it the Adyen webhook verifier refuses every request rather than waving one through.
  • horstoeko/zugferd: Required only to embed the EN 16931 CII XML into a ZUGFeRD/Factur-X hybrid PDF/A-3 via Invoicing\ZugferdPdfInvoice. The CII and XRechnung XML writers need none of it.
  • livewire/livewire: Required only for the optional account-hub UI — the nine Livewire screens. The billing core (models, webhooks, invoicing, tax, contracts) needs none of it.
  • mollie/mollie-api-php: Required only for the Mollie driver, version 3.13 or 4 — the local billing engine and every other driver need none of it. Deliberately not a hard dependency: an install that never selects billing.default=mollie would otherwise carry an HTTP client it never calls, the same reasoning that keeps horstoeko/zugferd optional.

Provides

None

Conflicts

None

Replaces

None

MIT f153c1869ec8d41384c1a0340f44f5fbc09e006d

paymentsstripemollielaravelsaasbillingmarketplaceinvoicessubscriptionscashierZUGFeRDe-invoicingxrechnungmetered-billingdatevdunningusage-based-billing

Published on Packagist.org on 2026-10-06 05:32 UTC

This package is auto-updated.

Last update: 2026-10-06 05:32:30 UTC

README

Billing for Laravel

Billing for Laravel

Latest Version PHP Version Laravel Versions License

Tests Coverage Type Coverage PHPStan Code Style Databases

Provider-neutral billing for Laravel: subscriptions, invoices, metered usage, dunning, tax and e-invoicing. Two drivers, one set of contracts.

Everything crosses a small set of contracts, so your app talks to billing — not to a provider. Stripe runs the subscription cycle on its own side, behind a hosted checkout. Mollie establishes a mandate through a first payment and this package runs the cycle itself, which is the path any provider without a native subscription API takes. Your application code does not change between them; billing.default does.

Highlights

  • Two-layer, provider-neutral core — PaymentRails (moves money, stores mandates) and BillingEngine (the recurring cycle). Money crosses the boundary as a Money value object, never a raw provider response.
  • Subscriptions — in-app upgrade/downgrade swap with a proration preview, cancel-into-grace, resume, and immediate cancel — the client submits a tier key, never a price (anti-price-injection).
  • Account hub — a publishable Livewire hub (overview, subscription, change-plan, payment methods, invoices, usage, payment recovery, danger zone) with config-driven routes and a self-contained Blade view set. Drop a <x-billing::banner /> into your layout to surface a failed payment, a lapsing grace period or a trial about to end.
  • Webhooks — an idempotent, signature-verified backbone with effects out of the box (plan-sync, add-on credit, dunning notice, invoice persistence) and a fail-loud webhook-secret guard.
  • Usage-based billing — charge a base fee plus what a customer actually used, with a retry that cannot double-bill, an outage that cannot silently lose revenue, oversell-safe reserve/work/settle metering, quota policies, and prepaid units that never expire.
  • Entitlements & seats — a separate License gate for what a tier unlocks (feature grants + numeric limits), independent of what it costs, plus team seats and a User-XOR-Team owner model.
  • Dunning, suspension & tax — a config-driven multi-level dunning ladder, a per-surface 423 Locked suspension gate driven by a stored delinquency clock (outage-safe), and provider tax (Stripe Tax) on the invoice with a pluggable TaxCalculator seam for a local computation path.
  • E-invoicing — dependency-free EN 16931 writers in both syntaxes (XRechnung UBL and ZUGFeRD / Factur-X CII), an optional hybrid PDF/A-3 embed, and a DATEV (EXTF Buchungsstapel) export.
  • Security-first — a billing.enabled master switch that makes the whole surface disappear, a scoped Content-Security-Policy for the hub, a fail-closed money-eligibility gate, and card capture that happens on the provider's own hosted page, so no card data ever touches your app (PCI SAQ-A).

Requirements

  • PHP 8.4+
  • Laravel 13+

Tested on PostgreSQL and MySQL 8.4, the databases Laravel Cloud runs (serverless Postgres and MySQL 8.4 LTS), so it runs there out of the box. The fast suite runs on SQLite.

Installation

composer require pushery/billing-for-laravel
php artisan billing:install
php artisan migrate

The service provider is registered through package discovery. The Stripe driver is the default and builds on Cashier, so set your Stripe keys (STRIPE_KEY, STRIPE_SECRET, STRIPE_WEBHOOK_SECRET) as usual.

For Mollie, set BILLING_DRIVER=mollie and BILLING_MOLLIE_API_KEY, and install its SDK — composer require mollie/mollie-api-php. It is a suggestion rather than a requirement on purpose: an install that never selects that driver would otherwise carry an HTTP client it never calls.

Billable model isn't App\Models\User? Set BILLING_CUSTOMER_MODEL before you run billing:install, or it adds the billing columns to users. See the installation guide for the full detail.

Documentation

The full documentation lives at docs.pushery.com/billing-for-laravel — start there. (It is published as a site rather than carried in the repository, so these links point outward and an installed package stays unchanged.)

Security

The card is captured on the provider's own hosted page, so no card data ever touches your app (PCI SAQ-A), and the webhook backbone refuses to boot in production without a signing secret. Please review the security policy and report vulnerabilities privately rather than opening a public issue.

Built by Pushery

This package is built and maintained by Pushery — a Berlin-based studio building Laravel applications, SaaS products, and open-source tools.

Building a Laravel UI? WireKit, Pushery's open-source Livewire component kit, gives you a themeable component library out of the box. Browse the rest of our work at pushery.com.

License

The MIT License (MIT). See LICENSE for details.