top of page
Blakfy logosu: dijital pazarlama ajansı

Wix VakıfBank Sanal POS ile 3D Secure Entegrasyonu Nasıl Yapılır?


Özet: - Wix, Türkiye'de kartlı ödemeyi doğrudan değil bir ödeme geçidi üzerinden alır. - Wix VakıfBank sanal POS akışında 3D Secure, geçit katmanında yapılandırılır. - Sanal POS tanımı için VakıfBank üye işyeri no, terminal no ve secret key gerekir. - Callback URL'in iki panelde tutarlı olması, kurulumun en kritik adımıdır. - HTTPS zorunludur; banka komisyonu sabit değildir, şubeyle görüşülmelidir.


İçindekiler


  • Wix Türkiye'de Kartlı Ödemeyi Nasıl Alır

  • VakıfBank Sanal POS Başvurusu ve Banka Tarafı

  • Sanal POS Bilgilerini Ödeme Geçidine Tanımlama

  • 3D Secure ve Callback URL Ayarı

  • Wix Ödeme Panelinde Geçidi Bağlama

  • Test Ortamı ve Canlıya Geçiş

  • Sık Karşılaşılan Hatalar ve Çözümleri


Wix ile kurduğunuz mağazada kredi kartı tahsilatı yapmak istediğinizde ilk sorulan soru şu olur: VakıfBank sanal POS'u doğrudan bağlayabilir miyim? Kısa cevap, hayır. Wix, kart verisini kendi altyapısında tutmaz. Ödeme, bir aracı katman üzerinden ilerler. Bu yazıda Wix VakıfBank sanal POS kurulumunu, başvurudan canlı teste kadar adım adım anlatıyoruz.


Rehberi sırayla okursanız, Wix VakıfBank sanal POS kurulumunun aslında bir tarif gibi olduğunu göreceksiniz. Malzemeler bellidir, adımlar bellidir. Atlanan tek bir adım yemeği bozar. O yüzden başlıkları sırayla takip edin.


Konu teknik görünüyor. Aslında akış nettir. Üç taraf var: banka, ödeme geçidi ve siteniz. Her biri zincirin bir halkasıdır. Halkalardan biri yanlış tanımlanırsa ödeme yarıda kalır. O yüzden sırayı bozmadan ilerlemek gerekir.


Wix VakıfBank sanal POS kurulumunu doğru kurguladığınızda, müşteriniz hiçbir teknik ayrıntıyı fark etmez. Kartını girer, banka onayını alır, sipariş tamamlanır. Görünmeyen tarafsa bu rehberin konusu. Aşağıdaki her başlık, zincirin bir halkasını tek tek açıyor.


Wix Türkiye'de Kartlı Ödemeyi Nasıl Alır


Wix, panelindeki "Accept Payments" bölümünden bir ödeme sağlayıcısı bağlamanıza izin verir. Platform, bağlanabilen 100'den fazla sağlayıcı sunduğunu belirtir ve bu liste işletmenizin konumuna göre değişir (support.wix.com). Türkiye'de bu sağlayıcılar genellikle yerel ödeme geçitleridir.


Burada kritik nokta şudur: 3D Secure yapılandırması VakıfBank ile doğrudan değil, ödeme geçidi katmanında gerçekleştirilir. iyzico, PayTR ya da Sipay gibi geçitler bankayla konuşur, doğrulama akışını otomatik yönetir. Yani Wix VakıfBank sanal POS bağlantısında bankayla siteniz arasında bir tercüman bulunur.


Bu tasarımın bir nedeni var. Kart verisi hiçbir zaman Wix altyapısından geçmez. Hassas bilgi, şifreli biçimde geçit ile VakıfBank arasında taşınır. Böylece PCI-DSS yükü sizin tarafınızdan geçide kayar. Mağaza sahibi için bu büyük bir kolaylıktır.


Bu mimariyi anlamak, Wix VakıfBank sanal POS kurulumunda yapılan hataların yarısını baştan önler. Çünkü çoğu kullanıcı sorunu Wix'te arar, oysa ayarların büyük bölümü geçit panelindedir. Wix sadece görünen yüzdür. Asıl ayar, banka ile geçit arasında kurulur.


VakıfBank Sanal POS Başvurusu ve Banka Tarafı


