Oluşturma alanları
| Alan | Tip | Açıklama |
|---|---|---|
| url | metin | Trendyol'un bildirim göndereceği adres |
| authenticationType | metin | BASIC_AUTHENTICATION ya da API_KEY |
| username / password | metin | Basic Auth seçildiyse zorunlu |
| apiKey | metin | API_KEY seçildiyse zorunlu; Trendyol isteğe x-api-key başlığıyla ekler |
| subscribedStatuses | dizi | Bildirim alınacak statüler; boş gönderilirse tümü |
subscribedStatuses boş bırakılırsa bütün statüler atanır ve listeye ileride eklenen statüler de aboneliğe otomatik eklenir. Statüler CREATED, PICKING, INVOICED, SHIPPED, CANCELLED, DELIVERED, UNDELIVERED, RETURNED, UNSUPPLIED, AWAITING, UNPACKED, AT_COLLECTION_POINT ve VERIFIED'dir.
Yönetim servisleri
| İşlem | Yöntem ve yol (/integration/webhook sonrası) |
|---|---|
| Oluşturma | POST /sellers/{sellerId}/webhooks |
| Listeleme | GET /sellers/{sellerId}/webhooks |
| Güncelleme | PUT /sellers/{sellerId}/webhooks/{Id} |
| Silme | DELETE /sellers/{sellerId}/webhooks/{Id} |
| Aktife alma | PUT /sellers/{sellerId}/webhooks/{Id}/activate |
| Pasife alma | PUT /sellers/{sellerId}/webhooks/{Id}/deactivate |
Listeleme yanıtı her webhook için id, url, username, authenticationType, status (ACTIVE ya da PASSIVE), subscribedStatuses, createdDate ve lastModifiedDate döner. Tarihler GMT+3 zaman damgasıdır. Güncelleme isteği oluşturma ile aynı alanları alır.
Kurallar
- Webhook adresi "Trendyol", "Dolap" ya da "Localhost" ifadesi içermemelidir. Adresinizi seçerken alan adı ve yol bölümünde bu kelimelerin geçmediğinden emin olun.
- Satıcı başına en fazla 15 webhook tanımlanabilir; pasif olanlar da sayılır. Sınıra ulaştıysanız kullanılmayanı silip yenisini tanımlayın.
- İstekler Basic Authentication ile yetkilendirilir; satıcı ID, API Key ve API Secret satıcı panelindeki Entegrasyon Bilgileri sayfasından alınır.
- Webhook sipariş paketleri içindir. Ürün, stok, iade ya da soru olayları için webhook tanımlanmaz; bu verileri ilgili servislerden çekmeniz gerekir.
Örnek kurulum
Aşağıdaki değerler örnektir; alan adı, anahtar ve satıcı bilgileri sahtedir.
- url: https://ornek-magaza.com/siparis-bildirim
- authenticationType: API_KEY
- apiKey: GIZLI_ANAHTAR
- subscribedStatuses: CREATED, CANCELLED, UNSUPPLIED
Bu tanımla Trendyol yalnız yeni, iptal edilen ve tedarik edilemeyen paketler için bildirim gönderir ve her isteğe x-api-key: GIZLI_ANAHTAR başlığını ekler. Alıcı tarafta önce bu başlığı doğrulayın, sonra isteği işleyin. Kurulumdan sonra listeleme servisiyle webhook'un ACTIVE olduğunu kontrol edin; test ortamında aynı servisler stageapigw.trendyol.com adresinde çalışır.
Pasife düşen webhook
Trendyol'un sıkça sorulan sorularına göre webhook adresinize gönderilen isteklerde 13 kez hata alınırsa sistem webhook'u otomatik olarak pasife alır. Bu süreçte iki e-posta gönderilir: ilki hata alınan webhook kimliğini ve isteklerin ne kadar süre daha deneneceğini, ikincisi sürenin dolduğunu ve webhook'un pasife alındığını bildirir.
| Adım | Ne yapılır |
|---|---|
| 1 | Adresinizin erişilebilir olduğunu ve 2xx yanıt verdiğini doğrulayın |
| 2 | Kimlik doğrulama bilgilerinin webhook tanımıyla aynı olduğunu kontrol edin |
| 3 | Listeleme servisiyle webhook'un PASSIVE olduğunu görün |
| 4 | activate servisiyle yeniden aktife alın |
| 5 | Kesinti süresindeki siparişleri sipariş servisinden çekerek eksikleri tamamlayın |
Sık sorulanlar
Trendyol webhook nasıl oluşturulur?
POST /integration/webhook/sellers/{sellerId}/webhooks servisine url, authenticationType, kimlik bilgileri ve isteğe bağlı subscribedStatuses gönderin. Yanıttaki id ile webhook'u yönetirsiniz.
Kaç webhook tanımlayabilirim?
Satıcı başına en fazla 15. Pasife alınmış webhook'lar da bu sayıya dahildir.
Webhook adresimde hangi kelimeler olamaz?
Doküman webhook adresinin "Trendyol", "Dolap" ve "Localhost" ibarelerini içermemesini ister.
API_KEY seçersem anahtar nasıl gönderilir?
Trendyol webhook isteğinde anahtarı x-api-key başlığında gönderir. Basic Auth seçerseniz username ve password kullanılır.
Webhook ürün veya stok değişikliğini bildirir mi?
Hayır. Trendyol webhook modeli sipariş paketleri içindir ve sipariş statüleri için bildirim gönderir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı