Neden WooCommerce ile SanalPos.com?
WooCommerce, eklenti mimarisi sayesinde ödeme yöntemlerini dışarıdan eklemeye açıktır. Türkiye'de satış yapan mağazaların ödeme tarafındaki ihtiyaçları ise uluslararası ödeme sayfalarından farklıdır: taksitli satış, yerli kartlarla çalışma, Türk Lirası cinsinden mutabakat ve 3D Secure doğrulamalı akış. Bu başlıkların hepsi, çalıştığınız ödeme kuruluşunun çözümüyle ve hesabınıza tanımlı seçeneklerle belirlenir.
sanalpos.com'un rolü bu noktada aracılıktır: başvurunuzu alır, satış yönteminizi ve mağazanızı değerlendirmeye sunar, uygun ödeme kuruluşuyla hesabınızın açılmasını koordine eder. Ödeme hizmetini, entegrasyon araçlarını ve dokümantasyonu hesabınızın açıldığı kuruluş sağlar. Eklenti dosyası, anahtarlar ve uç nokta adresleri de aynı kaynaktan gelir.
WooCommerce tarafında yapı değişmediği için ödeme yöntemi eklemek ya da sıralamayı değiştirmek tema ve sipariş akışınızı bozmaz. Başlamak için sanal POS başvurusu yeterlidir; kapsam ve koşullar teklifinizde yazılı olarak gelir. Mağaza tarafındaki genel çerçeve için e-ticaret sanal POS sayfasına bakabilirsiniz.
Eklenti Kurulumu ve Ödeme Yöntemi Ayarları
Kurulum iki parçadan oluşur: eklentinin yüklenmesi ve ödeme yönteminin yapılandırılması. Eklenti, WordPress yönetim panelinde Eklentiler → Yeni Ekle → Eklenti Yükle adımından dosya olarak yüklenir ve etkinleştirilir. Eklenti veya modül dosyasının adı ile nereden indirileceği, hesabınız açıldığında iletilen dokümantasyonda belirtilir; WordPress ve WooCommerce sürüm desteği de aynı dokümantasyonda yer alır. Eklenti kullanmadan, doğrudan API çağrılarıyla kendi ödeme yönteminizi yazmak da mümkündür.
Eklentinin kendisi çoğu zaman ücretsizdir: kuruluşların ücretsiz yayımladığı eklentiler WordPress eklenti dizininde «sanal pos» aramasıyla listelenir; maliyet eklentide değil, teklifte yazan ücret kalemlerindedir. WooCommerce 8.3’ten sonra kurulan mağazalarda ödeme sayfası blok tabanlıdır; eklentinin Checkout bloğunu desteklediğini kurmadan önce doğrulayın.
Etkinleştirmeden sonra ayarlar WooCommerce → Ayarlar → Ödemeler bölümünde görünür. Burada yöntem açılır, müşteriye gösterilecek ad ve açıklama yazılır, ardından anahtarlar girilir. Test ve canlı anahtarlar ayrıdır; canlı anahtarla test siparişi verilmez. Anahtarları tema dosyalarında ya da kod deposunda tutmayın.
Aynı ekranda 3D Secure doğrulamalı akışın açık olup olmayacağı, ödeme sonrası müşterinin döneceği adres ve ödeme kuruluşunun sunucusundan gelecek bildirimin (callback ya da webhook) gideceği adres tanımlanır. Bildirim adresinin dışarıdan erişilebilir olması ve HTTPS üzerinden çalışması gerekir; bakım kipindeki ya da parola korumalı bir mağaza bildirimi alamaz. Doğrulama akışının ne anlama geldiği 3D Secure ile güvenli ödeme sayfasında, bildirim alanları ve imza doğrulaması webhook ve callback sayfasında anlatılır.
Ödeme Akışı ve Sipariş Durumu
Müşteri sepeti onayladığında WooCommerce siparişi ödeme bekliyor durumunda oluşturur ve müşteriyi ödeme adımına gönderir. Kart bilgisi ödeme kuruluşunun sayfasında ya da doğrulama akışı içinde alınır; 3D Secure açıksa müşteri bankanın doğrulama ekranına yönlendirilir ve oradan mağazanıza döner.
Sipariş durumunu, müşterinin döndüğü sayfaya göre değil sunucunuza gelen bildirime göre kesinleştirin. Tarayıcı kapanabilir, bağlantı kopabilir; ödemenin sonucunu tek başına dönüş sayfası belirlemez. Bildirim alındığında önce imza doğrulanır, sonra sipariş durumu güncellenir ve 200 yanıtı döndürülür. Aynı bildirim iki kez gelebileceğinden güncelleme, aynı siparişte iki kayıt oluşturmayacak biçimde yazılmalıdır.
İade ile iptalin panelden mi yoksa program arayüzünden mi yapılacağı ve sipariş durumunun güncellenme biçimi seçilen çözüme göre sunulabilir; hesabınıza tanımlı işlemler dokümantasyonunuzda yazar. Müşterinin kartını sonraki alışverişte yeniden girmeden ödeme yapması isteniyorsa kart numarası mağazada saklanmaz, bunun yerine token kullanılır; ayrıntı için tek tıkla ödeme ve tokenization sayfasına bakın. Uç noktalar, alan adları ve hazır kütüphaneler için API ve SDK entegrasyonu ve API dokümantasyonu sayfalarını kullanabilirsiniz.
Teknik gereksinimler
WooCommerce entegrasyonu için teknik gereksinimler
| Gereksinim |
Detay |
| WordPress |
5.0 veya üzeri |
| WooCommerce |
5.0 veya üzeri |
| PHP |
Güvenlik desteği süren bir sürüm; eklentinin desteklediği PHP sürümü dokümantasyonda yazar |
| SSL Sertifikası |
Gerekli (HTTPS) |
| Ödeme kuruluşu hesabı |
Başvuru sonrası açılır (başvuru ücretsizdir) |
Sürüm bilgileri genel çerçevedir; kesin gereksinimler ve desteklenen sürümler, hesabınız açıldığında iletilen dokümantasyonda belirtilir.