# Stripe (Tokenized) Modülü

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

Kart ödemelerini kendi ödeme formunuzda Stripe üzerinden alın; müşteri kartını sonraki ödemeler ve otomatik yenilemeler için saklayabilsin.

## Ekrana Erişim

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

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

Kısa bir ayar formu: Stripe anahtar çifti, bildirim imza anahtarı ve her modülde bulunan ortak ağ geçidi ayarları.

Müşteri kartını sizin ödeme formunuza girer. Stripe kartı çeker; 3-D doğrulama isteyen kartta müşteri bankaya gider ve sitenize geri döner. Kart numarası Stripe tarafında bir belirtece dönüşür, kurulumunuz numarayı ve güvenlik kodunu saklamaz.

Modül ayrıca kart saklar ve saklı kartı otomatik çeker. Fatura ekranından yalnız birkaç faturayı birden kapatan çekimi iade eder; İşlemler bölümüne bakın. Abonelik açmaz, taksit sunmaz.

## Ön Koşullar

- Anahtar çiftini aldığınız bir Stripe hesabı. Test anahtarları ile canlı anahtarlar iki ayrı çifttir.
- Satış yaptığınız para birimlerinin Stripe hesabında açık olması.
- Saklı kart ve otomatik yenileme ödemeleri için **Başlangıç Ayarları** içindeki **Kart Saklama Modülü** alanında bu modülün seçili olması.

## Alanlar

- **API Key**: Çiftin yayınlanabilir anahtarı. Zorunlu.
- **Secret Key**: Aynı çiftin gizli anahtarı. Her çekim, iade ve saklı kart işlemi bunu kullanır. Zorunlu.
- **Signing Secret**: Stripe bildirim kaydının imza anahtarı. Bu modül webhook kullanmaz: alanı boş bırakın, Stripe tarafında bildirim kaydı açmanız gerekmez. Sonuç kart formundan ve 3-D dönüşünden gelir.
- **Test Mode**: Ödeme formundaki kart sorgusunu gerçek banka bilgisi yerine sabit test değerleriyle yanıtlar. Çekimi hangi Stripe ortamının karşılayacağını belirlemez; onu 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 kullandığınız çifte göre ayarlayın.
3. **Değişiklikleri Kaydet** butonuna tıklayın. Bu yöntemi seçen müşteriler artık kart formunu görür.

### Müşterinin kartını saklamasına izin verme

1. **Ayarlar → Finansal → Ödeme Ağ Geçitleri** ekranına dönün ve **Başlangıç Ayarları** sekmesini açın.
2. **Kart Saklama Modülü** alanından **Stripe (Tokenized)** seçin ve **Değişiklikleri Kaydet** butonuna tıklayın.
3. Müşteriler artık hesaplarından kart ekleyebilir, ödeme sırasında saklı kartı seçebilir ve otomatik ödemeyi açabilir.

### Müşterinin izlediği yol

1. Müşteri kart yöntemini sepette, bir faturada ya da bakiye yüklerken seçer.
2. Kart bilgilerini yazar ya da daha önce sakladığı bir kartı seçer.
3. Banka 3-D doğrulama isterse müşteri doğrulamayı tamamlar ve sitenize döner.
4. Çekim faturayı kapatır ve hizmet etkinleşir.

### Yenilemeleri saklı karttan çekme

1. Müşteri hesabındaki saklı kart için otomatik ödemeyi açar.
2. Vadesi gelen yenileme faturasında sistem önce hesap bakiyesini, sonra müşterinin sıraladığı saklı kartları dener.
3. Başarılı çekim faturayı kapatır. Kartların hepsi başarısız olursa müşteri başarısız ödeme bildirimi alır ve fatura açık kalır.

### Ödemeyi iade etme

1. Ödenmiş faturayı açın: `{admin}/invoices/detail?id={fatura}`
2. Tek bir çekim birkaç faturayı kapattıysa durumu **İade Edildi** yapın, **Ödeme altyapısı ile iade** seçeneğini seçin ve onaylayın. Her fatura yalnız kendi payını iade eder.
3. Tek bir faturayı kapatan çekim mevcut sürümde modül üzerinden iade edilemez. İstek başarısız olur ve fatura durumu değişmez. İadeyi Stripe panelinden yapın, sonra faturayı **Gider olarak ekle** seçeneğiyle **İade Edildi** yapın.

## Dikkat Edilecekler

> **Kart kaydı iade edilmeyen bir çekimle başlar**
> 
> Kart saklarken kartın çalıştığını kanıtlamak ve belirteci almak için Stripe üzerinden 1 ABD doları çekilir. Müşteri hangi para biriminde faturalanırsa faturalansın çekim her zaman ABD dolarındadır; yalnız **Para Birimi Dönüştürme** seçtiyseniz o birime çevrilir. Bu çekim iade edilmez: siz Stripe panelinden elle iade edene kadar tahsil edilmiş kalır. Müşteri bunu ekstresinde görür; kart saklamayı önerdiğiniz yerde bundan söz edin.

> **Kartı silmek Stripe tarafındaki kaydı da kaldırır**
> 
> Kart satırında yalnız belirteç ve son dört hane durur. Kartı sildiğinizde belirteç Stripe tarafında da çözülür; o karta bağlı otomatik ödeme çalışmaz olur.

> **Test Mode yalnız formdaki kart sorgusunu değiştirir**
> 
> İşaretliyken kart numarasının yanında görünen banka ve marka bilgisi, gerçek banka yerine sabit test değerleriyle döner. Çekimin kendisi ve kasaya yazılan kart bilgisi Stripe'tan gelir; ikisi de bu test değerlerini taşımaz. Canlı anahtarlarla çalışırken işareti kaldırın ki operatörleriniz gerçek banka bilgisini görsün.

## 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)
- [Modül Yönetimi](https://docs.wisecp.com/tr/modul-yonetimi)