Ödeme başarılı → fatura e-postası
- checkout-completed olayı SendNomi adresinize düşer
- İmza doğrulanır, olay kabul edilir
- Otomasyon, fatura şablonuyla işlemsel e-postayı gönderir
- Müşteri faturasını saniyeler içinde gelen kutusunda bulur
Ödeme onayı, yeni sipariş, çağrı durumu, release — sağlayıcılarınızın webhook'ları tek adreste toplanır. SendNomi imzayı doğrular, olayı kendi endpoint'inize temiz iletir; ulaşmayanı kuyruğa alır, tek tıkla geri gönderirsiniz. Webhook handler'ını elde yazma devri bugün kapanır.
Panelde bir alıcı oluşturursunuz: kaynak tipini seçer, sağlayıcınızın shared secret'ını yapıştırırsınız. Size üretilen SendNomi adresini sağlayıcının webhook ayarına girdiğinizde bağlantı tamamdır. Ödeme, kod hosting, telefoni, e-ticaret ve CRM için en yaygın imza şemaları yerleşiktir; listede olmayan servisi kendi secret'ınız ve header adınızla, özel HMAC tanımıyla bağlarsınız.
HMAC-SHA256 HMAC-SHA256 HMAC (URL-aware) HMAC-SHA256 HMAC veya OAuth bearer kendi secret’ınız Her sağlayıcının kendi HMAC şeması vardır; imzayı sizin yerinize SendNomi doğrular. SHA-256 ve SHA-1 imzaları desteklenir; timestamp + nonce denetimi, aynı isteğin yeniden oynatılmasını (replay) engeller. Doğrulanamayan istek 401 ile reddedilir ve her olay — kabul ya da ret — log'a işlenir. Payload yalnız imza geçtiğinde yola devam eder.
# İmzalı test olayı gönderin — doğrulamayı canlı izleyin
curl -X POST https://app.sendnomi.com/api/webhooks/inbound/<hesap-id>/test \
-H "Content-Type: application/json" \
-H "X-Signature: sha256=<imza>" \
-d '{"event":"test","payload":{...}}'
# 200 OK → imza geçerli, olay kabul edildi
# 401 → imza geçersiz ya da yeniden oynatılmış (replay) istek Header'lar normalleştirilir, payload istenirse dönüştürülür ve kendi endpoint URL'inize iletilir. Endpoint'iniz o an yanıt veremezse SendNomi 3 deneme + eksponansiyel backoff ve jitter ile tekrar dener; her deneme 30 saniyelik zaman aşımına bağlıdır. Aynı olay kimliği iki kez gelirse 24 saatlik dedup penceresi sayesinde bir kez işlenir — müşteriniz mükerrer e-posta ya da kayıt görmez.
Canlı olay akışı her webhook'u durumuyla listeler: kabul, ret, iletim, yeniden deneme. Delivery tester ile endpoint'inize panelden test olayı gönderir, yanıtı satır içinde görürsünüz. Tüm denemelere rağmen ulaşmayan olay dead-letter kuyruğuna düşer; sorunu giderdiğinizde tek tıkla yeniden gönderirsiniz. Hiçbir olay sessizce kaybolmaz.
payment.checkout_completed 200 · iletildi order.created 200 · iletildi call.status_changed yeniden deneme 2/3 release.published dead-letter Yeniden gönder unknown.source 401 · imza geçersiz Ücretsiz hesabınızı oluşturun — ayda 500 gönderim, süresiz.