# PayTR Modülü

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

Kredi kartı ödemelerini PayTR sanal POS hesabınız üzerinden alın; taksit, saklı kart ve iade işlemlerini panelden yönetin.

## Ekrana Erişim

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

Ağ geçidini müşterinin gördüğü yöntem listesine eklemeyi [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri) makalesinde bulursunuz.

## Ekranda Neler Var

İki sekme var. **Genel Ayarlar** mağaza bilgilerini, kart girişi tercihini ve ortak ağ geçidi ayarlarını taşır. **Taksit Ayarları** müşterinin ödediği oran tablosunu taşır.

Müşteri sitenizden ayrılmadan öder: ya PayTR ödeme çerçevesinin içinde, ya da kendi kart formunuzda. Kart formu yalnız bu modül **Kart Saklama Modülü** iken ve **Kart Girişi** Direkt API iken kullanılır. PayTR ardından kuruluma bildirim gönderir, fatura ödendi olur ve sipariş etkinleşir.

Modül ayrıca kart saklar, saklı kartı otomatik çeker ve fatura ekranından iade yapar. Abonelik açmaz.

## Ön Koşullar

- Mağaza numarası, anahtarı ve salt değeri olan bir PayTR mağaza hesabı.
- Kart formunu kendi sitenizde açacaksanız hesabınızda Direkt API ve 2D yetkisi.
- Saklı kart, otomatik yenileme ödemeleri ve bu sitedeki kart formu için **Başlangıç Ayarları** içindeki **Kart Saklama Modülü** alanında bu modülün seçili olması.

## Alanlar

### Genel Ayarlar

- **Kart Girişi**: Müşterinin kartı nereye yazacağı. **PayTR ödeme sayfası (iframe)** sağlayıcı çerçevesini sayfanızın içinde açar. **Kart formu bu sitede (Direkt API)** kendi formunuzu kullanır, ama yalnız bu modül **Kart Saklama Modülü** iken; değilse müşteri çerçeveyi görmeye devam eder. Varsayılan seçenek çerçevedir.
- **Merchant ID**: PayTR mağaza ayarları sayfasındaki mağaza numarası. Zorunlu.
- **Merchant Key**: Aynı sayfadaki mağaza anahtarı. Giden her isteği ve gelen her sonucu imzalar. Zorunlu.
- **Merchant Salt**: Aynı sayfadaki salt değeri; aynı imzada kullanılır. Zorunlu.
- **Taksit Seçenekleri**: Müşterilere taksit sunar. Varsayılan olarak açık.
- **Maksimum Taksit Sayısı**: Müşterinin seçebileceği en yüksek taksit sayısı, 1 ile 12 arasında. Üstteki seçenek işaretliyken görünür.
- **Test Modu**: Modülü PayTR test ortamında çalıştırır. Varsayılan olarak kapalı.
- **Hata Ayıklama Modu**: Bu seçeneğin mevcut sürümde bir etkisi yoktur. PayTR'ye gerçekten giden hata ayıklama bayrağı ayrı bir ayardır ve panelden değiştirilemez; bu kutuyu işaretlemek hiçbir şeyi değiştirmez.

**Durum**, **Komisyon Oranı (%)**, **Para Birimi Dönüştürme**, **Kabul Edilen Tutar Aralığı** ve ülke listeleri her ağ geçidinde aynı çalışır. [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri) makalesine bakın. **Callback URL**, **Success URL** ve **Failed URL** alanlarını değiştiremezsiniz: alanın sonundaki ikonla kopyalayın.

### Taksit Ayarları

Her kart ailesi için bir sütun, ikiden on ikiye kadar her taksit sayısı için bir satır taşıyan oran tablosu. Her kutuda o plan için toplama eklenecek yüzde durur.

Tablo yalnız bu sitedeki kart formuyla okunur. Ödeme çerçevesinde PayTR, mağaza panelinizde tanımlı oranları uygular; PayTR'ye yalnız **Taksit Seçenekleri** ve **Maksimum Taksit Sayısı** gider.

- Boş kutu, o kart ailesi için o planı kapatır.
- `0` yazılı kutu planı vade farksız sunar.
- Tablonun üstündeki yenileme butonu güncel oranları PayTR'den çeker.

## İşlemler

### Mağaza bilgilerini girme

