Wix Halkbank Sanal POS Entegrasyonu: KOBİ İçin Adım Adım Rehber

Özet: - Wix Halkbank Sanal POS entegrasyonu, banka kartlarını siteden tahsil etmek için bir ödeme geçidi üzerinden kurulur. - Halkbank üye işyeri başvurusu şube kanalıyla yapılır, ardından sanal POS bilgileri tanımlanır. - iyzico, PayTR ve Sipay gibi geçitler Halkbank altyapısını Wix mağazasına bağlar. - Kurulum dört aşamadır: başvuru, geçit kaydı, API anahtarı girişi, test kartıyla doğrulama. - 3D Secure ve PCI-DSS uyumu, kart verisinin güvenli işlenmesinin temelini oluşturur.

İçindekiler

• Wix neden Türk bankasına doğrudan bağlanmaz

• Halkbank üye işyeri başvurusu nereden başlar

• Ödeme geçidi seçimi: iyzico, PayTR ve Sipay

• API anahtarlarını Wix ödeme paneline girmek

• 3D Secure ve PCI-DSS güvenlik yapılandırması

• Test ortamından canlıya geçerken yapılan hatalar

• Entegrasyonu kim yönetmeli

Bir KOBİ Wix'te mağaza açtığında ilk takıldığı yer ödeme olur. Site hazırdır. Ürünler yüklüdür. Ama kart tahsilatı çalışmaz. Çünkü Wix, kart tahsilatını yerel acquiring üzerinden yürütmek yerine uluslararası sağlayıcılara dayandığı için Türkiye'deki bankaların sanal POS altyapısını kendi panelinden doğrudan tanımaz. İşte Wix Halkbank Sanal POS entegrasyonu tam burada devreye girer ve mağazanızı Halkbank'ın ödeme altyapısına bağlar. Bu rehberde Wix Halkbank Sanal POS entegrasyonunun her adımını başvurudan canlıya almaya kadar sırayla anlatıyoruz.

Halkbank, Türkiye'de milyonlarca esnaf ve KOBİ'nin çalıştığı kamu bankasıdır. Ticari müşterilere "POS Çözümleri" başlığı altında bir sanal POS hizmeti sunar. Resmî ürün sayfası hizmetin varlığını teyit eder, ancak kart şeması, taksit sayısı ya da ücret gibi ayrıntıları sözleşmeye bırakır. Bu yüzden kesin rakamları başvuru sürecinde üye işyeri temsilcinizden almanız gerekir. Wix Halkbank Sanal POS entegrasyonu, doğru bilgilerle başladığınızda sürpriz çıkarmayan bir süreçtir.

Wix neden Türk bankasına doğrudan bağlanmaz

Wix, global bir site kurma platformudur. Ödeme tarafında Stripe ya da PayPal gibi uluslararası sağlayıcılarla çalışır. Türkiye'deki banka sanal POS'larını doğrudan acquiring olarak tanımaz. Sonuç basit. Halkbank'ın üye işyeri numarasını Wix'e olduğu gibi yazamazsınız.

Araya bir köprü gerekir. Bu köprü, ödeme geçidi sağlayıcısıdır. Geçit, bir tarafta Halkbank sanal POS'una bağlanır, diğer tarafta Wix mağazanıza takılır. Müşteri kartını girdiğinde işlem geçit üzerinden bankaya iletilir, onay döner, sipariş tamamlanır. Wix Halkbank Sanal POS entegrasyonu dediğimiz şey aslında bu üçlü zinciri kurmaktır: banka, geçit ve mağaza.

Bu mimariyi anlamak önemlidir. Çünkü kurulumdaki çoğu sorun, müşterinin kart bilgisini girdiği anda hangi adımın bankaya, hangi adımın geçide, hangi sorumluluğun mağazaya ait olduğunun baştan ayrılmamasından doğar ve bu karışıklık ilk canlı işlemde ortaya çıkar. Bankayı düşünün. Geçidi düşünün. Sonra mağazayı. Üçü ayrı sözleşme, ayrı panel ve ayrı destek hattıdır. Wix Halkbank Sanal POS entegrasyonu, bu üç parçayı tek bir akışta buluşturur. Önce başvuru.

