Türk Banka Sanal POS Modülleri

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

Akbank

AkbankPayten

İş Bankası

Yapı Kredi

Finansbank

Ziraat

Kuveyt Türk

Ortak Seçenekler

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.

İş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

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
• Fatura Detayına Genel Bakış
• Garanti BBVA Entegrasyonu
• QNB Entegrasyonu