Shopify’da İyzico Kurulumu Nedir? Shopify’da iyzico kurulumu, Türkiye’den satış yapan bir mağazanın iyzico’nun sanal POS (Point of Sale satış noktası) altyapısını Shopify checkout sürecine bağlayarak kredi kartıyla ödeme tahsil etmesini sağlayan API tabanlı entegrasyon işlemidir.
iyzico, 2013 yılından bu yana Türkiye’de faaliyet gösteren ve BKM (Bankalararası Kart Merkezi) üyesi bankalarla anlaşmalı çalışan bir ödeme kuruluşudur. Shopify Payments Türkiye’de desteklenmediği için mağaza sahibi, kredi kartı tahsilatı almak amacıyla iyzico gibi üçüncü parti bir sağlayıcıyla entegrasyon yapmak zorundadır. Bu rehberdeki adımlar, Shopify mağaza kurulumu adım adım rehberi sürecinin ödeme altyapısı aşamasını tamamlayan teknik bir devam niteliği taşır.
İyzico Nedir ve Shopify İçin Neden Tercih Edilir?
iyzico, tek bir API üzerinden birden fazla bankanın sanal POS altyapısına erişim sağlayan bir ödeme kuruluşudur; bu yapı, mağaza sahibinin her banka ile ayrı sözleşme yapmasını gereksiz kılar.
Klasik banka sanal POS’unda mağaza sahibi bankayla üyelik sözleşmesi imzalar, komisyon oranını bankayla pazarlık eder ve genelde şubeye giderek evrak teslim eder. iyzico modelinde ise başvuru tamamen dijital ilerler; onay süresi ortalama 1-3 iş günü sürer (iyzico Geliştirici Dokümantasyonu, 2025). Shopify App Store üzerinden hazır entegrasyon sunması, kod yazmadan kurulum yapılabilmesini sağlayan en somut avantajıdır.
[İPUCU] Yeni kurulan bir mağaza için iyzico’yu tercih etmenin asıl nedeni komisyon oranı değil, başvuru ve onay sürecinin hızıdır; banka sanal POS başvurusu genelde 2-4 hafta sürebilirken iyzico bu süreyi günlere indirir.
iyzico’nun sunduğu tek panelden çoklu banka erişimi, özellikle stok devir hızı yüksek mağazalar için önem taşır. Bir mağaza sahibi tek bankanın sanal POS’una bağlı kaldığında, o bankanın sistem bakımı veya onay gecikmesi yaşadığı anlarda tüm tahsilat süreci durur. iyzico gibi çok bankalı bir yapı kullanıldığında ise trafik otomatik olarak alternatif bankaya yönlendirilebilir; bu yönlendirme mağaza sahibinin manuel müdahalesini gerektirmez ve checkout kesintisi riskini azaltır.
Fiyatlandırma tarafında iyzico, sabit aylık ücret talep etmez; komisyon yalnızca gerçekleşen işlem üzerinden kesilir. Bu model, aylık sipariş sayısı düşük olan yeni mağazalar için sabit maliyet riskini ortadan kaldırır. Buna karşılık yüksek hacimli mağazalar için özel komisyon oranı pazarlığı yapılabilir; bu pazarlık iyzico satış ekibiyle doğrudan görüşme gerektirir ve standart başvuru formunda otomatik olarak sunulmaz.
İyzico Hesabı Nasıl Açılır?
iyzico hesabı açmak için iyzico.com üzerinden “Hemen Başvur” formunu doldurup şirket veya şahıs bilgilerini girmek, ardından istenen evrakları yükleyip onay beklemek gerekir.
Başvuru formunda işletme türü (şahıs şirketi, limited şirket, anonim şirket) seçilir; bu seçim, sonraki adımda istenecek evrak listesini doğrudan belirler. Form onaylandıktan sonra iyzico, hesabı önce test (sandbox) ortamında aktive eder; canlı (production) API anahtarları ayrı bir doğrulama adımından sonra teslim edilir. Aşağıdaki adımlar başvurunun genel akışını özetler:
- iyzico.com üzerinden başvuru formunu doldur ve şirket türünü seç.
- İstenen evrakları (vergi levhası, imza sirküleri, kimlik fotokopisi) yükle.
- iyzico ekibinin evrak incelemesini bekle (ortalama 1-3 iş günü).
- Onay sonrası e-posta ile gelen sandbox API bilgilerini kaydet.
- Canlı işlem için ek doğrulama formunu tamamla ve production anahtarlarını al.
Başvuru formunda dikkat edilmesi gereken bir diğer alan, işyeri adı (merchant name) girişidir. Bu alan, müşterinin banka ekstresinde göreceği ibareyi belirler; mağaza adıyla birebir uyuşmayan bir işyeri adı, müşteri tarafında “tanımadığım işlem” itirazlarına (chargeback) yol açabilir. Başvuru aşamasında işyeri adını mağaza markasıyla tutarlı girmek, sonraki dönemde itiraz oranını düşüren basit ama sık atlanan bir detaydır.
[KRİTİK NOT] Başvuru formunda beyan edilen faaliyet alanı (örneğin “giyim”, “elektronik”, “kozmetik”) iyzico’nun risk skorlamasını etkiler; yüksek riskli kategorilerde (elektronik, dijital ürün) ek belge talebi veya işlem limiti uygulanabilir.
Şahıs ve Tüzel Şirket İçin Gerekli Evraklar Nelerdir?
Şahıs şirketi başvurusunda vergi levhası ve kimlik belgesi yeterliyken, tüzel şirket başvurusunda imza sirküleri ve ticaret sicil gazetesi ek olarak istenir.
Evrak eksikliği, iyzico başvuru sürecinde en sık karşılaşılan gecikme nedenidir. Bir belge eksik yüklendiğinde başvuru “beklemede” statüsünde kalır ve iyzico ekibi e-posta ile ek belge talep eder; bu döngü, tam evrak seti ilk seferde yüklenmediğinde süreci 3-5 gün uzatabilir.
| Evrak | Şahıs Şirketi | Limited/Anonim Şirket |
|---|---|---|
| Vergi Levhası | Zorunlu | Zorunlu |
| Kimlik Fotokopisi | Zorunlu | Yetkili kişi için zorunlu |
| İmza Sirküleri | Gerekmez | Zorunlu |
| Ticaret Sicil Gazetesi | Gerekmez | Zorunlu |
| Faaliyet Belgesi | Opsiyonel | Bazı durumlarda istenir |
Bir önceki bölümde anlatılan başvuru formunu dolduran mağaza sahibi, bu tabloda kendi şirket türüne karşılık gelen evrak setini önceden hazırlarsa onay süresini kısaltır.
Yurt dışında yerleşik ama Türkiye’de faaliyet gösteren şirketler için evrak süreci farklılaşır; bu profil iyzico’nun standart başvuru formuna genelde uymaz ve ayrı bir kurumsal görüşme gerektirir. Aynı şekilde dernek, vakıf veya kooperatif statüsündeki tüzel kişiler için de ek belge (tüzük, yetki belgesi) talep edilebilir. Bu tür istisnai durumlarda başvuru formunu doldurmadan önce iyzico’nun kurumsal satış ekibiyle iletişime geçmek, standart akışta reddedilme riskini önler.
Evrakların taranmış kopyalarını yüklerken dosya formatı ve çözünürlük de onay hızını etkiler. Bulanık veya kırpılmış taranan bir vergi levhası, iyzico’nun doğrulama ekibi tarafından reddedilir ve mağaza sahibinden yeniden yükleme istenir. PDF formatında, 300 DPI çözünürlükte ve belgenin tüm kenarlarını gösteren bir tarama, ilk seferde onay alma ihtimalini yükseltir. Yeni kurulan bir şahıs şirketinin vergi levhası henüz sistemde işlenmemişse, vergi dairesinden alınan geçici kayıt belgesi de bazı durumlarda kabul edilir; bu istisna iyzico’nun destek ekibiyle doğrudan teyit edilmelidir.
Shopify App Store’dan İyzico Uygulaması Nasıl Kurulur?
Shopify App Store’da “iyzico” araması yapıp uygulamayı mağazaya eklemek, entegrasyonun ilk teknik adımıdır ve bu işlem kod yazmadan birkaç dakikada tamamlanır.
Uygulama mağazaya eklendikten sonra Shopify admin panelinde Settings > Payments (Ayarlar > Ödemeler) bölümünde “Alternative payment methods” (Alternatif ödeme yöntemleri) altında iyzico seçeneği görünür hale gelir. Bu noktada uygulama henüz aktif değildir; API bilgileri girilmeden işlem alamaz.
[KRİTİK NOT] Shopify App Store’daki iyzico uygulaması bazı mağaza planlarında (özellikle en düşük seviye planlarda) üçüncü parti ödeme sağlayıcı ek ücretine tabi olabilir; kurulum öncesi Shopify’ın güncel plan koşullarını kontrol etmek gerekir.
Uygulama kurulduktan sonra Shopify, iyzico’yu “manuel olmayan” bir ödeme yöntemi olarak sınıflandırır; bu, ödemenin checkout sırasında anlık olarak onaylandığı ve siparişin otomatik “ödendi” statüsüne geçtiği anlamına gelir. Bazı mağaza sahipleri bu noktada iyzico’yu tek ödeme yöntemi olarak bırakır, bazıları ise kapıda ödeme veya banka havalesi gibi manuel yöntemlerle birlikte sunar. Birden fazla yöntem sunmak checkout ekranında seçenek karmaşasına yol açmaması için sade bir sıralamayla listelenmelidir; en çok tercih edilen yöntem (genelde kredi kartı) listenin en üstünde yer almalıdır.
API Key ve Secret Key Entegrasyonu Nasıl Yapılır?
API key ve secret key entegrasyonu, iyzico panelinden alınan iki anahtarın Shopify’daki iyzico uygulaması ayarlarına eksiksiz girilmesiyle tamamlanır.
iyzico Merchant Panel’de Ayarlar > API Anahtarları bölümünde hem sandbox hem production için ayrı anahtar çiftleri bulunur. Shopify tarafında bu anahtarlar uygulamanın yapılandırma ekranına yapıştırılır ve “Base URL” alanına doğru ortam adresi (sandbox veya production) girilir. Yanlış ortamın anahtarı yanlış URL ile eşleştirilirse entegrasyon “yetkisiz erişim” hatası döner.
| Alan | Sandbox Değeri | Production Değeri |
|---|---|---|
| API Key | sandbox-xxxxx önekiyle başlar | Önek taşımaz |
| Secret Key | sandbox-xxxxx önekiyle başlar | Önek taşımaz |
| Base URL | sandbox-api.iyzipay.com | api.iyzipay.com |
| Callback URL | Test mağaza adresi | Canlı mağaza domaini |
iyzico’nun API dokümantasyonuna göre her anahtar çifti belirli bir ortama (sandbox veya production) kilitlidir ve ortamlar arasında karışık kullanılamaz (iyzico Geliştirici Dokümantasyonu, 2025).
Anahtarları girdikten sonra Shopify uygulaması genelde bir “bağlantı testi” butonu sunar; bu buton API kimlik bilgilerinin geçerli olup olmadığını gerçek işlem yapmadan kontrol eder. Bağlantı testi başarısız olduğunda ilk kontrol edilmesi gereken üç nokta şunlardır: anahtarların kopyalanırken başında veya sonunda boşluk kalıp kalmadığı, Base URL’in ortamla eşleşip eşleşmediği ve iyzico hesabının hâlâ “aktif” statüde olup olmadığı. Hesap askıya alınmışsa (örneğin eksik evrak nedeniyle) API bağlantı testi de başarısız sonuç döner; bu durumda sorun Shopify tarafında değil, iyzico hesap statüsündedir.
[İPUCU] API anahtarlarını bir parola yöneticisinde saklamak, ileride domain veya tema değişikliğinde yeniden girme ihtiyacı doğduğunda zaman kazandırır; anahtarlar yalnızca iyzico panelinde bir kez tam olarak gösterilir.
Taksit Ayarları Nasıl Yapılandırılır?
Taksit ayarları, iyzico Merchant Panel’de banka bazlı taksit tablosu üzerinden yapılandırılır ve Shopify checkout ekranında kart girildikten sonra otomatik olarak müşteriye gösterilir.
Her banka için taksit sayısı ve komisyon oranı ayrı ayrı tanımlanabilir; mağaza sahibi belirli bir kategori için taksiti tamamen kapatabilir ya da maksimum taksit sayısını sınırlandırabilir. Örneğin elektronik kategorisinde 12 taksit açık tutulurken, indirimli ürünlerde taksit tamamen kapatılabilir.
- iyzico Merchant Panel’de Taksit Ayarları sekmesine gir.
- Anlaşmalı bankaları ve taksit seçeneklerini (2, 3, 6, 9, 12 ay) işaretle.
- Her taksit kademesi için komisyon oranını gözden geçir.
- Kategori bazlı taksit kısıtlaması varsa ürün etiketleriyle eşleştir.
- Ayarları kaydet ve Shopify checkout’ta test kartıyla doğrula.
[İPUCU] Taksit komisyonunu ürün fiyatına yansıtmak yerine kâr marjı içinde eritmek, checkout’ta “taksit farkı” görmeyen müşteri için tamamlanma oranını yükseltir.
Test İşlemi ve Canlıya Geçiş Süreci Nasıl İşler?
Canlıya geçiş, sandbox ortamında test kartlarıyla en az bir başarılı ve bir başarısız işlem denendikten sonra production anahtarlarına geçiş yapılmasıyla tamamlanır.
iyzico, sandbox ortamı için belirli test kart numaraları yayınlar; bu kartlarla yapılan işlemler gerçek para hareketi oluşturmaz ama API yanıtlarının doğruluğunu kontrol etmeye yeterlidir. Test aşaması atlanıp doğrudan production anahtarlarıyla canlıya geçilirse, callback URL veya webhook hatası ilk gerçek siparişte ortaya çıkar bu da müşteri kaybına yol açan bir senaryodur.
Test aşaması tamamlandıktan sonra sıra, sandbox ile production anahtarlarının karışmadığından emin olmaya gelir; bu karışıklık bir sonraki bölümde ele alınan en yaygın hatadır.
Canlıya geçiş öncesi kontrol edilmesi gereken bir diğer nokta, 3D Secure akışının doğru çalışmasıdır. iyzico, kart bilgisi girildikten sonra müşteriyi bankanın 3D Secure doğrulama sayfasına yönlendirir; bu sayfa mağazanın kendi domaininde değil, bankanın sunucusunda açılır. Test sırasında bu yönlendirmenin kesintisiz çalıştığından ve doğrulama sonrası müşterinin otomatik olarak Shopify “Thank You” (Teşekkürler) sayfasına döndüğünden emin olunmalıdır. Yönlendirme kopması, işlemin bankada başarılı görünüp Shopify’da sipariş oluşturmaması gibi uyuşmazlıklara yol açabilir.
İyzico Komisyon Oranları Nasıl Hesaplanır?
İyzico komisyon oranı sabit bir yüzde değildir; sektöre, aylık işlem hacmine ve taksit sayısına göre değişen bir oran olarak başvuru sonrası mağaza sahibine bildirilir.
Genel olarak tek çekim (peşin) işlemlerde komisyon oranı, taksitli işlemlere göre daha düşük kalır; taksit sayısı arttıkça banka tarafından kesilen taksit komisyonu da oransal olarak yükselir. Yeni açılan bir mağaza için standart oran genelde belirli bir bant içinde teklif edilir, ancak aylık işlem hacmi belirli bir eşiği geçtiğinde iyzico satış ekibiyle özel oran görüşmesi yapılabilir. Bu görüşme, başvuru formunda otomatik sunulmaz; mağaza sahibinin destek hattı üzerinden talep etmesi gerekir.
| İşlem Türü | Komisyon Eğilimi | Not |
|---|---|---|
| Tek Çekim | Görece düşük | Peşin ödemede en düşük komisyon oranı uygulanır |
| 2-3 Taksit | Orta | Banka taksit komisyonu eklenir |
| 6-12 Taksit | Yüksek | Uzun vadeli taksitlerde komisyon oranı belirgin şekilde artar |
[İPUCU] Yüksek taksit seçeneklerini yalnızca yüksek sepet tutarlı kategorilerde açık tutmak, genel komisyon maliyetini düşük sepetli ürünlerde aşırı yükseltmeden taksit avantajından yararlanmayı sağlar.
Komisyon oranı görüşmesinde dikkate alınması gereken bir diğer değişken, iade (chargeback) oranıdır. İade oranı yüksek bir mağaza profilinde iyzico, riski dengelemek için standart orandan daha yüksek bir komisyon uygulayabilir veya belirli bir bekleme süresi (rolling reserve) talep edebilir. Bu nedenle iyzico başvurusu öncesinde ürün iade politikasının net ve tutarlı olması, hem müşteri güveni hem de komisyon görüşmesi açısından avantaj sağlar.
Sık Karşılaşılan Hatalar ve Çözümleri
Sandbox ve production ortamlarının karışması ile callback URL uyuşmazlığı, iyzico-Shopify entegrasyonunda görülen en yaygın iki teknik hatadır.
Sandbox anahtarlarıyla production Base URL’ine istek atıldığında iyzico API’si “yetkisiz erişim” (401) hatası döner; bunun tersi de aynı sonucu verir. Callback URL uyuşmazlığında ise ödeme başarıyla tamamlanır ama Shopify sipariş durumunu güncelleyemez, çünkü iyzico’nun geri bildirim gönderdiği adres mağazanın güncel domaniyle eşleşmez.
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Yetkisiz Erişim | Sandbox/production anahtar karışıklığı | API key, secret key ve Base URL'in aynı ortama ait olduğunu doğrula |
| Sipariş Durumu Güncellenmiyor | Callback URL eski domaine işaret ediyor | iyzico panelinde callback URL'i güncel mağaza adresiyle eşleştir |
| 3D Secure Ekranı Açılmıyor | Tarayıcı popup engelleyici veya SSL sertifika sorunu | Mağaza domaininin SSL sertifikasını kontrol et |
| Taksit Seçenekleri Görünmüyor | Banka anlaşması taksit ayarında pasif | Merchant Panel'de ilgili bankanın taksit anahtarını aktive et |
[KRİTİK NOT] Domain değişikliği (özelden kendi alan adına geçiş gibi) yapıldığında callback URL güncellenmezse mağaza ödeme alır ama sipariş kaydı oluşmaz; bu senaryo genelde ilk fark edildiğinde birkaç sipariş kaybına neden olmuş olur.
Bu tabloda listelenmeyen ama sık görülen bir diğer sorun, tema güncellemesi sonrası ödeme butonunun kaybolmasıdır. Bazı özel temalar checkout sayfasını özelleştirirken üçüncü parti ödeme uygulamalarının enjekte ettiği script’i engelleyebilir. Tema güncellemesi yapıldıktan sonra iyzico’nun checkout ekranında görünür olup olmadığını test siparişiyle doğrulamak, canlı ortamda müşteri şikayeti almadan önce sorunu tespit etmeyi sağlar.
İyzico ile Diğer Ödeme Yöntemlerini Birlikte Kullanmak Mümkün mü?
Evet, iyzico Shopify checkout’ta tek başına değil, banka havalesi, kapıda ödeme veya PayTR gibi başka yöntemlerle yan yana listelenebilir; bu yöntemler birbirini dışlamaz.
Birden fazla ödeme yöntemi sunan mağazalarda müşteri, checkout adımında kendisine en uygun seçeneği kendisi seçer. Bu yaklaşımın avantajı, kredi kartı olmayan veya online kart bilgisi paylaşmak istemeyen müşteri segmentini kaybetmemektir. Dezavantajı ise her ek yöntemin kendi operasyonel yükünü (kapıda ödeme için kargo tahsilat takibi, banka havalesi için manuel eşleştirme) getirmesidir. iyzico’yu ana yöntem, kapıda ödemeyi ise düşük sepet tutarlı siparişler için ikincil yöntem olarak konumlandırmak, iki tarafın da avantajını korur.
- Kredi/banka kartı (iyzico üzerinden, anlık onaylı)
- Kapıda ödeme (manuel, teslimat sırasında tahsilat)
- Banka havalesi/EFT (manuel, sipariş sonrası eşleştirme gerektirir)
- Diğer sanal POS sağlayıcıları (PayTR gibi, yedek veya bölgesel tercih için)
Sanal POS seçenekleri arasında iyzico’yu PayTR ve banka bazlı çözümlerle kıyaslamak isteyenler için Shopify PayTR ve Garanti sanal POS entegrasyonu makalesi alternatif kurulum sürecini detaylandırır; tüm seçeneklerin yan yana karşılaştırması ise Shopify Türkiye ödeme yöntemleri karşılaştırması makalesinde yer alır.
Sık Sorulan Sorular
İyzico Shopify’da ücretsiz mi kullanılır? Uygulamanın kendisi ücretsizdir ama her işlemden komisyon kesilir. Komisyon oranı işlem hacmine ve sektöre göre değişir, sabit bir yüzde yoktur.
İyzico onay süreci ne kadar sürer? Evrak eksiksiz yüklendiğinde ortalama 1-3 iş günü sürer. Eksik veya hatalı evrak, süreci 5 güne kadar uzatabilir.
Şahıs şirketiyle iyzico başvurusu yapılabilir mi? Evet, şahıs şirketi vergi levhası ve kimlik belgesiyle başvuru yapabilir. Limited veya anonim şirkete göre daha az evrak istenir.
Sandbox ve production anahtarları aynı anda kullanılabilir mi? Hayır, iki ortamın anahtarları birbirinin yerine geçmez. Karışık kullanım 401 yetkisiz erişim hatasına yol açar.
İyzico kurulumunu kendim mi yapmalıyım yoksa geliştiriciye mi bırakmalıyım? Shopify App Store üzerinden kurulum teknik bilgi gerektirmez, panel üzerinden ilerler. Özel API entegrasyonu (checkout dışı kullanım) gerekiyorsa geliştirici desteği faydalı olur.
İyzico callback URL’i nereden değiştirilir? iyzico Merchant Panel’de entegrasyon ayarları sekmesinden güncellenir. Domain değişikliğinde bu alanın güncellenmemesi sipariş kaybına yol açar.
Taksit komisyonunu müşteriye mi yansıtmalıyım? Bu, kâr marjına ve rakip fiyatlandırmaya bağlı bir tercihtir. Komisyonu ürün fiyatına gizli şekilde eklemek, checkout terk oranını düşürebilir.
İyzico ile PayTR aynı anda kullanılabilir mi? Teknik olarak ikisi de Shopify checkout’ta eş zamanlı listelenebilir. Ancak çoğu mağaza operasyonel karmaşıklığı azaltmak için tek bir sanal POS sağlayıcısında karar kılar.
İyzico hesabım onaylandıktan sonra hemen para çekebilir miyim? Hayır, ilk işlemden sonra genelde belirli bir bekleme süresi (hakediş süresi) uygulanır. Bu süre banka ve risk skoruna göre değişir, iyzico panelinde işlem bazında görüntülenir.
Sonraki Adım
İyzico kurulumu tamamlandıktan sonra kapıda ödeme veya ek taksit seçenekleri eklemek isteyenler Shopify’da kapıda ödeme ve taksit seçeneği açma makalesine geçebilir; tüm ödeme sağlayıcılarını yan yana görmek isteyenler ise Shopify Türkiye ödeme yöntemleri karşılaştırması makalesini inceleyebilir.