# Stripe (Checkout) Modülü

https://docs.wisecp.com/tr/stripe-checkout-modulu

Ö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](https://docs.wisecp.com/tr/odeme-modulleri) 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

- **API Key**: Çiftin yayınlanabilir anahtarı. Zorunlu.
- **Secret Key**: Aynı çiftin gizli anahtarı. Stripe'a giden her istek bunu kullanır. Zorunlu.
- **Signing Secret**: Bildirim kaydını oluştururken Stripe'ın verdiği imza anahtarı. Zorunlu: boş bıraktığınızda modül gelen hiçbir bildirimi kabul etmez.
- **Payment Methods for One Time Payment**: Ödeme sayfasında sunulacak yöntem kodları, virgülle ayrılmış. Varsayılan `card`.
- **Payment Methods for Subscriptions**: Abonelik ödemeleri için aynı liste. Boş bırakırsanız tek seferlik ödeme listesi geçerli olur. `giropay` ve `p24` abonelik ödemelerinde kullanılamaz: buraya yazsanız da listeden çıkarılır, müşteri bunları Stripe sayfasında görmez.
- **Disable Subscription Feature**: İşaretlediğinizde abonelik seçeneği kalkar, her ödeme tek seferlik olur. Varsayılan olarak kapalı.
- **Payment Method Info**: Üstteki iki alana kopyalayabileceğiniz yöntem kodları. Bilgi amaçlı.
- **Webhook Event Types**: Modülün Stripe'tan beklediği olay. Bilgi amaçlı.
- **Test Mode**: Bu işaretin ürün içinde bir etkisi yoktur; hiçbir yerde okunmaz. Hangi ortamın yanıt vereceğini yalnız girdiğiniz anahtar çifti belirler. Varsayılan olarak açık.

**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](https://docs.wisecp.com/tr/odeme-modulleri) 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

> **Boş imza anahtarı bütün ödeme sonuçlarını keser**
> 
> Modül, imzasız bir bildirime güvenmek yerine onu geri çevirir. Müşteri öder, fatura açık kalır ve hizmet etkinleşmez. Canlıya geçmeden önce bu alanı doldurun.

> **Stripe kendi para birimini sunabilir**
> 
> Stripe hesabında uyarlanabilir fiyatlandırma açıksa ödeme sayfası müşteriye bulunduğu ülkenin para birimini önerir ve dönüşüm ücretini müşteri öder. Size yine fatura para biriminde geçer, fatura tutarı değişmez. Tek para birimi istiyorsanız bu seçeneği Stripe panelinden kapatın.

> **Test ve canlı anahtarlar ayrı hesaplara aittir**
> 
> Test Mode işaretini açmak anahtarları değiştirmez. Canlı anahtar çifti ile test imza anahtarını (ya da tersini) birlikte kullanırsanız bildirimler geri çevrilir. Anahtar çiftini, bildirim kaydını ve imza anahtarını birlikte değiştirin.

## Gerekli Yetkiler

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

## İlgili Makaleler

- [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayına Genel Bakış](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Abonelikler](https://docs.wisecp.com/tr/abonelikler)