FirsatGO Geliştirici Portalı — POS Entegrasyonu
POS / e-ticaret yazılımınızı FirsatGO'ya bağlayarak sipariş, menü/katalog, durum ve stok işlemlerini API üzerinden gerçekleştirin. FirsatGO platform (talep ağı), siz entegratörsünüz; kanonik sözleşmeye uyum sağlarsınız.
🚀 Başlangıç
- Başlangıç Rehberi — üç yüzey, kimlik & HMAC güvenlik, idempotency, olay türleri, go-live.
- Tam API Sözleşmesi — alan-bazlı referans (endpoint'ler, payload şemaları, imza).
📦 Sektör Entegrasyonları
Ortak sözleşme aynıdır; sipariş yaşam-döngüsü ve sektör-özel alanlar sektöre göre değişir. İşletmenizin sektörünü seçin:
| Sektör | Engine | Kapsam |
|---|---|---|
| 🍔 Yemek | food | restaurant, cafe, fast_food, bakery — menü + malzeme modifier (eklenen/çıkarılan) |
| 🛒 Market | retail | market, tekel, hırdavat, aydınlatma, yapı-market, genel-perakende — SKU/barkod/stok + substitution + yaş-doğrulama |
| 🐾 Petshop | pet | petshop — market + lot/SKT (FEFO) + mama aboneliği |
| 💐 Çiçek | flower | florist, aranjman, etkinlik — alıcı/gönderen/kart-notu/teslim-slotu/teslim-kanıtı |
| 🔧 Hizmet | service | saha, profesyonel, hibrit — sipariş değil iş-emri (randevu tabanlı, ayrı akış) |
🔑 Temel kavramlar (özet)
- Üç yüzey: A (FG→POS REST), B (POS→FG
/integration/*), C (POS→FG webhook). - Güvenlik:
X-Api-Key(REST) + HMACsha256=HMAC_SHA256(webhook_secret,"{ts}.{rawBody}")+ ±5dk replay. - İdempotency:
X-FirsatGo-Delivery-Id/event_id— aynı olayı iki kez işlemeyin. - Para: TRY, major +
*_minor(kuruş).original_subtotal − discount_amount + ücretler = total.
📨 Destek
Entegrasyon soruları / sözleşme değişiklikleri → FirsatGO entegrasyon ekibi. Sürüm: as-built 2026-06.