iyzico PayTR Entegrasyonu ve Testi

Kısa cevap: iyzico PayTR entegrasyonu eklentiyi açmakla bitmez. Ödeme sonucu, mağaza sunucusuna gelen bildirimle doğrulanır (iyzico’da webhook, PayTR’de Bildirim URL); sipariş ancak bundan sonra Hazırlanıyor durumuna geçer. İade, ödeme panelinden değil sipariş ekranından aynı sağlayıcıya gönderilir ve bütün akış canlıya çıkmadan test modunda denenir. WooCommerce’te iki sağlayıcının da resmi eklentisi vardır; Shopify’da ise ikisi üçüncü taraf ödeme sağlayıcısı olarak bağlanır.

Bir tekstil markası için ödeme adımı yalnızca kart bilgisinin girildiği ekran değildir. Ödeme alınmalı, sipariş doğru duruma geçmeli, beden ve renk stoğu güncellenmeli, müşteri beden değişimi istediğinde iade kaydı ödeme kaydıyla eşleşmelidir. Zincirin bir halkası eksikse en uygun sanal POS bile operasyonda pahalıya gelir.

Türkiye’de 2025 yılında e-ticaret ödemelerinin %62,5’i kartla yapıldı; kartlı işlemlerin %64,1’inde 3D Secure kullanıldı. Ticaret Bakanlığı’nın 2025 e-ticaret raporu, giyim, ayakkabı ve aksesuarın 428,7 milyar TL ile en büyük e-ticaret kategorisi olduğunu da gösteriyor.

Bu yazı, iyzico ve PayTR’yi WooCommerce ve Shopify mağazasına bağlamanın adımlarını, ödeme bildiriminin siparişe nasıl işlenmesi gerektiğini, iade ve kısmi iadeyi ve canlıya çıkmadan önce yapılacak testleri anlatıyor. Kaynaklar Ekim 2026’da kontrol edildi.

Öne Çıkanlar

• WooCommerce’te iyzico ve PayTR’nin resmi eklentileri vardır. Türkiye Shopify Payments’ın desteklendiği ülkeler arasında olmadığından Shopify mağazası ikisini üçüncü taraf ödeme sağlayıcısı olarak bağlar.
• Teşekkür sayfası ödeme kanıtı değildir. Sipariş, iyzico webhook’u veya PayTR Bildirim URL’si doğrulandıktan sonra Hazırlanıyor durumuna geçmelidir.
• İade sipariş ekranından gönderilmelidir. PayTR, kendi panelinden yapılan iadenin WooCommerce veya Shopify siparişine yansımadığını belirtir.
• Cayma hakkında para iadesi, müşterinin kullandığı ödeme aracına uygun olarak tek seferde ve masrafsız yapılır; taksitli satışın iadesi taksit taksit ödenmez.
• iyzico’nun test ortamı ayrı bir panel ve ayrı API anahtarlarıyla çalışır. Canlı anahtarlar, panel ve işlem geçmişi ajansın değil markanın hesabında kalmalıdır.

iyzico PayTR entegrasyonu neden eklentiden fazlasıdır?

Giyim satışında ödeme, ürün sayfasından ayrı düşünülemez. Müşteri siyah, M beden bir ürünü sepete ekler, kupon kullanır, ücretsiz kargo sınırını geçer, taksit seçeneğini görür ve 3D Secure ekranına gider. Mağazanın ödeme kuruluşuna ilettiği toplam, sepetteki toplamla birebir aynı olmalıdır.

Ödeme başarılı olduğunda ikinci aşama başlar: sipariş durumu değişir, stok düşer, sipariş e-postası gider, kargo hazırlığı başlar. Bunların hepsi, ödemenin sunucu tarafında doğrulanmasına bağlıdır.

Ödeme altyapısı, kart bilgisinin girildiği ekran değil; siparişin para hareketiyle doğru eşleşmesini sağlayan akıştır.

Varsayımsal bir örnek: Sezon indiriminde müşteri aynı elbiseyi ilk denemede kart hatası nedeniyle ödeyemiyor, ikinci denemede ödüyor. Mağazada iki sipariş oluşuyor. Bildirim doğrulanıp siparişe işlenmiyorsa ekip hangisinin ödendiğini panelden tek tek arar; ödenmemiş sipariş de ürünü bir süre stokta tutar. Sorun iyzico’da ya da PayTR’de değildir. Bildirim, sipariş durumu ve stok kuralı baştan birlikte kurulmamıştır.

