Hayır. Platformumuz PostgreSQL şema izolasyon teknolojisini kullanır. Her mağazanın ürünleri, siparişleri ve müşteri bilgileri tamamen kendine ait şemalarda (schema) tutulur ve fiziksel olarak yalıtılmıştır.

MonoMaza, dahili iyzico, paytr ödeme geçidi entegrasyonuna sahiptir. Onboarding esnasında iyzico API, PayTR anahtarlarınızı girerek anında kredi kartı ve banka kartıyla güvenli ödemeler almaya başlayabilirsiniz. Ayrıca farklı bir ödeme anlaşmanız varsa bize bildirerek ekranınıza eklenmesini sağlayabilirsiniz.

Evet. Mağazanızın yönetim panelinden kendi alan adınızı (örn: magazam.com) sistemimize bağlayabilirsiniz. Platformumuz SSL sertifikasını otomatik olarak sağlayacaktır.

Kendi alan adınızı MonoMaza mağazanıza bağlamak için aşağıdaki 3 adımı eksiksiz tamamlamanız gerekmektedir: 1. Mağaza Paneline Ekleme: Mağaza yönetim panelinizde Ayarlar > Özel Alan Adı (Domain) sayfasına giderek bağlamak istediğiniz alan adını girin ve kaydedin. 2. DNS A Kaydı Yönlendirmesi: Alan adı sağlayıcınızın (GoDaddy, Turhost, Natro vb.) DNS yönetim paneline girerek alan adınızın A kaydını, mağaza panelinizde size gösterilen sunucu IP adresine yönlendirin. 3. DNS TXT Doğrulama Kaydı: Alan adının size ait olduğunu doğrulamamız amacıyla panelde üretilen size özel güvenlik kodunu (örn: monomaza-verify=abc123xyz) DNS ayarlarınıza yeni bir TXT kaydı olarak ekleyin. DNS yönlendirmelerini tamamladıktan sonra mağaza panelinizdeki "Şimdi Doğrula" butonuna tıklayarak işlemi anında tamamlayabilirsiniz. Sistemimiz A ve TXT kayıtlarını doğruladığında otomatik olarak SSL (güvenli HTTPS) kurulumunu yapacaktır.

