# Paystack Modülü

https://docs.wisecp.com/tr/paystack-modulu

Paystack'i bağlayarak müşterilerinize sağlayıcının ödeme penceresini sunun ve fatura ödemelerini WISECP üzerinden takip edin.

## Ekrana Erişim

**Ayarlar → Finansal → Ödeme Ağ Geçitleri → Tüm Modüller** yolundan **Paystack** kartına tıklayın: `{admin}/modules/payment?module=Paystack`

## Ekranda Neler Var

Formda test ve canlı anahtarları, test seçeneği ve ortak ödeme ayarları bulunur. Müşteri Paystack penceresinde ödeme yapar. Modül WISECP kart saklama, otomatik ödeme, abonelik, taksit ayarı veya ödeme altyapısından iade sunmaz.

## Ön Koşullar

Canlı ödeme için etkinleştirilmiş Paystack üye iş yeri hesabı ve HTTPS kullanan bir site gerekir. Modül **NGN, USD, GHS ve ZAR** kabul eder; hesabınız da seçtiğiniz para birimini desteklemeli. Paystack'in sunduğu diğer para birimleri bu modülün listesinde yoktur.

Ayrı bir test sistemi kullanın. Bağlantı testi butonu yoktur; anahtarları kaydetmek ödemeyi doğrulamaz.

## Alanlar

- **Live Secret Key**: Canlı ödeme için zorunlu. İşlem ve bildirim imzası doğrulamasında kullanılır; varsayılanı boş.
- **Live Public Key**: Canlı ödeme penceresi için zorunlu. Canlı gizli anahtarla aynı hesaptan alın; varsayılanı boş.
- **Test Secret Key**: Test Mode açıkken zorunlu. Varsayılanı boş.
- **Test Public Key**: Test Mode açıkken zorunlu. Varsayılanı boş.
- **Test Mode**: Varsayılanı kapalı. Açıkken test çiftini, kapalıyken canlı çiftini kullanır.

**Durum** modülü etkinleştirir. Komisyon, para birimi dönüşümü, tutar sınırları ve ülke kısıtları [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri) rehberindedir. **Callback URL**, **Success URL** ve **Failed URL** sistemin hazırladığı adreslerdir; düzenlenmez.

## İşlemler

### Anahtarları Tanımlama

1. Paystack Dashboard'da **Settings → API Keys & Webhooks** bölümünü açın. Test ve canlı bölümlerini bulun. Göz simgesi, hesap parolanızdan sonra gizli anahtarı gösterir.
2. WISECP Paystack formunda **Durum** seçeneğini etkinleştirin. Her anahtarı aynı adlı alana kopyalayın ve **Test Mode** seçeneğini açın.
3. **Değişiklikleri Kaydet** butonuna tıklayın. **Ödeme Ağ Geçitleri → Başlangıç → Etkin Modül Seçimi** alanında Paystack'i seçip **Değişiklikleri Kaydet** butonuna tıklayın.
4. Yöntem tutar, para birimi ve ülke koşullarına göre kullanılabilir olur. Müşterilere sunmadan önce test faturasında doğrulayın.

### Bildirim Adresini Kaydetme

1. WISECP Paystack formundan **Callback URL** değerini kopyalayın.
2. Paystack **Settings → API Keys & Webhooks** bölümünde, ilgili ortamın **Webhook URL** alanına yapıştırıp o bölümün kaydını tamamlayın.
3. Ödeme olayı `charge.success` adını taşır. İmza ilgili ortamın gizli anahtarını kullanır; ayrı webhook anahtarı yoktur.
4. Sağlayıcıdaki işlemle WISECP faturasını birlikte kontrol edin. Mevcut modülün aşağıda açıklanan bildirim sınırlaması vardır.

### Test Etme ve Canlıya Geçme

1. Test anahtarları seçiliyken ödenmemiş test faturasını ilgili müşteri olarak açın. Paystack'i seçip **Ödeme Yap** butonuna tıklayın.
2. [Paystack test bilgileriyle](https://paystack.com/docs/payments/test-payments/) ödemeyi tamamlayın. Siteye dönüş bitene kadar pencereyi kapatmayın.
3. Sağlayıcıdaki başarılı işlemi, para birimini ve tutarı ödenmiş faturayla karşılaştırın. İptali ve tarayıcı dönüşü kesilen ödemeyi de kontrol edin.
4. Canlı kullanımda etkin hesabın canlı çiftini girin, **Test Mode** işaretini kaldırıp **Değişiklikleri Kaydet** butonuna tıklayın. Sonraki ödemeler gerçek para kullanır.

### Ödemeyi İade Etme

1. Paystack **Transactions** bölümünde işlemi açın. **Refunds → New Refund** yolundan tutarı girip **Confirm** butonuna tıklayın.
2. İade sonucunu Paystack'te kontrol edin. WISECP bu iadeyi göndermez veya eşitlemez.
3. Tamamen iade edilen faturayı `{admin}/invoices/detail?id={fatura}` adresinden açın. **Özet → Durumu Değiştir** bölümünde **İade Edildi** ve **Gider olarak ekle** seçin.
4. **Durumu Güncelle** butonuna tıklayın. İade kaydedilir, tekrar para gönderilmez. Kısmi iadeyi gerçek tutarıyla ayrıca kaydedin.

## Dikkat Edilecekler

> **Tek Başına Webhook'a Güvenmeyin**
> 
> Mevcut modül, bildirimdeki işlem referansını okumadan önce ödeme kaydını arar. Tarayıcının fatura referansını taşımayan webhook ödemeyi kaydedemeyebilir. Yeniden tahsilat öncesinde Paystack işlemlerini faturalarla karşılaştırın.

> **Dönüş Penceresini Açık Tutun**
> 
> Popup açılamadığında alternatif yönlendirme yolu başarısız olabilir. Başarı sayfası, eşleşen ödeme kanıtı değildir. Hizmet sunmadan veya tekrar tahsilat yapmadan önce işlem referansını, tutarı ve para birimini doğrulayın.

## Gerekli Yetkiler

WISECP ayarları **Modüller → Ödeme Altyapıları** (`MODULES_PAYMENT_SETTINGS`), fatura değişiklikleri **Faturalandırma → Düzenleme** (`INVOICES_OPERATION`) yetkisini gerektirir. Paystack anahtar yönetiminde hesap sahibi veya yönetici, iadede iade erişimi olan hesap kullanılmalı.

## İlgili Makaleler

- [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı Genel Görünüm](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Paystack Anahtarları ve Webhook](https://support.paystack.com/en/articles/2123458)
- [Paystack İadeleri](https://support.paystack.com/en/articles/2127106)