Her şey banka tarafındaki bir anlaşmayla başlar. VakıfBank, Türkiye'nin büyük kamu sermayeli bankalarından biridir ve ticari müşterilerine kart tahsilat çözümleri sunar (tr.wikipedia.org). Sanal POS almak için önce bir ticari hesabınızın ve üye işyeri sözleşmenizin olması gerekir.


Başvuruyu şube ya da ticari müşteri temsilciniz üzerinden yaparsınız. Banka, işletmenizin sektörünü, tahmini cirosunu ve web sitenizi değerlendirir. Onay sonrası size sanal POS tanım bilgileri verilir. Bu bilgiler kurulumun anahtarıdır.


Komisyon oranları konusunda net bir rakam vermek doğru olmaz. Oranlar bankaya, ciroya, taksit sayısına ve sözleşme koşullarına göre değişir. Sabit bir yüzde yoktur. Gerçek maliyeti öğrenmenin tek yolu, doğrudan VakıfBank şubesiyle ya da ticari temsilcinizle görüşmektir.


Başvuru sırasında alan adınızın hazır olması işinizi hızlandırır. Banka, sanal POS'u belirli bir alan adına bağlar. Wix sitenizin kendi alan adıyla yayında olması ve SSL sertifikasının aktif olması beklenir. Test ortamı çoğu zaman bu aşamada açılır.


Banka tarafı tamamlanmadan Wix VakıfBank sanal POS bağlantısına girişmek zaman kaybıdır. Önce sözleşme, sonra tanım bilgileri, en sonda site ayarı. Bu sırayı atlayanlar genellikle yarım kalan bir kurulumla kalır. Sabırlı olun, banka onayını bekleyin, ardından teknik adıma geçin.


Sanal POS Bilgilerini Ödeme Geçidine Tanımlama


Banka onayından sonra elinize bir dizi kimlik bilgisi geçer. Wix VakıfBank sanal POS kurulumunun teknik kalbi burasıdır. Sağlayıcı dokümantasyonlarına göre genellikle şu alanlar istenir:


  • Alan — Açıklama

  • Üye İşyeri No (Merchant ID) — VakıfBank tarafından verilen işyeri kimliği

  • Terminal No — Banka panelinde oluşturulan terminal numarası

  • Secret Key — Bankanın sistemi üzerinden üretilen gizli anahtar

  • Sanal POS Kullanıcı Adı — Sanal POS işlemleri için kullanıcı adı

  • Sanal POS Şifresi — Aynı kullanıcının şifresi


Bu bilgiler doğrudan Wix'e değil, kullandığınız ödeme geçidinin paneline girilir (destek.softtr.com). Geçit, VakıfBank sanal POS'unu API ve XML altyapısıyla çağırır ve PCI-DSS uyumlu bir köprü kurar (acenteyazilim.com). Siz yalnızca alanları doğru eşlemekle yükümlüsünüz.


Bu alanları bir kez doğru girdiğinizde, Wix VakıfBank sanal POS bağlantısının teknik tarafı büyük ölçüde biter. Geri kalan adımlar daha çok kontrol ve doğrulamadır. Bilgileri güvenli bir yerde saklayın, çünkü secret key'i kaybederseniz bankadan yenisini talep etmeniz gerekir.


Bir uyarı: bu beş alandan biri bile hatalı girilirse banka isteği reddeder. Özellikle terminal no ile secret key'i karıştırmak yaygın bir hatadır. Bilgileri kopyalarken baştaki ya da sondaki boşluklara dikkat edin. Tek bir görünmez karakter, tüm akışı durdurabilir.


Bilgileri girdikten sonra geçit panelinde bir bağlantı testi çalıştırın. Çoğu geçit, Wix VakıfBank sanal POS tanımını canlıya almadan önce bir doğrulama düğmesi sunar. Test başarılıysa bankayla el sıkışma tamamlanmış demektir. Başarısızsa, hatanın bu beş alandan birinde olduğunu bilirsiniz ve aramayı orada yaparsınız.


3D Secure ve Callback URL Ayarı


Şimdi en kritik adıma geldik. 3D Secure, çevrimiçi kart ödemelerinde kimlik doğrulama katmanı ekleyen bir protokoldür. Kart sahibi ödeme sırasında bankasına yönlendirilir, SMS ya da uygulama onayı verir, sonra mağazaya geri döner. VakıfBank bu akışı EMV 3DS, yani 3DS 2.0 standardıyla risk tabanlı olarak yürütür.


