Webhook'lar
Olaylar
Olay listesi
order.createdstatus: pendingSipariş oluşturuldu
Sipariş hangi kanaldan gelirse gelsin (API, panel, platform) sisteme yazıldığında.
order.assignedstatus: assigned · acceptedKurye atandı
Siparişe kurye atandığında ya da kurye değiştiğinde. Kurye teklifi kendisi kabul ettiyse durum doğrudan accepted olur ve ayrıca order.accepted gelmez.
order.acceptedstatus: acceptedKurye kabul etti
Doğrudan atanan sipariş kurye tarafından kabul edildiğinde.
order.courier_arrivedstatus: at_restaurantKurye işletmeye vardı
Kurye işletmeye vardığını bildirdiğinde.
order.picked_upstatus: picked_upPaket yola çıktı
Kurye paketi teslim aldığında.
order.at_customerstatus: at_customerKurye adreste
Kurye teslimat adresine vardığını bildirdiğinde.
order.deliveredstatus: deliveredTeslim edildi
Sipariş teslim edildiğinde.
order.failedstatus: failedTeslim edilemedi
Kurye siparişi teslim edemediğini bildirdiğinde; sebep cancel_reason alanında.
order.cancelledstatus: cancelledİptal edildi
Sipariş panelden, API'den ya da bağlı bir platformdan iptal edildiğinde.
order.unassignedstatus: pendingKurye ataması kaldırıldı
Kurye siparişten alındığında; sipariş yeniden atamaya döner.
Kurye firması webhook kaydında yalnızca bazı olayları seçtiyse diğerleri gönderilmez. Olay adları değişmez; ileride yeni olaylar eklenebilir, tanımadığınız olayları 200 dönüp yok sayın.
Tipik bir teslimatın olayları
order.created pending
order.assigned accepted (kurye teklifi kabul etti)
order.courier_arrived at_restaurant
order.picked_up picked_up
order.at_customer at_customer
order.delivered deliveredDoğrudan atanan siparişte order.assigned (assigned) ve ardından order.accepted gelir. Kurye işletmeye varmadan paketi alırsa order.courier_arrived hiç gelmeyebilir; adrese varış bildirilmeden teslim edilirse order.at_customer da gelmeyebilir. Ara olayları zorunlu varsaymayın.
Gövde
Bütün sipariş olaylarının gövdesi aynı biçimdedir: event, sent_at ve siparişin tam hali order. Alanların açıklamaları: Sipariş nesnesi.
{
"event": "order.delivered",
"sent_at": "2026-11-20T18:33:07.512Z",
"order": {
"id": 1842,
"code": "2611200042",
"status": "delivered",
"status_label": "Teslim edildi",
"source": "api",
"is_simulated": false,
"external_code": "A-52",
"restaurant": {
"id": 1,
"name": "Lezzet Dürüm",
"address": "Caferağa Mah. Moda Cad. No:3 Kadıköy",
"phone": "02165550101",
"lat": 40.9869,
"lng": 29.0262
},
"courier": {
"id": 7,
"name": "Ahmet Yılmaz",
"phone": "05550000001",
"vehicle_type": "motorcycle",
"photo_url": null
},
"customer_name": "Ayşe Yılmaz",
"customer_phone": "05321234567",
"address": "Caferağa Mah. Moda Cad. No:12 Kadıköy",
"address_detail": "Kat 3, Daire 7",
"directions": "Eczanenin yanındaki bina",
"lat": 40.9969,
"lng": 29.0342,
"payment_type": {
"id": 1,
"name": "Kapıda Nakit",
"kind": "cash",
"collect_from_customer": true
},
"total_amount": 285.5,
"collect_amount": 285.5,
"package_count": 1,
"items": [
{
"name": "Tavuk Dürüm",
"price": 120,
"quantity": 2
},
{
"name": "Ayran",
"price": 45.5,
"options": [
"Büyük"
],
"quantity": 1
}
],
"note": "Zili çalmayın",
"is_ready": true,
"prep_minutes": 15,
"ready_at": "2026-11-20T18:21:10.000Z",
"scheduled_at": null,
"distance_m": 1754,
"duration_s": 253,
"eta_at": null,
"route_seq": 1,
"business_date": "2026-11-20",
"created_at": "2026-11-20T18:10:32.000Z",
"assigned_at": "2026-11-20T18:12:05.000Z",
"accepted_at": "2026-11-20T18:12:05.000Z",
"arrived_restaurant_at": "2026-11-20T18:19:51.000Z",
"picked_up_at": "2026-11-20T18:24:40.000Z",
"arrived_customer_at": "2026-11-20T18:32:12.000Z",
"delivered_at": "2026-11-20T18:33:07.000Z",
"cancelled_at": null,
"cancel_reason": null,
"delivery_note": null,
"proof_photo_url": null,
"customer_id": 311,
"tracking_token": "oKe9xPqrlr7b_4jbNQiNCw",
"restaurant_fee": 70
}
}Deneme olayı: webhook.test
Paneldeki Deneme Çağrısı düğmesi aşağıdaki gövdeyi, gerçek olaylarla aynı başlık ve imzayla gönderir. Gövdede order yoktur; "test": true vardır.
{
"event": "webhook.test",
"sent_at": "2026-11-20T18:10:42.093Z",
"test": true,
"message": "Bu bir deneme çağrısıdır."
}Alıcınız webhook.test olayına da 200 dönmeli; panel deneme sonucunu bu yanıta göre gösterir.