Halkbank üye işyeri başvurusu nereden başlar

Her şey üye işyeri başvurusuyla başlar. Halkbank sanal POS'u, KOBİ kanalları üzerinden ve genellikle şube ilişkisiyle açılır. Yani önce bankada bir ticari müşteri kaydınızın olması beklenir. Esnaf ya da limited şirket fark etmez, banka sizi bir üye işyeri olarak tanımlamalıdır.

Başvuru sırasında banka sizden işletme belgelerini, vergi levhasını ve web sitesi bilgisini ister. Site adresi olarak Wix mağazanızın alan adını verirsiniz. Onay sonrası banka size bir üye işyeri numarası ve sanal POS panel erişimi tanımlar. Bu panel, ileride geçide gireceğiniz teknik bilgilerin kaynağıdır. Panelinize gelen kullanıcı adı ve şifreyi güvenli bir yerde saklayın.

Başvuru aşamasında acele etmeyin. Alan adının başvurudaki adresle birebir aynı olması gerekir. Farklı bir alt alan adı ya da geçici Wix URL'si verirseniz, canlı işlemde uyuşmazlık çıkar. Wix Halkbank Sanal POS entegrasyonu için kullanacağınız nihai alan adını başvurudan önce netleştirin. Alan adınızı sonradan değiştirirseniz, banka tarafında güncelleme gerekebilir.

Başvurunun ne kadar sürdüğü işletmenizin durumuna bağlıdır. Belgeleri eksiksiz verirseniz süreç hızlanır. Mevcut bir Halkbank ticari müşterisiyseniz, sanal POS tanımı daha çabuk açılır. Wix Halkbank Sanal POS entegrasyonu için banka onayı geldikten sonra elinizde üye işyeri numarası, panel kullanıcısı ve şifre bulunur. Bu üç bilgi olmadan geçit adımına geçemezsiniz.

Ödeme geçidi seçimi: iyzico, PayTR ve Sipay

Banka onayını aldıktan sonra sıra geçit sağlayıcıya gelir. Wix Halkbank Sanal POS entegrasyonu, doğru geçit seçimiyle ayakta durur. Türkiye'de en sık kullanılan üç seçenek iyzico, PayTR ve Sipay'dir. Üçü de Halkbank altyapısını Wix'e bağlayabilir. Aralarındaki fark hizmet modeli, komisyon ve onay hızındadır.

iyzico, 2013'te kurulan ve 2019'da PayU tarafından satın alınan bir e-ticaret ödeme sistemidir. Kendi beyanına göre 180 binin üzerinde üye işyerine hizmet verir ve günde bir milyondan fazla işlem yürütür. Bonus, World, Maximum, Axess, Paraf ve Advantage gibi kart programlarıyla taksitli ödeme sunar. PayTR ise mağaza odaklı bir geçit olarak öne çıkar ve mobil uygulamasıyla işlem takibini kolaylaştırır. Sipay de benzer bir altyapı sunar ve sektöre göre özelleşen paketleri vardır.

Aşağıdaki tablo üç geçidi temel kriterlerle karşılaştırır. Değerler sağlayıcı beyanlarına dayanır ve sözleşmeye göre değişebilir.

• Kriter — iyzico — PayTR — Sipay

• Onay süresi — Genelde 24 saat içinde — Başvuruya bağlı — Başvuruya bağlı

• Taksit — Var (kart programlarına göre) — Var — Var

• 3D Secure — Dynamic 3DS — Destekli — Destekli

• Wix bağlantısı — Geçit üzerinden — Geçit üzerinden — Geçit üzerinden

• Mobil takip — Var — Var (mağaza uygulaması) — Var

Komisyon tarafında dikkatli olun. Bir kaynak iyzico için 2025 yılında yaklaşık yüzde 4,29 artı işlem başına 0,25 TL'lik bir oran aktarır. Bu rakam tek kaynağa dayanır ve cironuza, sektörünüze ve sözleşmenize göre değişir. Kesin oranı her zaman sağlayıcıdan yazılı olarak isteyin. Birkaç geçitten teklif almak, hem oranı hem de hizmet kapsamını karşılaştırmanızı sağlar. Geçidi seçtikten sonra teknik kurulum başlar.