Başvuru: entegrasyondan önce hazır olması gerekenler

Sanal POS başvurusu, eklenti kurulumundan ayrı bir süreçtir ve mağazanın yayına hazır olmasını gerektirir. iyzico’nun başvuru koşulları şirket başvurusunda imza sirküleri, vergi levhası ve ortakların kimlik fotokopilerini ister. Site; ürün ve fiyat bilgileriyle kullanıma hazır olmalı, gizlilik politikası, mesafeli satış sözleşmesi, teslimat ve iade koşulları ile hakkımızda sayfası yayında olmalı, ödeme sayfasında SSL sertifikası bulunmalıdır. Belgeler sağlayıcıya ve şirket türüne göre değişir; güncel listeyi başvuru ekranından kontrol edin.

iyzico (İyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.) ve PayTR (Paytr Ödeme ve Elektronik Para Kuruluşu A.Ş.), TCMB’nin elektronik para kuruluşları listesinde yer alır. Hangisiyle çalışırsanız çalışın, Mesafeli Sözleşmeler Yönetmeliği md. 6/2-b gereği kabul ettiğiniz ödeme araçlarını ve varsa gönderim kısıtlarını, en geç müşteri siparişi vermeden önce açıkça göstermelisiniz.

WooCommerce iyzico entegrasyonu

iyzico’nun resmi eklentisi WordPress eklenti dizininde iyzico-woocommerce adıyla bulunur. iyzico’nun WooCommerce dokümantasyonuna göre kurulum şöyledir:

1. Eklentiler › Yeni Ekle altında eklentiyi arayın, yükleyin ve etkinleştirin.
2. WooCommerce › Ayarlar › Ödemeler altında iyzico’yu açın.
3. iyzico panelinde Ayarlar › Firma Ayarları altındaki API anahtarı ve güvenlik anahtarını eklentideki ilgili alanlara yapıştırın.
4. Eklenti, gizli anahtar alanının altında sitenize özel bir webhook adresi gösterir. Bu adresi iyzico panelinde Ayarlar › Firma Ayarları › İşyeri Bildirimleri altındaki URL alanına girin, Ödeme bildirimlerini gönder seçeneğini açın ve kaydedin.

Webhook imza özelliği iyzico’dan ayrıca istenir (entegrasyon@iyzico.com). Dokümantasyon, eklentinin yalın, ek eklentisiz bir WooCommerce kurulumu üzerinde geliştirildiğini ve test edildiğini belirtir. Gerçek bir mağazada tema özelleştirmeleri, önbellek araçları, kupon sistemleri, kargo eklentileri ve checkout düzenlemeleri bulunur; bunların her biri ödeme adımını etkileyebilir. Hızlı checkout vadeden araçlar ve özel tema kodu bu yüzden canlıya alınmadan önce ödeme akışıyla birlikte test edilmelidir.

WooCommerce PayTR entegrasyonu

PayTR’nin resmi modülü PayTR Sanal POS WooCommerce – iFrame API adıyla WordPress eklenti panelinden kurulur. Modülde Mağaza No, Mağaza Parola ve Mağaza Gizli Anahtar bilgileri istenir; bu bilgiler PayTR Mağaza Paneli’ndeki mağaza bilgileri sayfasındadır (PayTR WordPress modül rehberi).

PayTR iFrame API akışı iki adımdan oluşur:

1. Mağazanın sunucusu, müşterinin sepet ve iletişim bilgileriyle ödeme formu için bir token alır.
2. Ödeme sonucu, mağazanın Bildirim URL’sine sunucudan sunucuya iletilir.

Bildirim URL’si PayTR Mağaza Paneli’nde Ayarlar › Bildirim URL Ayarı altında Değiştir ile tanımlanır; WooCommerce seçilir ve adres https ile girilir. İkinci adım eksikse ödeme bankada başarılı görünse bile sipariş güncellenmez. Müşteri ödeme sayfasına hiç dönmese de (bağlantı kesilir, tarayıcı kapanır, banka uygulamasına geçer) bildirim işlenebilmelidir.

