Shopify iyzico Entegrasyonu: Adım Adım Kurulum Rehberi (2026)
Shopify iyzico entegrasyonu, iyzico ödeme altyapısını mağazaya bağlayıp kredi kartı, banka kartı ve taksitli ödemeyi mümkün kılan kurulumdur. Adım adım rehber.
Yazar: Efe Gündüz Nodus Works Shopify Agency Founder Yayın 8 dk okuma
Shopify iyzico Entegrasyonu Nedir ve Neden Önemlidir?
Shopify iyzico entegrasyonu, iyzico ödeme altyapısının Shopify mağazasına bağlanarak müşterilerin kredi kartı, banka kartı ve taksitli ödeme yapabilmesini sağlayan teknik bir yapılandırmadır. iyzico, 2013 yılında kurulan ve PayU bünyesinde TCMB lisansıyla çalışan bir ödeme altyapısı sağlayıcısıdır. Shopify'ın resmi App Store'unda yer alan iyzico, Türkiye'deki Shopify mağazaları için en yaygın ödeme çözümlerinden biridir.
Türkiye'de PayPal ve Stripe hizmet veremediğinden, TCMB lisanslı yerel sağlayıcılar tek geçerli seçenektir. iyzico, Shopify ile doğrudan entegrasyon sunması, Türkiye'deki tüm büyük bankaları desteklemesi, eksiksiz başvuruların 24 saat içinde sonuçlanması ve Shopify tarafındaki kurulumun teknik bilgi gerektirmemesi nedeniyle özellikle yeni başlayan mağazalar için tercih edilen çözümdür. iyzico, Türkiye'de kullanılan sanal POS altyapılarından biridir; banka sanal POS'ları dahil tüm seçeneklerin kurulumunu ve karşılaştırmasını Shopify sanal POS kurulum rehberimizde ayrıca ele aldık.
Shopify Türkiye'de kullanılabilecek tüm ödeme seçeneklerine genel bakış için: Shopify Ödeme Yöntemleri Ekleme: Türkiye Rehberi
iyzico Hesabı Açmak: Gereksinimler ve Başvuru Süreci
iyzico'ya bireysel ve kurumsal olmak üzere iki profille başvurulabilir. Ancak vergi levhası olmayan bireysel başvuru yalnız iyzico Link ürünü içindir; Link'te API anahtarı bulunmadığı için Shopify'a bağlanamaz. Shopify entegrasyonu için Sanal POS başvurusu gerekir ve bunun için vergi levhası olan bir şahıs şirketi ya da sermaye şirketi yeterlidir. İyzico entegrasyonunun ötesinde PayTR, Craftgate veya banka sanal pos bağlantısı da kurulacaksa Shopify entegrasyon hizmetimiz tüm Türkiye ödeme altyapısını tek proje kapsamında kurar.
Bireysel Başvuru için Gerekli Belgeler
- TC kimlik numarası
- Aktif banka hesabı ve IBAN
- Vergi numarası (bireysel vergi mükellefi)
- İletişim bilgileri
Kurumsal Başvuru için Gerekli Belgeler
- Vergi levhası
- İmza sirküleri
- Ticaret sicil gazetesi
- Şirket banka hesabı IBAN bilgisi
- Yetkili kişinin kimlik belgesi
Başvuru süreci iyzico.com üzerinden tamamen dijital olarak yürütülür; bilgi ve belgeleri eksiksiz tamamlanan başvurular iyzico'nun bildirdiğine göre 24 saat içinde sonuçlanır. İş modelinize göre ek belge ya da bilgi istenirse bu süre uzayabilir. Eksik belge olması durumunda iyzico ekibi e-posta veya telefon üzerinden bildirim yapar.
Shopify iyzico Entegrasyonu: Adım Adım Kurulum
Adım 1: iyzico Merchant Panel'den API Bilgilerini Alın

