# SSLCommerz Modülü

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

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 Ağ Geçitleri → 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

- **Store ID**: Zorunlu; varsayılanı boş. Seçilen test veya canlı ortamın mağazasını kullanın.
- **Store Password**: Zorunlu; varsayılanı boş. Bu Store ID için verilen entegrasyon parolasını girin; üye iş yeri panelinin giriş parolası değildir.
- **Test Mode**: Varsayılanı kapalı. Açıkken sandbox, kapalıyken canlı hizmet kullanılır. Ortam değiştirirken kimlik bilgilerini de değiştirin.
- **easyCheckout**: Varsayılanı kapalı. Açıkken popup, kapalıyken sağlayıcının ödeme sayfası seçilir.

**Durum** modülü etkinleştirir. Komisyon, dönüşüm, tutar sınırları ve ülke listeleri [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri) 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ı](https://developer.sslcommerz.com/registration/) 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 Ağ Geçitleri → 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

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 IPN dinleyicisi olarak girip mağazanın bildirim ayarlarını kaydedin.
3. Her ortamda ilgili mağazayı kullanın. Modül ödeme oluştururken bu IPN adresini de gönderir; ayrı webhook imza anahtarı alanı gerekmez.
4. SSLCommerz'in bildirimi ulaştırdığını, WISECP'in doğrulayıp kaydettiğini kontrol edin. Tarayıcının Success URL adresini açması ödemeyi doğrulamaz.

### 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](https://developer.sslcommerz.com/doc/v4/index.html) 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 ödenmiş faturayla karşılaştırın. İptali ve tarayıcı dönüşü kesildikten sonra bildirim teslimini kontrol edin.
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; canlı mağazanın IPN ayarını da doğrulayın.

### Ö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

> **Kaydetmeden Önce Mağaza Parolasını Yeniden Girin**
> 
> Mevcut sürümde form yeniden açıldığında parola alanı Store ID değerinden doldurulabilir. Her ayar kaydından önce gerçek entegrasyon parolasını yeniden girin.

> **Dönüş Sayfası Yerine Ödemeyi Kontrol Edin**
> 
> Başarılı dönüş tek başına faturayı kapatmaz. Doğrulama hatası, farklı tutar veya risk işareti faturayı açık bırakabilir. Yeniden ödeme istemeden sağlayıcıdaki işlemi karşılaştırın.

> **İade İsteği İadenin Tamamlanması Değildir**
> 
> Kabul veya işleniyor yanıtı, para müşteriye ulaşmadan WISECP'i güncelleyebilir. Sonucu SSLCommerz'de izleyin; aynı iadeyi iki sistemden birden göndermeyin.

## Gerekli Yetkiler

WISECP ayarları **Modüller → Ö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](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı Genel Görünüm](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [SSLCommerz Entegrasyonu](https://developer.sslcommerz.com/doc/v4/index.html)
- [SSLCommerz İade Yardımı](https://sslcommerz.com/faq/)