Kripto ödeme webhook’u: id ve status nasıl işlenir
Kripto ödeme webhook rehberi: son durumu id ve status alanlarıyla POST olarak alın, x-api-key başlığını doğrulayın ve siparişleri güvenle güncelleyin.
Kripto ödeme webhook’u, backend’inize bir ödemenin son durumunu bildirir. Qvard’da bu, sipariş numaranız ve durumla gelen bir POST isteğidir; böylece sipariş mantığı API’yi sürekli sorgulamadan güncellenir.
Webhook neler gönderir
Qvard, webhook URL’inize bir POST isteği gönderir. Gövdede ödemeyi oluştururken gönderdiğiniz id ve örneğin paid gibi bir status bulunur. İstek, başlıkta x-api-key belirtecinizi taşır.
x-api-key başlığını kontrol edin
Mesajı güvenmeden önce x-api-key başlığını hesabınızdaki belirteçle karşılaştırın. Başlığı olmayan istekleri reddedin; böylece kimse endpoint’inizi doğrudan çağırarak bir siparişi ödendi olarak işaretleyemez.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Siparişi id ile güncelleyin
Siparişi gövdedeki id ile bulun ve durumunu status değerine göre değiştirin. Siparişi yalnızca status paid olduğunda ödendi olarak işaretleyin; sisteminizin işlemediği durumları yok sayın.
İşleyiciyi tekrara dayanıklı yapın
Aynı webhook birden fazla kez gelebilir. İşlediğiniz id ve durumu kaydedin; olay zaten işlendiyse bir şey yapmayın. Değişiklik kaydedildikten sonra başarı koduyla yanıt verin.
Hızlı yanıt verin, yavaş işleri kuyruğa alın
Sipariş kaydedilir kaydedilmez webhook’u onaylayın. E-postaları, faturaları ve depo çağrılarını arka plan işinden gönderin; böylece yavaş bir adım asla zaman aşımına yol açmaz.
Demo faturayla test edin
Bir demo fatura oluşturun, hosted sayfada ödeyin ve canlıya geçmeden önce endpoint’inizin webhook’u aldığını izleyin.
FAQ
API yanıtı ile webhook arasındaki fark nedir?
API yanıtı ödemenin oluşturulduğunu doğrular ve bir redirectUrl döndürür. Ödemenin son durumunu yalnızca webhook bildirir.
Endpoint’im kapalıysa ne olur?
Teslimat yeniden denenir, bu yüzden işleyicinizin tekrara dayanıklı olması gerekir. Kayıtlarınızı düzenli kontrol edin ve beklemede kalan siparişleri uzlaştırın.
x-api-key olmadan bir webhook’a güvenebilir miyim?
Hayır. Bir siparişi değiştirmeden önce her zaman x-api-key başlığını kontrol edin.
Hangi durumları işlemeliyim?
Başarılı ödemeler için paid durumunu işleyin, diğer durumları bilgi olarak değerlendirin. Tüm değerlerin listesi API dokümantasyonundadır.