iyzico başvurunuz onaylandıktan sonra merchant.iyzipay.com adresindeki panelinize giriş yapın. Sol menüde Ayarlar bölümüne gidin. "API Anahtarları" altında iki farklı bilgi bulunur:
- API Key (Merchant API Anahtarı)
- Secret Key (Gizli Anahtar)
Bu iki bilgiyi güvenli bir yere kaydedin. Secret Key'i asla üçüncü taraflarla paylaşmayın.
Kritik Uyarı: iyzico panelinde iki ayrı ortam vardır: Sandbox (Test) ve Live (Canlı). Her ortamın ayrı API anahtarları vardır. Test ortamı anahtarlarıyla canlı ödeme alınamaz. Entegrasyon sırasında önce Sandbox anahtarlarını kullanın; test başarılı olduktan sonra Live anahtarlarına geçin.
Adım 2: Shopify Admin'de Ödeme Ayarlarına Gidin
Shopify Admin panelinde sol alt köşedeki Ayarlar (Settings) seçeneğine tıklayın. Açılan menüde Ödemeler (Payments) bölümünü seçin.
Adım 3: Üçüncü Taraf Sağlayıcı Olarak iyzico'yu Ekleyin

Ödeme yöntemi ekle butonuna tıklayın ve sağlayıcıya göre arama kutusuna "iyzico" yazın. Sonuçlardan iyzico'yu seçip Etkinleştir, ardından Bağlan deyin ve açılan ekrandan iyzico uygulamasını yükleyin.
Adım 4: API Bilgilerini Girin

