Entegrasyonları Yönetme (Liste, Kurulum, Açma/Kapama)

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 pencerede anahtarları girer, Entegrasyonu Etkinleştir anahtarıyla açar/kapatır ve Kaydet'e basarsı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ş → Güvenlik → E-posta → Yapay Zeka → E-Fatura → Pazaryerleri → Sosyal Medya. İç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.

2. Entegrasyon kartını okuma

Her kart, tek bir servisi temsil eder. Bir kartta şunlar bulunur:

Kartın üzerine geldiğinizde sağ tarafta bir ok (›) belirir. Karta tıklamak, o entegrasyonun yapılandırma penceresini ekranın ortasında açar.

3. Bir entegrasyonu yapılandırma (ayarları girme)

1. İlgili entegrasyonun kartına tıklayın. Ekranın ortasında bir pencere açılır.
2. Pencerenin üstünde servisin logosu, adı ve açıklaması görünür. Bazı entegrasyonlarda hemen altında "Kurulum rehberi: anahtar / jeton nasıl alınır?" bağlantısı bulunur; ilgili yardım sayfasını yeni sekmede açar.
3. Pencerede, 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. Bazı alanların altında, değeri servisin panelinde nerede bulacağınızı anlatan kısa bir açıklama yazar.
4. Alanları doldurun. Bazı alanlar açılır liste (örneğin Test Modu açık/kapalı) veya açma-kapama anahtarı şeklinde olabilir.
5. Pencerenin altındaki Kaydet butonuna basın. Başarılı olursa "Ayarlar kaydedildi" bildirimi çıkar ve pencere kapanır. Vazgeçmek isterseniz İptal'e basın.

Zorunlu bir alan boşsa ya da değer beklenen biçimde değilse kayıt yapılmaz; sebebi ilgili alanın altında kırmızıyla yazar (ör. "Bu alan zorunludur.").

E-posta, Güvenlik ve Sosyal Medya kategorilerinde pencerenin altında Bağlantı Test Et düğmesi de bulunur: girdiğiniz bilgileri kaydetmeden önce servisle dener ve sonucu bildirim olarak gösterir. Kayıtlı bir şifre ya da anahtarın alanını boş bıraktıysanız deneme kayıtlı değerle yapılır.

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.

Ö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.

Özel durum: Havale / EFT — banka hesapları

Ödeme kategorisindeki Havale / EFT entegrasyonunda anahtar girmek yerine banka hesaplarınızı eklersiniz. Pencerede 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 pencerede, 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 penceresinde, giriş alanlarının altında Entegrasyonu Etkinleştir başlıklı bir açma-kapama anahtarı bulunur.

• Anahtarı açıp Kaydet'e bastığınızda entegrasyon devreye girer.
• Kapatıp Kaydet'e bastığınızda durur; ayarlarınız silinmez, saklı kalır.

5. "Ayarları güncellendi" uyarısı (şema güncellemesi)

Bir entegrasyonun penceresini 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? Hayır. Kaydettiğiniz şifre ve anahtarlar güvenlik için bir daha açık hâliyle gösterilmez: pencereyi yeniden açtığınızda alan boş görünür, altında yalnız son dört karakteri yazar (ör. "Kayıtlı anahtar: ••••1234"). Değiştirmek için yeni değeri boş alana yapıştırıp Kaydet'e basın. Değiştirmek istemiyorsanız alanı boş bırakın; kayıtlı değer korunur. İsteğe bağlı bir şifreyi ya da anahtarı tamamen kaldırmak için bu satırın yanındaki Kaldır'ı kullanın: satırda "Kaydedince kaldırılacak" yazar ve değer Kaydet'e bastığınızda silinir. Vazgeçmek için Geri al'a basın; alana yeni bir değer yapıştırırsanız da kaldırma iptal olur ve yeni değer kaydedilir. Zorunlu alanlarda (yanında * olanlar) Kaldır yoktur; onları yalnız yeni değerle değiştirebilirsiniz.