Laravel Spark + Paddle PHP

Description

Laravel Spark + Paddle PHP Integration Toolkit

Laravel Spark + Paddle PHP is a developer-ready integration toolkit that connects Laravel Spark (subscription scaffolding for Laravel apps) with Paddle (Merchant-of-Record billing). Ship SaaS faster with native Paddle checkout, automatic tax/VAT handling, webhook-driven lifecycle events, and seat/usage billing—all inside your Spark application. Distributed by wpshop.net under the GPL license, it includes lifetime free updates and limited email support so you can launch and scale confidently.

🔥 Feature Highlights

• 💳 Paddle Checkout + Invoicing – Embed Paddle overlay/inline checkout and issue compliant invoices globally.
• 🌍 Merchant-of-Record (MoR) – Paddle calculates, collects, and remits sales taxes/VAT for you in 200+ regions.
• 🛠️ Tight Spark Binding – Plans, teams, seats, trials, coupons, and billing portal mapped to Spark models/actions.
• 🔔 Webhook Lifecycle – Subscriptions sync via signed Paddle webhooks (purchase, renewal, cancel, pause, refund).
• 📈 Seat & Usage Billing – Track team seats and optional metered features with proration support.
• 🧾 Compliant Receipts – Auto-attach Paddle invoice URLs and statuses to customer billing history.
• 🧩 Paddle PHP SDK – Clean service layer for Products, Prices, Customers, Subscriptions, and Transactions.
• 🔐 Security First – HMAC verification, CSRF-safe checkout flows, signed URLs, and rate-limited webhooks.

📜 Detailed Overview

Laravel Spark gives you subscription scaffolding; this toolkit adds a production-grade Paddle backbone. You’ll get service classes, jobs, events, and policies that translate Spark actions (create team, start trial, change plan, update seats, cancel) into Paddle API calls—then reflect the results back into your app via verified webhooks. Because Paddle acts as the Merchant-of-Record, you offload the heavy lifting of global tax/VAT compliance, fraud screening, chargebacks, and receipts. Developers keep Spark’s elegant UX while Finance/Legal teams enjoy compliant billing out of the box.

The codebase is framework-native (Laravel): container-bound services, queued webhook processors, first-class events for analytics hooks, and easily swappable config for sandbox vs production. You can extend it with custom coupons, one-off purchases, add-ons, and dunning emails. Everything is documented and organized to keep PRs small and audits simple.

⚖️ Comparison Table

Capability	Laravel Spark + Paddle PHP (This Toolkit)	DIY Stripe/Braintree Integration
Global Tax/VAT Compliance	✔️ Handled by Paddle (MoR)	❌ You manage tax engines & filings
Spark Model Mapping	✔️ Ready-made adapters & events	⚠️ Custom glue code required
Webhooks & Dunning	✔️ Verified handlers, retries, jobs	⚠️ Build & secure from scratch
Seat/Usage Billing	✔️ Built-in counters & proration	⚠️ Complex metering logic
Invoices & Receipts	✔️ Automatic, compliant receipts	⚠️ Template + jurisdiction logic
License & Updates	✔️ GPL + lifetime free updates	❌ Ongoing maintenance burden

⚙️ Installation Guide

1. Download the package from your wpshop.net account.
2. Install into your Spark app:
   • Copy the package into packages/ or install via VCS path in composer.json.
   • Run composer install then php artisan vendor:publish --tag=paddle-config.
3. Configure environment in .env:
   • PADDLE_VENDOR_ID=, PADDLE_API_KEY=, PADDLE_PUBLIC_KEY=
   • PADDLE_ENV=sandbox|live, PADDLE_WEBHOOK_SECRET=
4. Migrate supporting tables: php artisan migrate (adds billing, webhook, and usage records).
5. Map plans: create Paddle Products/Prices; link IDs in config/paddle.php to Spark plans/tiers.
6. Routes & webhooks: enable provided routes; point Paddle Webhook URL to /paddle/webhook; verify HMAC.
7. Queues: run php artisan queue:work for async webhook handling & dunning jobs.
8. Test sandbox checkout, trials, upgrades/downgrades, seat changes, and cancellations before switching to live.

Tip: Protect the webhook endpoint with IP allowlisting (optional) and monitor failures with Laravel Horizon or your APM.

🔑 Licensing Information

Laravel Spark + Paddle PHP ships under the GPL (General Public License) and includes:

• ✔️ Lifetime Free Updates – security fixes, improvements, and new Paddle endpoints as they roll out.
• ✔️ Limited Email Support – help with installation and basic troubleshooting from wpshop.net.
• ✔️ Full Customization Rights – extend services, override handlers, or adapt to custom pricing flows.

You retain full control of your codebase with no vendor lock-in.

❓ FAQs

1) Does this replace Spark’s billing entirely?

It augments Spark by routing billing actions through Paddle. You keep Spark’s UX/models while Paddle handles checkout, taxes, and invoices.

2) Can I support team seats and per-seat pricing?

Yes. The toolkit includes seat counters synced to Paddle with proration on upgrades/downgrades.

3) What about metered/usage billing?

Usage collectors and scheduled jobs are included so you can send usage totals to Paddle each cycle.

4) How are taxes and VAT handled?

Paddle, as Merchant-of-Record, calculates, collects, and remits taxes/VAT. Invoices remain compliant for each jurisdiction.

5) Is the checkout embedded or hosted?

Both are supported. Use Paddle’s overlay/inline checkout or redirect—configurable via the provided service layer.

6) Does it work in sandbox first?

Yes. Configure PADDLE_ENV=sandbox for test flows, then switch to live keys when ready.

🌟 Why Choose Laravel Spark + Paddle PHP?

If you love Spark’s developer ergonomics but want global compliance, MoR tax handling, and enterprise-grade billing without reinventing the wheel, this toolkit is the fastest path. You get clean Laravel code, verified webhooks, and ready-to-use adapters—so your team can focus on product, not payments.

🚀 Get Started Today

Launch compliant, scalable SaaS billing with Laravel Spark + Paddle PHP. Download now from wpshop.net to enjoy GPL licensing, lifetime free updates, and reliable email support. Ship subscriptions globally—without the tax headache!