Hemen Başla

1. Kimlik bilgisi alın

Geliştirmeye başlamak için işletme hesabı gerekmez: test hesabı için başvurursunuz; onaylanınca bir restoran ve bir Çarşı işletmesi için ck_test_ önekli anahtarlar verilir.

Canlı kimliği işletme oluşturur: partner panelindeki Entegrasyon sayfasında, Entegrasyon Bilgileri kartında Satıcı ID (API'deki merchantId), Entegrasyon Referans Kodu, ck_live_ önekli API Key, API Secret ve Token yer alır. İşletme bu bilgileri kasa yazılımınıza girer. API Secret ve Token yalnız oluşturuldukları anda gösterilir; kaybolursa yenilenir, geri getirilemez.

2. Temel adres

https://api.supergelsin.com/api/partner/v1

https://sandbox.supergelsin.com/api/partner/v1

İki ortam aynı yüzeyi sunar; farklı olan yalnız veri, anahtar öneki ve dış servislerdir. Yanlış ortama gönderilen anahtar 401 environment_mismatch alır. Yol önekleri yoktur: restoran ve Çarşı işletmeleri aynı uçları kullanır, işletmeyi ve dikeyi anahtar belirler.

3. İlk istek

Her istekte Basic kimlik doğrulaması ve X-Integrator başlığı zorunludur; X-Operator isteğe bağlıdır (bkz. Yetkilendirme). İlk çağrı ve düzenli izleme çağrısı GET /merchant olur.

curl "https://api.supergelsin.com/api/partner/v1/merchant" \
  -H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
  -H "X-Integrator: Ornek POS" \
  -H "X-Operator: kasiyer_01"

{
  "merchantId": "cm_ornek_isletme",
  "vertical": "restaurant",
  "name": "Örnek Restoran",
  "status": "open",
  "acceptingOrders": true,
  "busy": null,
  "autoPaused": null,
  "workingHours": null,
  "integrator": "Ornek POS",
  "serverTime": "2026-01-31T10:00:00.000Z"
}

Yanıttaki vertical değeri restaurant (restoran) ya da store (Çarşı işletmesi) olur. Her yanıt bir X-Request-Id taşır; destek talebinde bu değeri iletin. Ayrıntı için İşletme sayfasına bakın.

4. Test siparişi üretin

Entegrasyonu tamamlamak için üç şeyi denemeniz gerekir: webhook almak, sipariş okumak, durum yazmak. Gerçek müşteri beklemeden kendi kimliğinizle test siparişi üretebilirsiniz. Uç gövde okumaz.

curl -X POST "https://api.supergelsin.com/api/partner/v1/orders/test" \
  -H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
  -H "X-Integrator: Ornek POS" \
  -H "X-Operator: kasiyer_01"

Yanıt 201 ve GET /orders/{id} ile aynı gövdedir; isTest alanı true olur. Sipariş işletmenin kendi menüsünden (restoran) ya da satışa açık ürünlerinden (Çarşı) kalem seçer. Webhook adresiniz tanımlıysa order.created olayı gerçek imzayla iletilir ve sipariş GET /orders listesinde görünür.