İsteğin yapısı
| Özellik | Değer |
|---|---|
| Yöntem | POST |
| Gövde biçimi | JSON |
| İçerik | Sipariş paketlerini çekme servisiyle aynı modelde tam paket verisi |
| Kimlik doğrulama | Basic Auth (username, password) ya da x-api-key başlığı |
| Tetikleyen olaylar | Abone olunan sipariş paketi statüleri |
Gövdede shipmentPackageId, orderNumber, status, lines, shipmentAddress, invoiceAddress, kargo bilgileri ve tutar alanları bulunur. Model zamanla genişler: Eylül 2026'da ödeme yöntemi için paymentMethod alanı eklendi; Yurt Dışı Aracılığı siparişlerinde invoiceStatus ve invoiceRejectedReasonKeys alanları da gelir. Alan ayrıntıları için sipariş paketlerini çekme sayfasına bakın.
Yeniden deneme ve pasife alma
- Webhook adresinize yapılan bir istek başarısız olursa Trendyol, başarılı olana kadar her 5 dakikada bir yeniden gönderir. Doküman bu kuralın ileride değişeceğini not eder.
- Sıkça sorulan sorulara göre 13 kez hata alınırsa webhook otomatik pasife alınır ve iki bilgilendirme e-postası gönderilir.
- Pasife düşen webhook, sorun giderildikten sonra activate servisiyle yeniden aktife alınır.
- Trendyol tarafında da kesinti olabilir. Örneğin 6 Ekim 2026'da 11:02 ile 12:25 arasında webhook'a sipariş düşmedi; veriler sonradan aktarıldı ve kontrol için o aralığın sipariş servisinden çekilmesi önerildi.
Güvenilir bir alıcı nasıl kurulur?
| Uygulama | Neden |
|---|---|
| İsteği hemen 2xx ile yanıtlayın, işi arka planda yapın | Uzun işlem zaman aşımına ve gereksiz yeniden denemeye yol açar |
| Kimlik doğrulama başlığını her istekte kontrol edin | Sahte isteklerin siparişlerinizi değiştirmesini önler |
| İşlemleri tekrar güvenli yapın (idempotent) | Aynı paket 5 dakikalık denemelerle birden çok kez gelebilir |
| Paketi shipmentPackageId ve son değişiklik zamanıyla kaydedin | Eski bir bildirimin yeni durumu ezmesini önler |
| Ham gövdeyi kısa süre saklayın | Hata ayıklamada gerçek veriyi görmenizi sağlar |
| Periyodik sipariş çekmeyi sürdürün | Webhook her zaman iletilemeyebilir; Trendyol bunu açıkça önerir |
Webhook ile çekmeyi birlikte kullanmak
Webhook, yeni siparişi dakikalar içinde fark etmenizi sağlar; periyodik çekme ise kaçan bildirimleri tamamlar. Önerilen düzen şudur: webhook geldiğinde ilgili paketi işleyin, ayrıca düzenli aralıklarla akış servisiyle son değişen paketleri tarayın ve iki kaynağı shipmentPackageId ile birleştirin.
Bu düzen, sipariş çekme limitini de rahatlatır. Yalnız sık sorgulamaya dayanan bir entegrasyon en düşük kademedeki dakikada 30 istek sınırına çabuk takılır; webhook ile birlikte daha seyrek tarama yeterli olur.
Sık sorulanlar
Trendyol webhook hangi olaylarda istek gönderir?
Abone olduğunuz sipariş paketi statülerinde: CREATED, PICKING, INVOICED, SHIPPED, CANCELLED, DELIVERED, UNDELIVERED, RETURNED, UNSUPPLIED, AWAITING, UNPACKED, AT_COLLECTION_POINT ve VERIFIED.
Webhook gövdesinde ne gelir?
Statü fark etmeksizin sipariş paketlerini çekme servisindeki modelle aynı, tam sipariş paketi verisi JSON olarak gelir.
Webhook isteği başarısız olursa ne olur?
Trendyol başarılı olana kadar 5 dakikada bir yeniden gönderir. Sıkça sorulan sorulara göre 13 hatadan sonra webhook pasife alınır.
Webhook varsa sipariş çekmeye gerek var mı?
Evet. Trendyol webhook ile veri gönderiminin her zaman mümkün olmadığını belirtir ve sipariş servisinden periyodik eşitleme yapmanızı önerir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı