iyzico'yu Mağazanıza Bağlama
Önce iyzico'ya başvurup onay alırsınız, sonra iyzico panelinden aldığınız API Key ve Secret Key değerlerini Treyza'ya girip entegrasyonu…
Nerede bulunur: Sol menü → Entegrasyonlar → Ödeme kategorisi → iyzico Kimler için: Müşterilerinden kredi kartıyla ödeme almak isteyen ve iyzico'yu tercih eden mağazalar. Kısaca: Önce iyzico'ya başvurup onay alırsınız, sonra iyzico panelinden aldığınız API Key ve Secret Key değerlerini Treyza'ya girip entegrasyonu etkinleştirirsiniz. Başvuru onaylanmadan kart ödemesi alamazsınız.
Sıralamayı baştan bilin (en çok burada takılınıyor)
iyzico entegrasyonu, diğer entegrasyonların çoğundan farklıdır: anahtarları girmeden önce iyzico'nun sizi onaylaması gerekir. Onay sürecinde iyzico sitenize girip bakar — sözleşmeleriniz, iletişim bilgileriniz ve logoları yerinde mi diye kontrol eder.
Buradaki tuhaflık şudur: iyzico logolarını sitenizde ister, ama o logoları koymanız gereken an, henüz entegrasyonu bağlayamadığınız andır. Treyza bu yüzden logoları entegrasyondan bağımsız olarak açmanıza izin verir (aşağıda 2. adım).
Doğru sıra:
- Sitenizi iyzico kriterlerine hazırlayın (sözleşmeler, iletişim, SSL).
- Logoları elle açın — entegrasyon henüz bağlı değilken bile.
- iyzico'ya başvurun ve onayı bekleyin.
- Onay gelince anahtarları Treyza'ya girip entegrasyonu etkinleştirin.
- Test edin.
Dikkat: 2. adımı atlarsanız iyzico başvurunuz "web sitesi kriterleri eksik" gerekçesiyle geri dönebilir ve süreç baştan uzar.
1) Sitenizi iyzico kriterlerine hazırlayın
iyzico, başvuru sırasında sitenizde şunları arar:
| Kriter | Treyza'da nereden yapılır? |
|---|---|
| Site yayında ve ürünler fiyatlarıyla görünür olmalı | Mağazanız yayında olmalı, ürünlerinizin fiyatları girilmiş olmalı. |
| Gizlilik Politikası | İçerik → Yasal Sayfalar |
| Mesafeli Satış Sözleşmesi | İçerik → Yasal Sayfalar |
| Teslimat ve İade Şartları | İçerik → Yasal Sayfalar |
| İletişim bilgileri (ticaret unvanı, vergi no, adres, e-posta, telefon) | Mağaza Ayarları ve/veya bir İletişim sayfası; footer'dan erişilebilir olmalı |
| SSL sertifikası | Treyza'da barındırılan mağazalarda hazır gelir; kendi alan adınızı bağladıysanız sertifikanın aktif olduğunu doğrulayın. |
| Visa, Mastercard ve "iyzico ile Öde" logoları | Tema Editörü (bir sonraki adım) |
| Faaliyetinizle ilgili lisans/belgeler | Sattığınız ürün grubu izne tabiyse (gıda takviyesi, kozmetik vb.) ilgili belgeler istenir. |
İpucu: Yasal sayfaları oluşturmak için İçerik → Yasal Sayfalar ekranındaki hazır şablonlardan yararlanabilirsiniz. Oluşturduğunuz sayfaların footer'da bağlantılı olduğundan emin olun — iyzico sayfanın var olmasına değil, siteden ulaşılabilir olmasına bakar.
2) Logoları başvurudan ÖNCE yayına alın
Treyza'da ödeme logoları iki yerden kontrol edilir: mağaza geneli bir ayar ve istenirse her footer bloğu için ayrı bir ayar.
Mağaza geneli (önerilen yol)
- Sol menüden Tema Editörü'nü açın.
- Sağ paneli Tema Ayarları moduna alın ve Ödeme () sekmesine geçin.
- Ödeme Özellikleri başlığı altındaki Ödeme Logoları ayarını bulun.
- iyzico seçeneğini işaretleyin.
Seçenekler şunlardır:
| Seçenek | Ne yapar? |
|---|---|
| Otomatik | Bağlı ödeme entegrasyonunu izler. Hiçbiri bağlı değilse logo çıkmaz. Başvuru aşamasında işinize yaramaz. |
| iyzico | Entegrasyon bağlı olmasa bile Visa + Mastercard + iyzico bandını gösterir. Başvuru için bunu seçin. |
| PayTR | Entegrasyon bağlı olmasa bile PayTR logosunu gösterir. |
| Gösterme | Hiçbir ödeme logosu çıkmaz. |
Dikkat: Ödeme sekmesi Yayınla'yı beklemez; değişiklik birkaç saniye içinde otomatik kaydedilir ve mağazaya yansır.
Tek bir footer için ayrı seçim
Mağazanızda birden fazla footer bileşeni olabilir (Klasik, Ortalanmış, Sade ve Koyu footer). Her birinin kendi ayarları vardır:
- Tema Editörü'nde ilgili footer bloğuna tıklayın.
- Sağdaki Özellikler panelinde Ödeme Logolarını Göster anahtarını açık bırakın.
- Hemen altındaki Logo Seti listesinden seçim yapın:
- Tema ayarını kullan (varsayılan) — yukarıdaki mağaza geneli seçim geçerli olur.
- iyzico (Visa + Mastercard) — yalnız bu footer'da iyzico bandı.
- PayTR — yalnız bu footer'da PayTR logosu.
- Gösterme — yalnız bu footer'da logo yok.
İpucu: Blok ayarı, mağaza geneli ayarı ezer. Karışıklığı önlemek için normalde tüm footer'ları Tema ayarını kullan'da bırakın ve seçimi tek yerden, Ödeme sekmesinden yönetin.
Logolar nerede görünür?
- Footer'da: Visa + Mastercard + iyzico logo bandı. Footer'ın zemini koyuysa logonun beyaz, açıksa renkli sürümü otomatik seçilir.
- Ödeme sayfasında: kart bilgilerinin girildiği formun altında "iyzico ile Öde" rozeti. Bu rozeti ödeme formu bloğunun iyzico ile Öde Rozetini Göster ayarıyla ayrıca kapatabilirsiniz.
Dikkat: Logolar iyzico'nun kendi marka paketinden gelir ve Treyza içinde saklanır. Renklerini, oranlarını değiştirmeyin, kırpmayın; iyzico başvuruda buna da bakar.
3) iyzico'ya başvurun
Başvuruyu Treyza'dan değil, iyzico'nun kendi sitesinden yaparsınız. Başvuru sırasında genellikle şu belgeler istenir:
- İmza sirküleri
- Vergi levhası
- Şirket ortaklarının kimlik fotokopisi
- Hesap sahibinin adını ve IBAN'ı gösteren banka hesap belgesi
Başvuru formunda mağazanızın alan adını yazarsınız; iyzico bu adresi açıp yukarıdaki kriterleri kontrol eder.
İpucu: Başvurudan önce mağazanızı gizli/bakım modunda bırakmayın. iyzico siteyi göremezse başvuru ilerlemez.
Ne kadar sürer? Süre iyzico'nun yoğunluğuna ve belgelerinizin eksiksizliğine göre değişir. Eksik belge veya eksik kriter, süreci en çok uzatan sebeptir.
4) Anahtarları Treyza'ya girin
Başvurunuz onaylandıktan sonra iyzico size bir mağaza paneli verir. Anahtarları oradan alırsınız.
- iyzico panelinizde Ayarlar → API Anahtarları bölümüne gidin.
- API Key ve Secret Key değerlerini kopyalayın.
- Treyza'da sol menüden Entegrasyonlar sayfasını açın.
- Ödeme kategorisinde iyzico kartına tıklayın.
- Açılan pencerede alanları doldurun:
| Alan | Ne yazılır |
|---|---|
| API Key | iyzico panelindeki API anahtarınız |
| Secret Key | iyzico panelindeki gizli anahtarınız |
| Test Modu | Gerçek para çekmeden denemek için açılır (bkz. aşağıdaki bölüm) |
- Aynı pencerede Entegrasyonu Etkinleştir anahtarını açın.
- Kaydet'e basın. Anahtarlar ve açık/kapalı durumu birlikte kaydedilir.
Dikkat: Ödeme kategorisinde aynı anda yalnızca bir sağlayıcı açık olabilir. iyzico'yu açtığınızda PayTR veya Stripe açıksa otomatik olarak kapanır. Havale / EFT bu kuralın dışındadır; kartlı ödemenin yanında açık kalabilir.
İpucu: Secret Key şifreli saklanır ve mağaza vitrinine hiçbir zaman gönderilmez. Kart işlemleri sunucu tarafında yürütülür.
5) Test modu
Test Modu açıkken ödemeler iyzico'nun sandbox ortamına gider; gerçek para çekilmez. Bu mod için iyzico size ayrı test anahtarları verir.
- Test anahtarları normalde
sandbox-ön ekiyle başlar. - Test modunu açtığınızda test anahtarlarını da girin. Test modu açık ama test anahtarları boşsa ödeme başlatılmaz ve "Ödeme sağlayıcısı test modunda ama test anahtarları girilmemiş" hatası alırsınız — bu, canlı anahtarların yanlışlıkla test ortamına gönderilmesini engelleyen bir korumadır.
Dikkat: Mağazanızı canlıya alırken Test Modu'nu kapatmayı unutmayın. Test modu açık kaldığında müşteri ödeme yapmış görünür ama hesabınıza para geçmez.
6) Çalıştığını doğrulayın
- Vitrininizde bir ürünü sepete ekleyip Ödeme adımına gelin.
- Kredi Kartı seçeneğinin geldiğini ve kart formunun açıldığını görün.
- Kart formunun altında "iyzico ile Öde" rozetinin göründüğünü kontrol edin.
- Sayfanın en altına inip footer'da Visa + Mastercard + iyzico bandını görün.
- Test modunda küçük tutarlı bir sipariş deneyin ve Siparişler ekranında göründüğünü doğrulayın.
Sık sorulan
Logoları koydum ama vitrinde görünmüyor. Üç şeyi sırayla kontrol edin: (1) Tema Ayarları → Ödeme → Ödeme Logoları ayarı Gösterme olmasın, (2) footer bloğunun Ödeme Logolarını Göster anahtarı açık olsun, (3) o bloğun Logo Seti ayarı Gösterme olmasın. Vitrin sayfaları kısa süre önbelleklenir; değişiklikten hemen sonra bir kez sayfayı yenileyin.
Ayarı "Otomatik" bıraktım, logo çıkmıyor. Otomatik, bağlı ödeme entegrasyonuna bakar. Henüz iyzico'yu bağlamadıysanız bağlı bir sağlayıcı yoktur, dolayısıyla logo çıkmaz. Başvuru aşamasında ayarı iyzico yapın.
Birden fazla footer'ım var, hepsinde logo göstermek zorunda mıyım? Hayır, ama iyzico logoyu sitede görebilmek ister. Ziyaretçinin gördüğü footer'da logo yoksa kriter karşılanmamış sayılabilir. En güvenli yol: seçimi mağaza geneli Ödeme sekmesinden yapmak ve tüm footer bloklarını Tema ayarını kullan'da bırakmak.
Başvurum reddedildi, ne yapmalıyım? iyzico size hangi kriterin eksik olduğunu bildirir. En sık çıkanlar: yasal sayfaların eksik olması veya footer'dan erişilebilir olmaması, iletişim bilgilerinin eksikliği ve logoların bulunmaması. Eksiği tamamlayıp yeniden başvurun.
PayTR'de de aynı logo zorunluluğu var mı? PayTR'nin iyzico gibi yayımlanmış bir "logo zorunluluğu" maddesi bulunmuyor; PayTR başvurusunda öne çıkan şartlar SSL ve yasal sayfalardır (gizlilik, iade/iptal). Yine de PayTR logosunu göstermek isterseniz Ödeme Logoları ayarını PayTR yapabilirsiniz. Kesin şartlar için PayTR ile teyit edin.
Anahtarlarımı değiştirdim, ne olur? Yeni anahtarları girip Kaydet'e bastığınızda bağlantı hemen yenilenir. Devam eden ödemeler etkilenmez; sonraki ödemeler yeni anahtarlarla yürür.
İlgili sayfalar
- Entegrasyon kurma ve etkinleştirme adımları: Entegrasyonları Yönetme (Liste, Kurulum, Açma/Kapama)
- Hangi sağlayıcı hangi bilgiyi istiyor: Sağlayıcı Kataloğu (Hangi Entegrasyon Ne İster?)
- Ödeme logosu ayarının bulunduğu sekme: Tema Ayarları — Sabit Butonlar, Davranış ve Ödeme
- Footer bloklarının tüm ayarları: Bileşen Kataloğu (Tüm Bileşenler)
- Yasal sayfaları oluşturma: Yasal Sayfalar (Sözleşmeler)
Bu sayfa faydalı oldu mu?