1. PayTR mağaza panelinizde **Destek & Kurulum** bölümünü açın ve **Bilgi** sayfasına gidin. Bu sayfayı ana kullanıcı ile teknik kullanıcı görebilir.
2. Modül kartını açın ve **Durum** kutusunu işaretleyin. Bunu yapmadan diğer alanlar kilitli kalır.
3. **Genel Ayarlar** sekmesinde **Mağaza No** değerini **Merchant ID**, **Mağaza Parola** değerini **Merchant Key**, **Mağaza Gizli Anahtar** değerini **Merchant Salt** alanına kopyalayın. Sonra yetkiniz olan **Kart Girişi** seçeneğini belirleyin.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Bu yöntemi seçen müşteriler artık kart adımına ulaşır.

### Bildirim adresini PayTR'ye kaydetme

1. Modül kartındaki **Callback URL** değerini kopyalayın.
2. PayTR mağaza panelinde **Destek & Kurulum** altındaki **Ayarlar** sayfasını açın ve **Bildirim URL Ayarı** bölümünü bulun.
3. **Değiştir** butonuna tıklayın, kopyaladığınız adresi yazın ve kaydedin. Sitenizde SSL sertifikası varsa HTTPS biçimini seçin.
4. Ödemeler artık faturasını kendiliğinden kapatır. Yanlış anahtarla imzalanan sonuç kabul görmez; anahtarı değiştirdiğinizde adresi de gözden geçirin.

### Taksit planlarını ayarlama

1. **Taksit Seçenekleri** kutusunu işaretleyin ve **Maksimum Taksit Sayısı** değerini seçin. Ödeme çerçevesinde PayTR'nin ihtiyacı bundan ibarettir.
2. Kart formu bu sitedeyse **Taksit Ayarları** sekmesini açın; güncel oranları çekmek için yenileme butonuna tıklayın ya da oranları kendiniz yazın.
3. Sunmak istemediğiniz planların kutularını boşaltın ve kaydedin.
4. Kart formunuzu kullanan müşteriler artık kartlarına açık planları görür; seçtikleri plan vade farkını faturaya ekler.

### Müşterinin izlediği yol

1. Müşteri bu yöntemi sepette, bir faturada ya da bakiye yüklerken seçer.
2. Kartını yazar ya da daha önce sakladığı kartı seçer; plan sunulduğunda taksit sayısını belirler.
3. Banka doğrulama adımı açılır, ardından müşteri sitenize döner.
4. Gelen sonuç faturayı kapatır ve hizmet etkinleşir.

### Ödemeyi iade etme

1. Ödenmiş faturayı açın: `{admin}/invoices/detail?id={fatura}`
2. Fatura durumunu **İade Edildi** yapın, iade yöntemi olarak **Ödeme altyapısı ile iade** seçin ve onaylayın.
3. Modül iadeyi o fatura için PayTR'ye gönderir. PayTR talebi kabul etmezse fatura durumu korunur ve sebep ekranda görünür.

## Dikkat Edilecekler

> **Direkt API önce yetki ister**
> 
> PayTR mağazanızda Direkt API ve 2D yetkisi yokken kart formunu bu sitede açarsanız ödemeler her seferinde başarısız olur. Yetkiyi PayTR panelinizdeki **Destek & Kurulum** altındaki **Destek** sayfasından talep edin. Bunlar iki ayrı yetkidir ve PayTR her birini kendi incelemesinden sonra tanımlar. Onay gelene kadar ödeme çerçevesinde kalın.

> **Boş oran kutusu kapalı plan demektir**
> 
> Boş kutu planın sunulmadığını, `0` ise vade farksız sunulduğunu gösterir. Bir kart ailesinin sütununu tamamen boşaltırsanız o kartlarda taksit kalkar, tek çekim sürer.

> **Test Modu mağaza bilgilerini değiştirmez**
> 
> Modül girdiğiniz mağaza değerlerini kullanmayı sürdürür, yalnız test ortamına sorar. Gerçek ödeme almadan önce işareti kaldırın ve ilk canlı ödemeyi PayTR hesabınızdan doğrulayın.

> **Kart kaydı iade edilen bir çekimle başlar**
> 
> Kart eklerken PayTR üzerinden 1 birimlik doğrulama çekimi yapılır. Sonuç geldiğinde modül bu çekimin iadesini birkaç dakika sonrası için kuyruğa alır. İade ancak cron çalışırken gerçekleşir. Müşteri ekstresinde ikisini de görür; kart saklamayı önerdiğiniz yerde bundan söz edin.

> **PayTR kendi adıyla görünmeyebilir**
> 
> PayTR **Kart Saklama Modülü** iken ve **Kart Girişi** Direkt API iken kendi satırı yerine tek bir **Kredi veya Banka Kartı** satırını doldurur. PayTR ödeme çerçevesi seçiliyken ağ geçidi kendi adıyla listelenir.

## Gerekli Yetkiler

**Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) yetkisi gerekir.

## İlgili Makaleler

- [Ödeme Modülleri](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)