PayTR, modülü test modunda kurup bir iki test işlemi yaptıktan sonra canlıya geçmeyi önerir. Ürün sayfasında taksit tablosu göstermek için PayTR’nin kendi PayTR Taksit Tablosu WooCommerce eklentisi vardır. Tekstil mağazasında taksit bilgisini yalnızca son ödeme ekranında göstermek çoğu zaman yeterli olmaz; müşteri, özellikle yüksek sepet tutarlarında, taksiti ödeme adımına gelmeden görmek ister.

Shopify’da iyzico ve PayTR nasıl bağlanır?

Türkiye, Shopify Payments’ın desteklendiği ülkeler arasında değildir. Türkiye’deki bir Shopify mağazası kart ödemesini iyzico veya PayTR gibi üçüncü taraf ödeme sağlayıcısıyla alır. Bu durumda sağlayıcının komisyonuna ek olarak Shopify’ın plana bağlı işlem ücreti de oluşur; maliyet karşılaştırmasını Shopify mı WooCommerce mi yazısında anlattık.

iyzico (iyzico Shopify rehberi):

1. Shopify yönetim panelinde Ayarlar › Ödemeler altında desteklenen ödeme yöntemlerinden Ödeme yöntemi ekle’yi seçin.
2. Sağlayıcıya göre arama yapıp “iyzico”yu bulun, Etkinleştir ve Bağlan ile uygulamayı yükleyin.
3. iyzico panelindeki API anahtarı ve güvenlik anahtarını girip bağlayın, ardından iyzico - Kredi ve Banka Kartları yöntemini etkinleştirin.

PayTR (PayTR Shopify rehberi):

1. PayTR Sanal POS uygulamasını Bağlan ile yükleyin ve açılan ekrandan 3 dakika içinde PayTR Mağaza Paneli’ne giriş yapın.
2. Shopify’da ödeme yöntemini etkinleştirin. Test modunda verilen siparişlerin notunda “Test True” görünür.
3. PayTR, Shopify’ın ödeme sayfası ayarlarında iletişim yöntemi olarak e-postanın seçilmesini ve ad soyad alanının zorunlu yapılmasını ister.

Shopify sepet ayrıntısını PayTR ile paylaşmadığı için PayTR panelinde ürünler yerine “Shopify Alışverişi” ifadesi görünür. Hangi ödemenin hangi siparişe ait olduğunu bu yüzden sipariş numarasıyla eşleştirirsiniz. Yurt dışı satışta tahsilat ve paranın hesabınıza aktarılması ayrı bir konudur; e-ihracatta ödeme alma ve payout yazısında ele alıyoruz.

Ödeme sonucu siparişe nasıl işlenir?

Müşterinin tarayıcısında açılan başarılı ödeme sayfası, siparişin kesinleştiğini göstermez. Sipariş durumu, sunucuya gelen ve doğrulanan bildirime göre değişmelidir.

WooCommerce sipariş durumları

WooCommerce’in Türkçe arayüzündeki durumlar ve WooCommerce’in tanımları:

Durum	Anlamı	Stok
Ödeme bekliyor	Sipariş oluştu, ödeme henüz alınmadı	Tutulur; stok bekletme süresi dolunca ödenmemiş sipariş iptal edilir
Hazırlanıyor	Ödeme alındı	Düşülmüştür
Beklemede	Ödemenin elle onaylanması bekleniyor (ör. havale)	Düşülmüştür
Başarısız	Ödeme reddedildi veya başarısız oldu	Geri döner
Tamamlandı / İptal edildi / İade edildi	Sipariş kapandı, iptal edildi veya iade edildi	Duruma göre

Kart ödemesinde hedef, doğrulanmış bildirimle siparişin doğrudan Hazırlanıyor’a geçmesidir. GA4 ve Google Ads’e giden satın alma olayı da bu ödenmiş duruma bağlanmalıdır; ayrıntısı dönüşüm takibi kurulumu yazısında.

iyzico webhook

iyzico webhook HTTPS bir adres ister ve bildirimi X-IYZ-SIGNATURE-V3 başlığıyla imzalı gönderir. İlk bildirim işlemden 10–15 saniye sonra gelir; mağaza 2xx yanıtı dönmezse bildirim 15 dakika arayla üç kez yeniden denenir. Önbellek, güvenlik duvarı veya bakım modu yüzünden bildirime 2xx yanıt veremeyen bir site, ödenmiş siparişleri Ödeme bekliyor’da bırakır. İmza doğrulaması ise bildirimin gerçekten iyzico’dan geldiğini kanıtlar.

