WooCommerce’e iyzico Nasıl Kurulur? 2026 Adım Adım Rehber

WooCommerce mağazanızda iyzico ile kart tahsilatı almak istiyorsanız, doğru yapılandırılmış bir ödeme eklentisine ihtiyacınız var. Bu rehberde WooCommerce iyzico kurulumu sürecini baştan sona, üye işyeri başvurusundan API anahtarlarına, test modundan 3D Secure ve canlıya geçişe kadar adım adım anlatıyoruz. Örneklerimizde ücretsiz Invum POS Lite eklentisini kullanacağız; çünkü iyzico gateway’ini lisans gerektirmeden, 3D Secure ve saklı kart desteğiyle birlikte sunuyor.

Başlamadan önce: gereksinimler

Kuruluma geçmeden önce mağazanızın temel altyapısının güncel olduğundan emin olun. iyzico entegrasyonu ve Invum POS eklentisi aşağıdaki minimum sürümlerle çalışır:

• WordPress 6.6 veya üzeri
• WooCommerce 9.0 veya üzeri (HPOS / yüksek performanslı sipariş depolama uyumlu)
• PHP 8.1 veya üzeri
• Geçerli bir SSL sertifikası (HTTPS) — ödeme sayfaları için zorunlu
• iyzico üye işyeri hesabı (sözleşmeli, canlı) ve test için bir sandbox hesabı

Bu değerleri WordPress panelinizde Araçlar → Site Sağlığı → Bilgi bölümünden kontrol edebilirsiniz. Eksik bir şey varsa hosting sağlayıcınızla PHP sürümünü güncelleyerek başlamanız en sağlıklısıdır.

1. iyzico üye işyeri ve API anahtarını alma

iyzico ile ödeme almak için önce bir üye işyeri hesabına ihtiyacınız var. Kurulumun ilk aşaması API anahtarlarını edinmektir:

• Sandbox (test) hesabı: sandbox-merchant.iyzipay.com adresinden ücretsiz bir test hesabı oluşturun. Bu hesap gerçek para hareketi olmadan tüm akışı denemenizi sağlar.
• Canlı hesap: iyzico ile ticari sözleşmenizi tamamlayıp hesabınız onaylandığında merchant.iyzipay.com paneline erişirsiniz.
• Panelde Ayarlar → API Anahtarları bölümüne gidin. Burada iki değer bulacaksınız: API Key ve Secret Key. Bu ikisi entegrasyonun anahtarıdır.

Sandbox ve canlı ortamın anahtarları ayrıdır ve birbirinin yerine çalışmaz. Test aşamasında sandbox anahtarlarını, canlıya geçtiğinizde canlı anahtarları kullanacaksınız. Anahtarları güvenli bir yerde saklayın; bunlar mağazanızın tahsilat yetkisini taşır.

2. Invum POS Lite eklentisini WordPress’e kurma

API anahtarlarını girmek için bir gateway eklentisine ihtiyacınız var. Ücretsiz Invum POS Lite bu iş için yeterlidir ve iyzico’yu tam olarak destekler. Kurulum şöyle:

• WordPress yönetim panelinizde Eklentiler → Yeni Ekle yolunu izleyin.
• Arama kutusuna eklentinin adını yazın veya eklenti ZIP dosyasını Eklenti Yükle ile karşıya aktarın.
• Kurulum bittikten sonra Etkinleştir butonuna basın.
• Etkinleştirmenin ardından yönetim menüsünde Invum POS panosunu göreceksiniz. Buradan kurulu ödeme entegrasyonlarını tek ekrandan yönetebilirsiniz.

Invum POS Lite, iyzico ve PayTR gateway’lerini lisans gerektirmeden sunar; 3D Secure, saklı kart, çoklu hesap desteği ve yönetim panosu ücretsiz sürüme dahildir. Param, 12 NestPay bankası, Garanti BBVA, Yapı Kredi Posnet, VakıfBank, Craftgate ve Moka gibi toplam 21 entegrasyondan oluşan geniş listeye ihtiyaç duyarsanız bunlar ayrı Invum POS Pro eklentisiyle açılır. iyzico kurulumu için Lite sürümü tamamen yeterlidir.

3. iyzico gateway’ini etkinleştirme ve API anahtarlarını girme

Bu adım WooCommerce iyzico kurulumu sürecinin kalbidir. Eklenti kurulduktan sonra iyzico’yu bir ödeme yöntemi olarak tanımlayacağız:

