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.

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.