WooCommerce nedir?
WooCommerce, WordPress üzerine kurulan açık kaynaklı bir e-ticaret platformudur. Türkiye’de binlerce işletme küçük butikten büyük markaya kadar mağazasını WooCommerce ile yönetiyor — esnek tema yapısı, geniş eklenti ekosistemi ve veri sahipliği avantajları ile. Ödeme tarafında ise WooCommerce’in kendi varsayılan ödeme yöntemleri Türkiye’deki banka altyapısına ve BKM kurallarına uymadığı için yerel bir sanal POS sağlayıcısı şart.
iyzico nedir?
iyzico, Türkiye’de BKM lisanslı en yaygın ödeme altyapılarından biridir. Banka anlaşması gerektirmeden kredi kartı, banka kartı, taksitli ödeme ve marketplace (alt üye işyeri) ödeme dağıtımı sunar. Yeni kurulan e-ticaret siteleri ve pazaryeri modelli platformlar arasında popüler olmasının başlıca sebebi, başvuruyu onayladıktan sonra nispeten hızlı canlıya alınabilmesi.
Neden WooCommerce ve iyzico entegre edilmeli?
WooCommerce mağazanızda kart ile ödeme alabilmek için BKM uyumlu bir sanal POS sağlayıcısı zorunlu. iyzico’nun WooCommerce için resmi bir eklentisi olması, bu kombinasyonu yerel pazardaki birçok araca göre daha kolay başlatılabilir kılıyor. Doğru kurulmuş bir entegrasyon şunları sağlıyor:
- BKM uyumlu kart ödemesi: Visa, Mastercard ve Troy kartlarıyla güvenli ödeme; kart bilgisi sizin sunucunuzda saklanmaz.
- 3D Secure uyumu: Türkiye’de online kart ödemelerinde yasal zorunluluk olan 3D Secure WooCommerce checkout akışına yerleşir.
- Banka bazlı taksit: 2-12 arası taksit seçenekleri checkout’ta gösterilir, banka bazında doğru oranlarla.
- Otomatik sipariş statü akışı: Ödeme başarılı olduğunda WooCommerce siparişi otomatik ‘işleniyor’ statüsüne geçer, stok düşülür.
- Tek altyapı, tek panel: Tüm kart ödemeleri iyzico panelinde toplanır; iade ve mutabakat tek yerden yürür.
Asıl mesele eklentinin kurulması değil; eklentinin tek başına çözmediği 3D Secure dönüş akışı, sipariş statü eşleşmesi ve taksit görünümünün doğru yapılandırılmasıdır.
WooCommerce iyzico entegrasyonu nasıl yapılır?
Zeisoft olarak WooCommerce-iyzico kurulumunu uçtan uca yapıyoruz. iyzico’nun resmi eklentisi var, ama kurulumun değer yarattığı yer eklentinin yapmadığı kısımlar:
- Mevcut mağazanızı, sipariş hacminizi ve checkout’taki diğer eklentileri (kargo, kupon, çoklu para birimi) inceliyoruz — çakışma riskini baştan görüyoruz.
- iyzico resmi WooCommerce eklentisini kuruyor, sandbox API anahtarlarıyla test ortamını ayağa kaldırıyoruz.
- 3D Secure dönüş (callback) URL’sini ve iyzico bildirimlerini WooCommerce sipariş statülerine doğru eşliyoruz — ödeme başarılıysa sipariş ‘işleniyor’a, başarısızsa ‘başarısız’a geçsin.
- Banka bazlı taksit kuralları, minimum sepet tutarı ve faiz/fark gösterimini checkout’ta yapılandırıyoruz.
- Sandbox’ta tek çekim, taksit ve 3D Secure senaryolarını test ediyor, ardından production anahtarlarına kontrollü geçiyoruz.
- Canlı geçişten sonra ilk gerçek işlemleri birlikte doğruluyor, ilk hafta yoğun izleme yapıyoruz.
- Bakım anlaşmasıyla iyzico, WooCommerce ve WordPress güncellemelerini proaktif takip ediyoruz — sürüm çakışmaları size kalmıyor.
Sıkça karşılaşılan sorunlar
Sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Ödeme alındı, sipariş ‘beklemede’ takıldı. 3D Secure dönüşünde callback/bildirim URL’si yanlış ayarlandığında, ödeme iyzico panelinde başarılı görünür ama WooCommerce sipariş statüsünü çeviremez; müşteri parayı öder, sipariş işleme alınmaz. Çözüm: callback URL’sini ve sipariş statü eşleşmesini kurulumda test ederek netleştirmek.
- Canlıda hâlâ sandbox anahtarı. Test anahtarlarından production’a geçiş unutulduğunda gerçek ödemeler test ortamına gider, hesaba para geçmez. Çözüm: canlı geçişi kontrol listesiyle yapıp ilk gerçek işlemleri birlikte doğrulamak.
- Eklenti çakışması. iyzico eklentisi, checkout’u özelleştiren başka bir eklentiyle (kargo, kupon, AJAX checkout) çakıştığında ödeme adımı kilitlenir. Çözüm: kurulum öncesi mevcut eklenti yığınını inceleyip çakışan davranışları izole etmek.
- Taksit checkout’ta yanlış görünüyor. Banka bazlı taksit oranları ve minimum sepet tutarı tanımlanmadığında müşteriye yanlış taksit veya faiz gösterilir, ödeme adımında güven kaybı olur. Çözüm: kurulum başında banka-taksit eşleme kurallarını tanımlamak.
Dördü de kurulumda doğru yapılandırmayla önlenebilir; sonradan canlı mağazada düzeltmek hem gelir kaybı hem ekstra iş yükü yaratır.