PayTR Bildirim URL

PayTR’nin Bildirim URL kuralları açıktır:

• Bildirimdeki hash mutlaka doğrulanmalıdır; PayTR, doğrulama yapılmazsa maddi kayıp doğabileceğini belirtir.
• Yanıt yalnızca OK olmalıdır; öncesinde veya sonrasında HTML ya da başka bir çıktı olmamalıdır.
• Aynı sipariş için birden fazla bildirim gelebilir; yalnızca ilki dikkate alınmalı, sipariş numarasıyla (merchant_oid) tekilleştirme yapılmalıdır.
• Başarılı ödeme dönüş sayfası, siparişi onaylayacağınız sayfa değildir.

Taksit ve 3D Secure

iyzico’da taksit oranları panelde Taksit ve Komisyon Ayarları altında tanımlanır. Taksit ve BIN sorgusu kartın bankasını, kart ailesini, 3D Secure zorunluluğunu ve her vade için taksit tutarıyla toplam tutarı döndürür. Ürün sayfasındaki taksit tablosu bu yüzden paneldeki ayarla aynı kaynaktan beslenmelidir; aksi halde müşteri ürün sayfasında gördüğü vadeyi ödeme ekranında bulamaz. PayTR’de taksit, token isteğinde gönderilen taksit parametreleriyle kapatılabilir veya en yüksek taksit sayısı sınırlanabilir.

Kredi kartında taksit sayısı BDDK düzenlemesine tabidir; taksitin checkout’ta nasıl gösterileceğini checkout optimizasyonu yazısında anlattık. 3D Secure dönüşünde yaşanan kayıplar ve sahte sipariş kontrolleri için dolandırıcılık önleme yazısına bakın.

İptal, iade ve kısmi iade

Tekstil mağazasında iade istisna değildir: beden uymaz, renk ekranda farklı görünür, müşteri değişim ister. Bu yüzden iptal ile iadenin farkını ve kısmi iadeyi kurulumda netleştirin.

iyzico (iptal ve iade):

• İptal yalnızca ödemenin yapıldığı gün ve tutarın tamamı için yapılabilir; ekstrede işlem görünmez.
• İade, ödemeden sonraki 365 gün içinde tam veya kısmi olarak yapılabilir. Siparişteki her ürün ayrı bir kırılımdır; aynı ödemeye birden fazla kısmi iade yapılabilir. Üç üründen birinin beden nedeniyle iadesi, siparişin tamamını bozmaz.
• İadenin karta yansıması bankaya göre birkaç gün sürebilir.

PayTR (iade API’si) tam veya kısmi iade kabul eder; iade tutarı ödenen tutarı geçemez. WooCommerce’te iade, sipariş ekranından Para İadesi ile tutar girilip PayTR üzerinden gönderilir. PayTR’nin uyarıları:

• PayTR Mağaza Paneli’nden yapılan iade WooCommerce veya Shopify siparişine yansımaz. İadeyi sipariş ekranından başlatın.
• İade nedeni PayTR paneline aktarılmaz; kaydı siparişte tutun.
• Vade farklı ödemelerde vade farkını iade etmeyin; vade farkı sistem tarafından otomatik iade edilir.

iyzico’nun WooCommerce eklentisi de iadeyi sipariş ekranından gönderebilir. Kural iki sağlayıcıda da aynıdır: iade, siparişin geldiği sağlayıcıya ve sipariş ekranından gider; böylece WooCommerce siparişi, ödeme kaydı ve stok hareketi aynı yerde kalır.

Yasal taraf da kurulumu etkiler. Mesafeli Sözleşmeler Yönetmeliği’nin 1 Ocak 2026’dan beri uygulanan md. 12 hükmüne göre cayma hakkında satıcı, iade edilen ürünün ön bilgilendirmede belirtilen taşıyıcıya teslim edildiği tarihten itibaren 14 gün içinde ödemeleri iade eder; ürün başka bir taşıyıcıyla gönderilirse süre ürünün satıcıya ulaştığı tarihten başlar. İade, müşterinin kullandığı ödeme aracına uygun şekilde, masrafsız ve tek seferde yapılır; kredi kartıyla yapılan ödemede tutar kart limitine tek seferde yansıtılır.

