WooCommerce Sanal POS Rehberi — Doğru Entegrasyon

WooCommerce mağazanıza sanal POS entegre etmek istiyorsunuz ancak hangi sağlayıcıyı seçeceğinizi, eklentiyi nasıl kuracağınızı ya da temanızla uyumlu olup olmayacağını bilmiyorsunuz. Bu rehber, Türkiye’deki WooCommerce kullanıcılarının en sık karşılaştığı soruları doğrudan yanıtlar: hangi sanal POS sağlayıcısı ne işe yarar, entegrasyon nasıl çalışır ve mağazanız için doğru altyapıyı nasıl kurarsınız.

Sanal POS Nedir ve WooCommerce İle İlişkisi Nasıldır?

Sanal POS (Sanal Point of Sale), fiziksel bir kart okuyucu olmaksızın internet üzerinden kredi kartı ve banka kartı ödemesi almanızı sağlayan bir ödeme altyapısıdır. Bankanız ya da bir ödeme aracısı, size çevrimiçi işlem yapabileceğiniz bir API ve yönetim paneli tanımlar; siz de bu API’ı mağazanıza bağlarsınız.

WooCommerce, kendi başına bir ödeme altyapısı değildir. Ürün kataloğu, sepet, sipariş yönetimi ve müşteri hesapları gibi e-ticaret işlevlerini sağlar; ancak ödeme almak için bir ağ geçidi (gateway) eklentisine ihtiyaç duyar. Sanal POS sağlayıcınızın WooCommerce eklentisi, bu iki sistemi birbirine bağlar: müşteri ödeme bilgilerini girer, WooCommerce siparişi oluşturur, sanal POS işlemi onaylar ve sipariş durumu otomatik güncellenir.

Türkiye’de banka sanal POS’ları (Garanti BBVA, Akbank, Vakıfbank, Kuveyt Türk vb.) ile ödeme aracıları (iyzico, PayTR, Sipay, Paynkolay vb.) arasında temel bir fark vardır: banka POS’larında doğrudan bankayla sözleşme yaparsınız; ödeme aracılarında ise tek bir entegrasyonla birden fazla bankadan tahsilat yapabilirsiniz. İkinci yöntem kurulum sürecini önemli ölçüde kısaltır ancak genellikle ek komisyon içerir.

Türkiye’deki Başlıca WooCommerce Sanal POS Sağlayıcıları

Hangi sağlayıcıyı seçeceğinizi anlamak için önce piyasadaki ana oyuncuları tanımak gerekir. Aşağıdaki tablo, Türkiye’deki WooCommerce kullanıcılarının en sık karşılaştığı sağlayıcıları temel kriterler üzerinden karşılaştırır.

Yeni kurulan ya da cirosu henüz düşük olan bir mağaza için ödeme aracıları daha hızlı başlangıç sağlar. Hacim büyüdükçe ve komisyon farkı belirginleştikçe banka POS’una geçiş mantıklı hale gelebilir. Bu karar tamamen işletmenizin mevcut durumuna ve büyüme hızına bağlıdır.

iyzico ile WooCommerce Sanal POS Entegrasyonu

iyzico, Türkiye’deki WooCommerce mağazaları arasında en yaygın kullanılan ödeme aracısıdır. Bunun başlıca nedeni resmi WooCommerce eklentisinin hem WordPress.org’da hem de kendi geliştirici portalında güncel tutulması ve kurulum sürecinin görece kısa olmasıdır.

Entegrasyon adımları genel hatlarıyla şu şekilde işler: iyzico üyelik ve onay sürecini tamamlarsınız; API anahtarlarınızı (API Key ve Secret Key) alırsınız; WooCommerce eklentisini yükler ve etkinleştirirsiniz; eklenti ayarlarına API anahtarlarınızı girersiniz; test (sandbox) ortamında birkaç deneme işlemi yaparsınız; ardından canlı ortama geçersiniz. Süreç teknik bilgi gerektiren değil, adım adım takip edilebilir niteliktedir.

iyzico’nun WooCommerce’de öne çıkan özellikleri arasında 3, 6, 9 ve 12 taksit seçenekleri, BKM Express desteği ve 3D Secure yer alır. Taksit tablosu, ürün sayfasına veya ödeme adımına otomatik olarak eklenebilir; bu da sepet terk oranını düşürdüğü gözlemlenen bir özellik olarak sıkça dile getirilmektedir. Tema uyumu açısından bakıldığında, iyzico’nun WooCommerce standart ödeme akışına entegre olması, tema değil sağlayıcı odaklı bir uyum gerektirdiği anlamına gelir.

