Laravel İle Dinamik Bir Yayın İçi Ödeme Ve Bağış Sistemi Nasıl Yapılır?

Ön Hazırlık ve Gereksinimler

Projeye başlamadan önce sisteminizde Laravel'in gerektirdiği temel bileşenlerin yüklü olduğundan emin olmalısınız. Geliştirme ortamınızda PHP 8.3, Composer ve bir veritabanı yönetim sistemi (MySQL veya PostgreSQL) kurulu olmalıdır.

• Laravel 11.x framework
• Composer paket yöneticisi
• Redis (Gerçek zamanlı bildirimler için)
• Seçilen ödeme sağlayıcısının API anahtarları

Öncelikle projenizi oluşturun ve gerekli bağımlılıkları yükleyin. Ardından, Laravel'in sunduğu "Breeze" veya "Jetstream" gibi başlangıç paketlerini kullanarak kullanıcı kimlik doğrulama sistemini hazır hale getirin.

Veritabanı Yapısının Tasarlanması

Bağışları ve ödemeleri takip etmek için ilişkisel bir veritabanı yapısı kurmamız gerekir. donations tablosu, bağışın miktarını, gönderen kullanıcıyı, yayıncıyı ve işlemin durumunu tutmalıdır.

// Migration dosyası örneği
Schema::create('donations', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained();
    $table->foreignId('streamer_id')->constrained('users');
    $table->decimal('amount', 10, 2);
    $table->string('status')->default('pending'); // pending, success, failed
    $table->string('transaction_id')->nullable();
    $table->timestamps();
});

Bu yapı, ödemenin durumunu takip etmemize ve daha sonra yayıncı panellerinde gelir raporları oluşturmamıza olanak tanır. status alanı, ödeme sağlayıcısından gelen web-hook (kanca) yanıtlarını doğrulamak için hayati önem taşır.

Ödeme Sağlayıcı Entegrasyonu

Ödeme işlemleri için Laravel'in resmi paketi olan Laravel Cashier kullanılabileceği gibi, yerel sağlayıcılar için kendi servis sınıfınızı da yazabilirsiniz. Aşağıda, ödeme başlatma işlemini yöneten bir servis katmanı örneği bulunmaktadır.

namespace App\Services;

class PaymentService {
    public function createPaymentIntent($amount, $userId) {
        // Ödeme sağlayıcısının API'sine istek atılır
        return [
            'client_secret' => 'pi_12345_secret_67890',
            'amount' => $amount
        ];
    }
}

Servis katmanı kullanmak, kodunuzun test edilebilirliğini artırır. İş mantığını Controller'dan ayırarak, yarın bir gün farklı bir ödeme sağlayıcısına geçmek istediğinizde sadece bu sınıfı güncellemeniz yeterli olacaktır.

Yayın İçi (Real-time) Bildirimler

Kullanıcı bağış yaptığında, yayıncının ekranında anlık bir bildirim görünmesi için Laravel Echo ve Pusher (veya soket sunucusu) kullanmalısınız. Bu, kullanıcı etkileşimini en üst seviyeye çıkaran "dinamik" özelliğimizdir.

// Event sınıfı örneği
class NewDonationEvent implements ShouldBroadcast {
    public $donation;
    public function broadcastOn() {
        return new Channel('stream.' . $this->donation->streamer_id);
    }
}

Bu olay (event) tetiklendiğinde, belirtilen kanala abone olan yayıncının tarayıcısına anlık veri iletilir. Yayıncı, sayfayı yenilemeden bağışı görür ve teşekkür edebilir.

Ödeme Yöntemlerinin Karşılaştırılması

Güvenlik ve Validasyon Uyarıları

Kritik Uyarı: Ödeme işlemlerinde asla kullanıcıdan gelen "tutar" bilgisini doğrudan veritabanına kaydetmeyin. Her zaman ödeme sağlayıcısından dönen onaylı tutarı baz alın. XSS saldırılarına karşı tüm kullanıcı girdilerini Laravel'in e() fonksiyonu veya Blade'in {{ }} sözdizimi ile escape edin.

SQL Injection'a karşı Laravel'in Eloquent ORM'ini kullanmak sizi büyük ölçüde korur. Ancak ham sorgular yazmanız gerekirse mutlaka "Binding" (bağlama) yöntemini kullanın.

Sıkça Sorulan Sorular

Ödeme onayını nasıl doğrularım?

Ödeme sağlayıcınızın sunduğu Webhook URL'sini Laravel rotalarınıza tanımlayarak, sağlayıcıdan gelen POST isteklerini doğrulamalı ve veritabanı durumunu buna göre güncellemelisiniz.

Bağışlar için komisyon kesebilir miyim?

Evet, veritabanına kayıt atarken amount değerinden platform komisyonunu düşen bir hesaplama mantığı kurarak yayıncıya ödenecek net tutarı ayrı bir sütunda saklayabilirsiniz.

Yayıncılar için ödeme geçmişi nasıl listelenir?

Eloquent'in where('streamer_id', auth()->id()) sorgusu ile sadece ilgili yayıncının bağışlarını listeleyen bir Controller metodu yazarak bu veriyi Vue.js veya Livewire ile tabloya basabilirsiniz.