# API Entegrasyonu — Sık Sorulan Sorular (SSS) --- ## 🔌 Genel ### API nedir ve ne işe yarar? API (Application Programming Interface — Uygulama Programlama Arayüzü), mağazanızın verilerine dış yazılımlardan otomatik olarak erişilmesini ve güncellenebilmesini sağlayan bir köprüdür. MonoMaza API sayesinde: - **ERP ve muhasebe yazılımlarınız** siparişleri otomatik çekebilir - **Stok yönetim programları** anlık stok güncellemesi yapabilir - **Entegratör firmalar** (Monotegra, Sopyo, Entegra vb.) mağazanızı pazaryerleriyle bağlayabilir - **Kendi geliştirdiğiniz uygulamalar** mağaza verinize erişebilir --- ### API'yi kullanmak için teknik bilgiye ihtiyacım var mı? API'yi doğrudan kullanmak için yazılım bilgisi gerekir. Ancak **Sopyo, Entegra gibi entegratör firmalar** bu teknik süreci sizin adınıza yönetir. Siz sadece API anahtarınızı oluşturup entegratöre iletirsiniz; geri kalanını onlar halleder. --- ### Hangi platformlarla entegre olabilirim? MonoMaza'nın açık API'si herhangi bir yazılımla entegre olabilir. Yaygın kullanım senaryoları: - **Pazaryerleri:** Trendyol, Hepsiburada, n11, Amazon — entegratör firma aracılığıyla - **ERP sistemleri:** Logo, Mikro, Netsis, SAP - **Muhasebe yazılımları:** E-fatura entegratörleri (Paraşüt, KolayBi) - **Kargo yönetimi:** Aras, Yurtiçi, Sürat API'leri ile entegrasyon --- ## 🔑 API Anahtarı ### API anahtarını nasıl oluşturabilirim? 1. Mağaza Yönetim Paneli'ne giriş yapın 2. Sol menüden **Ayarlar → Entegrasyonlar & API** sekmesine tıklayın 3. **"Pazaryeri ve Açık API Anahtarları"** bölümünde bir açıklama girin (örn: *"MonoTegra Bağlantısı"*) 4. **"+ Yeni Oluştur"** butonuna tıklayın 5. Ekranda beliren anahtarı kopyalayın > ⚠️ **Önemli:** Anahtar size **yalnızca bir kez** gösterilir. Mutlaka kopyalayıp güvenli bir yere kaydedin. --- ### API anahtarımı kaybettim, ne yapmalıyım? MonoMaza, güvenliğiniz için API anahtarlarını geri döndürülemez biçimde şifreler; bu nedenle kaybedilen bir anahtarı yeniden gösterme imkânımız yoktur. **Yapmanız gereken:** 1. **Ayarlar → Entegrasyonlar & API** sayfasına gidin 2. Eski anahtarın yanındaki **"İptal Et"** butonuna tıklayın 3. Yeni bir anahtar oluşturun 4. Entegratör firmanıza yeni anahtarı iletin --- ### Kaç adet API anahtarı oluşturabilirim? Birden fazla anahtar oluşturabilirsiniz. Her entegrasyon için ayrı bir anahtar kullanmanızı öneririz. Bu sayede tek bir entegrasyona erişimi kapatmak istediğinizde diğerleri etkilenmez. --- ### API anahtarım başka biri tarafından ele geçirilirse ne olur? **Hemen** Entegrasyonlar & API sayfasına gidip ilgili anahtarı **"İptal Et"** butonu ile devre dışı bırakın. Her anahtar mağazanıza özgü olduğundan başka bir mağazada kullanılamaz. Yeni bir anahtar oluşturarak güvenli biçimde devam edebilirsiniz. --- ## 🔄 Entegratör Firmalar ### Sopyo veya Entegra gibi bir firmayla çalışıyorum. Ne yapmam gerekiyor? 1. Yukarıdaki adımları izleyerek bir API anahtarı oluşturun 2. Anahtarı ve mağaza adresinizi (örn: `sizinmagazaniz.monomaza.com`) entegratöre iletin 3. Entegratör firma bu bilgilerle sisteminize bağlanır ve siparişleri otomatik yönetmeye başlar --- ### WooCommerce eklentisi kullanan bir entegratöre sahibim. Çalışır mı? Monomaza API'si, WooCommerce'den ilham alan bir yapıdadır. Sipariş yanıtlarındaki alan adları (`billing`, `shipping`, `line_items`) WooCommerce ile büyük ölçüde uyumludur. Çoğu entegratör firma, yalnızca **API adresini** (Base URL) değiştirerek sorunsuz bağlanabilir. Uyumluluk konusunda entegratörünüzle iletişime geçmenizi öneririz. --- ## 📊 Sipariş ve Stok Yönetimi ### Entegratör sipariş durumunu nasıl güncelleyebilir? Entegratör firma, sipariş kargoya verildiğinde şu durumları güncelleyebilir: | Durum | Açıklama | |-------|----------| | `pending` | Yeni / Ödeme bekleniyor | | `confirmed` | Onaylandı | | `preparing` | Hazırlanıyor | | `shipped` | Kargoya verildi | | `completed` | Teslim edildi | | `cancelled` | İptal edildi | Kargoya verilen siparişler için kargo firması ve takip numarası da sisteme işlenebilir. --- ### Stok güncelleme nasıl yapılır? Entegratör firma, SKU, barkod veya stok kodu üzerinden anlık stok güncellemesi yapabilir. Ürün varyantları da desteklenmektedir. Güncelleme anında mağaza ön yüzüne yansır. --- ### API üzerinden yeni sipariş oluşturabilir miyim? Hayır. Siparişler yalnızca müşterilerin mağaza üzerinden alışveriş yapmasıyla oluşturulur. API şu an için **okuma ve güncelleme** işlemlerini destekler. --- ## 🛡️ Güvenlik ### API erişimim güvenli mi? Evet. MonoMaza API güvenliği birden fazla katmanla sağlanmaktadır: - **HTTPS:** Tüm istekler şifreli bağlantı üzerinden iletilir - **Anahtar şifreleme:** API anahtarları veritabanında SHA-256 ile şifreli saklanır; düz metin olarak tutulmaz - **Mağaza kısıtlaması:** Her anahtar yalnızca ait olduğu mağaza adresinde geçerlidir; başka bir mağaza adresinde kullanılamaz - **Anlık iptal:** İstediğiniz zaman anahtarı tek tıkla devre dışı bırakabilirsiniz --- ### API isteklerinin bir limiti var mı? Belirli bir süre içinde çok fazla istek yapılması durumunda sistem geçici olarak `429 Too Many Requests` yanıtı dönebilir. Normal entegrasyon trafiğinde bu sınıra ulaşılmaz. Yoğun toplu senkronizasyon işlemleri için istekleri kısa aralıklarla gönderin. --- *Daha fazla teknik bilgi için mağaza panelinizden destek talebinde bulunabilirsiniz.*

Desi, kargo taşımacılığında paketlerin hacimsel ağırlığını ifade eden bir ölçü birimidir. Kargo şirketleri, gönderinin taşıma ücretini belirlerken paketin gerçek ağırlığı (kg) ile hacimsel ağırlığını (desi) hesaplar ve hangi değer daha yüksekse kargo ücretlendirmesini o değer üzerinden yapar. Desi hesaplama işlemi e-ticaret siteleri ve kargo firmaları için standart bir uygulamadır. Buradan desi hesaplama aracımıza ulaşabilirsiniz.