PayTR ile WooCommerce Sanal POS Entegrasyonu

PayTR, iyzico’ya alternatif olarak yaygın biçimde tercih edilen bir ödeme aracısıdır. iFrame API yaklaşımı sayesinde müşteri ödeme sayfanızdan ayrılmadan işlemi tamamlar; bu da hem kullanıcı deneyimini iyileştirir hem de PCI uyumluluğunu kolaylaştırır çünkü kart bilgileri doğrudan PayTR altyapısında işlenir.

PayTR, kredi kartı dışında havale/EFT ve kapıda ödeme seçeneklerini de sunar; bu çeşitlilik özellikle henüz çevrimiçi kart ödemesine alışık olmayan müşteri kitlesine hitap eden mağazalar için değerlidir. WordPress.org’daki resmi PayTR WooCommerce eklentisi aktif olarak güncellenmektedir ve WooCommerce’in güncel sürümleriyle uyumlu şekilde çalışır.

PayTR’ın iFrame entegrasyonu, bazı özelleştirilmiş ödeme sayfalarında görsel uyumsuzluğa yol açabilir. Bu durumda temanızın checkout şablonunu kontrol etmek ve iFrame’in doğru boyutlarda render edildiğini test etmek gerekir. Sandbox ortamında test kartlarıyla birkaç senaryo çalıştırmak bu sorunları erken tespit etmenin en pratik yoludur.

Banka Sanal POS’ları: Garanti BBVA, Akbank, Vakıfbank, Kuveyt Türk

Banka POS’larının temel avantajı, aracı komisyonu olmaksızın doğrudan bankadan tahsilat yapmanızdır. Özellikle işlem hacmi yüksek mağazalar için komisyon farkı belirgin tasarrufa dönüşebilir. Ancak bu avantaj, daha uzun bir başlangıç süreciyle birlikte gelir: şirket belgelerinin hazırlanması, banka şubesinde sözleşme imzalanması ve API entegrasyon onayının beklenmesi haftalar alabilir.

Garanti BBVA, WooCommerce için resmi bir ödeme modülü sunmaktadır. Modül Garanti’nin geliştirici portalında (dev.garantibbva.com.tr) detaylı teknik dökümanlarla birlikte yer alır; test (sandbox) ortamı mevcuttur. Akbank ve Vakıfbank entegrasyonları için genellikle üçüncü taraf eklenti geliştiricilerine ya da bankanın API belgelerine göre hazırlanmış özel modüllere ihtiyaç duyulur. Kuveyt Türk de WooCommerce için resmi bir modül yayınlamış durumdadır.

Banka POS’u başvurusunda dikkat edilmesi gereken noktalar şunlardır: e-ticaret sektör kodu, günlük işlem limiti ve taksit anlaşmaları genellikle ayrı müzakere gerektirir. Taksit seçenekleri banka ile yapılan sözleşmeye göre farklılaşır; bazı bankalarda belirli kart tipleri veya harcama kategorileri için taksit kısıtlaması uygulanabilir.

Sanal POS Seçerken Dikkat Edilmesi Gereken Kriterler

Doğru sanal POS seçimi yalnızca komisyon oranına bakarak yapılmaz. Aşağıdaki kriterler, kararınızı daha sağlam temellere oturtmanıza yardımcı olur.

• Onay süresi: Mağazanız ne zaman açılacak? Ödeme aracıları genellikle daha hızlı onay verirken banka POS başvuruları haftalar sürebilir.
• Taksit seçenekleri: Hedef kitleniz taksitle alışveriş yapıyor mu? Kaç ay taksit sunacaksınız? Bazı sağlayıcıların taksit anlaşmaları daha kapsamlıdır.
• Komisyon ve işlem ücreti: Sabit ücret mi var, işlem başına mı kesiliyor? Düşük hacimli mağazalar için sabit ücret caydırıcı olabilir. Güncel koşullar için doğrudan sağlayıcıyla görüşün.
• WooCommerce eklentisi kalitesi: Eklenti aktif olarak güncelleniyor mu? WordPress.org’da mı yoksa yalnızca sağlayıcı sitesinde mi? Son güncelleme tarihi kritik bir sinyaldir.
• İptal ve iade akışı: WooCommerce’den sipariş iptal ettiğinizde ödeme tarafında ne olur? Eklentinin bu senaryoyu nasıl yönettiğini sandbox ortamında test etmek önemlidir.
• Teknik destek: Entegrasyon sırasında sorun çıktığında Türkçe teknik destek alabilecek misiniz?
• Tema uyumu: Kullandığınız tema, seçtiğiniz ödeme eklentisiyle test edilmiş mi?

