İçeriğe geç
KuryeSoft

Webhook'lar

Olaylar

Gönderilen olaylar, ne zaman gönderildikleri ve gövdenin tam hali.

Olay listesi

order.createdstatus: pending

Sipariş oluşturuldu

Sipariş hangi kanaldan gelirse gelsin (API, panel, platform) sisteme yazıldığında.

order.assignedstatus: assigned · accepted

Kurye 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: accepted

Kurye kabul etti

Doğrudan atanan sipariş kurye tarafından kabul edildiğinde.

order.courier_arrivedstatus: at_restaurant

Kurye işletmeye vardı

Kurye işletmeye vardığını bildirdiğinde.

order.picked_upstatus: picked_up

Paket yola çıktı

Kurye paketi teslim aldığında.

order.at_customerstatus: at_customer

Kurye adreste

Kurye teslimat adresine vardığını bildirdiğinde.

order.deliveredstatus: delivered

Teslim edildi

Sipariş teslim edildiğinde.

order.failedstatus: failed

Teslim 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: pending

Kurye 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ı

event · order.status
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        delivered

Doğ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.

order.delivered
{
  "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.

webhook.test
{
  "event": "webhook.test",
  "sent_at": "2026-11-20T18:10:42.093Z",
  "test": true,
  "message": "Bu bir deneme çağrısıdır."
}
İpucu:

Alıcınız webhook.test olayına da 200 dönmeli; panel deneme sonucunu bu yanıta göre gösterir.