🚀 Genel Bakış

Laravel Spark + Paddle PHP, Laravel uygulamaları için Paddle'ı ödeme ağ geçidi olarak entegre eden eksiksiz bir abonelik faturalandırma başlangıç kitidir.
Ekip faturalandırması, koltuk bazlı fiyatlandırma, faturalar, vergi yönetimi ve müşteri portalları gibi SaaS'a hazır özellikler sunar; bunların tümü Laravel'in yerel Cashier entegrasyonu üzerine kurulmuştur.

Bu paket, start-up'ların faturalandırma altyapısını sıfırdan yeniden oluşturmaya gerek kalmadan abonelik tabanlı yazılımı hızlı bir şekilde başlatmasına olanak tanır.

Şunlar için idealdir: SaaS kurucuları, Laravel geliştiricileri, üyelik platformları ve web ürünlerinden para kazanan girişimciler.

✨ Temel Özellikler

• Paddle Faturalama Entegrasyonu: Otomatik vergi/KDV işlemleriyle kredi kartlarını ve yerelleştirilmiş küresel ödemeleri kabul eder.
• Abonelik Modelleri: aylık/yıllık planlar, koltuk başına/ekip fiyatlandırması, deneme süreleri ve yükseltmeler/düşürmeler.
• Müşteri Faturalandırma Portalı: faturaları görüntüleyin, ödeme yöntemlerini güncelleyin, ekip üyelerini yönetin.
• Ekip ve Koltuk Yönetimi: üyeleri davet edin, roller atayın ve faturalandırma miktarlarını otomatik olarak güncelleyin.
• Gelir Analitiği: kaybı, MRR'yi, aktif abonelikleri ve faturalandırma geçmişini görüntüleyin.
• Fatura ve Vergi: indirilebilir makbuzlar, Paddle tarafından yönetilen vergi uyumluluğu, fatura ayrıntılarının düzenlenmesi.
• Kimlik Doğrulamaya Hazır: Laravel Breeze/Jetstream tarzı kimlik doğrulama dahildir.
• Geliştirici Dostu Codebase: planları, bildirimleri, etkinlikleri ve ara yazılım politikalarını genişletin.

⚙️ Teknik Yığın

• Çerçeve: SaaS için Spark içeren Laravel 10+.
• Ödeme: Laravel Cashier Paddle sürücüsü aracılığıyla Paddle PHP SDK entegrasyonu.
• Veritabanı: Abonelik ve kullanıcı verileri için MySQL/MariaDB/PostgreSQL.
• Ön Uç: Blade, Tailwind CSS ve Alpine.js (SPA isteğe bağlı).
• Sunucu Gereksinimleri: PHP 8.1+, SSL/HTTPS, etkinlikler ve web kancaları için kuyruk çalışanı.

Teknik Bilgi: Paddle, PCI uyumluluğu ve vergi gereksinimlerinin yükünü hafifleterek SaaS uygulamalarının operasyonel riskini azaltır.

🧩 Kurulum Kılavuzu (Hızlı Kurulum)

1. Laravel ve Spark başlangıç dosyalarını yükleyin.
2. Paddle için ortam değişkenlerini yapılandırın (Satıcı Kimliği, API anahtarı, genel anahtar, ödeme ayarları).
3. Geçişleri ve tohum planlarını çalıştırın (php artisan geçiş --seed isteğe bağlı).
4. Faturalandırma etkinlikleri için Paddle web kancalarını ve kuyruk çalışanlarını ayarlayın.
5. Plan fiyatlandırmasını, limitleri ve ekip rollerini özelleştirin ve ardından devreye alın.

İpucu: Geliştirme sırasında güvenli test ödemeleri için Paddle sanal alanını yapılandırın.

📦 Teslimatlar

• Laravel Spark iskelesi + Paddle faturalandırma mantığı.
• Ekip aboneliği yönetimi kodu ve kullanıcı arayüzü bileşenleri.
• Faturalandırma için veritabanı geçişleri ve model ilişkileri.
• Paddle kurulumu, vergiler ve web kancalarına ilişkin belgeler.
• Değişiklik ve yeniden dağıtıma olanak tanıyan GPL lisans dosyası.

📱 Desteklenen Platformlar

• Web Tarayıcıları: Chrome, Safari, Edge, Firefox.
• Sunucu İşletim Sistemi: Linux/Ubuntu önerilir — cPanel ve Laravel Forge dağıtımlarıyla da uyumludur.

🧠 Notlar

• Lisans: GNU GPL kapsamında dağıtılmıştır — düzenlenebilir ve yeniden dağıtılabilir.
• Özelleştirme Fikirleri: kullanıma dayalı faturalandırma, promosyon kodları, ölçülü faturalandırma API'leri, ortaklık sistemi.
• SEO: “Laravel SaaS faturalandırma”, “Paddle aboneliği Laravel”, “Spark Paddle entegrasyonu” gibi anahtar kelimeler için optimize edilmiştir.
• Güvenlik: Paddle ödemesi için web kancası imza doğrulamasını ve Şerit eşdeğeri belirteç kurallarını zorunlu kılın.

👨‍💻 Orijinal Geliştirici Kredisi

Kredi, Laravel Spark ve Paddle entegrasyon paketlerine orijinal katkıda bulunanlara aittir.
Tüm ticari markalar ilgili sahiplerinin mülkiyetinde kalır.

🔒 Sorumluluk reddi beyanı

Bu, Laravel Spark + Paddle PHP'nin eğitim amaçlı ve kendi kendine barındırılan kullanıma yönelik GPL lisanslı bir dağıtımıdır.
Laravel veya Paddle'a bağlı değiliz veya onları desteklemiyoruz.
Orijinal yayıncıdan alınmadığı sürece hiçbir resmi destek dahil değildir.