iyzico kurulum ekranında şu alanları doldurun:
- API Key: iyzico panelinden kopyaladığınız merchant API anahtarı
- Secret Key: Gizli anahtarınız
- Etkinleştirme: Bilgileri kaydettikten sonra Shopify'da "iyzico - Kredi ve Banka Kartları" ödeme yöntemini etkinleştirin
Adım 5: Test İşlemi Yapın
iyzico Sandbox ortamını kullanarak test ödemesi gerçekleştirin. Test kartı bilgileri için iyzico'nun resmi geliştirici dokümantasyonunu kullanın. Başarılı test sonrasında sandbox anahtarlarını canlı API Key ve Secret Key ile değiştirin; test modu açıksa kapatın.
Adım 6: Taksit Seçeneklerini Yapılandırın
iyzico panelinde Taksit Ayarları bölümünden hangi bankalar için kaç taksit sunacağınızı belirleyebilirsiniz. Taksit sayısına göre iyzico'nun komisyon oranı artar; bu nedenle taksit-komisyon dengesini ürün marjlarınıza göre ayarlayın.
iyzico Komisyon Yapısı (2026)
iyzico, işlem bazlı komisyon alır. Sabit bir aylık ücret uygulamaz.
| İşlem Türü | Komisyon Oranı (yaklaşık) |
|---|---|
| Tek çekim (tüm bankalar) | Vergi levhalı satıcı %4,29 + 0,25 TL (BSMV dahil); şirketi olmayan bireysel kullanıcıların %4,49 + 0,25 TL'den başlayan oranı yalnız Shopify'a bağlanamayan Link ürünü içindir |
| 3 taksit | Tek çekim oranına (%4,29 + 0,25 TL) bankaya göre değişen vade farkı eklenir; iyzico Yardım Merkezi'ne göre taksit için tek liste oranı yoktur, kesinti panelin Taksit ve Komisyon Yönetimi bölümünde hesaplanır (Ekim 2026) |
| 6 taksit | %4,29 + 0,25 TL üstüne bankaya göre değişen vade farkı; taksit sayısı arttıkça yükselir |
| 9 taksit | %4,29 + 0,25 TL üstüne bankaya göre değişen vade farkı; taksit sayısı arttıkça yükselir |
| 12 taksit | %4,29 + 0,25 TL üstüne bankaya göre değişen vade farkı; taksit sayısı arttıkça yükselir |
| Yabancı kart | iyzico ayrı liste oranı yayımlamaz; döviz ile tahsilat için Multi Currency eklentisi yıllık 99 TL (Ekim 2026 liste fiyatı), döviz işlemlerinde taksit yoktur |
Shopify İşlem Ücreti: Shopify kendi ödeme altyapısı dışında bir sağlayıcı kullandığınızda ek işlem ücreti alır. Basic planda %2, Grow planda %1, Advanced planda %0,6, Plus planda %0,2 oranında ek maliyet oluşur. Toplam maliyeti hesaplarken bu ücret iyzico komisyonuna eklenmelidir.
iyzico ile PayTR Karşılaştırması
| Özellik | iyzico | PayTR |
|---|---|---|
| Kuruluş yılı | 2013 | 2009 |
| Tek çekim komisyon | %4,29 + 0,25 TL (kurumsal, 2026) | %2,19'dan başlar (7 gün valörle; kesin oran işlem hacmi ve sektöre göre teklifle belirlenir, işlem başına sabit ücret yok) |
| Shopify entegrasyonu | Resmi | Resmi |
| Kurulum zorluğu | Kolay | Orta |
| Başvuru onay süresi | 24 saat (eksiksiz başvuruda) | 1-5 iş günü |
| Yabancı kart desteği | Evet | Evet |
| Taksit seçenekleri | Tüm büyük bankalar | Tüm büyük bankalar |
| Müşteri desteği | 7/24 | 7/24 |
Düşük işlem hacimli yeni mağazalar için iyzico'nun kurulum kolaylığı belirleyici bir avantajdır; işlem hacminiz arttıkça PayTR'den işletmenize özel komisyon teklifi alın ve iki sağlayıcının toplam maliyetini karşılaştırın.
Yaygın Hatalar ve Çözümleri
Hata: Ödeme alınamıyor, "geçersiz API anahtarı" hatası Neden: Sandbox ve Live API anahtarları karıştırılmış. Çözüm: iyzico panelinde hangi ortamda olduğunuzu kontrol edin. Canlı mağaza için Live ortamının anahtarlarını kullanın. Shopify yardımına göre, üçüncü taraf ödeme sağlayıcısıyla alınan siparişte Shopify'ın kestiği işlem ücreti, mağazanın ülkesinde Shopify Payments varsa iade edilmez. Shopify Payments yoksa ve iade Shopify yönetiminden yapıldıysa ücret, iade oranında geri yazılır. Kaynak: Refunding orders.
Hata: 3D Secure ekranı açılmıyor Neden: iyzico hesabında 3D Secure aktif değil. Çözüm: iyzico panelinde "3D Secure" ayarının aktif olduğunu doğrulayın.
Hata: Taksit seçenekleri checkout'ta görünmüyor Neden: Shopify planında taksit özelleştirmesi sınırlıdır ya da iyzico panelinde taksit tanımlanmamıştır. Çözüm: iyzico panelindeki Taksit Ayarları bölümünden bankaları ve taksit sayılarını etkinleştirin.
Hata: Ödeme başarılı ama sipariş oluşmuyor Neden: iyzico uygulamasının Shopify bağlantısı tamamlanmamış ya da ödeme yöntemi etkinleştirilmemiş; iyzico ödeme onayını Shopify'a iletemiyor. Çözüm: Ayarlar > Ödemeler bölümünde iyzico uygulamasının bağlı olduğunu ve "iyzico - Kredi ve Banka Kartları" yönteminin etkin olduğunu kontrol edin.
iyzico ile Uluslararası Satış
iyzico, yabancı kredi kartlarıyla ödeme almayı destekler. Tahsilat standart olarak Türk Lirası (TRY) üzerinden yapılır; ek ücretli Multi Currency eklentisi (yıllık 99 TL) iyzico Kontrol Paneli'nin Eklentiler bölümünden etkinleştirildiğinde Visa ve Mastercard kartlarla USD, EUR, GBP, RUB, CHF ve NOK cinsinden ödeme alınabilir. Döviz olarak alınan ödemeler işlem günündeki Merkez Bankası kuruyla Türk Lirası'na çevrilerek hesabınıza aktarılır. Farklı para biriminde ödeme almak ve yurt dışı müşterilere yerel ödeme seçenekleri sunmak için Shopify'da market bazlı ödeme yönetimi rehberimize göz atın.
Shopify Sipariş Kaydında Vade Farkı Nasıl Gösterilir?
Shopify'da taksitli satış yapan mağazalarda, iyzico üzerinden alınan vade farkı sipariş kaydına otomatik yansımaz; sipariş tutarı yalnızca ürün fiyatını gösterir. Bu sorunu kendi geliştirdikleri app ile çözen iyzico, admin panelindeki sipariş detayına vade farkını otomatik ekleyen ücretsiz bir uygulamaları mevcuttur o konuya diğer yazımızda detaylıca değindik.
SSS
Shopify'a iyzico nasıl eklenir? iyzico.com'dan hesap açılır ve API anahtarları alınır. Shopify Admin'de Ayarlar, Ödemeler, Sağlayıcı ekle adımlarıyla iyzico seçilir ve API bilgileri girilir. Test işlemi başarılıysa canlı moda geçilir.
iyzico'nun Shopify'daki komisyon oranı nedir? iyzico'nun resmi sanal POS sayfasına göre 2026'da tek çekim komisyonu kurumsal satıcılar için %4,29 + 0,25 TL (BSMV dahil), bireysel satıcılar için %4,49 + 0,25 TL'den başlar. Taksitli işlemlerde taksit sayısına göre bu oran artar. Shopify'ın ek işlem ücreti de toplam maliyete eklenir.
iyzico başvurusu ne kadar sürer? iyzico'nun Yardım Merkezi'ne göre bilgi ve belgeleri eksiksiz tamamlanan başvurular 24 saat içinde sonuçlanır. İş modelinize göre ek belge ya da bilgi istenirse süre uzayabilir.
iyzico ile taksit yapılabilir mi? Evet. iyzico, Türkiye'deki tüm büyük bankalar için taksit tanımlaması yapılmasına izin verir. Taksit sayısı ve banka seçimi iyzico merchant panelinden ayarlanır.
Shopify iyzico entegrasyonunda teknik bilgi gerekiyor mu? Hayır. Shopify Admin üzerindeki kurulum adımları teknik bilgi gerektirmez. Webhook ve ileri düzey özelleştirmeler için teknik destek almanız önerilir.
iyzico Shopify ile uyumlu mu? Evet. iyzico, Shopify'ın resmi entegrasyon listesinde yer alır ve Türkiye'de Shopify mağazaları için en yaygın kullanılan ödeme altyapısıdır. Kurulum doğrudan Shopify Admin üzerinden yapılır.
Shopify iyzico veya PayTR hangisi daha iyi? Her iki sağlayıcı da güvenilirdir. iyzico kurulum kolaylığıyla öne çıkar ve düşük hacimli mağazalar için pratik bir başlangıçtır. PayTR'nin yayımladığı başlangıç oranı (7 gün valörle %2,19'dan başlar) iyzico'nun liste oranından düşüktür; ancak PayTR'de kesin oran işlem hacmi ve sektöre göre teklifle belirlenir. Hacminiz arttıkça PayTR'nin teklifini iyzico ile karşılaştırın.
Shopify iyzico entegrasyonu, Türkiye'deki mağazanız için ödeme altyapısını en hızlı şekilde kurmanın yoludur. Başvuru sürecinden API yapılandırmasına kadar tüm adımlar doğru takip edildiğinde, belgeleri eksiksiz bir başvuru iyzico'nun bildirdiği 24 saatlik onay süresinin ardından aktif hale getirilebilir.
Entegrasyon sırasında sorunla karşılaşırsanız veya iyzico ile PayTR arasında karar vermekte güçlük çekiyorsanız Shopify entegrasyon hizmetlerimizden yararlanabilirsiniz. Shopify Türkiye ödeme sistemi kurulumu konusundaki tüm seçenekler için Shopify Türkiye rehberimize göz atın.