WooCommerce’e iyzico Nasıl Bağlanır? Adım Adım Entegrasyon

6 Ağustos 2026 · adaptedijital

Net cevap: iyzico’yu WooCommerce’e bağlamak dört aşamalık bir iştir — (1) iyzico satıcı hesabı açıp evrak onayını tamamlarsınız, (2) resmî iyzico WooCommerce eklentisini kurarsınız, (3) panelden aldığınız API Key + Secret Key ikilisini eklenti ayarlarına işlersiniz, (4) önce sandbox (deneme) ortamında test ödemesi yapar, geçince canlı moda alırsınız. Teknik kısım yarım saatliktir; süreyi belirleyen genellikle evrak onay süreci ve test disiplinidir.

Bu rehber dört aşamayı ekran sırasıyla anlatır, 3D Secure ve taksit ayarlarını gösterir, canlıya geçiş öncesi kontrol listesini verir. Ödeme altyapılarının genel kıyası ödeme rehberinde, mağazanın bütünü WooCommerce sayfamızda.

Aşama 1: iyzico Hesabı ve Onay

Entegrasyonun en uzun kalemi kod değil, evraktır — erken başlayın.

Başvuru ve Belgeler

iyzico satıcı başvurusunda vergi levhası, imza sirküleri/beyannamesi ve banka bilgileri istenir: şahıs şirketinde süreç daha kısa, limited-anonim yapıda birkaç iş günü sürebilir.

Web Sitesi Ön Şartları

Onay ekibi sitenize bakar: iletişim bilgileri, mesafeli satış sözleşmesi, iade-teslimat sayfaları ve SSL görünür olmalı — eksik sayfa, onayı bekleten bir numaralı sebeptir.

Komisyon ve Para Akışı

Onayla birlikte komisyon oranlarınız ve hakediş takviminiz netleşir: bu iki bilgiyi fiyatlamanıza yansıtmadan mağazayı açmayın.

Kaynak ve resmî belge: iyzico

Aşama 2: Resmî Eklentiyi Kurmak

Tek güvenli kaynak: resmî eklenti — üçüncü el paketlere gerek yok.

Kurulum Yolu

Eklentiler → Yeni Ekle → ‘iyzico’ araması → resmî ‘iyzico WooCommerce’ eklentisi: kur ve etkinleştir; sürüm ve son güncelleme tarihine bakmayı ihmal etmeyin.

Ayar Ekranının Yeri

WooCommerce → Ayarlar → Ödemeler sekmesinde iyzico satırı belirir: ‘Yönet’ ile ayar ekranına girilir — ödeme yöntemini burada aktifleştireceksiniz.

Çakışma Kontrolü

Başka ödeme eklentileri veya eski iyzico kalıntıları varsa temizleyin: aynı işi yapan iki eklenti, ödeme sayfasında sessiz hatalar üretir.

Aşama 3: API Anahtarları ve Temel Ayarlar

İki anahtar, bir köprü: mağaza ile iyzico burada el sıkışır.

Anahtarları Almak

iyzico panelinde Ayarlar → API Anahtarları bölümünden API Key ve Secret Key kopyalanır: canlı ve sandbox anahtarları AYRIDIR — hangi moddaysanız o çifti kullanın.

Eklentiye İşlemek

Anahtar çiftini eklenti ayarındaki alanlara yapıştırın, ödeme başlığını Türkçe ve net yazın (‘Kredi/Banka Kartı ile Öde’): sepette müşteri bu başlığı görür.

3D Secure ve Taksit

3D’yi açık tutun (hem güvenlik hem banka onay oranı için); taksit seçeneklerini iyzico panelinden yönetin — taksit tablosunun üründe görünmesi dönüşümü ölçülür biçimde artırır.

Aşama 4: Sandbox Testi

Test etmeden açılan ödeme kanalı, kampanya günü patlayan kanaldır.

Test Modunu Açmak

Eklentide sandbox/test modunu seçip sandbox anahtar çiftini girin: artık gerçek para akmaz, akış birebir çalışır.

Test Kartlarıyla Prova

iyzico’nun yayınladığı test kartlarıyla üç senaryo koşun: başarılı ödeme, 3D doğrulama, başarısız kart — üçünün de sipariş durumuna doğru yansıdığını görün.

Sipariş Akışı Kontrolü

Test siparişinin WooCommerce’te ‘işleniyor’a düştüğünü, mail bildirimlerinin gittiğini ve iyzico panelinde işlemin göründüğünü doğrulayın: üç nokta da yeşilse köprü sağlamdır.

Canlıya Geçiş ve İlk Gün

Sandbox’tan canlıya üç dakikalık ama disiplinli bir geçiş.

Anahtar Değişimi

Test modunu kapatın, CANLI anahtar çiftini girin, kaydedin: en sık hata, sandbox anahtarıyla canlıya çıkmaktır — ‘ödeme alınamıyor’ şikâyetinin klasiği.

Gerçek Kartla Mikro Test

Kendi kartınızla düşük tutarlı gerçek bir sipariş verin, ardından iyzico panelinden iade edin: canlı akışın kanıtı, bu tek işlemdir.

İlk Hafta İzlemesi

İlk hafta ödeme hatalarını günlük kontrol edin (WooCommerce → Durum → Günlükler + iyzico panel): erken yakalanan sorun, kaybedilmemiş ciro demektir.

Sık Sorunlar ve Çözüm Haritası

