Introduction
Subscribd is a comprehensive subscription billing package for Laravel. It handles the full lifecycle of recurring billing — from plan definition to invoice generation — so you can focus on building your product rather than wiring up payment infrastructure.What Subscribd provides
Subscribd integrates deeply with Laravel’s ecosystem to give you:- Six payment gateways — Stripe, PayPal, Braintree, Paddle, FastSpring, and Square, with a clean driver interface for custom integrations
- Flexible billing models — flat-rate, per-seat, tiered, and metered plans through a unified pricing rules system
- PlanItems — composable add-ons that let customers mix and match quantities per plan, with per-item cap behaviours and price overrides
- Entitlements and feature limits — check what a subscriber can access, track usage against limits, and enforce soft or hard caps
- Multiple subscriptions — support multi-slot billing for teams, resellers, or any model where one customer holds several concurrent subscriptions
- Coupon system — percentage discounts, fixed-amount discounts, and feature-granting coupons with optional plan restrictions and expiry
- Dunning management — configurable retry schedules for failed payments, automatic grace periods, and final-retry cancellation
- Proration — three strategies (
now,renewal,none) with native gateway proration where supported and a built-in proration engine elsewhere - Invoice PDF generation — dompdf-backed PDF invoices with a configurable company name and logo
- Livewire and Blade components — a full UI library for plan selection, checkout, subscription management, invoice history, and coupon redemption, all publishable and fully customisable
- Filament admin panel — a ready-to-install plugin with resources, relation managers, and dashboard widgets for every billing entity
- Event-driven architecture — dispatches a Laravel event at every billing milestone so your listeners stay decoupled from billing logic
- REST API — bearer-token authenticated API at
subscribd/api/v1for headless or mobile integrations - Localisation — ships with English, Spanish, French, German, and Chinese (Simplified) translations
Why Subscribd?
Most billing libraries lock you into a single gateway or a single billing model. Subscribd is gateway-agnostic by design: swapping from Stripe to Paddle is a configuration change, not a rewrite. The same applies to billing models — adding per-seat or metered pricing to an existing flat-rate plan requires no structural changes. The package follows Laravel conventions throughout. Plans are defined inconfig/subscribd.php, migrations are published and run with php artisan migrate, and every interaction goes through standard Eloquent models and Laravel events. If you know Laravel, Subscribd will feel familiar immediately.
Requirements
| Minimum | |
|---|---|
| PHP | 8.3 |
| Laravel | 12 or 13 |
| Database | MySQL, PostgreSQL, or SQLite |
Next steps
- Installation — Install the package and run migrations
- Billable Models — Mark your Eloquent model as billable
- Plans — Define your pricing tiers
- Creating Subscriptions — Subscribe your first user