API anahtarlarını Wix ödeme paneline girmek

Bu adım Wix Halkbank Sanal POS entegrasyonunun kalbidir. Geçit sağlayıcı, Halkbank sanal POS panelinizden aldığı bilgilerle bir bağlantı kurar. softTR gibi altyapı dokümanları, Halkbank modülünde dört teknik alanın doldurulduğunu gösterir: Üye İşyeri No, Sanalpos Kullanıcı Adı, Sanalpos Kullanıcı Şifresi ve Secret Key.

Bu dört bilgiyi Halkbank'ın size verdiği panelden alırsınız. Kullanıcı adı, şifre ve Secret Key genellikle banka panelinde sizin oluşturduğunuz değerlerdir. Sonra bu bilgileri geçit sağlayıcının ekranına ya da Wix ödeme paneline girersiniz. Modülü varsayılan banka olarak işaretler, yayın durumunu aktif yapar ve kaydedersiniz. Kaydet butonuna basmadan önce her alanı iki kez kontrol edin.

Bir uyarı. API anahtarlarını kimseyle paylaşmayın. E-posta ya da mesajla iletmeyin. Asla. Secret Key bir kez sızarsa, sizin üye işyeri kimliğinizle sahte işlemler oluşturulabilir, itiraz ve ters ibraz süreçleri başınıza kalır ve bunu geri almak haftalar sürer. Wix Halkbank Sanal POS entegrasyonu sırasında bu değerleri yalnızca güvenli panel üzerinden girin. Bir bilgiyi yanlış kopyalarsanız işlem reddedilir. Panik yapmayın. Alanı temizleyip yeniden girin. İşlem akışını kurduktan sonra güvenlik katmanını yapılandırmak gerekir.

3D Secure ve PCI-DSS güvenlik yapılandırması

Kart ödemesinde güvenlik tercih değil zorunluluktur. Pazarlık konusu değil. İki kavram öne çıkar: 3D Secure ve PCI-DSS.

3D Secure, kart sahibinin işlemi banka tarafından doğrulamasını sağlar. Müşteri kartını girdikten sonra bankadan gelen tek kullanımlık kod ya da uygulama onayıyla işlemi tamamlar. iyzico bunu Dynamic 3DS adıyla sunar. Bu katman, sahte işlem riskini ciddi biçimde düşürür ve itiraz oranını azaltır. Müşteri için birkaç saniye uzar, ama sizin için güven kazandırır.

PCI-DSS ise kart verisinin nasıl saklanıp işleneceğini belirleyen uluslararası standarttır. İyi haber şu. Bir ödeme geçidi kullandığınızda kart verisi sizin sunucunuzda tutulmaz. Geçit, kart bilgisini tokenize eder ve PCI yükünü büyük ölçüde üstlenir. Bu da KOBİ'nin omzundaki uyum sorumluluğunu hafifletir. Wix Halkbank Sanal POS entegrasyonu, kart verisini doğrudan ellemeden çalışır.

Bir teknik nokta daha. Geçidin size verdiği webhook adresi mutlaka HTTPS olmalıdır. Wix zaten siteyi HTTPS ile yayınlar, ancak özel bir dönüş adresi tanımlıyorsanız protokolü kontrol edin. Wix Halkbank Sanal POS entegrasyonu güvenli bir dönüş kanalı olmadan tam çalışmaz. Güvenlik ayarı bittiğinde test aşamasına geçilir.

Test ortamından canlıya geçerken yapılan hatalar

Kurulum bitti sanıp canlıya geçmek en sık yapılan hatadır. Önce test edin. Halkbank ve geçit sağlayıcı, gerçek para hareketi olmadan tek seferlik ya da taksitli senaryoları, başarılı ve başarısız işlemleri ayrı ayrı deneyebileceğiniz test kartları sunar. Troy da deneyin.

Sahada en çok görülen sorunları şöyle sıralayabiliriz:

• Test ve canlı ortamın karıştırılması. Test anahtarlarıyla canlıya geçilirse işlem reddedilir.

• Troy kart uyumu. Yerel kart şeması her geçitte aynı sorunsuzlukta çalışmayabilir.