Sahada en çok görülen üç arıza, üç kestirme çözüm.

‘Geçersiz İmza / Anahtar’ Hatası

Yüzde doksan anahtar karışıklığıdır: mod ile anahtar çiftinin eşleştiğini, kopyalarken boşluk gelmediğini kontrol edin.

Ödeme Sonrası Sipariş Güncellenmiyor

Callback (geri bildirim) adresi engelleniyor olabilir: güvenlik eklentinizde ve sunucu tarafında iyzico isteklerine izin verildiğini doğrulayın — güvenlik ayarları ile ödeme istisnaları birlikte düşünülür.

Kurulumu Devretmek

Bu adımlarla uğraşmak istemeyene dürüst yol: paketlerimizde iyzico kurulumu ve üç senaryolu testi standarttır — fiyat sayfası kapsamı, iletişim hattı sorularınızı bekler.

Sahadan Notlar

Saha notu: iyzico kurulumlarında takvimi hep evrak belirler: teknik iş yarım saat, onay süreci günler. Bu yüzden mağaza projelerinde ilk günün işi tasarım değil, ödeme başvurusudur — site biterken onay da biter, açılış beklemez.

Onay ipucu: Onay ekibinin baktığı sayfaları (mesafeli satış, iade, teslimat, iletişim) şablondan değil kendi bilgilerinizle doldurun: kopyala-yapıştır metinlerdeki yabancı firma adları, onay sürecinin en gereksiz gecikme sebebidir.

Anahtar disiplini: Dört anahtarı (canlı çift + sandbox çift) tek güvenli notta, etiketleyerek saklayın: ‘hangisi canlıydı?’ karışıklığı, canlıya sandbox anahtarıyla çıkma hatasının anasıdır. Etiketli not, üç dakikalık sigortadır.

Test tecrübesi: Üç senaryolu provada başarısız kart testini atlamayın: mağazaların çoğu ‘başarılı ödeme’ testiyle yetinir, ilk gerçek red geldiğinde sipariş durumları karışır. Reddin de düzgün işlendiğini görmek, testin yarısıdır.

Geçiş uyarısı: Mikro test iadesini iyzico panelinden yapın ve iadenin WooCommerce’e yansımasını da kontrol edin: iade akışı, kimsenin test etmediği ama ilk müşteri iadesinde herkesin aradığı akıştır.

İzleme notu: İlk haftadan sonra izlemeyi bırakmayın, seyreltip aylık rutine bağlayın: ödeme başarı oranınızı iyzico panelinden ayda bir okuyun. Oran düşüyorsa sorun çoğu zaman 3D akışında veya mobil sepettedir — erken fark eden, ciroyu erken kurtarır.

Kısa Sözlük

Sandbox: Gerçek para akmayan deneme ortamı; canlı öncesi prova sahası.

API Anahtar Çifti: Mağaza ile iyzico’yu eşleştiren Key + Secret ikilisi.

3D Secure: Bankanın SMS/uygulama doğrulamalı güvenli ödeme katmanı.

Callback: Ödeme sonucunun iyzico’dan mağazaya geri bildirimi.

Hızlı Özet

iyzico entegrasyonu dört aşamadır: hesap + evrak onayı (en uzun kalem — erken başlayın; site ön şartları: sözleşme-iade-iletişim sayfaları ve SSL), resmî eklenti kurulumu, API anahtar çiftinin işlenmesi + 3D ve taksit ayarı, sandbox’ta üç senaryolu test (başarılı-3D-red). Canlıya geçişte anahtar çifti değiştirilir, gerçek kartla mikro test + iade koşulur, ilk hafta günlük izlenir. Sık hatalar: mod-anahtar uyumsuzluğu ve engellenen callback.

Sıradaki Adım

Bugün iki iş: iyzico başvurunuzu yapın (evrak saati şimdiden işlesin) ve sitenizdeki dört ön şart sayfasını kontrol edin. Eklenti kurulumuna geçtiğinizde bu rehber ekran ekran yanınızda; devretmek isterseniz kurulum+test paketlerimizde standart — kapsam burada, sorular burada.

Sık Sorulan Sorular

iyzico’yu WooCommerce’e bağlamak zor mu?

Teknik kısmı değil: resmî eklenti + API anahtar çifti + ayarlar yarım saatlik iştir. Süreyi belirleyen, satıcı hesabının evrak onayı ve test disiplinidir. Dört aşamayı sırayla izleyen herkes bağlantıyı kurabilir; kritik kural sandbox’ta üç senaryoyu test etmeden canlıya çıkmamaktır.

iyzico onayı için sitemde neler olmalı?

Görünür iletişim bilgileri, mesafeli satış sözleşmesi, iade-teslimat koşulları sayfaları ve SSL. Onay ekibi siteyi inceler; eksik veya şablondan kopyalanmış sayfalar sürecin en sık gecikme sebebidir — metinleri kendi firma bilgilerinizle doldurun.

Ödeme alınamıyor, en olası sebep nedir?

Mod-anahtar uyumsuzluğu: canlı modda sandbox anahtarı (veya tersi) kullanmak. İkinci aday, güvenlik katmanının iyzico callback isteklerini engellemesi. Anahtar çiftini ve güvenlik istisnalarını kontrol edin; günlükler (WooCommerce → Durum) hatanın adresini söyler.

← Tüm Yazılar Profesyonel Destek Alın