# Türk Banka Sanal POS

https://docs.wisecp.com/tr/turk-banka-sanal-pos-modulleri

Türk banka sanal POS modüllerini kurun; hesap, taksit, test ve iade koşullarını kontrol edin.

## Ekrana Ulaşım

**Ayarlar → Finansal → Ödeme Ağ Geçitleri → Tüm Modüller** yolunu açıp bankanızı seçin. `{admin}/modules/payment?module=Garanti`

## Ekranda Neler Var

Her bankanın ayrı formu vardır. Akbank ve AkbankPayten farklı hesap bilgileri kullanır. Kart saklama, otomatik ödeme ve abonelik desteği yoktur.

## Kurulumdan Önce

Bankadan sanal POS sözleşmesi, üye işyeri onayı, API kullanıcısı ve 3D erişimi alın. Ayrı test bilgileri isteyin; modülün protokol ve adreslerini doğrulatın. Kayıtlı değerler kullanılabilir test kimliği sayılmaz.

## Alanlar

Bankaya özgü alan etiketleri iki panel dilinde de Türkçedir. İsteğe bağlı belirtilmedikçe bankanın verdiği değerleri girin; hazır kullanılabilir hesap bilgisi yoktur.

### Garanti

- **Sanal Pos Tipi (3D Security Level)**: Bankanın onayladığı 3D_FULL, 3D_PAY veya 3D_HALF değerini seçin; başlangıçta boş.
- **Mağaza Numarası (Merchant ID)**: Üye işyeri numarası.
- **Provizyon Şifresi**: Provizyon kullanıcısının şifresi.
- **Store Key**: 3D doğrulama anahtarı.
- **Terminal ID**: Terminal numarası.

### Akbank

- **Pos Tipi**: Varsayılan 3D PAY; diğer seçenekler 3D MODEL ve PAY HOSTING.
- **Güvenli Üye İş Yeri numarası**: Yönetim → Üye İş Yeri İşlemleri → Üye İş Yeri Bilgileri.
- **Güvenli Terminal Numarası**: Yönetim → Terminal İşlemleri → Terminal Safe ID.
- **Secret Key**: Yönetim → Güvenlik Anahtarları.

### AkbankPayten

- **Pos Tipi**: 3D PAY HOSTING veya 3D PAY seçin; başlangıçta boş.
- **Mağaza Numarası**: Payten mağaza numarası.
- **Kullanıcı Adı**: API kullanıcısı.
- **Parola**: API kullanıcısının parolası.
- **Store Key**: 3D mağaza anahtarı.

### İş Bankası

- **Pos Tipi**: 3D PAY HOSTING, 3D PAY veya 3D MODEL seçin.
- **Mağaza Numarası**: Mağaza numarası.
- **Kullanıcı Adı**: API kullanıcısı.
- **Parola**: API kullanıcısının parolası.
- **Store Key**: 3D mağaza anahtarı.

### Yapı Kredi

- **Store Key (ENC Key)**: POSNET ENC anahtarı.
- **POSTNET ID**: Bankanın verdiği POSNET kimliği.
- **Üye İşyeri No**: Üye işyeri numarası.
- **Terminal No**: Terminal numarası.
- **Kullanıcı Adı**: İsteğe bağlı; mevcut ödeme akışında kullanılmaz.
- **Parola**: İsteğe bağlı; mevcut ödeme akışında kullanılmaz.

### Finansbank

- **Üye İşyeri Numarası (MerchantID)**: QNB üye işyeri numarası.
- **Terminal Numarası (TerminalID)**: Terminal numarası.
- **Kullanıcı Adı (User Code)**: API kullanıcı kodu.
- **Kullanıcı Şifre (User Password)**: API kullanıcısının şifresi.
- **3D üye İşyeri Anahtarı (MerchantPass)**: 3D üye işyeri anahtarı; kullanıcı şifresinden farklıdır.

### Ziraat

- **POX Request URL**: Zorunlu HTTPS provizyon adresi; yalnız banka alan adı.
- **3D Secure Enrollment URL**: Zorunlu HTTPS kayıt adresi; yalnız banka alan adı.
- **Merchant ID (Üye İşyeri Numarası)**: Üye işyeri numarası.
- **Merchant Password (Üye İşyeri Şifresi)**: Üye işyeri şifresi.

### Kuveyt Türk

- **Mağaza Numarası**: Mağaza numarası.
- **Müşteri Numarası**: Müşteri numarası.
- **API Kullanıcı Adı**: API kullanıcısı.
- **API Parola**: API parolası.

