# 2Checkout Modülü

https://docs.wisecp.com/tr/2checkout-modulu

Müşteriyi 2Checkout ödeme sayfasına yönlendirerek tahsilat alın ve ödeme bildirimini faturayla eşleştirin.

## Ekrana Erişim

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

Müşterinin göreceği yöntem listesini [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) ekranından düzenleyin.

## Ekranda Neler Var

Kartta 2Checkout hesap bilgileri, test seçeneği ve ortak ağ geçidi ayarları bulunur.

Müşteri sipariş ve fatura bilgileriyle 2Checkout ödeme sayfasına yönlendirilir. Kart bilgilerini orada girer. Ödeme bildirimi WISECP'ye geldiğinde ilgili fatura işlenir.

Bu modülde kart saklama, abonelik, taksit ve otomatik iade yoktur. İadeyi 2Checkout hesabınızdan yaparsınız.

## Ön Koşullar

- Satıcı kodunu bildiğiniz bir 2Checkout hesabı.
- Hesabınızın kabul ettiği bir tahsilat para birimi.
- 2Checkout bildirimlerinin HTTPS üzerinden ulaşabildiği bir kurulum.

## Alanlar

- **Merchant Code**: Zorunlu. Ödemenin alınacağı satıcı hesabının kodu.
- **Secret Key**: Zorunlu. Gelen bildirimin imzasını doğrulayan gizli anahtar. Yanlış imza taşıyan bildirim kabul edilmez.
- **Secret Word**: Zorunlu. Aynı imza kontrolünde kullanılan gizli sözcük.
- **Publishable Key**: Bu sürüm ödeme sayfasında ve bildirimde bu değeri kullanmaz. Boş bırakabilirsiniz.
- **Private Key**: Bu sürüm bu değeri kullanmaz. Boş bırakabilirsiniz.
- **Test Mode**: Ödeme sayfasını gerçek tahsilat yapmayan demo siparişiyle açar. İşaretsiz gelir.

**Durum**, komisyon, para birimi dönüştürme, tutar aralığı ve ülke listeleri için [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) makalesine bakın. **Callback URL**, **Success URL** ve **Failed URL** değiştirilemez; alan sonundaki kopyalama simgesini kullanın.

## İşlemler

### 2Checkout hesap bilgilerini alma

1. 2Checkout hesabınızda **Integrations → Webhooks & API** sayfasını açın.
2. API bölümündeki gizli anahtarı ve INS bölümündeki gizli sözcüğü kopyalayın.
3. Aynı alandaki satıcı kodunu da alın. WISECP'ye gireceğiniz üç değer hazırdır.

### Hesap bilgilerini kaydetme

1. 2Checkout modül kartını açın ve **Durum** kutusunu işaretleyin. Kapalıyken diğer alanlar kilitlidir.
2. **Merchant Code**, **Secret Key** ve **Secret Word** alanlarını doldurun.
3. Deneme için **Test Mode** kutusunu işaretleyin; gerçek tahsilata geçmeden önce işareti kaldırın.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Ödeme yönteminin ayarları kaydedilir.

### Bildirim adresini kaydetme

1. Modül kartındaki **Callback URL** değerini alan sonundaki simgeyle kopyalayın.
2. **Integrations → Webhooks & API → INS Settings → Add endpoint** yolunu açın. Adresi yapıştırın, **SHA256** seçin ve **Save endpoint** butonuna tıklayın.
3. `INVOICE_STATUS_CHANGED` olayını düzenleyin. **Parameters** bölümünde `md5_hash` yerine `hash` seçin ve **Save trigger** butonuna tıklayın.
4. Test ödemesinde sağlayıcı işlem kaydını ve WISECP faturasını karşılaştırın. Modül imzalı `approved` ve `deposited` bildirimlerini kabul eder.

### Müşterinin ödeme akışı

1. Müşteri siparişte, faturada veya bakiye yüklerken bu yöntemi seçer.
2. Kısa bekleme ekranından sonra 2Checkout ödeme sayfasına gider.
3. Ödemeyi orada tamamlar ve sitenize döner.
4. Ödeme bildirimi faturayı kapatır. Bildirim müşterinin dönüşünden sonra gelebilir; fatura durumunu kontrol edin.

### Ödemeyi iade etme

1. İadeyi 2Checkout hesabınızdan yapın. Modül sağlayıcıya iade isteği göndermez.
2. Ödenmiş faturayı açın: `{admin}/invoices/detail?id={invoice}`
3. **Ö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. WISECP iade durumunu kaydeder; bu işlem ikinci kez para göndermez.

## Dikkat Edilecekler

> **Ödeme bildirimini doğrulayın**
> 
> Yanlış gizli anahtar, gizli sözcük veya ulaşılamayan bildirim adresi faturanın açık kalmasına yol açabilir. Yöntemi müşterilere sunmadan önce test ödemesiyle fatura durumunu birlikte kontrol edin.

> **Dönüş sayfası başarısızlık gösterebilir**
> 
> Bu sürümde müşteri ödemeden sonra başarısız ödeme sayfasına dönebilir. Yeniden ödeme istemeden önce 2Checkout işlem kaydıyla WISECP faturasını karşılaştırın.

> **Kart saklama ve abonelik yoktur**
> 
> Kayıtlı karttan otomatik yenileme için **Kart Saklama Modülü** alanında başka bir sağlayıcı seçin. 2Checkout iadelerini sağlayıcı hesabınızdan yönetin.

## Gerekli Yetkiler

Ayarlar için **Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) gerekir. Fatura değişiklikleri için **Faturalandırma → Düzenleme** (`INVOICES_OPERATION`) gerekir.

## İlgili Makaleler

- [Ödeme Ağ Geçitleri](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)