SSS ve Destek

Sıkça Sorulan Sorular

Genel

MuditaPOS'u kullanmak için ne gerekli?

Bir HTTP sunucusu ve webhook endpoint'i oluşturabilmeniz yeterli. Node.js, Python, PHP, Java, Go, .NET — istediğiniz teknolojiyi kullanabilirsiniz.

Hangi platformlar destekleniyor?

Getir, Yemeksepeti, Trendyol GO, Migros Yemek, Getir Su ve SepetTakip. Detaylar için Desteklenen Platformlar sayfasına bakın.

Birden fazla restoran bağlayabilir miyim?

Evet. Her restoran için ayrı bir Integration kaydı oluşturulur. Tek müşteri hesabı altında sınırsız entegrasyon tanımlanabilir.

Test ortamı var mı?

Evet. Stage ortamı (stage.pos.muditakurye.com.tr) üzerinde gerçek sipariş oluşturmadan test yapabilirsiniz.

Webhook

Webhook'u kaçırırsam ne olur?

MuditaPOS 3 kez retry yapar (1 dakika aralıkla). 3 başarısız denemeden sonra Telegram bildirimi gönderilir. Siparişler veritabanında korunur.

Webhook URL'mi değiştirebilir miyim?

Evet. MuditaPOS yönetim ekibine yeni URL'nizi bildirmeniz yeterli. Değişiklik anında geçerli olur.

HTTPS zorunlu mu?

Production ortamında evet, HTTPS zorunludur. Stage ortamında HTTP de kabul edilir.

Webhook isteği ne kadar sürede timeout olur?

10 saniye. Bu sürede yanıt vermezseniz timeout olur ve retry mekanizması devreye girer.

200 dışında bir kod döndürdüm, ne olur?

Retry tetiklenir. 201, 202, 204 dahil tüm 2xx kodları da retry tetikler. Sadece 200 kabul edilir.

Status Update

Durum güncellemesi göndermek zorunlu mu?

Platformlar bunu bekler. Özellikle Getir'de sipariş onayı (VERIFY) yapılmazsa sipariş iptal edilebilir.

Yanlış sırada durum gönderirsem ne olur?

MuditaPOS sequence guard uygulanır. Mantıksız geçişler (örn: DELIVER before VERIFY) reddedilir ve hata döner.

Aynı durumu iki kez gönderirsem?

İdempotency koruması sayesinde aynı aksiyon ikinci kez gönderilmez. Güvenle tekrar deneyebilirsiniz.

Güvenlik

API Key çalınırsa ne olur?

Hemen MuditaPOS ekibine bildirin. Mevcut anahtar iptal edilir ve yeni anahtar üretilir.

İmza doğrulama zorunlu mu?

Zorunlu değil ama şiddetle tavsiye edilir. Üçüncü şahısların sahte webhook göndermesini engeller.

---

Sorun Giderme

Webhook Alınamıyor

1. Endpoint erişilebilir mi? → curl -I https://your-url/webhooks/new-order
2. Firewall kuralları → MuditaPOS IP'lerinin açık olduğundan emin olun
3. SSL sertifikası → Geçerli ve zincir tamamlanmış mı?
4. Timeout → 10 saniye içinde yanıt veriliyor mu?

Status Update Hatası

1. API Key doğru mu? → X-Internal-Api-Key header kontrol edin
2. Platform kodu doğru mu? → Büyük harf kullanın: GETIR, YEMEKSEPETI
3. providerOrderId doğru mu? → Platformun verdiği orijinal ID'yi kullanın
4. Sıra doğru mu? → VERIFY → PREPARE → HANDOVER → DELIVER

Mükerrer Sipariş

MuditaPOS mükerrer siparişleri otomatik filtreler. Yine de kendi tarafınızda providerOrderId ile kontrol yapmanızı öneririz.

---

İletişim

Kanal	Bilgi
E-posta	info@muditayazilim.com.tr
Telefon	+90 (553) 205 55 67
Telegram	Entegrasyon grubunuz üzerinden
Çalışma Saatleri	Hafta içi 09:00 - 18:00 (İstanbul)

Acil Durumlar

Production'da sipariş akışını etkileyen kritik sorunlarda Telegram grubunuz üzerinden anında destek alabilirsiniz. 7/24 destek mevcuttur.