• API gecikmesi. Yoğun anlarda bankadan dönen yanıt gecikebilir, zaman aşımı ayarını kontrol edin.

• Para birimi sınırı. Türk Lirası dışı tahsilat planlıyorsanız geçidin bunu desteklediğini doğrulayın.

Bu kontrolleri tek tek yaparsanız, ilk gerçek siparişte sürprizle karşılaşmazsınız. Wix Halkbank Sanal POS entegrasyonunun başarısı, test disiplinine bağlıdır. Küçük bir tutar gönderin. Karta düşen ekstreyi kontrol edin. İade akışını da deneyin. Müşteri iade talep ettiğinde sistemin nasıl davrandığını önceden görmek, sonradan çıkacak sorunu baştan kapatır.

Bir test daha yapın. Farklı bir tarayıcı ve telefondan sipariş deneyin. Mobil ödeme akışında 3D Secure ekranının düzgün açıldığını görün. Wix Halkbank Sanal POS entegrasyonu masaüstünde çalışıp mobilde takılırsa, müşterilerin çoğunu kaybedersiniz. Çünkü Türkiye'de alışverişin büyük kısmı telefondan yapılır. Bu yüzden mobil testi atlamayın.

Entegrasyonu kim yönetmeli

Tüm bu adımlar teknik görünüyor olabilir. Doğru. Başvuru, geçit seçimi, anahtar girişi ve güvenlik ayarı birbirine bağlı bir zincirdir; başvuruda verdiğiniz alan adı geçide girdiğiniz bilgiyle, geçitteki ayar bankadaki tanımla, bankadaki tanım da mağazadaki yayın durumuyla uyumlu olmadığında zincir sessizce kopar ve işlem reddedilir. Tek başınıza yürütmek mümkün. Ama zaman ister.

Blakfy olarak Wix Halkbank Sanal POS entegrasyonunu uçtan uca yönetiyoruz: şube başvurusunun koordinasyonundan geçit kurulumuna, test kartıyla doğrulamadan canlıya almaya kadar süreci sizin yerinize tamamlıyoruz. Mağazanız kurulum boyunca açık kalır, işlem kaybı yaşamazsınız. Böylece siz işinize, ödeme altyapısı da arka planda çalışmaya devam eder.

Sık Sorulan Sorular

Wix'e doğrudan Halkbank sanal POS eklenebilir mi?

Hayır. Wix, Türk bankalarının sanal POS'unu doğrudan tanımaz. Araya iyzico, PayTR ya da Sipay gibi bir ödeme geçidi koymanız gerekir. Geçit, Halkbank altyapısını Wix mağazanıza bağlar.

Wix Halkbank Sanal POS entegrasyonu ne kadar sürer?

Banka başvurusunun onayı işletme durumuna göre değişir. Geçit tarafında onay genelde 24 saat içinde gelebilir. Teknik kurulum, bilgiler hazırsa kısa sürede tamamlanır.

Taksitli satış yapabilir miyim?

Evet. iyzico ve benzeri geçitler Bonus, World, Maximum, Axess gibi kart programlarıyla taksit sunar. Taksit sayısı ve koşulları banka anlaşmanıza bağlıdır.

Komisyon ne kadar?

Komisyon sağlayıcıya, cironuza ve sektörünüze göre değişir. Bir kaynak iyzico için 2025'te yaklaşık yüzde 4,29 artı işlem başına 0,25 TL aktarır, ancak kesin oranı sağlayıcıdan yazılı olarak teyit etmeniz gerekir.

Kart bilgileri sitemde saklanır mı?

Hayır. Ödeme geçidi kart verisini tokenize eder ve PCI-DSS uyumunu üstlenir. Kart bilgisi sizin Wix mağazanızda tutulmaz.

Kaynakça

• Halkbank, POS Çözümleri / Sanal POS (halkbank.com.tr)

• softTR Destek, Halkbank Sanal POS Entegrasyonu Nasıl Yapılır (destek.softtr.com)

• iyzico resmî sitesi (iyzico.com)

• IdeaSoft, iyzico Nedir Nasıl Kullanılır (ideasoft.com.tr)

• Vikipedi, İyzico maddesi (tr.wikipedia.org)

• PayTR resmî sitesi (paytr.com)