HMAC-SHA256 İmzalı · Deterministik event_id · 6 Aşamalı Yeniden Deneme

Birleşik Kripto Ödeme Webhook Olayları ve Teslimat Mimarisi.

Sipariş teslimatını, SaaS koltuk yükseltmelerini, oyuncu bakiye yüklemelerini ve ES256 yazılım lisansı üretimini imzalı ve idempotent HMAC-SHA256 webhook'larıyla desteklenen 12 blokzincirin tamamında otomatikleştirin.

🧪 Etkileşimli HMAC Webhook Test Aracı 🔐 İmza Doğrulama Teknik İncelemesi 🔁 İdempotensi Mimarisi Rehberi ⚖️ Eksik / Fazla Ödeme Rehberi

Olay Türünü Seçin (9 Standart Olay)

HTTP Başlıkları ve JSON Olay Yükü


        

    


    

        
Sabit Zamanlı HMAC-SHA256 Doğrulaması (6 Dil)

        

            
            
            
            
            
            
        

        

    


    

        

            Güvenilirlik
            
6 Aşamalı Üstel Yeniden Deneme Takvimi

            
2xx dışındaki yanıtlar şu aralıklarda otomatik yeniden denemeleri tetikler: 30s → 2m → 10m → 1h → 6h → 24h; ayrıca İşyeri Webhook Günlüklerinizden tek tıkla manuel yeniden gönderim yapılabilir.

        

        

            Defter Bütünlüğü
            
Benzersiz event_id İdempotensisi

            
Bakiyeleri alacaklandırmadan veya dijital ürünleri teslim etmeden önce event_id değerini bir UNIQUE veritabanı anahtarı olarak saklayın; böylece yeniden denemeler teslimatı asla kopyalamaz.

        

        

            Giden Trafik Güvenliği
            
TLS Sabitlemeli ve SSRF Korumalı

            
XPayr sıkı HTTPS, DNS sabitlemeli genel IP çözümlemesi, CURLOPT_FOLLOWLOCATION=falseve 5 dakikalık tekrar penceresi zaman damgası başlıklarını zorunlu kılar.

        

    


    

        
Webhook'lar ve Geri Çağırmalar SSS

                    

                Bir webhook'un gerçekten XPayr'dan geldiğini nasıl doğrularım?
                
whsec_ uç nokta sırrınızı kullanarak ayrıştırılmamış ham HTTP istek gövdesi üzerinde tam olarak HMAC-SHA256 hesaplayın ve onaltılık özeti crypto.timingSafeEqual (Node.js), hmac.compare_digest (Python) veya hash_equals (PHP) gibi sabit zamanlı bir fonksiyonla X-XPayr-Signature ile karşılaştırın.

            

                    

                payment.completed ile payment.underpaid_accepted arasındaki fark nedir?
                
payment.completed, zincir üstü transfer tam fatura tutarına eşit olduğunda veya bu tutarı aştığında tetiklenir. payment.underpaid_accepted ise bir Doğrudan Borsa QR çekimi XPayr'ın 1% (maks. $0.50) tolerans eşiği içinde ulaştığında tetiklenir ve defterinizin kuruşu kuruşuna doğru kalması için hem requested_amount hem de received_amount değerlerini sunar.

            

                    

                XPayr uç nokta kesintilerini veya 5xx yanıtlarını nasıl yönetir?
                
HTTP 200–299 dışındaki (veya 10 saniyeden yavaş) her yanıt, aynı event_id değerini koruyarak XPayr'ın üstel geri çekilmeli yeniden deneme kuyruğuna (30s, 2m, 10m, 1h, 6h, 24h) girer; böylece idempotency tablonuz mükerrer alacak kaydını önler.

            

                    

                İşyeri webhook uç noktaları için hangi URL güvenlik kuralları geçerlidir?
                
Canlı ortam webhook hedefleri, geçerli TLS sertifikalarına sahip genel yönlendirilebilir DNS/IP'ler üzerinden HTTPS kullanmalıdır. XPayr, SSRF saldırılarını önlemek için şifresiz HTTP'yi, özel/loopback RFC1918 aralıklarını, bulut meta veri IP'lerini ve HTTP yönlendirmelerini engeller.