Pazaryeri & POS Entegrasyonları

Platformları restoran panelinden bağlayın; siparişler otomatik olarak KuryeX'e aktarılır ve sipariş durumu platforma geri yazılır.

Getir YemekOtomatik sipariş ve durum senkronu Trendyol GoOtomatik sipariş ve durum senkronu YemeksepetiWebhook ile anlık sipariş aktarımı Migros YemekMağaza bazlı entegrasyon SepetTakipRestoran eşlemeli sipariş aktarımı Adisyo / Mutfak POS / GoPOS / DesenPOS / CubePOSPOS ve mutfak sistemleri SuitablePOSHarici sipariş ve durum webhook'u

POS yazılımı geliştiriyorsanız soldaki API Dokümantasyonu ve POS Partner Kayıt bölümlerini inceleyin.

POS Partner API

Siparişleri webhook ile gönderin, sipariş durumlarını iki yönlü senkronize edin. Tek API anahtarı, REST/JSON. Canlı test ortamında deneyin → Firma teknik dokümanı → Kurye uygulamanız için satış görüşmesi →

Başlangıç

1
Kayıt

Soldaki POS Partner Kayıt formu

2
API anahtarı

E-posta ile kxpos_…

3
Mağaza eşlemesi

storeId tanımı

4
Webhook

Sipariş için POST isteği

Kimlik doğrulama

BaşlıkDeğer
X-API-Keykxpos_xxxxxxxx…
AuthorizationBearer kxpos_xxxxxxxx…

Sipariş webhook

POST/api/pos-partners/webhook/order

Content-Type: application/json

GET/api/pos-partners/webhook/order

Sağlık kontrolü (kimlik doğrulama gerekmez)

İstek gövdesi

AlanTipAçıklama
orderId *stringPOS sipariş ID
storeId *stringMağaza kodu (eşleşmiş)
sourcestringKanal adı
customer.phonestring5xxxxxxxxx
address.fullAddressstringTeslimat adresi
payment.totalPricenumberToplam TL

Örnek istek

curl -X POST "https://kuryex.net/api/pos-partners/webhook/order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kxpos_ANAHTARINIZ" \
  -d '{"orderId":"ORD-001","storeId":"MAGAZA-001","source":"Restoran"}'

Yanıtlar

200 — success: true, internalOrderId

401 — Geçersiz API anahtarı

404 — storeId eşlemesi yok

409 — Yinelenen sipariş

Durum bildirimleri (KuryeX → POS)

Webhook adresinizi ve api-key değerinizi iletin; sipariş durumu değiştikçe KuryeX bu adrese aşağıdaki gövdeyle POST isteği gönderir (Header: api-key).

orderStatusTextAnlamı
ACCEPTEDKurye siparişi kabul etti
PICKED_UPPaket kuryede, yolda
DELIVEREDTeslim edildi
CANCELLEDİptal edildi (+ cancelledText)
 
{
  "storeId": "MAGAZA-001",
  "orderId": "ORD-001",          // sizin sipariş kimliğiniz
  "internalOrderId": 12345,      // KuryeX sipariş no
  "orderStatusText": "PICKED_UP",
  "eventTime": "2025-08-11T10:15:00.000Z"
}

Webhook adresinizi test sayfasından kendiniz kaydedebilir veya info@kuryex.net ile iletebilirsiniz. 2xx dışındaki yanıtlar kayıt altına alınır; endpoint'iniz {"success": true} dönmelidir.

Sipariş iptali (POS → KuryeX)

POST/api/pos-partners/webhook/status
{
  "storeId": "MAGAZA-001",
  "orderId": "ORD-001",
  "orderStatusText": "CANCELLED",
  "cancelledText": "Müşteri vazgeçti"
}

Alternatif kısayol: PUT /api/pos-partners/webhook/order/{orderId}/cancel (body: storeId, reason). Teslim edilmiş sipariş iptal edilemez (409). Gelen yönde yalnızca CANCELLED kabul edilir; diğer durumlar KuryeX → POS yönünde bildirilir.

Canlı test ortamı

API anahtarınızla entegrasyon test sayfasına bağlanın ve akışı uçtan uca deneyin:

1
Test mağazası

storeId → test restoranı

2
Sipariş gönderimi

Gerçek payload ile canlı deneme

3
Simülasyon

Kabul → Kuryede → Teslim / İptal

4
Doğrulama

Webhook'unuza gelen bildirimleri izleyin

Mağaza eşlemesi

Her storeId bir KuryeX restoran ID ile eşleştirilmelidir. İlk eşlemeyi kayıt formunda yapabilir, diğer mağazaların listesini info@kuryex.net adresine gönderebilirsiniz.

POS Partner Kayıt

API anahtarınız e-postanıza gönderilir.

15 Gün Ücretsiz Bölge Demo

Bayi paneliyle bölgenizdeki restoranları, kuryeleri ve siparişleri tek ekrandan yönetin.