Stripe (Checkout) Modülü

Ödemeleri Stripe'ın kendi ödeme sayfasında toplayın ve müşterinin aynı akıştan abonelik başlatmasına izin verin; kart bilgisi sitenize hiç girmez.

Ekrana Erişim

Ayarlar → Finansal → Ödeme Ağ Geçitleri yolunu izleyin, Tüm Modüller sekmesini açın ve Stripe (Checkout) kartına tıklayın: {admin}/modules/payment?module=StripeCheckout

Ağ geçidini müşterinin gördüğü yöntem listesine eklemeyi Ödeme Modülleri makalesinde bulursunuz.

Ekranda Neler Var

Tek bir ayar formu: sağlayıcı kimlik bilgileri, ödeme yöntemi kodları ve her modülde bulunan ortak ağ geçidi ayarları.

Müşteri bu yöntemi seçer, Stripe'ın ödeme sayfasına geçer, ödemesini orada yapar ve Stripe kuruluma bildirim gönderir. Bildirim faturayı ödendi durumuna alır ve siparişi etkinleştirir.

Modül ayrıca ödeme sırasında abonelik açar ve fatura ekranından iade yapar. Kart saklamaz, sitenizde kart formu açmaz ve taksit sunmaz.

Ön Koşullar

• Anahtar çiftini aldığınız bir Stripe hesabı. Test anahtarları ile canlı anahtarlar iki ayrı çifttir.
• Stripe panelinde checkout.session.completed olayı için oluşturduğunuz bir bildirim kaydı ve onun imza anahtarı.
• Satış yaptığınız para birimlerinin Stripe hesabında açık olması.

Alanlar

Durum, Komisyon Oranı (%), Para Birimi Dönüştürme, Kabul Edilen Tutar Aralığı ve ülke listeleri her ağ geçidinde aynı çalışır; Ödeme Modülleri makalesine bakın. Callback URL, Success URL ve Failed URL alanlarını değiştiremezsiniz: alanın sonundaki ikonla kopyalayın.

İşlemler

Anahtarları Stripe'tan alma

1. Stripe paneline giriş yapın. Test anahtarları için hesap seçicisinden bir sandbox ortamına geçin, gerçek ödemeler için canlı modda kalın.
2. Developers menüsünü açın, Workbench bölümüne tıklayın ve API keys sayfasına gidin.
3. Standard keys altındaki yayınlanabilir anahtarı ve gizli anahtarı kopyalayın. Sandbox anahtarları pk_test_ ve sk_test_, canlı anahtarlar pk_live_ ve sk_live_ ile başlar.
4. Canlı modda kendi oluşturduğunuz gizli anahtar bir kez gösterilir. Kaybederseniz aynı sayfadan anahtarı yenileyin ve yeni değeri kopyalayın.

Kimlik bilgilerini girme

1. Modül kartını açın ve Durum kutusunu işaretleyin. Bunu yapmadan diğer alanlar kilitli kalır.
2. API Key ve Secret Key alanlarını doldurun. Test Mode işaretini çifte göre ayarlamak isteğe bağlıdır: bu işaret yalnız bir etikettir, hiçbir şeyi değiştirmez.
3. Değişiklikleri Kaydet butonuna tıklayın. Ağ geçidi artık aşağıdaki bildirim adımına hazır.

Bildirim adresini Stripe'a kaydetme

1. Modül kartındaki Callback URL değerini kopyalayın.
2. Workbench içinde Webhooks sekmesini açın ve yeni bir olay hedefi oluşturmaya başlayın.
3. Adresi Endpoint URL alanına yapıştırın, kapsamı kendi hesabınızın olayları olarak bırakın ve checkout.session.completed olayını seçin. Modül başka bir olay okumaz.
4. Oluşturduğunuz hedefi açın, imza anahtarını görünür yapın ve Signing Secret alanına kopyalayın. Değişiklikleri Kaydet butonuna tıklayın.
5. Ödemeler artık faturasını kendiliğinden kapatır. Bu adım olmadan para Stripe'a geçer ama fatura açık kalır.

Müşterinin izlediği yol

1. Müşteri bu yöntemi sepette, bir faturada ya da bakiye yüklerken seçer.
2. Siparişte yenilenen kalemler varsa önce tek seferlik ödeme mi abonelik mi sorusunu yanıtlar.
3. Stripe ödeme sayfasına geçer ve izin verdiğiniz yöntemlerden biriyle öder.
4. Stripe kuruluma bildirim gönderir, fatura ödendi olur ve hizmet etkinleşir.

Ödemeyi iade etme

1. Ödenmiş faturayı açın: {admin}/invoices/detail?id={fatura}
2. Fatura durumunu İade Edildi olarak değiştirin ve modül üzerinden iade kutusunu işaretli bırakın.
3. Tek bir ödeme birkaç faturayı kapatmış olsa bile her fatura yalnız kendi payı kadar iade alır. Başarısız kalan iade kendiliğinden tekrarlanmaz.

Aboneliği izleme

1. Bu ağ geçidiyle açılan anlaşmaları görmek için Faturalandırma → Abonelikler ekranını açın.
2. Buradan iptal ettiğiniz anlaşma Stripe tarafında da iptal olur; tek bir satırı çıkardığınızda o satır anlaşmadan düşer.

Dikkat Edilecekler

Gerekli Yetkiler

Ödeme Modülü Ayarları (MODULES_PAYMENT_SETTINGS) yetkisi gerekir.

İlgili Makaleler

• Ödeme Modülleri
• Fatura Detayına Genel Bakış
• Abonelikler