### Ortak Seçenekler

- **Taksit Seçeneği**: Başlangıçta kapalı; Kuveyt Türk dışındaki bankalarda bulunur.
- **Taksit Komisyonu**: Başlangıçta boş. Her satıra adet : yüzde girin; örneğin 2 : 2.50.
- **Taksit Sınırı**: Varsayılan 12; bankanın onayladığı adetlerle sınırlayın. Garanti ayrıca kartın bankasını kontrol eder.
- **Test Modu**: Başlangıç değeri kapalı. Ziraat’te anahtar yok; QNB’de adresi değiştirmez. Kayıtlı ayarları kontrol edin.

Ziraat başlangıç adresleri: `https://sanalpos.ziraatbank.com.tr/v4/v3/Vposreq.aspx`; `https://mpi.ziraatbank.com.tr/Enrollment.aspx`. Yalnız ziraatbank.com.tr altında HTTPS adresleri kabul edilir.

Durum, komisyon ve tutar/ülke sınırları için [Ödeme Modülleri](https://docs.wisecp.com/tr/odeme-modulleri).

## İşlemler

### Bankayı Bağlayıp Etkinleştirin

1. Yukarıdaki bilgileri bankanın üye işyeri panelinden alın. Garanti için uygun provizyon kullanıcısını ve 3D Store Key değerini isteyin.
2. Uygun POS tipini seçip hesap bilgilerini girin. **Durum** seçeneğini açın ve **Ayarları Kaydet** butonuna tıklayın.
3. **Ödeme Ağ Geçitleri → Başlangıç → Etkin Modül Seçimi** bölümünde bankayı seçip **Ayarları Kaydet** butonuna tıklayın.
4. Bankanın desteklediği para biriminde fatura kullanın. Ortak dönüşüm her modülde uygulanmaz; Yapı Kredi dönüş akışı TRY kullanır.

### Ödemeyi ve Dönüşü Sınayın

1. Banka onaylı test bilgilerini kullanın. Kart göndermeden önce QNB’nin test düzenini ve Ziraat’in iki test adresini bankayla doğrulayın.
2. Faturanın müşterisi olarak bankayı seçip **Şimdi Öde** butonuna tıklayın. Başarılı, reddedilen ve iptal edilen 3D ödemeleri sınayın.
3. Dönüş boyunca aynı tarayıcı oturumunu koruyun. Banka onayını, referansı, tutarı ve taksitleri fatura ödemesiyle karşılaştırın.
4. Eksik veya belirsiz sonucu tekrar denemeden önce bankayla çözün. Kabul sonrası canlı hesap bilgilerini ve doğru ortam ayarını kaydedin.

### Ödemeyi İade Edin

Yalnız AkbankPayten, İş Bankası ve Finansbank fatura üzerinden ağ geçidi iadesi sunar. Diğerlerinde bankadan iade yapın.

Şurayı açın: `{admin}/invoices/detail?id={fatura}`. **Özet → Durumu Değiştir** bölümünde **İade Edildi** ve **Ödeme altyapısı ile iade** seçip **Durumu Güncelle** butonuna tıklayın.

İstek faturanın kayıtlı ödeme payını kullanır. Banka sonucunu doğrulayın. Dışarıda yapılan veya özel kısmi iadeyi kaydederken ikinci kez ağ geçidi iadesi istemeyin.

## Dikkat Edilecekler

> **Uyumluluğu Doğrulayın**
> 
> Garanti ve Kuveyt Türk eski adres/protokol seçimleri içerir. QNB’de Test Modu ayrı ortam adresi seçmez. Canlı ödemeyi açmadan önce uyumluluğu doğrulatın.

3D dönüş adresleri otomatik üretilir. Ayrı webhook alanı yoktur. Bazı dönüşler tarayıcı oturumuna bağlıdır; sayfaya dönmek tek başına ödeme kanıtı değildir.

## Gerekli Yetkiler

Ayarlar: **Modüller → Ödeme Altyapıları** (`MODULES_PAYMENT_SETTINGS`). İadeler: **Faturalandırma → Düzenleme** (`INVOICES_OPERATION`).

## İ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)
- [Garanti BBVA Entegrasyonu](https://dev.garantibbva.com.tr/sanalpos-satis-on-otorizasyon-3dli)
- [QNB Entegrasyonu](https://vpos.qnb.com.tr/Help/apiIntegrationDocument)