Wix Yapı Kredi Sanal POS Entegrasyonu: Kurulum Rehberi

Özet: - Wix, Yapı Kredi API'sine doğrudan bağlanmaz, araya iyzico veya PayTR gibi bir ödeme kuruluşu girer - Yapı Kredi ödeme mimarisi REST tabanlı çalışır, istekler TLS 1.2 ve SHA-256 imza ister - 3D Secure akışında müşteri bankaya yönlenir, OTP girer, callback ile işlem kapanır - Sanal POS başvurusu için SSL sertifikası, vergi levhası, imza sirküleri ve IBAN gerekir - Canlıya geçmeden önce test modunda deneme ödemesi almak zorunludur

İçindekiler

• Wix mağazasında Yapı Kredi sanal POS gerçekte nasıl çalışır

• Başvuru öncesi mağazanızda hazır olması gerekenler

• Ödeme kuruluşu hesabını açma ve sanal POS tanımlama

• 3D Secure doğrulama akışını kurmak

• Wix ödeme ayarlarında bağlantıyı tamamlama

• Test modunda ödeme deneme ve canlıya geçiş

• En sık karşılaşılan hatalar ve çözümleri

• Sık Sorulan Sorular

• Kaynakça

Türkiye'de bir Wix mağazası açıp kredi kartıyla ödeme almak isteyen herkes er ya da geç aynı duvara çarpar, çünkü bankanın sunduğu altyapı ile platformun kendi ödeme sistemi birbirini doğrudan tanımaz. Bankanın sanal POS'u var. Wix'in ödeme altyapısı da var. Ama ikisi el sıkışmıyor. İşte tam burada Wix Yapı Kredi sanal POS entegrasyonu devreye girer ve çoğu kişinin sandığından bambaşka bir mantıkla çalışır.

Bu yazıda Wix Yapı Kredi sanal POS kurulumunu başvurudan canlı yayına kadar sırayla açıyoruz. Hangi belgeler gerekiyor, 3D Secure neden zorunlu, test modunu atlarsanız ne olur. Hepsi burada. Jargonu sadeleştirdik, ama önemli ayrıntıyı atlamadık.

Wix mağazasında Yapı Kredi sanal POS gerçekte nasıl çalışır

Önce bir yanlış anlamayı düzeltelim. Wix Yapı Kredi sanal POS bağlantısında Wix, bankanın ödeme sistemine doğrudan kablo uzatmaz. Yapı Kredi'nin YKB API altyapısı REST tabanlı bir mimari üzerine kuruludur ve Wix bu bağlantıyı kendi içinde desteklemez. Yani panele girip "Yapı Kredi'yi seç" diyeceğiniz hazır bir düğme yoktur.

Peki ödeme nasıl alınıyor? Araya bir ödeme kuruluşu giriyor. iyzico, PayTR ya da Sipay gibi BDDK onaylı platformlar burada köprü görevi görür ve müşteriden gelen kart isteğini bankanın anlayacağı dile çevirip güvenli kanaldan iletir. Mağazanız Wix'te kalır. Kart bilgisi bu kuruluşun şifreli altyapısından geçer. Kuruluş da arka planda banka tarafıyla konuşur.

Akışı somut bir örnekle düşünelim. Müşteri sepeti onaylar. İstek ödeme sağlayıcısına gider. Sağlayıcı Yapı Kredi tarafına bağlanır. Müşteri 3D Secure doğrulama ekranına yönlenir, telefonuna gelen OTP kodunu girer. İşlem callback ile tamamlanır ve sonuç mağazaya döner. Bu zincirde her halka şifrelidir.

Güvenlik tarafında iki rakam önemli. İstekler TLS 1.2 şifreleme ile taşınır. Kimlik doğrulama ise merchant ID, terminal ID ve SHA-256 imza üçlüsüyle yapılır; yani her ödeme isteği, mağazanıza özel bu üç değer banka tarafından doğrulanmadan asla işlenmez ve sahte bir isteğin geçme ihtimali son derece düşük kalır. Test ortamı ve canlı ortam için ayrı endpoint adresleri bulunur. İkisini karıştırmak en sık yapılan başlangıç hatasıdır.

Kısacası Wix Yapı Kredi sanal POS entegrasyonu, "Wix artı banka" değil, "Wix artı ödeme kuruluşu artı banka" denklemidir.

Başvuru öncesi mağazanızda hazır olması gerekenler

Banka ya da ödeme kuruluşu, sanal POS vermeden önce mağazanıza bakar. Eksik bir sayfa, başvurunuzu günlerce bekletebilir. Wix Yapı Kredi sanal POS başvurusunda ilk iş, kontrol listesini eksiksiz tamamlamaktır.