WooCommerce Sanal POS’ta Tema Uyumu Neden Önemlidir?

Sanal POS entegrasyonu teknik olarak doğru kurulmuş olsa bile, ödeme sayfasının görsel bütünlüğü mağaza temanıza bağlıdır. Yabancı kökenli ya da genel amaçlı (multipurpose) temalar, Türkiye’deki ödeme eklentilerinin ürettiği HTML yapısıyla çakışabilir. Bu durum checkout sayfasında bozuk bir görünüme, taksit tablosunun yanlış konumlanmasına ya da iFrame’in taşmasına yol açabilir.

Yerli ve WooCommerce odaklı bir tema kullanmak bu riski önemli ölçüde azaltır. Örneğin Site24 WordPress E-Ticaret Teması, iyzico ve PayTR eklentileriyle birlikte test edilerek geliştirilmiştir; bu iki sağlayıcının WooCommerce entegrasyonu tema paketine dahil edilmiştir. Yabancı bir tema satın alıp sonradan yerli ödeme sistemleriyle uyumlu hale getirmeye çalışmak, başlangıçta doğru temayı seçmekten çok daha fazla zaman ve kaynak tüketir.

Çok satıcılı bir platform kuruyorsanız — örneğin birden fazla satıcının komisyon modeliyle ürün listelediği bir marketplace — ödeme akışı daha da karmaşık hale gelir. Bu durumda iyzico’nun pazaryeri ödeme bölüşümü (split payment) desteği gibi özellikler kritik öneme kavuşur. Site24 WordPress Pazaryeri Teması, Dokan uyumlu altyapısı ve iyzico ile PayTR entegrasyonuyla bu senaryoyu karşılamak için tasarlanmıştır.

WooCommerce Sanal POS Kurulum Adımları (Genel Akış)

Her sağlayıcının kendi özel dökümanı olsa da WooCommerce sanal POS kurulumunun genel akışı aşağıdaki adımları izler. Bu akışı önceden bilmek, hem hazırlık sürecinizi kısaltır hem de olası sorunları erken fark etmenizi sağlar.

• 1. Başvuru ve onay: Sağlayıcıya üye olun, gerekli şirket belgelerini yükleyin ve onay bekleyin. Ödeme aracılarında bu süreç genellikle birkaç iş günüdür.
• 2. API bilgilerini alın: Onay sonrası size API Key, Secret Key (veya Merchant ID) gibi bilgiler iletilir. Bu bilgileri güvende tutun.
• 3. WooCommerce eklentisini yükleyin: WordPress yönetim panelinden Eklentiler → Yeni Ekle bölümünden eklentiyi arayın ve yükleyin.
• 4. Eklenti ayarlarını yapılandırın: WooCommerce → Ayarlar → Ödemeler menüsünden ilgili ödeme yöntemini etkinleştirin ve API bilgilerini girin.
• 5. Test ortamında doğrulayın: Sağlayıcının sunduğu test kartlarıyla başarılı ödeme, başarısız ödeme ve iptal senaryolarını çalıştırın.
• 6. Canlıya geçin: Test başarılıysa eklenti ayarlarında modu “Canlı” (Live) olarak değiştirin ve gerçek bir küçük tutarlı işlemle doğrulayın.

Kurulum sonrasında checkout akışını farklı cihazlardan (masaüstü, tablet, mobil) test etmek iyi bir pratiktir. Özellikle mobil görünüm ve 3D Secure yönlendirme adımı bazı konfigürasyonlarda sorun çıkarabilir.

Sanal POS Entegrasyonunda Sık Yapılan Hatalar

WooCommerce sanal POS kurarken tekrarlayan birkaç hata kategorisi öne çıkar. Bunları önceden bilmek hem kurulum sürecini hızlandırır hem de canlı ortamda müşterinin karşılaşabileceği sorunları önler.

Sandbox’ı atlamak: Test ortamını kullanmadan direkt canlıya geçmek, gerçek müşterilerle hata ayıklama yapmak anlamına gelir. Bu hem itibar riski hem de potansiyel kayıp içerir. Her zaman en az başarılı ödeme, kart reddi ve iptal senaryolarını test ortamında çalıştırın.

