Pazaryeri & POS Entegrasyonları

Restoran panelinizden platformları bağlayın; siparişler otomatik KuryeX'e düşer.

Getir YemekOtomatik sipariş ve durum senkronu Trendyol GoÇoklu mağaza desteği YemeksepetiWebhook ile anlık sipariş Migros YemekMağaza bazlı entegrasyon SepettakipRestoran eşlemeli sipariş aktarımı Adisyo / Mutfak POS / GoPOSPOS ve mutfak sistemleri SuitablePOSExternal order + durum webhook

POS yazılımınız varsa soldan API Dokümantasyonu ve POS Partner Kayıt bölümlerine geçin.

POS Partner API

Webhook ile sipariş gönderin, durum bildirimlerini iki yönlü alın/verin. Tek API anahtarı, REST JSON. Canlı test ortamında deneyin →

Başlangıç

Kayıt

Soldan POS Partner Kayıt

API anahtarı

E-posta ile kxpos_…

Mağaza eşlemesi

storeId tanımı

Webhook

POST sipariş

Kimlik doğrulama

Başlık	Değer
`X-API-Key`	`kxpos_xxxxxxxx…`
`Authorization`	`Bearer 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

Alan	Tip	Açıklama
`orderId` *	string	POS sipariş ID
`storeId` *	string	Mağaza kodu (eşleşmiş)
`source`	string	Kanal adı
`customer.phone`	string	5xxxxxxxxx
`address.fullAddress`	string	Teslimat adresi
`payment.totalPrice`	number	Toplam 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)

Bize bir webhook URL ve api-key verin; sipariş durumu değiştikçe KuryeX aşağıdaki gövdeyle POST atar (Header: api-key).

orderStatusText	Anlamı
`ACCEPTED`	Kurye siparişi kabul etti
`PICKED_UP`	Paket kuryede, yolda
`DELIVERED`	Teslim edildi
`CANCELLED`	İptal edildi (+ `cancelledText`)

{
  "storeId": "MAGAZA-001",
  "orderId": "ORD-001",          // sizin sipariş kimliğiniz
  "internalOrderId": 12345,      // KuryeX sipariş no
  "orderStatusText": "PICKED_UP",
  "eventTime": "2026-08-11T10:15:00.000Z"
}

Webhook adresinizi test sayfasından kendiniz kaydedebilir veya info@kuryex.net ile iletebilirsiniz. 2xx dışındaki yanıtlar loglanı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:

Test mağazası

storeId → Gaziantep test restoranı

Sipariş gönder

Gerçek payload ile canlı deneme

Simüle et

Kabul → Kuryede → Teslim / İptal

Doğrula

Webhook'unuza gelen bildirimleri izleyin

Mağaza eşlemesi

Her storeId bir KuryeX restoran ID ile eşleştirilmelidir. Kayıt formunda veya info@kuryex.net ile liste gönderebilirsiniz.

POS Partner Kayıt

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

15 Gün Ücretsiz Bölge Demo

Bayi yönetim paneli — bölgenizde kurye ağını yönetin.