README

lyre/billing adds subscription and billing domain primitives to Lyre applications.

What it provides

• Models: Subscription, SubscriptionPlan, PaymentMethod, Invoice, Transaction, Billable*
• REST endpoints for subscriptions, plans, payment methods
• Unified payment orchestration via Lyre\Billing\Services\PaymentManager
• Gateway adapters under src/Services/Gateways for:
  • mpesa (real initiation + webhook handling)
  • paypal (real initiation + capture/return handling)
  • stripe (scaffold with status-safe placeholders)
  • paystack (scaffold with status-safe placeholders)
• Additional billing routes:
  • GET /api/subscriptionplans/{plan}/subscribe
  • GET /api/subscriptions/{subscription}/approved
  • POST /api/billing/webhook
• Filament resources via LyreBillingFilamentPlugin

Install

composer require lyre/billing

Publish migrations:

php artisan vendor:publish --provider="Lyre\Billing\Providers\LyreBillingServiceProvider"
php artisan migrate

Seed default payment methods (optional):

php artisan db:seed --class="Lyre\\Billing\\Database\\Seeders\\PaymentMethodSeeder"

Filament

Register plugin in your panel provider:

use Lyre\Billing\Filament\Plugins\LyreBillingFilamentPlugin;

$panel->plugins([
    LyreBillingFilamentPlugin::make(),
]);

Notes

• Billing package follows core Lyre controller/repository/resource conventions.
• Keep webhook route behavior stable when integrating external payment providers.
• Checkout surfaces in consuming apps should call PaymentManager instead of using provider clients directly.
• Provider-specific payloads and callback interpretation belong in gateway adapters, not in app controllers.