SSL sertifikası olmadan geçmek: Bütün sanal POS sağlayıcıları SSL (HTTPS) zorunlu tutar. Sertifika yoksa ödeme sayfası yüklenemez ya da tarayıcı uyarısı gösterir. Hosting panelinizden ücretsiz Let’s Encrypt sertifikası aktif edin.

Eklenti sürüm uyumsuzluğu: WooCommerce’in major sürüm güncellemesi (örn. 8.x → 9.x) sonrasında ödeme eklentileri uyumsuz hale gelebilir. Güncelleme öncesi eklentinin WooCommerce’in yeni sürümüyle uyumlu olduğunu kontrol edin.

İptal akışını test etmemek: Sipariş iptali veya müşteri tarafından işlem iptali senaryolarında eklentinin nasıl davrandığını sandbox ortamında mutlaka kontrol edin. Bazı eklenti yapılandırmalarında bu akış ayrıca test gerektirir.

iyzico veya PayTR’ın eski eklenti sürümünü kullanmak: Eklenti GitHub veya WordPress.org’dan değil sağlayıcının eski belge sayfasından indirildiyse güncel olmayabilir. Her zaman resmi kaynak kullanın.

Ücretsiz Sanal POS Eklentileri Yeterli Mi?

WordPress.org’da bazı sanal POS eklentileri ücretsiz olarak sunulmaktadır. iyzico ve PayTR’ın kendi resmi eklentileri de ücretsizdir. Dolayısıyla soru “ücretsiz mi ücretli mi” değil, “hangi eklenti projemin gereksinimlerini karşılar” şeklinde kurulmalıdır.

Ücretsiz resmi eklentiler, standart WooCommerce kurulumları için çoğu zaman yeterlidir. Ancak şu durumlarda ek çözümlere ihtiyaç duyabilirsiniz: birden fazla sanal POS sağlayıcısını aynı mağazada kullanmak istiyorsanız; taksit tablosunu ürün sayfasında veya özel bir konumda göstermek istiyorsanız; B2B fatura entegrasyonu gibi ek özellikler gerekiyorsa. Bu senaryolarda ücretli ya da özelleştirilmiş eklentiler veya tema düzeyinde entegrasyonlar devreye girebilir.

Önemli bir uyarı: “nulled” ya da kırılmış ödeme eklentisi kullanmak hem güvenlik riski hem de ödeme verisi ihlali anlamına gelir. Özellikle kart bilgilerinin işlendiği bir bileşende bu risk kabul edilemez. Resmi eklentiler ücretsizken bu riski almak mantıksızdır.

WooCommerce Sanal POS ve SEO: Checkout Hızı Sıralamanızı Etkiler

Sanal POS entegrasyonu yalnızca ödeme almak için değil, mağazanızın genel performansı açısından da önemlidir. Google, Core Web Vitals metriklerini (LCP, CLS, INP) sıralama sinyali olarak kullanır; ödeme sayfasının yavaş yüklenmesi hem müşteri deneyimini hem de indeksleme kalitesini etkiler.

PayTR’ın iFrame yaklaşımı, bazı durumlarda sayfada ek bir yükleme katmanı oluşturabilir. iyzico’nun script’i de benzer şekilde sayfa yükleme süresine katkıda bulunabilir. Bu etkiyi minimize etmek için ödeme eklentilerini lazy load yöntemiyle yalnızca checkout sayfasında yüklemek, gereksiz diğer eklentileri devre dışı bırakmak ve LiteSpeed Cache gibi bir önbellek çözümü kullanmak iyi uygulamalardır.

Bootstrap 5 tabanlı hafif bir tema altyapısı, bu optimizasyonları destekler. Ağır sayfa kurucularla (page builder) inşa edilmiş checkout sayfaları, ödeme eklentisinden bağımsız olarak yavaş açılabilir ve bu doğrudan dönüşüm oranına yansır.

Pazaryeri Modeli İçin Sanal POS: Split Payment ve Komisyon Dağıtımı

Tek mağazalı bir e-ticaret sitesinde sanal POS entegrasyonu görece doğrusaldır. Ancak birden fazla satıcının aynı platformda ürün sattığı bir pazaryeri kuruyorsanız — örneğin Trendyol ya da Hepsiburada benzeri bir model — ödeme akışı önemli ölçüde karmaşıklaşır.

