Ana içeriğe geç

Ödeme Ağ Geçitleri (Stripe ve PayPal)

FeedbackPulse SaaS, abonelik faturalandırması için Stripe ve PayPal'ı destekler. Birini veya her ikisini etkinleştirebilirsiniz.

💰 Faturalandırma Nasıl Çalışır​

  1. Admin → Planlar bölümünde abonelik planları oluşturursunuz (örn. Başlangıç $9.99/ay, Pro $29.99/ay)
  2. Her planın bir Stripe Fiyat Kimliği ve/veya PayPal Plan Kimliği vardır
  3. Bir kiracı abone olduğunda Stripe Checkout veya PayPal'a yönlendirilir
  4. Ödeme sonrasında FeedbackPulse aboneliğini etkinleştirir
  5. Webhook'lar her şeyi senkronize tutar (yenilemeler, iptaller, başarısızlıklar)

💳 Stripe Kurulumu​

1. Adım: Stripe Hesabı Oluşturun​

  1. stripe.com adresinde kayıt olun
  2. Kimlik doğrulamasını tamamlayın
  3. Developers → API Keys bölümünden API anahtarlarınızı alın

2. Adım: API Anahtarlarınızı Alın​

AnahtarNerede Bulunur.env Değişkeni
Yayımlanabilir AnahtarDashboard → Developers → API KeysSTRIPE_PUBLISHABLE_KEY
Gizli AnahtarDashboard → Developers → API KeysSTRIPE_SECRET_KEY
STRIPE_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxxxxxxx
STRIPE_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxx

🧪 Test: Sandbox modu için pk_test_ ve sk_test_ anahtarlarını kullanın.

3. Adım: Stripe'ta Ürünler ve Fiyatlar Oluşturun​

Her abonelik planı için Stripe'ta tekrarlayan fiyat oluşturun:

  1. Products → Add Product bölümüne gidin
  2. Ad: "FeedbackPulse Başlangıç" (veya plan adınız)
  3. Tekrarlayan fiyat ekleyin: $9.99 / ay
  4. İsteğe bağlı olarak yıllık fiyat ekleyin: $99.99 / yıl
  5. Fiyat Kimliğini kopyalayın (price_ ile başlar)

4. Adım: Fiyatları Planlara Bağlayın​

FeedbackPulse'da Admin → Planlar → Düzenle bölümüne gidin:

Plan AlanıStripe Değeri
Stripe Aylık Fiyat Kimliğiprice_xxxxxxxxx (aylık fiyat kimliği)
Stripe Yıllık Fiyat Kimliğiprice_xxxxxxxxx (yıllık fiyat kimliği)

5. Adım: Stripe Webhook'larını Kurun​

Bu kritik öneme sahiptir — webhook'lar abonelikleri senkronize tutar.

  1. Stripe Dashboard → Developers → Webhooks bölümüne gidin
  2. Add endpoint'e tıklayın
  3. Uç Nokta URL: https://yourdomain.com/webhooks/stripe
  4. Dinlenecek olaylar:
    • checkout.session.completed
    • customer.subscription.created
    • customer.subscription.updated
    • customer.subscription.deleted
    • invoice.payment_failed
  5. İmzalama Sırrını kopyalayın (whsec_ ile başlar)
STRIPE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxx

6. Adım: Yönetici Panelinde Etkinleştirin​

Admin → Ayarlar → Ödemeler bölümüne gidin:

  • Stripe'ı etkin konuma getirin
  • Yayımlanabilir ve gizli anahtarlarınızı yapıştırın
  • Kaydedin

💰 PayPal Kurulumu​

1. Adım: PayPal İş Hesabı Oluşturun​

  1. paypal.com/business adresinde kayıt olun
  2. developer.paypal.com adresine gidin

2. Adım: REST API Uygulaması Oluşturun​

  1. Dashboard → Apps & Credentials bölümüne gidin
  2. Create App'e tıklayın
  3. Ad: "FeedbackPulse"
  4. İstemci Kimliği ve Sırrı kopyalayın
PAYPAL_CLIENT_ID=your_client_id
PAYPAL_CLIENT_SECRET=your_client_secret
PAYPAL_MODE=live

🧪 Test: Sandbox kimlik bilgileri için PAYPAL_MODE=sandbox kullanın.

3. Adım: PayPal'da Abonelik Planları Oluşturun​

  1. PayPal Developer Dashboard → Subscriptions → Plans bölümüne gidin
  2. Önce bir ürün oluşturun, ardından bunun için planlar oluşturun
  3. Her Plan Kimliğini kopyalayın (P- ile başlar)

4. Adım: FeedbackPulse'da Planları Bağlayın​

Admin → Planlar → Düzenle bölümünde:

Plan AlanıPayPal Değeri
PayPal Aylık Plan KimliğiP-xxxxxxxxx (aylık plan)
PayPal Yıllık Plan KimliğiP-xxxxxxxxx (yıllık plan)

5. Adım: PayPal Webhook'larını Kurun​

  1. PayPal Developer Dashboard → Webhooks bölümünde
  2. Webhook URL'si ekleyin: https://yourdomain.com/webhooks/paypal
  3. Olayları seçin:
    • BILLING.SUBSCRIPTION.CREATED
    • BILLING.SUBSCRIPTION.ACTIVATED
    • BILLING.SUBSCRIPTION.UPDATED
    • BILLING.SUBSCRIPTION.CANCELLED
    • BILLING.SUBSCRIPTION.SUSPENDED
    • PAYMENT.SALE.COMPLETED
  4. Webhook Kimliğini kopyalayın
PAYPAL_WEBHOOK_ID=your_webhook_id

6. Adım: Yönetici Panelinde Etkinleştirin​

Admin → Ayarlar → Ödemeler bölümüne gidin:

  • PayPal'ı etkin konuma getirin
  • İstemci Kimliği ve Sırrınızı yapıştırın
  • Kaydedin

🧪 Ödeme Testi​

Stripe Test Modu​

Test kart numaralarını kullanın:

  • Başarılı: 4242 4242 4242 4242
  • Reddedilen: 4000 0000 0000 0002
  • 3D Secure: 4000 0025 0000 3155

Son kullanma tarihi: herhangi bir gelecek tarih. CVC: herhangi 3 rakam.

PayPal Sandbox​

  1. developer.paypal.com → Sandbox → Accounts adresine gidin
  2. Ödemeleri test etmek için oluşturulan sandbox alıcı hesabını kullanın

Çoklu Para Birimi Desteği​

Planlara farklı para birimleri atanabilir (örn. USD, EUR, GBP). Desteklenen para birimlerinin listesini Admin > Ayarlar > Ödemeler bölümündeki Desteklenen Para Birimleri alanından yapılandırın.

  • Stripe: Checkout oturumları planın para birimini otomatik olarak iletir, böylece müşteriler doğru para biriminde ücretlendirilir.
  • PayPal: Abonelik talepleri planın yapılandırılmış para birimiyle eşleşen para birimi meta verilerini içerir.
  • Para birimi, doğru kayıt tutma için her faturada saklanır.

Desteklenen para birimlerini yapılandırma hakkında ayrıntılar için bkz. Platform Ayarları.

🔒 Güvenlik Notları​

  • API anahtarları platform_settings tablosunda şifrelenmiş olarak saklanır
  • Webhook imzaları doğrulanır (Stripe HMAC, PayPal imza doğrulaması)
  • Ödeme olayları payment_events tablosuna kaydedilir (Admin → Ödemeler)
  • Olay tekilleştirme webhook'ların çift işlenmesini önler

⏭️ Sonraki Adımlar​