Wix Garanti Sanal POS Bağlantısı Nasıl Yapılır?
- Tarık Tunç

- 3 gün önce
- 6 dakikada okunur
Özet: - Wix yerel banka POS'unu doğrudan bağlamaz, iyzico veya PayTR gibi bir ödeme aracı köprü olur. - Garanti BBVA başvurusu için vergi levhası, imza sirküleri ve SSL sertifikalı bir domain şart. - Merchant ID ve Terminal ID sağlayıcı panelinden alınır, anahtar çifti üretilir. - 3D Secure için başarılı, başarısız ve hata olmak üzere üç HTTPS URL tanımlanır. - Komisyon sabit değildir, oran her zaman banka veya sağlayıcıyla görüşülerek netleşir.
İçindekiler
Wix Garanti sanal POS bağlantısı için iki yol
Garanti BBVA sanal POS başvurusu ve gerekli belgeler
Sanal POS bilgilerini Wix'e tanımlama
3D Secure URL ayarları ve güvenlik katmanı
Wix ödeme ayarlarını etkinleştirme ve test
Sık karşılaşılan hata kodları ve çözümleri
Sık Sorulan Sorular
Türkiye'de bir Wix mağazası açtınız. Ürünler hazır, tasarım oturdu, geriye tek şey kaldı: kart tahsilatı. İşte burada çoğu işletme aynı duvara toslar. Wix'in hazır ödeme listesinde Türk bankaları çıkmaz. Peki Wix Garanti sanal POS bağlantısı gerçekten mümkün mü? Kısa cevap evet. Uzun cevap bu rehberin tamamı.
Aşağıda başvurudan canlı teste kadar bütün süreci sırayla anlatıyoruz. Banka tarafındaki belgeleri, panel ayarlarını, 3D Secure yapılandırmasını ve ödeme reddedildiğinde gördüğünüz hata kodlarını tek tek açıyoruz. Amaç, Wix Garanti sanal POS sürecini deneme yanılmadan, ilk seferde doğru kurmanız.
Wix Garanti sanal POS bağlantısı için iki yol
Önce şu yanlış beklentiyi düzeltelim. Wix, Garanti BBVA'nın sanal POS altyapısına yerel bir entegrasyon sunmaz. Yani banka panelinden aldığınız bilgileri doğrudan Wix'e yapıştıramazsınız. Arada bir köprü gerekir.
Bu köprü, bankayla anlaşmalı bir ödeme aracı kuruluşudur. iyzico, PayTR ve Sipay bu işi yapan yaygın sağlayıcılardır. Hepsi PCI-DSS uyumlu çalışır. İki temel senaryo var.
İlk senaryoda Garanti ile doğrudan anlaşmalı bir ödeme aracı kuruluşu kullanırsınız. Tahsilat Garanti POS'u üzerinden geçer, para banka hesabınıza akar. İkinci senaryoda iyzico gibi bir sağlayıcı tüm kart trafiğini kendi havuzunda toplar. Garanti kartları yine sorunsuz çalışır, ama muhatabınız doğrudan banka değil sağlayıcı olur.
Hangisi sizin için doğru? Cevap işlem hacminize ve komisyon pazarlığına bağlı. Yüksek ciroda doğrudan banka anlaşması genelde daha ucuza gelir. Yeni başlayan bir mağaza içinse sağlayıcı kurulumu çok daha hızlıdır. Wix Garanti sanal POS kurgusunda her iki yol da aynı teknik mantıkla ilerler. Yani aşağıdaki adımlar hangi yolu seçerseniz seçin geçerlidir.
Bir noktayı da baştan netleştirelim. Wix'in kendi ödeme motoru olan Wix Payments, Türkiye'de henüz kart tahsilatı için aktif değildir. Bu yüzden sağlayıcı katmanı bir tercih değil zorunluluktur. Sağlayıcıyı seçerken sadece komisyona değil, hangi taksit programlarını desteklediğine, iade sürecinin ne kadar hızlı olduğuna ve teknik destek kalitesine de bakın. Bu üç başlık, ilk aydan sonra asıl farkı yaratan kalemlerdir. Wix Garanti sanal POS kurarken acele edip en ucuz sağlayıcıya yönelmek, sonradan iade ve mutabakat tarafında zaman kaybettirebilir.
Garanti BBVA sanal POS başvurusu ve gerekli belgeler
Sanal POS, e-ticaret yapan iş yerlerinin ürün ve hizmet satışını çevrim içi tahsil etmesini sağlayan ödeme yöntemidir. Garanti BBVA tarafında Visa, Mastercard, American Express, Diners ve Troy kartları kabul edilir. Taksit programları arasında Bonus, Flexi, Shop&Fly ve Miles&Smiles bulunur. Çoklu para birimi desteği de vardır, yani yurt dışına satışta dolar veya euro tahsil edebilirsiniz.
Başvuruyu internet bankacılığından ya da şubeye giderek yaparsınız. İşletme tipinize göre istenen belgeler değişir.
İşletme tipi — Gerekli belgeler
Şahıs ve ortaklı işletme — Nüfus cüzdanı fotokopisi, vergi levhası, ortaklık sözleşmesi, imza sirküleri
Ticari ortaklık — Vergi levhası, ticaret sicil gazetesi, imza sirküleri
Banka, başvuruyu değerlendirirken sitenizin de hazır olmasını bekler. Üç teknik şart var. SSL sertifikası zorunludur. Satışa sunduğunuz ürünler mağazada görünür olmalıdır. Mesafeli satış sözleşmesi ve ilgili politika sayfaları yayında bulunmalıdır. Bu üç madde eksikse başvuru en başta takılır. Wix Garanti sanal POS yolculuğunun ilk barikatı genelde burasıdır.
Komisyon konusuna gelince, net bir rakam vermek doğru olmaz. Garanti BBVA komisyonu sabit değildir ve Ürün ve Hizmet Ücretleri üzerinden belirlenir. Sağlayıcı tarafındaki oranlar da dönemsel değişir. Kesin tutarı her zaman bankayla veya sağlayıcıyla görüşerek öğrenin. İnternette gördüğünüz örnek oranlar zamanla eskir, sözleşme anındaki güncel oran bağlayıcıdır.
Sanal POS bilgilerini Wix'e tanımlama
Başvuru onaylandığında elinize bir dizi kimlik bilgisi geçer. Wix Garanti sanal POS tanımlamasının kalbi burasıdır. Sırasıyla şunları yaparsınız.
Merchant ID ve Terminal ID bilgilerini sağlayıcı panelinden alın. Bu iki değer, ödemenin hangi iş yerine ve hangi terminale ait olduğunu söyler. Ardından bir anahtar çifti üretirsiniz: bir public key, bir de secret key. Secret key'i kimseyle paylaşmayın, ekran görüntüsünde bile saklayın.
Bu bilgileri ödeme sağlayıcının paneline girersiniz. Sonra Wix yönetim ekranına geçip ödeme ayarlarını etkinleştirirsiniz. Para birimini TRY seçin. Minimum ve maksimum işlem tutarı sınırlarını belirleyin. Bu sınır, hatalı yüksek tutarlı denemeleri baştan eler. Wix Garanti sanal POS tarafında bu küçük ayar, ileride yaşanacak çoğu derdi baştan kapatır.
Küçük bir uyarı. Merchant ve terminal değerlerini elle yazarken tek bir karakter hatası bile ödemeyi reddeder. Kopyala yapıştır kullanın. Wix Garanti sanal POS kurulumunda en sık görülen aksaklık, yanlış girilmiş terminal bilgisidir. Bir boşluk karakteri bile her işlemi düşürür.
3D Secure URL ayarları ve güvenlik katmanı
3D Secure, kart sahibinin fiziksel olarak bulunmadığı çevrim içi işlemlere ek bir güvenlik katmanı ekler. Protokol XML tabanlıdır ve yirmi yıldır sahteciliği önlemek için kullanılır. Visa Secure, Mastercard Identity Check ve EMV 3DS 2.0 bu yapının parçalarıdır. Müşteri ödeme anında bankasından tek kullanımlık bir parola alır ve onu girerek işlemi tamamlar.
Sağlayıcı panelinde üç adres tanımlamanız gerekir.
Başarılı ödeme URL'si: işlem onaylanınca müşterinin yönleneceği sayfa.
Başarısız ödeme URL'si: ödeme reddedilince açılacak sayfa.
Hata URL'si: teknik bir aksaklıkta devreye giren sayfa.
Bu üç adresin tamamı HTTPS ile başlamalı ve geçerli SSL sertifikasına sahip bir domaine ait olmalıdır. Http ile başlayan bir adres kabul edilmez. iyzico tarafında Dynamic 3DS ve akıllı yönlendirme servisi bu süreci yönetir, altyapı PCI-DSS sertifikalıdır. Wix Garanti sanal POS akışında 3D Secure, isteğe bağlı bir süs değil tahsilatın temelidir. Bu katman olmadan kart bilgisi taşıyan hiçbir işlem güvenli sayılmaz.
Wix ödeme ayarlarını etkinleştirme ve test
Bilgiler girildi, URL'ler tanımlandı. Şimdi sıra denemede. Asla doğrudan canlıya geçmeyin.
Önce sandbox ortamında test ödemeleri yapın. Sağlayıcılar bu amaçla ayrı bir test paneli verir. iyzico tarafında sandbox paneli ve docs.iyzico.com belgeleri bu iş içindir. Test kartlarıyla birkaç başarılı, birkaç de bilerek başarısız işlem deneyin. Üç URL'nin de doğru sayfalara yönlendiğini gözünüzle görün.
Test akışı şuna benzer. Sepete ürün ekleyin. Ödeme adımına geçin. Kart bilgisini girin. 3D Secure ekranının açıldığını doğrulayın. Onay sonrası başarılı sayfasına düştüğünüzü kontrol edin. Bir de yetersiz bakiye senaryosunu deneyip başarısız sayfasının çalıştığına bakın.
Her şey yolundaysa canlıya geçersiniz. Canlı ortamda ilk birkaç gün kendi kartınızla küçük tutarlı gerçek bir alışveriş yapın. Para hesaba düştü mü, ekstre kalemi doğru mu, hepsini izleyin. Wix Garanti sanal POS bağlantısı ancak bu kontrol bittiğinde gerçekten tamamlanmış sayılır. Erken sevinip testi atlamak, ilk gerçek siparişte sürpriz bir redle karşılaşmak demektir.
Sık karşılaşılan hata kodları ve çözümleri
Tahsilat reddedildiğinde panik yapmayın. Ekrandaki kod size sorunu net söyler. En çok karşılaşılan dördü şöyle.
Kod — Anlamı — Ne yapmalı
05 — Kart limiti aşıldı ya da banka reddetti — Müşteri bankasıyla görüşür, başka kart denenir
12 — Yanlış terminal ID — Panel ayarındaki terminal bilgisini düzeltin
51 — Müşteri bakiyesi yetersiz — Müşteri tarafı sorunudur, alternatif ödeme önerin
57 — Taksit ayarlanmamış kart tipi — İlgili kart için taksit tanımını açın
Bu kodların çoğu müşteri kaynaklıdır, yani sitenizde bir arıza yoktur. Ama 12 kodu doğrudan sizi ilgilendirir. Terminal bilgisi yanlış girilmişse her işlem bu kodla döner. İlk gördüğünüzde panel ayarlarına dönüp Merchant ve Terminal değerlerini tekrar karşılaştırın.
Bir de şu detay var. 57 kodu, taksit beklediğiniz bir kampanyada işi bozar. Kart tipine taksit tanımlanmadıysa müşteri tek çekim dışına çıkamaz. Bonus ve diğer programların taksit tanımlarını sağlayıcı panelinden açık tuttuğunuzdan emin olun.
Hata kodlarını not alın. İlk haftalarda Wix Garanti sanal POS panelinde hangi kodun ne sıklıkla geldiğini izlemek, gerçek bir sorunu müşteri kaynaklı redden ayırmanızı sağlar. Eğer aynı kod tek bir kartta değil, peş peşe farklı müşterilerde dönüyorsa sorun büyük ihtimalle sizin ayarınızdadır. Tek tük redler ise tahsilatın normal akışıdır, hiçbir sistemde sıfır ret yoktur.
Buraya kadar gelen süreç, ilk bakışta uzun görünse de mantığı basittir. Banka başvurusu, kimlik bilgilerinin tanımı, güvenlik katmanı ve test. Dördünü sırayla yaptığınızda mağazanız kart kabul etmeye hazır olur. Wix Garanti sanal POS bağlantısı, doğru kurulduğunda arka planda sessizce çalışan bir mekanizmadır. Takıldığınız teknik adımlarda, özellikle 3D Secure ve hata kodu tarafında, bir uzmandan destek almak günler kazandırır.
Sık Sorulan Sorular
Wix'e Garanti sanal POS doğrudan bağlanır mı?
Hayır. Wix, Türk bankalarının POS altyapısına yerel entegrasyon sunmaz. iyzico, PayTR veya Sipay gibi bir ödeme aracı kuruluşu köprü görevi görür. Garanti kartları bu sağlayıcı üzerinden tahsil edilir, yani Wix Garanti sanal POS kurgusu hep bir ara katmanla çalışır.
Başvuru için hangi belgeler gerekiyor?
Şahıs işletmesinde nüfus cüzdanı fotokopisi, vergi levhası, ortaklık sözleşmesi ve imza sirküleri istenir. Ticari ortaklıkta vergi levhası, ticaret sicil gazetesi ve imza sirküleri gerekir. Site tarafında SSL sertifikası ve mesafeli satış sözleşmesi zorunludur.
Komisyon oranı ne kadar?
Sabit bir oran yoktur. Garanti BBVA komisyonu Ürün ve Hizmet Ücretleri üzerinden belirlenir, sağlayıcı oranları da dönemsel değişir. Kesin tutarı bankayla veya ödeme sağlayıcısıyla görüşerek öğrenmeniz gerekir.
3D Secure zorunlu mu?
Pratikte evet. Kart sahibinin bulunmadığı çevrim içi işlemlerde güvenlik için kullanılır ve sağlayıcı panelinde üç HTTPS URL tanımlamanızı gerektirir. Wix Garanti sanal POS akışında bu katman olmadan tahsilat güvenli kabul edilmez.
Ödeme neden 12 hatasıyla reddediliyor?
12 kodu yanlış terminal ID anlamına gelir. Sağlayıcı panelindeki terminal bilgisi hatalı ya da eksik girilmiştir. Merchant ve Terminal değerlerini panelden kopyalayıp tekrar karşılaştırarak düzeltin.
Kaynakça
Garanti BBVA, Sanal POS: garantibbva.com.tr/isim-icin/kartlar-pos/sanal-pos
iyzico, Ödeme Çözümleri: iyzico.com
IdeaSoft, iyzico Nedir Nasıl Kullanılır: ideasoft.com.tr/iyzico-nedir-nasil-kullanilir
Vikipedi, 3-D Secure: tr.wikipedia.org/wiki/3-D_Secure
Blakfy, Wix Garanti POS Entegrasyonu Teknik Rehberi



