İçeriğe geç

Webhook'lar

Yeni sipariş, ödeme, sipariş durumu, yeni üye ve iade talebi olaylarını dış sistemlere anında bildirmek; imza doğrulama ve yeniden deneme.

Panelde: Ayarlar › Webhook'lar

Webhook, mağazanızda bir olay olduğunda kendi sisteminize (ERP, muhasebe, depo yazılımı, Zapier, Make, n8n …) anında HTTP bildirimi gönderir. REST API'yi sürekli sorgulamanıza gerek kalmaz. Webhook'lar REST API Erişimi ücretli ek modülüyle birlikte gelir.

Olaylar

OlayNe zaman
siparis.olusturulduVitrinde yeni sipariş oluşunca (havale, kapıda ödeme, kart ödemesi başlarken)
siparis.odendiKart ödemesi ya da alışveriş kredisi onaylanınca
siparis.durumSipariş durumu panelden, kargo entegrasyonundan ya da otomasyondan değişince
musteri.olusturulduVitrinde üye olununca (e-posta ya da Google/Apple ile)
iade.talebiMüşteri iade talebi açınca

Sipariş olaylarında veri alanında sipariş no, durum, ödeme, tutarlar, müşteri, teslimat adresi, kargo bilgisi ve ürünler bulunur.

Webhook ekleme

  1. Ayarlar › Webhook'lar ekranında adresi (canlı mağazada https:// zorunlu) ve olayları seçip Ekle'ye basın.
  2. Gösterilen imza anahtarını alıcı sisteme kaydedin; sayfadan ayrılınca bir daha tam görünmez. Kaybederseniz Yeni anahtar oluşturun.
  3. Dene düğmesi test olayı gönderir; sonucu ekranda görürsünüz.

İstek biçimi ve imza

Bildirim POST ile JSON gövdeyle gider: {"olay": "siparis.olusturuldu", "id": "…", "zaman": "…", "magaza": "https://…", "veri": {…}}.

Başlıklar: X-Kodend-Olay, X-Kodend-Teslim, X-Kodend-Zaman (Unix zamanı) ve X-Kodend-Imza. İmza sha256= + HMAC-SHA256(X-Kodend-Zaman + . + ham gövde, imza anahtarı) değerinin onaltılık yazımıdır. Alıcı:

  1. Aynı imzayı kendisi hesaplayıp sabit zamanlı karşılaştırmayla eşleştirmeli,
  2. X-Kodend-Zaman 5 dakikadan eskiyse isteği reddetmeli,
  3. Aynı id iki kez gelirse (yeniden deneme) ikinciyi yok saymalıdır.

Yeniden deneme

Alıcı 10 saniye içinde 2xx yanıt vermezse bildirim 1, 5 ve 30 dakika, 2 ve 6 saat sonra yeniden denenir; sonra Ulaşmadı olur. Son bildirimler tablosunda her bildirimin sonucu ve alıcının yanıtı görünür; ulaşmayanları Yeniden gönder ile tekrar yollayabilirsiniz. Webhook'u kapatırsanız sıradaki bildirimler iptal edilir.

Güvenlik için bildirimler iç ağ adreslerine gönderilmez ve yönlendirmeler izlenmez.

Son güncelleme: 2026-10-27