Test modu: canlıya çıkmadan önce

iyzico’nun sandbox ortamı ayrı bir panelde (sandbox-merchant.iyzipay.com) çalışır; her test hesabının kendi üye işyeri numarası ve API anahtarları vardır, test ödemelerinde SMS şifresi her zaman 123456’dır. Test kartları başarılı ödemenin yanında yetersiz bakiye, işlem reddi, süresi geçmiş kart, hatalı CVC, dolandırıcılık şüphesi ve 3D Secure başlatma hatası gibi senaryoları üretir. PayTR’de modül ve Shopify uygulaması test modunda çalıştırılır.

Canlıya almadan önce şu senaryoları gerçek akışta deneyin:

• Başarılı tek çekim ve taksitli ödeme
• Yetersiz bakiye, reddedilen kart ve 3D Secure ekranında iptal
• Ödeme sırasında tarayıcıyı kapatma: sipariş yine de bildirimle Hazırlanıyor’a geçiyor mu?
• Aynı sipariş için çift tıklama veya tekrar deneme
• Kupon, indirim ve ücretsiz kargo eşiğiyle ödeme: sağlayıcıya giden tutar sepetle aynı mı?
• Varyantlı üründe stok düşümü ve başarısız ödemede stoğun geri dönmesi
• Sipariş ekranından tam iade ve tek ürünlük kısmi iade
• Mobil cihazda ödeme ve banka uygulamasına geçip dönme
• Müşteriye giden sipariş ve iade e-postaları

Bu testler kampanyadan önce yapılmalıdır. Kampanya gününde bulunan bir ödeme hatası, doğrudan kayıp sipariş ve müşteri desteği yükü demektir.

İki sağlayıcıyı birlikte kullanmak

iyzico ve PayTR teknik olarak aynı WooCommerce mağazasında birlikte çalışabilir. Ancak müşteriye “Kredi Kartı ile Öde - iyzico” ve “Kredi Kartı ile Öde - PayTR” diye iki seçenek göstermek, checkout’a gereksiz bir karar ekler: hangisi güvenli, hangisinde taksit var?

İkinci sağlayıcı ancak açık bir kural varsa anlamlıdır ve şu üç soru baştan cevaplanmalıdır: hangi sipariş hangi sağlayıcıdan geçti (sipariş kaydında görünmeli), iade hangi sağlayıcıya gidecek (siparişin geldiği sağlayıcı), muhasebe iki paneli nasıl mutabık edecek?

API anahtarları, hesap sahipliği ve KVKK

Ödeme hesabı markanın e-posta adresiyle açılmalıdır. API anahtarları, işlem geçmişi, iade yetkileri ve finansal raporlar markada kalır; ajansa veya geliştiriciye gerektiği kadar erişim verilir. Anahtarlar eklenti ayarlarında durur; tema dosyasına, Git deposuna veya eski ajansın hesabına yazılmaz. Test ve canlı anahtarlar ayrı tutulur.

Entegrasyon müşterinin kişisel verisini ödeme kuruluşuna aktarır: PayTR’nin token isteği müşterinin adını, e-postasını, telefonunu, adresini ve sepet içeriğini gönderir. Bu aktarım, 6698 sayılı KVKK md. 10 gereği aydınlatma metninde, verilerin kimlere ve hangi amaçla aktarılabileceği başlığında yer almalıdır. Kart bilgisi mağaza veritabanında tutulmaz; kart, sağlayıcının ödeme formuna girilir.

iyzico PayTR entegrasyonu kontrol listesi

