> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subscribd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> A modern, gateway-agnostic subscription billing package for Laravel

# 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/v1` for 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 in `config/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](/getting-started/installation)** — Install the package and run migrations
* **[Billable Models](/getting-started/billable-models)** — Mark your Eloquent model as billable
* **[Plans](/getting-started/plans)** — Define your pricing tiers
* **[Creating Subscriptions](/subscriptions/creating)** — Subscribe your first user