Entegrasyonları Yönetme (Liste, Kurulum, Açma/Kapama)
Entegrasyon kartına tıklayıp açılan panelde anahtarları girer, kaydeder ve Entegrasyonu Etkinleştir anahtarıyla açar/kapatırsınız.
Nerede bulunur: Sol menü → Entegrasyonlar Kimler için: Bir servisi (ödeme, kargo, analitik vb.) ilk kez kuran veya mevcut bir entegrasyonun ayarlarını değiştirmek isteyenler. Kısaca: Entegrasyon kartına tıklayıp açılan panelde anahtarları girer, kaydeder ve Entegrasyonu Etkinleştir anahtarıyla açar/kapatırsınız.
Ne işe yarar?
Bu sayfa, Entegrasyonlar ekranının nasıl çalıştığını adım adım anlatır: entegrasyonların nasıl listelendiği, kartların ne anlama geldiği, bir entegrasyonun nasıl yapılandırılıp etkinleştirildiği ve karşınıza çıkabilecek uyarılar.
1. Sayfanın genel görünümü
Sayfanın en üstünde başlık (Entegrasyonlar) ve altında "Mağaza entegrasyonlarını yönetin" açıklaması bulunur.
Hemen altında bir arama kutusu vardır: "Entegrasyon ara...". Buraya yazdığınız metin, entegrasyonun adına veya açıklamasına göre listeyi anında filtreler. Örneğin "kargo" yazarsanız yalnızca kargo entegrasyonları kalır.
Arama kutusunun altında, entegrasyonlar kategori bölümleri hâlinde alt alta sıralanır. Bölümler her zaman şu sırayla gelir: Ödeme → Kargo → Analitik → Site Doğrulama → Sosyal Giriş → E-posta → Yapay Zeka → E-Fatura → Pazaryerleri. İçinde hiç entegrasyon olmayan kategori gösterilmez.
Her kategori bölümünün başında: renkli bir ikon, kategori adı (örneğin Ödeme) ve kısa açıklaması (örneğin "Ödeme sağlayıcıları ve ödeme yöntemleri") yer alır. Altında o kategorinin entegrasyon kartları kart ızgarası şeklinde dizilir.
İpucu: Aradığınızı bulamıyorsanız ya o kategoride henüz hiç entegrasyon tanımlı değildir ya da arama kutusuna yazdığınız kelime eşleşmiyordur. Arama sonuç vermezse "Sonuç bulunamadı", hiç entegrasyon yoksa "Henüz entegrasyon yok" yazısı görünür.
2. Entegrasyon kartını okuma
Her kart, tek bir servisi temsil eder. Bir kartta şunlar bulunur:
| Öğe | Anlamı |
|---|---|
| Logo | Servisin logosu (yoksa kategorinin ikonu gösterilir) |
| Ad | Servisin adı (örneğin iyzico, Trendyol) |
| Global etiketi | Bu entegrasyonun ayarının tüm mağazalarınız için ortak (hesap düzeyinde) tutulduğunu belirtir |
| Yeşil tik | Entegrasyonun şu an açık/etkin olduğunu gösterir |
Kartın üzerine geldiğinizde sağ tarafta bir ok (›) belirir. Karta tıklamak, o entegrasyonun yapılandırma panelini sağdan açar.
İpucu: Bir entegrasyonun açık olup olmadığını anlamak için kartın sağındaki yeşil tike bakın. Tik yoksa entegrasyon kapalıdır (ayarlarını girmiş olsanız bile çalışmaz).
3. Bir entegrasyonu yapılandırma (ayarları girme)
- İlgili entegrasyonun kartına tıklayın. Sağdan bir panel açılır.
- Panelin üstünde servisin logosu, adı ve açıklaması görünür.
- Panelde, o servise özel giriş alanları listelenir. Bu alanlar her servis için farklıdır; örneğin bir ödeme sağlayıcısı API Key ve Secret Key isterken, bir kargo firması Kullanıcı Adı ve Şifre ister. Zorunlu alanların yanında kırmızı bir yıldız (
*) bulunur. - Alanları doldurun. Bazı alanlar açılır liste (örneğin Test Modu açık/kapalı) veya açma-kapama anahtarı şeklinde olabilir.
- Panelin altındaki Kaydet butonuna basın. Başarılı olursa "Ayarlar kaydedildi" bildirimi çıkar. Vazgeçmek isterseniz İptal'e basın.
Hangi entegrasyonun tam olarak hangi alanları istediğini önceden görmek için Sağlayıcı Kataloğu (Hangi Entegrasyon Ne İster?) sayfasına bakın.
Dikkat: Girdiğiniz API anahtarları ve şifreler hassas bilgilerdir. Yanlış veya eksik girilirse entegrasyon çalışmaz (örneğin ödeme alınamaz). Anahtarları ilgili servisin resmi panelinden kopyaladığınızdan ve fazladan boşluk bırakmadığınızdan emin olun.
Özel durum: Test Modu
Birçok ödeme ve kargo entegrasyonunda bir Test Modu (bazı yerlerde "Sandbox") anahtarı vardır. Açık olduğunda işlemler gerçek değil, deneme ortamında yapılır. Gerçek satışa geçtiğinizde bu anahtarı kapatmayı unutmayın.
Dikkat: Test Modu açıkken gerçek ödeme alınmaz. Mağazanız canlıya geçtiğinde ödeme ve kargo entegrasyonlarınızda test modunun kapalı olduğunu mutlaka kontrol edin.
Özel durum: Havale / EFT — banka hesapları
Ödeme kategorisindeki Havale / EFT entegrasyonunda anahtar girmek yerine banka hesaplarınızı eklersiniz. Panelde Banka Hesapları bölümünden Hesap Ekle ile her hesap için Banka, IBAN ve Hesap Sahibi bilgilerini girersiniz.
- IBAN, TR ile başlayıp ardından 24 rakam içermelidir; aksi hâlde "Geçerli bir IBAN giriniz (TR + 24 rakam)" uyarısı çıkar.
- Bu hesaplar, müşteriniz ödeme adımında "Havale/EFT" seçtiğinde ona gösterilir.
Özel durum: PayTR bildirim (webhook) adresi
PayTR entegrasyonunda panelde, kopyalamanız için özel bir bildirim URL'si gösterilir. Bu adresi PayTR'nin kendi mağaza panelindeki bildirim/webhook ayarlarına yapıştırmanız gerekir; aksi hâlde ödeme sonuçları mağazanıza düzgün ulaşmaz.
4. Bir entegrasyonu etkinleştirme / devre dışı bırakma
Yapılandırma panelinin üst kısmında Entegrasyonu Etkinleştir başlıklı bir açma-kapama anahtarı bulunur.
- Anahtarı açtığınızda entegrasyon devreye girer.
- Kapattığınızda durur; ayarlarınız silinmez, saklı kalır.
Dikkat: Bazı kategoriler için ekranda şu uyarı görünür: "Bu kategori için sadece bir entegrasyon aktif olabilir." Bu, o kategoride (örneğin Ödeme, E-posta, Yapay Zeka, E-Fatura) aynı anda yalnızca tek bir entegrasyonun açık kalabileceği anlamına gelir. Yeni birini açarsanız, aynı kategorideki önceki açık entegrasyon otomatik olarak kapanır. Bir kategoride tek seçimin zorunlu olup olmadığını Sağlayıcı Kataloğu (Hangi Entegrasyon Ne İster?) sayfasındaki tablodan görebilirsiniz.
5. "Ayarları güncellendi" uyarısı (şema güncellemesi)
Bir entegrasyonun panelini açtığınızda üstte sarı bir uyarı görebilirsiniz: "Bu entegrasyonun ayarları güncellendi. Lütfen yapılandırmayı kontrol edin."
Bu, Treyza tarafında o entegrasyonun istediği alanların güncellendiği anlamına gelir. Yeni bir alan eklenmiş veya değişmiş olabilir. Bu uyarıyı görürseniz alanları gözden geçirip yeniden Kaydet'e basmanız yeterlidir.
Sık sorulan
Kaydettim ama entegrasyon çalışmıyor, ne yapmalıyım? Önce Entegrasyonu Etkinleştir anahtarının açık olduğundan emin olun. Sonra anahtarların doğru kopyalandığını ve test modunun durumunu kontrol edin. Hâlâ sorun varsa girdiğiniz bilgileri ilgili servisin panelinden tekrar doğrulayın.
Aynı kategoride birden fazla entegrasyonu açık tutabilir miyim? "Bu kategori için sadece bir entegrasyon aktif olabilir" uyarısını gösteren kategorilerde hayır; tek seçim zorunludur. Bu uyarıyı göstermeyen kategorilerde (örneğin Analitik, Kargo) ise birden fazlasını aynı anda açık tutabilirsiniz.
Girdiğim şifreyi/anahtarı sonradan görebilir miyim? Hassas alanlar güvenlik için gizlenir. Değiştirmeniz gerekirse alanı yeniden doldurup kaydedebilirsiniz.