Webhooks: sipariş ve ürün olaylarını kendi sisteminize bildirme

Ayarlar › Webhooks sayfası, seçtiğiniz olaylar olduğunda kendi sunucunuza imzalı (HMAC-SHA256) bir POST isteği gönderir. API anahtarlarıyla birlikte entegrasyonların temelidir.

1/3Bildirim gidecek uç nokta adresini girin.https://sizinsiteniz.com/webhooks/arsigo

Olaylar

• order.created Sipariş oluşturuldu · order.paid Ödeme alındı · order.shipped Kargoya verildi · order.delivered Teslim edildi · order.cancelled İptal edildi
• product.created Ürün eklendi · product.updated Ürün güncellendi

İmza doğrulama

Her istek X-Arsigo-Signature: sha256=… başlığıyla imzalanır; olay türü X-Arsigo-Event başlığında gelir. Gövdenin (ham, raw body) HMAC-SHA256 değerini webhook'un secret değeriyle hesaplayıp başlıktaki değerle karşılaştırın.

// Node.js örneği
const crypto = require("crypto");
const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers["x-arsigo-signature"]));

Yönetim

• Test gönder (kâğıt uçak simgesi): örnek bir istek yollar, sonucu HTTP koduyla gösterir.
• Göz simgesi: webhook'u pasifleştirir ya da aktifleştirir (yeşil nokta aktif).
• Çöp kutusu: webhook'u siler.
• Secret satırı: göz simgesiyle gösterir, kopyala simgesiyle kopyalar.
• Son teslimatlar: son 30 gönderimin durumunu (Başarılı / Hata ve HTTP kodu) gösterir.