SSLCommerz

SSLCommerz'i bağlayarak sağlayıcının ödeme sayfası veya popup'ı üzerinden tahsilat sunun ve faturaları WISECP'te takip edin.

Ekrana Erişim

Ayarlar → Finansal → Ödeme Yöntemleri → Tüm Modüller yolundan SSLCommerz kartına tıklayın: {admin}/modules/payment?module=SSLCommerz

Ekranda Neler Var

Formda mağaza kimliği, parola, test seçeneği, popup tercihi ve ortak ödeme ayarları bulunur. easyCheckout kapalıyken müşteri SSLCommerz ödeme sayfasına gider. Açıkken sağlayıcının popup'ı açılır.

Modül WISECP kart saklama, otomatik ödeme, abonelik veya taksit ayarı sunmaz. Sağlayıcıdaki ödeme seçenekleri üye iş yeri hesabınıza bağlıdır. İade desteği tek faturalı ve birleştirilmiş ödemelerde farklıdır; iade adımlarına bakın.

Ön Koşullar

SSLCommerz'den ayrı sandbox ve canlı Store ID/parola çiftlerini alın. Canlı ödeme için onaylı üye iş yeri hesabı, HTTPS ve TLS 1.2 veya üzerini destekleyen sunucu gerekir.

Mağazanın para birimi ve işlem sınırlarını SSLCommerz ile doğrulayın. BDT dışındaki ödemelerde sağlayıcı BDT dönüşümü yapabilir. API iadesi için sunucunun dışarıya bağlanırken kullandığı genel IP'yi SSLCommerz'e kaydettirin.

Ayrı bir test sistemi kullanın. Bağlantı testi butonu yoktur; bilgileri kaydettikten sonra test ödemesi gerekir.

Alanlar

Durum modülü etkinleştirir. Komisyon, dönüşüm, tutar sınırları ve ülke listeleri Ödeme Modülleri rehberindedir. Callback URL, Success URL ve Failed URL sistemin hazırladığı adreslerdir.

İşlemler

Mağazayı Tanımlama

1. Test için SSLCommerz sandbox kaydını kullanın. Mağazanın entegrasyon bilgilerini alın; canlı bilgiler onaylı üye iş yeri hesabınızdan gelir.
2. WISECP SSLCommerz formunda Durum seçeneğini etkinleştirin. Store ID ve Store Password değerlerini girip Test Mode seçeneğini açın.
3. easyCheckout seçeneğini açın veya sağlayıcı sayfası için kapalı bırakın. Değişiklikleri Kaydet butonuna tıklayın.
4. Ödeme Altyapıları → Başlangıç → Etkin Modül Seçimi alanında SSLCommerz'i seçip Değişiklikleri Kaydet butonuna tıklayın. Yöntem belirlediğiniz sınırlar içinde kullanılabilir olur.

Ödeme Bildirimlerini Tanımlama (İsteğe Bağlı)

WISECP her ödemeyi müşteri döndüğünde SSLCommerz ile doğrular ve bildirim adresini her ödemeyle birlikte gönderir. Üye iş yeri panelindeki bildirim dinleyicisi, yarıda kesilen dönüşler için yedektir.

1. WISECP formundaki Callback URL değerini kopyalayın ve sonuna ?callback_type=ipn ekleyin.
2. SSLCommerz üye iş yeri panelinde My Store → IPN Settings bölümünü açın. Tam adresi girin, varsa eski adresin yerine yazın ve mağazanın bildirim ayarlarını kaydedin.
3. Her ortamda ilgili mağazayı kullanın; ayrı webhook imza anahtarı alanı gerekmez. Zaten kapanmış bir ödemenin bildirimi onaylanır ve ikinci kez kaydedilmez.

Test Etme ve Canlıya Geçme

1. Ödenmemiş test faturasını ilgili müşteri olarak açın. SSLCommerz'i seçip Ödeme Yap butonuna tıklayın.
2. SSLCommerz sandbox ödeme bilgileriyle sayfa veya popup ödemesini tamamlayın. İki görünümü de kullanacaksanız ikisini ayrı deneyin.
3. Sağlayıcıdaki işlem, tutar ve para birimini, dönüşte ödenmiş görünen faturayla karşılaştırın. Başka bir denemeyi iptal etmek faturayı ödenmemiş bırakır.
4. Canlı mağaza çiftini girin, Test Mode işaretini kaldırıp Değişiklikleri Kaydet butonuna tıklayın. Sonraki ödemeler gerçek para kullanır. Bildirim dinleyicisi kullanıyorsanız onu canlı mağazaya da kaydedin.

Ödemeyi İade Etme

Tek faturayı kapatan ödeme için SSLCommerz üye iş yeri panelini kullanın. Mevcut modülün tek ödeme iade yolu SSLCommerz iade hizmetini çağırmaz.

1. SSLCommerz'de işlem detaylarını ve Refund Request bölümünü açın. Tam veya kısmi tutarı girin, isteği gönderin ve durumunu kontrol edin.
2. Tam iade için WISECP faturasını açın: {admin}/invoices/detail?id={fatura}.
3. Özet → Durumu Değiştir bölümünde İade Edildi ve Gider olarak ekle seçip Durumu Güncelle butonuna tıklayın.
4. WISECP tekrar para göndermeden iadeyi kaydeder. Kısmi iadeyi gerçek tutarıyla ayrıca kaydedin.

Birden fazla faturayı kapatan ödemede, modül her faturanın tahsil edilmiş payı için ayrı API iade yolu kullanır. Aynı durum bölümünde Ödeme altyapısı ile iade seçip Durumu Güncelle butonuna tıklayın. Mağaza bilgileri ve banka işlem referansı gerekir; modül eski referansları sorgulayabilir. WISECP isteği kabul etse de nihai iadeyi SSLCommerz'de kontrol edin.

Dikkat Edilecekler

Gerekli Yetkiler

WISECP ayarları Faturalandırma Ayarları → Ödeme Altyapıları (MODULES_PAYMENT_SETTINGS), fatura değişiklikleri Faturalandırma → Düzenleme (INVOICES_OPERATION) yetkisini gerektirir. SSLCommerz hesabınız mağaza/IPN ayarları ve iade isteklerine erişebilmeli. Bu izinleri üye iş yeri yöneticisinden isteyin.

İlgili Makaleler

• Ödeme Modülleri
• Fatura Detayı Genel Görünüm
• SSLCommerz Entegrasyonu
• SSLCommerz İade Yardımı