KargoJet Dokümantasyon

Webhooklar

Gönderi, takip, iade ve kapıda ödeme olaylarını sisteminize gerçek zamanlı iletin.

Son güncelleme: 2026-05-09

Olay modeli

Webhooklar KargoJet'te oluşan operasyon olaylarını sisteminize bildirir. En yaygın olaylar gönderi oluşturma, etiket oluşturma, takip güncelleme, teslim, iade ve kapıda ödeme tahsilatıdır.

POST/v1/webhooks/endpoints

Webhook endpoint'inizi kaydeder ve hangi olayları dinleyeceğinizi belirler.

Örnek payload

{
  "id": "evt_01HX...",
  "type": "shipment.delivered",
  "createdAt": "2026-05-09T11:00:00Z",
  "data": {
    "shipmentId": "shp_01HX...",
    "trackingNumber": "3489123412",
    "carrierCode": "aras"
  }
}

Güvenlik

Webhook imzasını her istekte doğrulayın.
Aynı event birden fazla kez gelebilir; event id ile idempotent işlem yapın.
Başarılı işleme sonrası 2xx yanıt döndürün.

const expectedSignature = createHmac("sha256", webhookSecret)
  .update(rawBody)
  .digest("hex");