En kritik şart SSL sertifikasıdır. Ödeme alacağınız sayfa mutlaka https ile yüklenmeli, çünkü tarayıcının adres çubuğundaki kilit simgesi olmadan ne banka ne de müşteri size güvenir. Wix bunu çoğu planda otomatik sağlar. Yine de özel alan adınızda sertifikanın aktif olduğunu doğrulayın. SSL yoksa onay da yok.

Yasal sayfalar da zorunludur. Mesafeli satış sözleşmesi, iade ve iptal koşulları, gizlilik politikası, kullanım şartları ile kargo koşulları yayında olmalı. Hepsi başvuru değerlendirmesinde tek tek kontrol edilir.

Bir de şirket evrakı tarafı var. Tipik bir başvuruda imza sirküleri ya da imza beyannamesi, vergi levhası, ortakların kimlik fotokopisi ve şirketin IBAN bilgisi istenir; bu belgeler hem şirketin faaliyette olduğunu hem de paranın doğru hesaba aktarılacağını kanıtladığı için ödeme kuruluşu eksik dosyayı çoğu zaman doğrudan geri çevirir. Şahıs şirketi de açabilir. Belgeler hesap türüne göre küçük farklar gösterir.

Son olarak mağazanızda gerçekten satılabilir ürünler bulunsun. Fiyatı, görseli ve açıklaması olan ürünler. Boş bir vitrinle yapılan başvurular çoğu zaman geri döner.

Ödeme kuruluşu hesabını açma ve sanal POS tanımlama

Artık köprüyü kuruyoruz. Bir ödeme kuruluşu seçip hesap açacaksınız, çünkü Wix Yapı Kredi sanal POS entegrasyonu bu hesap olmadan ilerlemez. Wix Yapı Kredi sanal POS kurulumunun kalbi tam olarak burasıdır.

iyzico bu alanda en bilinen seçeneklerden biri. Wikipedia kaydına göre iyzico 10 Nisan 2013'te kuruldu, 2019 Haziran'ında PayU tarafından yaklaşık 165 milyon dolara satın alındı ve bugün 130 binden fazla e-ticaret sitesine hizmet veriyor. 2025'te Paynet'i 87 milyon dolara almasıyla altyapısını daha da genişletti. Yani arkasında ciddi bir teknik birikim var.

Hesabı açarken yukarıdaki belgeleri yüklersiniz. Onay sonrası size bir merchant paneli verilir. Bu panelde "sanal POS" ya da "ödeme yöntemleri" bölümünden Yapı Kredi'yi tanımlar, ardından banka tarafından size özel olarak üretilen merchant ID, terminal ID ve mağaza anahtarı gibi değerleri ilgili alanlara tek tek işleyerek bağlantının kimlik bilgilerini eksiksiz tamamlarsınız. Bu değerler size özeldir. Asla paylaşılmaz.

Komisyon konusu da burada netleşir. iyzico için ideasoft'un paylaştığı 2025 verilerinde komisyon "%4,29'dan başlar" ve işlem başına 0,25 TL alınır, aylık sabit ücret yoktur. Ancak bu oranlar cironuza, sektörünüze ve anlaşmaya göre değişir; aylık işlem hacminiz yükseldikçe pazarlık masasında eliniz güçlenir ve küçük başlayan bir mağaza zamanla çok daha avantajlı oranlara geçebilir. Net rakam için doğrudan banka veya ödeme kuruluşuyla görüşmek gerekir.

Taksit imkanı da bu aşamada açılır. Bonus, World, Maximum, Paraf, Axess, Advantage ve QNB gibi kart programları taksitli ödemeyi destekler ve hangilerinin görüneceğini panel üzerinden ayarlarsınız.

3D Secure doğrulama akışını kurmak

3D Secure, ödeme zincirinin en çok yanlış anlaşılan halkasıdır. Wix Yapı Kredi sanal POS kurulumunda bu adım atlanamaz. Aslında işi basittir: kartın gerçek sahibinin işlemi onayladığını kanıtlar. Müşteri ödeme anında bankanın ekranına yönlenir, telefonuna gelen OTP kodunu girer ve onay verir.

Çoğu ödeme kuruluşunda 3D Secure doğrulama süreci kendiliğinden uygulanır, yani el ile bir şey kodlamanız gerekmez. Panelde 3D Secure'u zorunlu hale getiren bir anahtar bulunur. Onu açık bırakın. Kapatırsanız sahtecilik riski ile bankaya yansıyan geri ödeme talepleri kısa sürede tırmanır ve kazancınızdan çok daha fazlasını kaybedersiniz.

Burada kart bilgisinin korunması da önemli. iyzico gibi kuruluşlar PCI-DSS sertifikalı altyapı kullanır, yani kart numarası sizin sunucunuza hiç düşmez. Müşteri kartını ödeme kuruluşunun güvenli ekranında girer.

