Entegrasyon

WooCommerce Mağazanızda Güvenli Ödeme Alın

WooCommerce, WordPress üzerinde çalışan açık kaynaklı bir e-ticaret eklentisidir; ürün, sepet ve sipariş yönetimini WordPress yönetim paneline taşır. Ödeme adımı bu yapıda ayrı bir ödeme yöntemi olarak tanımlanır. Aşağıdaki bölümler, mağazanıza sanal POS eklerken izlenen yolu, panelde yapılan ayarları ve ödemenin siparişe nasıl işlendiğini anlatır.

  • Eklenti / SDK veya doğrudan API
  • Test ortamında deneyip canlıya geçiş
  • Dokümantasyon hesap açılışında

Eklenti dosyası ve anahtarlar, hesabınız açıldıktan sonra tanımlanır.

Entegrasyon araçları ve API, hesabınızın açıldığı ödeme kuruluşunun çözümüne aittir; sanalpos.com başvuruyu koordine eder.

WooCommerce mağazanızda kartla ödeme: hangi aşamadasınız?

Dört adım

WooCommerce Sanal POS Kurulum Adımları

Başvurudan canlı ödemeye giden sıra.

01

Başvurun ve hesabınız açılsın.

Başvuru formunu doldurduğunuzda satış yönteminiz ve mağazanız değerlendirilir. Test ve canlı anahtarlarınız, hesabınız açıldığında ayrı ayrı tanımlanır; anahtarlar bu adımdan önce verilmez.

02

Eklentiyi kurun.

WordPress yönetim panelinde Eklentiler bölümünden eklenti dosyasını yükleyip etkinleştirirsiniz. Eklenti veya modül dosyası ile adı, hesabınız açıldığında iletilen dokümantasyonda belirtilir; eklenti kullanmadan doğrudan API ile ilerlemek de mümkündür.

03

Ödeme yöntemini ayarlayın.

WooCommerce → Ayarlar → Ödemeler bölümünde ödeme yöntemini etkinleştirir, anahtarlarınızı girer, 3D Secure seçeneğini ve bildirim (callback / webhook) adresini tanımlarsınız. Ayar adları eklentinin sürümüne göre değişebilir.

04

Test edip canlıya alın.

Test anahtarlarıyla sepetten ödemeye kadar akışı çalıştırın; başarılı ödeme, başarısız ödeme ve 3D Secure adımını deneyin. Doğruladıktan sonra yalnız ortam ve anahtar değerlerini canlıya çevirirsiniz.

Kurulum süresi mağazanızın yapısına, tema ve eklenti düzeninize ve seçilen çözüme göre değişir.

Ücretsiz Başvuru →

Başvuru ücretsizdir. Teklifi inceleyip karar verin.

WooCommerce entegrasyonu

Mağazanızda ödeme akışının parçaları.

Aşağıdaki üç başlık, WooCommerce tarafında yapılandırdığınız ana bölümleri özetler. Hangi seçeneklerin hesabınıza tanımlı olacağı, çalışılan ödeme kuruluşunun çözümüne göre belirlenir.

Kart ve taksit seçenekleri

  • Ödeme adımında kart ile ödeme
  • Taksit seçeneklerinin sepette gösterimi
  • Kart BIN bilgisine göre seçenek listesi

Desteklenen kart aileleri ve taksit sayıları bankaya ve seçilen çözüme göre değişir.

Güvenlik ve doğrulama

  • 3D Secure yönlendirmeli akış
  • Mağazada HTTPS zorunluluğu
  • Anahtarların sunucu tarafında tutulması

Kart verisini WooCommerce veritabanınızda saklamayın; kart saklama gerekiyorsa token kullanın.

Sipariş takibi ve raporlar

  • Ödeme sonucunun siparişe işlenmesi
  • Sunucu bildirimiyle durum güncelleme
  • Panelden işlem ve iade kayıtları

İade ve sipariş durumu güncellemesinin panelden mi yoksa program arayüzünden mi yapılacağı seçilen çözüme göre sunulabilir.

Eklenti veya modül dosyası ile paket adı, hesabınız açıldığında iletilen dokümantasyonda belirtilir.

Ücretsiz Başvuru →Test siparişlerinde ve günlük kayıtlarında gerçek kart ya da müşteri verisi tutmayın. Ayrıntı için: KVKK Aydınlatma Metni.
Sık sorulan sorular

WooCommerce entegrasyonu hakkında.

WooCommerce sanal POS entegrasyonu ne kadar sürer?

Süre; mağazanızın yapısına, temanıza, kullandığınız diğer eklentilere ve seçilen ödeme kuruluşunun çözümüne göre değişir. Sıra bellidir: başvuru ve hesap açılışı, eklenti kurulumu, ödeme yöntemi ayarları, test ve canlıya geçiş. Adım adım anlatım için entegrasyon kılavuzu sayfasına bakın.

WooCommerce mağazamda taksitli ödeme sunabilir miyim?

Taksitli ödeme, WooCommerce ödeme adımında sunulabilen seçeneklerden biridir. Taksit sayıları, hangi kartlarda geçerli olduğu ve oranlar; bankaya, kart tipine ve hesabınızın açıldığı ödeme kuruluşunun çözümüne göre değişir. Hesabınıza tanımlı seçenekler teklifinizde ve dokümantasyonunuzda yazar.

WooCommerce entegrasyonu için teknik bilgi gerekli mi?

Eklenti kurulumu ve ödeme yöntemi ayarları WordPress yönetim panelinden yapılır; temel WordPress ve WooCommerce kullanımı çoğu kurulum için yeterlidir. Kendi ödeme akışınızı yazmak isterseniz doğrudan API ile de ilerleyebilirsiniz; ayrıntı için API ve SDK entegrasyonu sayfasına bakın.

Mevcut WooCommerce ödeme yöntemlerimi değiştirmem gerekir mi?

Hayır. WooCommerce birden çok ödeme yöntemini birlikte gösterebilir; yeni yöntemi ek bir seçenek olarak ekleyebilir ya da sıralamada öne alabilirsiniz. Ödemeler ekranındaki sırayı ve hangi yöntemin açık olacağını kendiniz belirlersiniz.

WooCommerce sanal POS entegrasyonunda sandbox (test) ortamı var mı?

Ayarlarınızı canlıya almadan denemek için ayrı anahtarlarla çalışan bir test ortamı kullanılır; test ortamında gerçek para hareketi olmaz. Erişim, kapsam ve varsa ücreti hesabınız açıldığında tanımlanır. Ayrıntı için test ortamı (sandbox) sayfasına bakın.

Entegrasyona başlayın

Önce başvurunuzu tamamlayalım.

Eklenti dosyası, dokümantasyon ve anahtarlar hesap açılışıyla tanımlanır. Ön değerlendirme için başvuru formunu doldurun.

Başvuru ücretsizdir. Teklifi inceleyip karar verin.

Başvuru nasıl ilerler? →

Teknik sorularınız için:0212 909 00 87ya da WhatsApp’tan yazın

Ayrıntılar

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.

Ara WhatsApp Ücretsiz Başvur →