Gerçek zamanlı olaylar

Webhooks ile sisteminizi tetikleyin

Ödeme ve faturalama olaylarını HTTPS uç noktanıza iletin; imza doğrulaması, yeniden deneme ve teslim geçmişi tek yerde. Dashboard ve API aynı olay modelini paylaşır.

Teslim hatti

Olaydan uç noktaya tek çizgi

Üç eşit kart yerine; bağlantının kendisi okunur. Vurgu sırayla ilerler, mobilde dikey, masaüstünde yatay akış korunur.

Olay
Ödeme veya abonelik
hsrcpay
İmzalı HTTP POST
Sizin URL
HTTPS endpoint
Onay
2xx veya kuyruk

Neden ayrı bir entegrasyon katmanı?

Anket veya yoklama yerine sunucunuz olanı anında öğrenir. Başarısız teslimlerde üstel geri deneme, imza başlığı ve gövde bütünlüğü ile sahteciliği düşürürsünüz.

  • Her teslimat için benzersiz imza ve zaman damgası
  • 4xx ve 5xx ayrımı; geçici hatalarda üstel bekletme
  • Aynı olay için yeniden oynatma ve idempotent işleyiş önerileri
  • Dashboard üzerinden son denemeler ve yanıt gövdesi
webhook_deliveryattempt_1
POST /hooks/hsrcpay
X-Hsrcpay-Signature doğrulama
200 işleniyor…
yeniden deneme kuyruğu beklemede

Gösterim amaçlıdır; üretimde uç nokta URL ve imza sırrı sizin tarafta kalır.

Asimetrik yerleşim

Geniş olay alanı, kısa operasyon notları ve durum şeridi. Gölge yok; sadece kenar ve yüzey ayrımı.

Olay kataloğu

Tahsilat, iade, abonelik ve fatura yaşam döngüsü aynı isimlendirme uzayı altında gelir. Filtreleyin, sürümleyin, hangi ortamın hangi URL ile dinlediğini ayrı ayrı tanımlayın.

type payment_intent.succeeded

Yeniden deneme

Geçici hatalarda otomatik aralık artışı.

Gecikme bütçesi

SLA dostu üst sınır ve ölü harf kuyruğu.

Uç nokta politikası

HTTPS zorunluluğu, izin verilen IP listesi ve başlık şeması tek ekranda; değişiklikler sürümle birlikte yayınlanır.

POST https://api.sizinalanadiniz.com/hooks/hsrcpay

Doğrulama özeti

  • İmza eşleşti
  • Bekleyen yeniden deneme
  • Kalıcı başarısızlık

Webhook'ları önce test ortamında dinleyin, sonra üretime taşıyın.

Çift yönlü doğrulama ve gizli anahtar rotasyonu için dokümantasyondaki adımları izleyin.