Paystack Modülü

21 görüntülenme Markdown

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 KeyCanlı ödeme için zorunlu. İşlem ve bildirim imzası doğrulamasında kullanılır; varsayılanı boş.
Live Public KeyCanlı ödeme penceresi için zorunlu. Canlı gizli anahtarla aynı hesaptan alın; varsayılanı boş.
Test Secret KeyTest Mode açıkken zorunlu. Varsayılanı boş.
Test Public KeyTest Mode açıkken zorunlu. Varsayılanı boş.
Test ModeVarsayı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 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 ö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ı.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.