Bu senaryoda müşteri tek bir sepetten ödeme yapar; ancak satış gelirinin birden fazla satıcıya bölüştürülmesi gerekir. Bu işlev “split payment” ya da “alt satıcı modeli” olarak adlandırılır. iyzico, pazaryeri sahipleri için Marketplace API’ı sunar; bu API, komisyon oranına göre otomatik gelir dağıtımını mümkün kılar. Dokan eklentisi ile iyzico’nun bu özelliği kombine edildiğinde, her satıcının hesabına düşen tutar otomatik olarak aktarılabilir.

Bu yapıyı kurmak için tema, WooCommerce, Dokan ve iyzico’nun hepsinin birbiriyle uyumlu çalışması gerekir. Bunlardan herhangi birinin uyumsuz olması tüm ödeme akışını bozabilir. Site24’ün pazaryeri teması bu üç katmanı birlikte ele alacak şekilde geliştirilmiş olup iyzico pazaryeri entegrasyonu ile Dokan satıcı panelini Türkçe arayüzle bir araya getirir.

Sık Sorulan Sorular

WooCommerce’e sanal POS entegre etmek için hangi eklenti gerekir?

Her sanal POS sağlayıcısı WooCommerce için kendi eklentisini sunar. iyzico ve PayTR’ın resmi eklentileri WordPress.org’da ücretsiz olarak mevcuttur. Garanti BBVA ve Kuveyt Türk gibi banka POS’ları için ise bankanın kendi geliştirici portalındaki modüller veya üçüncü taraf eklentiler kullanılır. Eklentiyi yükledikten sonra WooCommerce → Ayarlar → Ödemeler menüsünden etkinleştirmeniz ve API bilgilerinizi girmeniz gerekir.

iyzico mu yoksa PayTR mi daha iyi?

İkisi de yaygın kullanılan güvenilir ödeme aracılarıdır; hangisinin daha uygun olduğu mağazanızın ihtiyacına göre değişir. iyzico, özellikle taksit tablo görünümü ve BKM Express entegrasyonu konusunda öne çıkar. PayTR ise iFrame yapısı, havale/EFT ve kapıda ödeme seçenekleriyle daha geniş bir ödeme yelpazesi sunar. Komisyon oranları sektöre ve sözleşmeye göre farklılaştığından her iki sağlayıcıdan da teklif almanız önerilir.

WooCommerce sanal POS için SSL sertifikası zorunlu mu?

Evet, tüm sanal POS sağlayıcıları SSL (HTTPS) zorunlu tutar. SSL olmayan bir sitede ödeme formu çalışmaz ya da tarayıcı güvenlik uyarısı göstererek müşteriyi sayfadan uzaklaştırır. Hosting panelinizden Let’s Encrypt ile ücretsiz SSL sertifikası aktif edebilirsiniz; bu işlem çoğu hostingde birkaç dakika sürer.

Banka sanal POS’u mu, ödeme aracısı mı seçmeliyim?

Yeni açılan ya da düşük cirolu mağazalar için ödeme aracıları (iyzico, PayTR vb.) daha hızlı başlangıç sağlar çünkü onay süreci daha kısadır ve tek entegrasyonla birden fazla bankanın kartını kabul edebilirsiniz. İşlem hacimleri arttıkça ve komisyon farkı belirginleştikçe banka sanal POS’una geçiş değerlendirilebilir. İkisi birbirini dışlamaz; bazı mağazalar her ikisini de paralel kullanır.

Sanal POS entegrasyonunda tema uyumu neden önemli?

Sanal POS eklentileri, WooCommerce’in checkout şablonuna HTML ekler. Temanın bu şablonu özelleştirmiş olması durumunda ödeme alanı bozuk görünebilir, taksit tablosu yanlış konumlanabilir ya da iFrame düzgün render edilmeyebilir. Türkiye’deki ödeme sistemleriyle birlikte test edilmiş bir tema kullanmak bu sorunları baştan engeller.

WooCommerce pazaryerinde sanal POS split payment nasıl çalışır?

Pazaryeri modelinde müşteri tek ödeme yapar; bu ödeme belirlenen komisyon oranına göre platform sahibi ve satıcılar arasında otomatik bölüştürülür. iyzico’nun Marketplace API’ı bu işlevi destekler. Dokan eklentisi ile entegre kullanıldığında her satıcının hesabına düşen tutar otomatik dağıtılabilir. Bu yapının düzgün çalışması için tema, WooCommerce, Dokan ve iyzico’nun uyumlu sürümlerinin birlikte kullanılması gerekir.