API

Entegrasyonlar için belgelenmiş API

Web sitesi, platform veya teslimat hizmeti işletme anahtarıyla çalışır. Anahtar yalnızca tek bir işletme için geçerlidir, anında iptal edilir ve diğer işletmelerin verilerine erişim vermez — bunu ayrı bir kontrol değil, sistemin yapısı sağlar.

Back office: website section — storefront with dish photos from the till menu

Entegrasyon neler yapabilir

📋

Menü ve uygunluk

Vitrin kategorileri, ürünleri, fiyatları, ekstraları ve fotoğrafları alır — satıştan kaldırılmış kalemler olmadan ve “işletme şu an sipariş almıyor” işaretiyle birlikte.

🧾

Sipariş kabulü

Sipariş tek bir istekle oluşturulur ve bir numara alır. Aynı isteğin tekrarı ikinci bir sipariş oluşturmaz.

✏️

Değişiklik ve iptal

İşletme siparişi kabul edene kadar kaynak içeriğini değiştirebilir veya iptal edebilir.

🎟

Promosyon kodu kontrolü

Kupon POSitive tarafında kontrol edilir, böylece vitrindeki ve kasadaki indirim birbirinden farklı olmaz.

💳

Ödeme bildirimi

Vitrin tarafında alınan ödeme işletmenin ödeme yöntemiyle eşleştirilir — para doğru hesaba geçer.

↩️

Geri dönen durumlar

Kabul edildi, hazırlanıyor, kuryeye verildi, tamamlandı — bildirimler kaynağa gider ve ortak bir sırla imzalanır.

Spesifikasyon yayınlanmaz. Yöntem adresleri, alanlar, hata kodları ve istek örnekleri anahtarla birlikte verilir — işletmeye, geliştiricisine veya iş ortağına. Nedeni basit: vitrinde yayınlanan bir sözleşme, entegratörden çok başkalarının entegrasyonlarını arayanların işine yarar. Açıklamayı tek bir talep ile alabilirsiniz, aynı gün yanıt veririz.

Sözleşmenin garanti ettikleri

🔁

Tekrar güvenliği

Aynı işlem anahtarıyla yeniden gönderim ikinci bir sipariş oluşturmaz. Çift tıklamaya ve bağlantı kopmalarına karşı korur.

🔐

İmza ve anahtarlar

Anahtar tek bir işletme için geçerlidir ve anında iptal edilir. Sır, hash olarak saklanır ve bizim tarafımızdan bile geri getirilemez. Anahtar misafirin tarayıcısında değil, iş ortağının sunucusunda durur.

🧾

Açıklayıcı hatalar

Yanıt, genel bir “400 Bad Request” yerine tam olarak hangi kalemin neden geçmediğini söyler.

🛑

Güncel stop listesi

Menü, satıştan kaldırılmış kalemler olmadan iletilir: kasada durdurulan kalem siteden hemen kaybolur.

↩️

Geri bildirim kanalı

Sipariş durumu kaynağa döner: kabul edildi, hazırlanıyor, kuryeye verildi, tamamlandı.

🧪

Test ortamı

Ayrı anahtarı olan bir test işletmesi: entegrasyon, canlı verilere dokunmadan kurulup denenebilir.

Anahtar veya sözleşme mi gerekiyor?

Alanları ve örnekleriyle açıklamayı gönderir, test ortamını açar ve entegrasyon sorularınızı yanıtlarız.