3-D Secure, internet kart işlemleri için geliştirilmiş XML tabanlı bir güvenlik protokolüdür ve ilk olarak Visa'nın "Verified by Visa" uygulamasıyla yayıldı (tr.wikipedia.org). 2.0 sürümü, EMVCo tarafından 2016'da duyuruldu ve frictionless doğrulama ile risk tabanlı onay verisini ekledi. Pratikte bu, düşük riskli işlemlerde müşterinin daha az adımla ödeme tamamlaması demektir.


Buradaki teknik düğüm callback URL'dir. Bu adres, banka doğrulaması bittikten sonra müşterinin geri döneceği yerdir. Callback URL hem geçit panelinde hem de VakıfBank üye işyeri ayarlarında birebir aynı tanımlanmalıdır. Tek harf farkı bile siparişi havada bırakır.


Bir nokta daha var. Tüm bu akış yalnızca HTTPS üzerinden çalışır. Banka, HTTP üzerinden gelen istekleri reddeder. Wix sitenizde özel alan adı kullanıyorsanız SSL sertifikasının aktif olduğundan emin olun. Sertifika pasifse 3D Secure penceresi hiç açılmaz.


Wix VakıfBank sanal POS akışında 3D Secure, müşterinin güvenini de kazandırır. Banka ekranı tanıdık gelir, SMS kodu beklenen yerden gelir. Bu tanışıklık, sepeti terk oranını düşürür. Yani 3D Secure yalnızca bir zorunluluk değil, aynı zamanda dönüşümü destekleyen bir unsurdur.


Wix Ödeme Panelinde Geçidi Bağlama


Banka ve geçit tarafı hazırsa sıra Wix'e gelir. Site panelinizde "Accept Payments" bölümüne girin. İşletme konumunuzun Türkiye olarak göründüğünü doğrulayın. Listeden, VakıfBank sanal POS'unuzu tanımladığınız ödeme geçidini seçin ve "Connect" deyin.


Bu aşama, Wix VakıfBank sanal POS zincirinin son halkasıdır. Önceki adımlarda banka ve geçit konuşmaya başlamıştı; şimdi siteniz de o konuşmaya katılır. Bağlantıyı kurarken aynı tarayıcıda geçit hesabınıza giriş yapmış olmanız işi kolaylaştırır.


Bağlantı ekranında geçit hesabınızın kimlik bilgilerini istersiniz. Burada girdiğiniz bilgiler, az önce sanal POS alanlarını tanımladığınız geçit hesabına aittir. Wix ile geçit arasındaki bu eşleşme tamamlandığında ödeme yöntemi mağazanızda görünür hale gelir.


Yayına almadan önce ödeme yöntemini sepet ve ödeme sayfasında kontrol edin. Kart formu görünüyor mu? Para birimi doğru mu? Wix VakıfBank sanal POS akışında para biriminin TL olması ve geçit hesabınızla uyumlu olması gerekir. Uyumsuz para birimi, işlemin reddine yol açar.


Mağazanızda birden fazla ödeme yöntemi sunuyorsanız sıralamaya da bakın. Müşteriye kafa karıştırmayan, sade bir ödeme ekranı sunmak dönüşümü artırır. Kartla ödeme seçeneğini görünür bir yere koyun. Geçidiniz üzerinden gelen Wix VakıfBank sanal POS akışı, müşteriye tek tıkla erişilebilir olmalıdır.


Test Ortamı ve Canlıya Geçiş


Hiçbir kurulum testsiz canlıya alınmaz. VakıfBank ve geçidiniz size test kartları sağlar. Bu kartlarla hem başarılı hem de başarısız 3D Secure senaryolarını deneyin. Amaç, akışın her iki uçta da doğru davrandığını görmektir.


Testte üç şeye bakın. Birincisi, sipariş durumu Wix'e doğru düşüyor mu? İkincisi, müşteri tarayıcısı banka sayfasından mağazaya sorunsuz dönüyor mu? Üçüncüsü, başarısız işlemde sipariş gerçekten iptal oluyor mu? Üçü de yeşilse canlıya geçebilirsiniz.


Canlıya geçerken en sık unutulan şey, test anahtarlarını canlı anahtarlarla değiştirmektir. Geçit hesabınızda ortam ayarını "production" yapın ve VakıfBank canlı bilgilerini girin. Bu adımı atlarsanız tüm ödemeler reddedilir, çünkü banka canlı ortamda test anahtarını tanımaz.