1. Başvuru belgeleri hazır; site ürün ve fiyatlarla yayında, yasal sayfalar ve SSL tamam.
2. Kabul edilen ödeme araçları ve gönderim kısıtları sipariş öncesinde görünüyor.
3. Eklenti veya Shopify uygulaması resmi kaynaktan kuruldu; anahtarlar markanın panelinden alındı.
4. iyzico webhook adresi İşyeri Bildirimleri’ne girildi, ödeme bildirimleri açık; PayTR Bildirim URL’si https ile tanımlı.
5. PayTR bildiriminde hash doğrulanıyor, yanıt yalnızca OK, merchant_oid ile tekilleştirme var.
6. Doğrulanmış ödeme siparişi Hazırlanıyor’a geçiriyor; başarısız ödemede stok geri dönüyor.
7. Ürün sayfasındaki taksit bilgisi paneldeki taksit ayarıyla aynı.
8. Tam ve kısmi iade sipariş ekranından deneniyor; panelden iade yapılmıyor.
9. Test modundaki bütün senaryolar geçti; canlı anahtarlarla tek bir gerçek işlem yapılıp iade edildi.
10. Aydınlatma metni ödeme kuruluşuna aktarımı içeriyor; erişimler teslimde belgelendi.

Sık sorulan sorular

iyzico ve PayTR aynı WooCommerce sitesinde birlikte kullanılabilir mi?

Evet, teknik olarak kullanılabilir. Ancak müşteriye iki ayrı kartla ödeme seçeneği göstermek checkout kararını zorlaştırır. İkinci sağlayıcı yalnızca açık bir kuralla eklenmeli; her siparişte hangi sağlayıcının kullanıldığı görünmeli ve iade, siparişin geldiği sağlayıcıya gönderilmelidir.

Shopify’da iyzico veya PayTR nasıl kurulur?

Türkiye Shopify Payments ülkeleri arasında olmadığı için ikisi de üçüncü taraf ödeme sağlayıcısı olarak bağlanır. iyzico, Ayarlar › Ödemeler › Ödeme yöntemi ekle altında aranıp etkinleştirilir ve panelden alınan API anahtarlarıyla bağlanır. PayTR, PayTR Sanal POS uygulamasıyla kurulur. Shopify’ın plana bağlı işlem ücreti, sağlayıcının komisyonundan ayrıdır.

Başarılı ödeme neden WooCommerce siparişine düşmeyebilir?

Çünkü sipariş, müşterinin gördüğü başarılı ödeme sayfasıyla değil sunucuya gelen bildirimle güncellenir. iyzico’da webhook adresi tanımlı değilse ya da 2xx yanıt dönmüyorsa, PayTR’de Bildirim URL’si yanlışsa, hash doğrulanmıyorsa veya yanıt yalnızca OK değilse sipariş Ödeme bekliyor’da kalır.

İade WooCommerce’den mi, iyzico veya PayTR panelinden mi yapılmalı?

Sipariş ekranından. İki resmi eklenti de iadeyi WooCommerce siparişinden sağlayıcıya gönderebilir; PayTR, kendi panelinden yapılan iadenin WooCommerce veya Shopify siparişine yansımadığını belirtir. iyzico’da aynı gün yapılan iptal yalnızca tam tutar içindir; tek ürünlük iade, 365 gün içinde kısmi iade olarak yapılır.

iyzico ve PayTR test modu nasıl kullanılır?

iyzico’da sandbox ayrı bir panel ve ayrı API anahtarlarıyla çalışır; test kartları başarılı ödeme, yetersiz bakiye ve 3D Secure hatası gibi senaryolar üretir. PayTR’de modül veya Shopify uygulaması test modunda çalıştırılır, birkaç test işleminden sonra canlıya geçilir. Canlıya geçince test anahtarlarını canlı anahtarlarla değiştirmeyi unutmayın.

Sonuç: Doğru entegrasyon, daha az elle iş

iyzico veya PayTR’yi seçmek işin küçük kısmıdır. Tekstil mağazasında doğru kurulmuş bir ödeme akışında ödeme bildirimle doğrulanır, sipariş Hazırlanıyor’a geçer, stok doğru düşer, taksit bilgisi her ekranda aynıdır ve beden değişimindeki kısmi iade sipariş ekranından takip edilir. Hesap ve anahtarlar markada kalır; bütün senaryolar canlıya çıkmadan test modunda denenir.

İlgili Yazılar

• Checkout Optimizasyonu: Tekstil Rehberi
• E-Ticarette Dolandırıcılık Önleme: Tekstil Rehberi
• Dönüşüm Takibi Kurulumu: GA4 ve Ads
• Tekstil İçin Shopify mı WooCommerce mi?
• Özel Tema mı Hazır Tema mı? Üçüncü Yol