Webhook test araci

Webhook geri çağrılarını test edinİmzayı doğrulayın

Örnek gövdeyi düzenleyin, HMAC-SHA256 imzası ve cURL isteği oluşturun. Doğrulamayı test ortamınızda kontrol edin.

Webhook imza çalışma alanı

Testi yapılandırın, gövdeyi düzenleyin, imzayı ve isteği kopyalayın.

01

Testi yapılandırın

Adres, test anahtarı ve zaman damgasını girin.

İmza tarayıcıda hesaplanır. Test anahtarı kullanın.

BoltUtil başlıklarıyla uyumlu, milisaniye cinsinden Unix zaman damgası.

02

Gövdeyi düzenleyin, imza oluşturun

JSON düzenlendiğinde imza ve cURL güncellenir.

Imza

HMAC-SHA256

Geçerli anahtar, zaman damgası ve JSON girin.

Zaman damgası, ham gövde ve test anahtarından hesaplanır.

Geçerli JSON
cURL / POSTTest isteği
Geçerli adres, anahtar, zaman damgası ve JSON girin.

USDC sipariş geri çağrısı örneği; USDT olarak değiştirilebilir. Sipariş, adresler ve işlem karması örnektir, ödeme kanıtı değildir.

Araç istek göndermez. cURL komutunu test ortamınızda elle çalıştırın.

İmza doğrulama

Devam etmeden doğrulayın

Aynı kuralla doğrulayın, olayı güvenle kaydedin ve siparişi güncelleyin.

Doğrulama kılavuzu
HMAC_SHA256(timestamp + "." + rawBody, secret)
  1. 01

    Ham gövdeyi doğrulayın

    JSON'yi ayrıştırmadan önce HMAC'yi hesaplamak için başlıktaki milisaniyelik zaman damgasını ve tam ham gövdeyi kullanın. Boşluk, satır sonları ve alan sırası imzayı etkiler.

  2. 02

    Zamanlama açısından güvenli karşılaştırmayı kullanın

    Alınan imzayı, dil çalışma zamanınız tarafından sağlanan sabit zamanlı bir yardımcıyla karşılaştırın.

  3. 03

    Güvenli bir şekilde kaydedin ve ardından 2xx'ye geri dönün

    Başarıyı ancak olayı kaydettikten veya dayanıklı bir dahili kuyruğa koyduktan sonra döndürün.

Webhook sorun giderme

Odeme Webhook'u neden basarisiz olabilir

Sorunlarin cogu imza dogrulama, body parse etme, retry yonetimi veya odeme olayini kalici kaydetmeden once basarili yanit donmekten kaynaklanir.

01

İmza uyuşmazlığı

En yaygın neden, tam ham gövde yerine ayrıştırılmış JSON'yi imzalamak veya istek başlığından farklı bir zaman damgası kullanmaktır.

02

Yanlış sır

Satıcı uç noktası için yapılandırılan web kancası sırrını kullanın. API anahtarları ve webhook sırları farklı kimlik bilgileri olarak ele alınmalıdır.

03

Gövde ayrıştırıcı yükü değiştirdi

JSON ara yazılımı, yükleri yeniden sıralayabilir veya yeniden biçimlendirebilir. HMAC imzalarını doğrularken ayrıştırmadan önce ham gövdeyi yakalayın.

04

Uç nokta 2xx olmayanı döndürür

2xx dışındaki yanıtlar başarısızdır. Yeniden deneme, geri çağrı türü, HTTP durumu ve politikaya bağlıdır.

05

İşleme önemsiz değil

Sipariş ve durum ya da benzersiz olay kimliğiyle tekilleştirin. Bir işlem karması birden çok aktarım içerebilir.

06

Dayanıklılıktan önce başarı

HTTP 2xx'yi yalnızca olayı veritabanınıza veya sıranıza yazdıktan sonra döndürün. Aksi takdirde, bir kilitlenme tamamlanmış ödeme bildirimini kaybedebilir.

SSS

Webhook debug sorulari

Odeme tamamlandigi halde uygulaman guncellenmediginde bu kontrolleri kullan.

Webhook imza doğrulamam neden başarısız oluyor?

Tam ham istek gövdesini, zaman damgası başlığını ve yapılandırılmış web kancası sırrını doğrulayın. Ayrıştırılmış JSON'nin veya yeniden biçimlendirilmiş bir gövdenin imzalanması genellikle farklı bir HMAC üretir.

Webhook uç noktam yanıt gövdesinde BAŞARI döndürmeli mi?

Hayır. BoltUtil HTTP durumunu kullanır: 2xx başarılı teslimdir. Önce doğrulayın ve olayı kaydedin.

Yinelenen web kancası teslimatlarını nasıl ele almalıyım?

Sipariş ve durum ya da olay kimliği için benzersiz kısıt veya atomik işlem kullanın. Yalnızca işlem karmasına dayanmayın.

Uç noktam ne zaman HTTP 2xx döndürmeli?

Doğrulama ve kayıttan sonra 2xx döndürün. Hatalarda uygun durum kodu kullanın; yeniden deneme türe ve politikaya bağlıdır.