• WooCommerce → Ayarlar → Ödemeler sekmesine gidin.
• Listede iyzico gateway’ini bulun ve etkinleştirme anahtarını açın.
• Ayarlarına girmek için Yönet (Manage) bağlantısına tıklayın.
• Açılan ekranda API Key ve Secret Key alanlarına iyzico panelinden aldığınız değerleri yapıştırın.
• Müşterinin ödeme sayfasında göreceği başlık ve açıklama metnini düzenleyin (örneğin “Kredi/Banka Kartı ile Öde”).
• Ayarları kaydedin.

Invum POS, girdiğiniz API Key ve Secret Key değerlerini veritabanında AES-256-CBC ile şifreleyerek saklar. Ayrıca kart numarası ve CVV gibi hassas veriler asla düz metin olarak tutulmaz ve loglara yazılmaz. Bu, hem güvenlik hem de PCI-DSS uyumluluğu açısından önemlidir.

4. Test modunda deneme siparişi verme

Canlıya geçmeden önce entegrasyonun uçtan uca çalıştığını doğrulamak şarttır. iyzico ayar ekranında Test Modu (Sandbox) seçeneğini etkinleştirin ve sandbox API anahtarlarını girin. Ardından:

• Mağazanızda ucuz bir ürünü sepete ekleyip ödeme sayfasına gidin.
• Ödeme yöntemi olarak iyzico’yu seçin.
• iyzico’nun sağladığı test kartlarından birini kullanın; örneğin 5528790000000008 gibi bir kart başarılı işlem üretir. (Gerçek kart kullanmayın.)
• İşlem tamamlandığında siparişin WooCommerce’te “işleme alındı” veya “tamamlandı” durumuna geçtiğini doğrulayın.

Sipariş durumu doğru güncelleniyorsa entegrasyonunuz çalışıyor demektir. Bir sorun görürseniz WooCommerce’in sipariş notlarında ve Invum POS panosundaki durum kayıtlarında ipucu bulabilirsiniz.

5. 3D Secure ve canlıya geçiş

Türkiye’de kart işlemleri için 3D Secure doğrulaması standarttır ve dolandırıcılığa karşı ek koruma sağlar. Invum POS’un iyzico gateway’i 3D Secure akışını destekler: müşteri kart bilgisini girdikten sonra bankasının doğrulama adımına yönlendirilir, onay sonrası sipariş tamamlanır. Bu davranışı ayar ekranından etkinleştirebilirsiniz.

Testler başarılıysa canlıya geçiş için şu adımları izleyin:

• iyzico ayar ekranında Test Modu’nu kapatın.
• Sandbox anahtarlarını silip yerine canlı API Key ve Secret Key değerlerini girin.
• Ayarları kaydedin ve mağazanızda düşük tutarlı bir gerçek kartla küçük bir deneme işlemi yapın.
• İşlem başarılıysa dilerseniz bu siparişi iyzico panelinden iade edebilirsiniz.

Sık karşılaşılan hatalar ve çözümleri

• “Geçersiz imza / yetkilendirme hatası”: API Key veya Secret Key yanlış ya da eksik yapıştırılmış olabilir. Anahtarları kopyalarken baştaki/sondaki boşluklara dikkat edin.
• Sandbox anahtarı canlıda çalışmıyor: Test Modu kapalıyken sandbox anahtarı kullanmak veya tam tersi en sık yapılan hatadır. Ortam ile anahtarı eşleştirin.
• Ödeme sayfası açılmıyor / yönlendirme başarısız: Genellikle SSL/HTTPS eksikliği veya hatalı callback adresidir. Sitenizin tamamen HTTPS üzerinden çalıştığından emin olun.
• Sipariş “beklemede” kalıyor: 3D Secure doğrulaması yarıda kesilmiş olabilir; müşteriden tekrar denemesini isteyin ve callback ayarlarını kontrol edin.

Daha ayrıntılı yapılandırma bilgisi için iyzico entegrasyon kılavuzumuza göz atabilir, sıkça sorulan sorulara SSS sayfamızdan ulaşabilirsiniz.

Özet ve sonraki adım

WooCommerce iyzico kurulumu aslında birkaç net adımdan oluşur: iyzico panelinden API anahtarlarını alın, Invum POS Lite’ı kurun, iyzico gateway’ini etkinleştirip anahtarları girin, sandbox’ta test edin ve 3D Secure ile canlıya geçin. Kart verilerinin şifreli saklanması ve loglanmaması sayesinde güvenlik tarafını da baştan doğru kurmuş olursunuz.

Başlamak için hiçbir ücret ödemeniz gerekmez; ücretsiz Invum POS Lite ile iyzico’yu bugün mağazanıza ekleyebilirsiniz. İleride Param, NestPay bankaları veya Garanti BBVA gibi ek entegrasyonlara ihtiyaç duyarsanız Invum POS planlarını inceleyerek Pro sürüme geçebilirsiniz.