Dynamic 3DS gibi gelişmiş seçenekler de vardır. Bu sistem, geçmiş davranışı ve işlem tutarını anlık değerlendirerek riskli gördüğü ödemede müşteriden ek doğrulama ister, alışıldık ve düşük riskli bir ödemede ise hiç araya girmeden müşteriyi tek adımda geçirir ve böylece hem sahteciliği önler hem de sepetini terk etmesini engeller. Dönüşüm oranınızı korur. Güvenliği de yüksek tutar. Doğrulama tarafı hazırsa, artık Wix panelinde bağlantıyı tamamlayabiliriz.

Wix ödeme ayarlarında bağlantıyı tamamlama

Şimdi iki ucu birleştiriyoruz. Wix Yapı Kredi sanal POS bağlantısını tamamlamak için Wix yönetim panelinde "Ayarlar" altından "Kabul Edilen Ödemeler" ya da "Ödemeler" bölümüne gidersiniz. Burada seçtiğiniz ödeme kuruluşunu bulup bağlantı düğmesine basarsınız.

Bağlantı sırasında ödeme kuruluşu hesabınıza giriş yapmanız istenir ve Wix, kuruluşun API bilgilerini güvenli şekilde alır. Çoğu durumda merchant ID gibi değerler oturum açtığınızda otomatik aktarılır. Panelde bağlantının "aktif" göründüğünü kontrol edin.

Wix Yapı Kredi sanal POS bağlantısında en temiz yol, ödeme kuruluşunun Wix App Market içindeki resmi uygulamasını kullanmaktır. Uygulamayı kurar, hesabınızla eşler ve ödeme yöntemini etkinleştirirsiniz. Resmi uygulama yoksa, kuruluşun yönlendirdiği harici bağlantı yöntemini izlersiniz.

Sonra ödeme yönteminin mağaza ön yüzünde göründüğünü doğrulayın. Sepete ürün ekleyip ödeme adımına ilerleyin. Kart formu çıkıyorsa teknik bağlantı tamamdır. Ama henüz gerçek para almaya hazır değilsiniz, çünkü test aşaması atlanamaz.

Test modunda ödeme deneme ve canlıya geçiş

Kurulumu bitirip "tamam, satışa başlıyorum" demek en pahalı hatadır. Her ciddi kurulum test moduyla doğrulanır. Bu yüzden Wix Yapı Kredi sanal POS bağlantısı da önce sahte bir ortamda denenir. Wix Yapı Kredi sanal POS entegrasyonunda test aşaması, gerçek paranın güvenliğini garanti eden basamaktır.

Ödeme kuruluşu panelinde bir test ya da sandbox modu bulunur. Bu mod açıkken yapılan ödemeler gerçek para çekmez; istek, banka altyapısının yalnızca deneme amacıyla ayrılmış test endpoint adresine gider ve gerçek bir kartı borçlandırmadan tüm akışın baştan sona doğru çalışıp çalışmadığını güvenle görmenizi sağlar. Hatırlayın, test ve canlı için ayrı adresler vardı. Test kartlarıyla birkaç deneme ödemesi yapın.

Test sırasında üç şeyi kontrol edin. Birincisi, 3D Secure ekranı düzgün açılıyor mu. İkincisi, başarılı ödeme sonrası sipariş Wix'te "ödendi" olarak işaretleniyor mu. Üçüncüsü, başarısız bir denemede sistem doğru hata mesajını gösterip müşteriyi tekrar ödeme adımına yönlendiriyor mu. Üçü de tıkır tıkır çalışıyorsa hazırsınız. Değilse durun.

Her şey yolundaysa canlı moda geçersiniz. Panelde test modunu kapatır, gerçek endpoint adresine geçersiniz. İlk gerçek siparişi mümkünse kendi kartınızla, küçük bir tutarla test edin. Para hesabınıza düştüğünde kurulum gerçekten tamamlanmış olur.

• Aşama — Yapılan İşlem — Kontrol Noktası

• Hazırlık — SSL, yasal sayfalar, ürünler — https aktif mi

• Başvuru — Belge yükleme, hesap onayı — Merchant onayı geldi mi

• Tanımlama — Sanal POS bilgileri girişi — Banka değerleri doğru mu

• Test — Sandbox ödeme denemesi — 3D Secure ve callback çalışıyor mu

• Canlı — Gerçek endpoint'e geçiş — İlk ödeme hesaba düştü mü

Tablo size bir yol haritası verir, ama asıl iş ayrıntıda biter. Şimdi en çok takılınan noktalara bakalım.

En sık karşılaşılan hatalar ve çözümleri

Wix Yapı Kredi sanal POS kurulumunda ilk ve en yaygın sorun yanlış endpoint kullanımıdır. Test bilgileriyle canlı ortama, ya da canlı bilgilerle teste gitmeye çalışmak işlemi düşürür. Çözüm basit: hangi modda olduğunuzu her zaman panelden teyit edin ve değerleri eşleştirin.