Canlı ortamda hata ayıklama nasıl yapılır?

Laravel'in Log::info() veya Log::error() metodlarını ödeme döngülerinin her adımında kullanarak storage/logs/laravel.log dosyasını takip edebilirsiniz.

Pusher yerine alternatif var mı?

Evet, kendi sunucunuzda çalışan Laravel Reverb kullanarak tamamen ücretsiz ve kendi altyapınızda gerçek zamanlı bildirimler sağlayabilirsiniz.

Ödeme Sistemlerinde Performans Optimizasyonu ve Ölçeklendirme

Yayın içi ödeme sistemleri, anlık trafik artışlarına (spike) karşı oldukça hassastır. Özellikle popüler bir yayıncıya gelen bağış yağmuru sırasında veritabanı kilitlenmelerini önlemek ve sistemin yanıt süresini korumak için bazı stratejiler uygulamak kritiktir.

Redis ile Kuyruk Yönetimi

Ödeme onaylarını doğrudan veritabanına yazmak yerine, Laravel'in Queue (Kuyruk) sistemini kullanarak işlemleri arka plana atmak, kullanıcıya anında "İşleminiz alınıyor" mesajı dönmenizi sağlar. Bu, sistemin yoğun anlarda bile akıcı kalmasını sağlar.

// app/Jobs/ProcessDonation.php
public function handle()
{
    // Ödeme doğrulama ve veritabanı kayıt işlemleri burada yapılır
    $donation = Donation::create($this->data);
    
    // Bildirim tetikleme
    event(new DonationReceived($donation));
}

// Controller içerisinde kullanımı:
ProcessDonation::dispatch($request->all());

Veritabanı İndeksleme Stratejileri

Bağış geçmişi sorguları, sistem büyüdükçe yavaşlayacaktır. donations tablonuzda user_id ve created_at sütunlarına mutlaka indeks eklemelisiniz. Ayrıca, çok büyük verilerle çalışıyorsanız veritabanı bölümleme (partitioning) yöntemlerini değerlendirebilirsiniz.

// Migration dosyasında indeksleme
Schema::table('donations', function (Blueprint $table) {
    $table->index(['user_id', 'created_at']);
});

İleri Seviye Hata Ayıklama ve Loglama Teknikleri

Canlı bir ödeme sisteminde hata oluştuğunda, hatanın kaynağını saniyeler içinde tespit etmeniz gerekir. Laravel'in varsayılan loglama sistemini, ödeme süreçlerine özel bir kanal ile genişletmek en iyi pratiktir.

Özel Ödeme Logu Oluşturma

Tüm ödeme isteklerini ve yanıtlarını ayrı bir dosyada tutmak, olası bir uyuşmazlık durumunda (örneğin kullanıcı ödeme yaptığını iddia ederken sistemin hata alması) kanıt niteliği taşır.

// config/logging.php içerisine ekleyin
'payment' => [
    'driver' => 'single',
    'path' => storage_path('logs/payments.log'),
    'level' => 'debug',
],

// Kullanımı:
Log::channel('payment')->info('Ödeme isteği alındı', ['transaction_id' => $id]);

Sentry veya Flare ile Hata Takibi

Sadece log dosyalarına güvenmek yerine, Sentry gibi hata izleme araçlarını entegre etmek, ödeme sırasında oluşan istisnaların (exception) anında e-posta veya Slack üzerinden bildirilmesini sağlar. Özellikle try-catch bloklarında yakaladığınız hataları bu servislere göndermek, sistemin kararlılığını artırır.

try {
    $paymentService->process($request);
} catch (\Exception $e) {
    report($e); // Laravel'in hata raporlama sistemine gönderir
    return response()->json(['error' => 'Ödeme işlenemedi'], 500);
}

İpucu: Ödeme sistemlerinde idempotency (eşsizlik) anahtarı kullanmayı unutmayın. Aynı ödeme isteğinin iki kez işlenmesini önlemek için ödeme sağlayıcınızın sunduğu idempotency-key header değerini mutlaka Laravel tarafında kaydedin ve kontrol edin.

Sonuç

Laravel ile dinamik bir yayın içi ödeme sistemi kurmak, hem teknik yetkinlik hem de güvenlik bilinci gerektiren bir süreçtir. Bu rehberde, veritabanı tasarımından gerçek zamanlı bildirimlere kadar tüm süreci ele aldık. Bir sonraki adım olarak, ödeme sağlayıcınızın "Sandbox" (test) ortamında tüm senaryoları (başarılı, başarısız, iptal) test etmenizi ve ardından canlıya geçmenizi öneririm. Kodunuzu her zaman güncel tutun ve Laravel'in güvenlik güncellemelerini yakından takip edin.

Yasal Sorumluluk Reddi: Bu makale sadece eğitim amaçlıdır. Finansal işlemler ve ödeme sistemleri, yerel yasalar ve BDDK düzenlemelerine tabidir. Canlıya geçmeden önce mutlaka bir hukuk danışmanı ve finansal uzman ile çalışın.