Canlıya aldıktan sonra ilk gerçek siparişi kendiniz vermenizi öneririz. Küçük tutarlı bir deneme, Wix VakıfBank sanal POS akışının uçtan uca çalıştığını kanıtlar. Kartınızla ödeyin, 3D Secure ekranını geçin, siparişin panele düştüğünü görün. Sonra dilerseniz bu denemeyi iade edersiniz. Böylece müşteriniz değil, siz ilk hatayı yakalarsınız.


Sık Karşılaşılan Hatalar ve Çözümleri


İlk klasik sorun, siparişin "pending" yani beklemede kalmasıdır. Nedeni neredeyse her zaman yanlış callback URL'dir. İki paneldeki adresi karakter karakter karşılaştırın. Çoğu zaman sorun, sondaki bir eğik çizgi ya da http/https farkıdır.


İkinci sorun, SMS doğrulamasının gelmemesidir. Bunun kaynağı banka tarafındadır. Kart sahibinin VakıfBank kayıtlarındaki telefon numarası güncel değilse OTP iletilemez. Bu durumda çözüm sitede değil, müşterinin bankasındadır.


Üçüncü ve en sinir bozucu sorun, tüm doğrulamaların reddedilmesidir. Genellikle suçlu, canlı ortamda hâlâ duran test API anahtarıdır. Anahtarları kontrol edin. Bir de alan adı eşleşmesine bakın, çünkü banka sanal POS'u yetkisiz alan adından gelen isteği geçirmez.


Son olarak, 3D Secure penceresinin hiç açılmaması SSL ile ilgilidir. Sertifika süresi dolmuş ya da alan adı doğrulaması eksik olabilir. Wix tarafında alan adınızın SSL durumunu kontrol edin. Sertifika aktifse pencere açılır, değilse akış daha başlamadan kırılır.


Bu dört sorunun ortak özelliği şudur: hiçbiri Wix'in çekirdek hatası değildir. Wix VakıfBank sanal POS kurulumunda arıza neredeyse her zaman bir ayar uyuşmazlığıdır. Callback, anahtar, telefon ya da sertifika. Doğru yerden başladığınızda çözüm dakikalar sürer. Yanlış yerde aradığınızda ise saatler kaybedersiniz.


Tüm bu adımları sırayla uyguladığınızda Wix VakıfBank sanal POS kurulumu karmaşık olmaktan çıkar. Akış üç halkadan ibarettir: bankadan aldığınız bilgiler, geçide doğru tanımlanan ayarlar ve iki panelde tutarlı bir callback URL. Bu üçünü hizalarsanız müşteriniz kartını güvenle girer, banka onayını verir ve sipariş mağazanıza temiz biçimde düşer.


Sık Sorulan Sorular


Wix VakıfBank sanal POS'u doğrudan bağlanabilir mi?


Hayır. Wix, Türk bankalarının sanal POS'unu doğrudan kabul etmez. Bağlantı, iyzico, PayTR ya da Sipay gibi bir ödeme geçidi üzerinden kurulur. Banka bilgileri geçide girilir, Wix de geçide bağlanır.


3D Secure'u kapatabilir miyim?


Pratikte hayır. VakıfBank kartlı işlemlerde 3D Secure doğrulamasını standart akışın parçası olarak uygular. Doğrulama, hem bankanın hem de kart şemalarının güvenlik gereksinimidir ve mağaza tarafından kapatılması beklenmez.


Sanal POS komisyonu ne kadardır?


Sabit bir oran yoktur. Komisyon; ciroya, sektöre, taksit seçeneklerine ve sözleşmeye göre değişir. Gerçek oranı yalnızca VakıfBank şubesi ya da ticari müşteri temsilciniz söyleyebilir. İnternette gördüğünüz rakamlar bağlayıcı değildir.


Callback URL'i nereden öğrenirim?


Callback URL'i kullandığınız ödeme geçidi tanımlar. Geçit panelindeki entegrasyon bölümünde bu adres yazılıdır. Aynı adresi VakıfBank üye işyeri ayarlarına da birebir girmeniz gerekir. İki adresin aynı olması zorunludur.


Ödeme neden "beklemede" kalıyor?


En yaygın neden, yanlış ya da tutarsız callback URL'dir. Banka doğrulamayı tamamlar, ama müşteri doğru adrese dönemediği için sipariş Wix'e onaylı düşmez. İki paneldeki adresi karşılaştırarak sorunu çözebilirsiniz.


Kaynakça



 
 

İlgili Yazılar

Hepsini Gör
bottom of page