İkinci sık hata, SSL ya da alan adı sorunudur. Sertifika süresi dolmuş ya da www ile www'siz adresler birbirine karışmışsa, ödeme kuruluşu işlemi tamamlayan callback isteğini doğru adrese geri gönderemez ve sonuçta müşterinin kartından para çekildiği halde Wix tarafındaki sipariş sonsuza dek "bekliyor" durumunda asılı kalır. Müşteri öder. Sipariş "ödendi" olmaz. Alan adı ve sertifika ayarlarını tek bir standartta sabitleyin.

Üçüncü problem 3D Secure'da yaşanır. Müşteri OTP ekranına gelir ama işlem geri dönmez. Bunun nedeni çoğunlukla callback adresinin yanlış tanımlanmasıdır. Ödeme kuruluşu panelindeki dönüş adresini Wix mağazanızla eşleştirin.

Bir başka durum komisyon ve mutabakat karışıklığıdır. Hesabınıza geçen tutar, sattığınız tutardan azsa panik yapmayın; aradaki farkın tamamı ödeme kuruluşunun kestiği komisyon ile işlem başına alınan sabit ücretten ibarettir ve bu kesintiler genellikle birkaç iş günü içinde yapılan toplu mutabakat raporunda kalem kalem dökülür. Net oranları başvuru sırasında bankayla netleştirmek bu şaşkınlığı baştan önler.

Son olarak taksit görünmüyorsa, ilgili kart programının panelde etkin olmadığını kontrol edin; her banka programı ayrı bir kutucukla yönetildiği için Bonus, World ya da Maximum gibi seçeneklerden hangisini açık bırakmadıysanız müşteri o karta ait taksit planını ödeme adımında hiçbir şekilde göremez. Sebep çoğu zaman budur. Bu ayarları tek tek açmak gerekir.

Bütün bu adımları tek başına yürütmek karmaşık gelebilir. Çoğu zaman öyledir. Wix Yapı Kredi sanal POS entegrasyonunun teknik tarafı, yani Wix Yapı Kredi sanal POS bağlantısının API mimarisi ve güvenlik yapılandırması düzeyi, gerçek tecrübe ister. Blakfy işte burada devreye girer ve başvuru, güvenli yapılandırma, taksit yönetimi, test ile canlı yayın süreçlerini uçtan uca üstlenir. Siz ürününüze odaklanırsınız. Ödeme altyapısı arkada sessizce çalışır.

Sık Sorulan Sorular

Wix Yapı Kredi sanal POS entegrasyonu doğrudan yapılabilir mi?

Hayır. Wix, Yapı Kredi API'sine doğrudan bağlanmaz. Wix Yapı Kredi sanal POS bağlantısında araya iyzico, PayTR veya Sipay gibi BDDK onaylı bir ödeme kuruluşu girer ve bu kuruluş banka ile mağaza arasında köprü kurar.

Sanal POS başvurusu için hangi belgeler gerekir?

Genellikle imza sirküleri veya beyannamesi, vergi levhası, ortakların kimlik fotokopisi ve şirket IBAN bilgisi istenir. Ayrıca mağazada SSL sertifikası ile yasal sayfaların yayında olması zorunludur.

Wix Yapı Kredi sanal POS kurulumunda 3D Secure zorunlu mu?

Pratikte evet. 3D Secure, kartın gerçek sahibinin işlemi onaylamasını sağlar ve sahtecilik ile geri ödeme riskini ciddi biçimde azaltır. Çoğu ödeme kuruluşunda otomatik devreye girer ve açık bırakılması önerilir.

Komisyon oranı ne kadar?

Oranlar sabit değildir. Cironuza, sektörünüze ve anlaşmaya göre değişir. iyzico için 2025'te paylaşılan veride komisyon yüzde 4,29'dan başlıyordu, ancak kesin rakam için doğrudan banka veya ödeme kuruluşuyla görüşmek gerekir.

Test yapmadan canlıya geçebilir miyim?

Geçmemelisiniz. Wix Yapı Kredi sanal POS test modu, 3D Secure akışını, callback dönüşünü ve sipariş durumunu doğrulamadan gerçek para almak büyük risk taşır. Önce sandbox ortamında deneme ödemesi alın, sonra canlıya geçin.

Kaynakça

• Blakfy, "Wix Yapı Kredi Sanal POS Entegrasyonu", blakfy.com

• Yapı Kredi, "Sanal POS Ödeme Çözümleri", yapikredipos.com.tr

• ideasoft, "iyzico Nedir, Nasıl Kullanılır", ideasoft.com.tr

• Vikipedi, "İyzico", tr.wikipedia.org

• posentegrator, "Yapı Kredi Sanal POS Kurulumu", posentegrator.com