Webhook'lar sunucunuza her ödeme, satın alma ve para çekme değişikliğini bildirir. Proje başına bir adres ekleyin ve her çağrıda imzayı kontrol edin.
Adresi ekleyin
- Projeyi açın ve Webhook URL'si alanını doldurun. Herkese açık bir https adresi olmalıdır.
- Ayarları kaydet düğmesine, ardından test.ping gönder düğmesine basın. Panel, sunucunuzun bunu kabul edip etmediğini gösterir.
Ne göndeririz
JSON gövdeli bir POST: olay türü (örneğin deposit.in_hold, deposit.success, deposit.hold_returned, purchase.accepted veya payout.paid), canlı mı test mi olduğu ve nesnenin kendisi. Tüm olay türleri API referansı'nda listelenir.
İmzayı kontrol edin
Her çağrı, bir zaman damgası ve webhook imzalama anahtarınızla oluşturulmuş bir HMAC-SHA256 imzası içeren SkinPlata-Signature başlığını taşır. Hiçbir şeye güvenmeden önce imzayı ham gövdeden hesaplayıp karşılaştırın. API referansı'nda hazır örnekler var.
Hızlı yanıt verin
Birkaç saniye içinde herhangi bir 2xx durumuyla yanıt verin, ağır işleri sonra yapın. Diğer yanıtlar başarısız sayılır ve yaklaşık iki gün boyunca yeniden deneriz.
Güvenle onaylayın
- Her olayı bir kez işleyin: aynı olay birden fazla kez gelebilir.
- Kendi tarafınızda değer vermeden önce ödemeyi API'den yeniden okuyun.
- Bir ödeme geri alındığında değeri geri alın, bkz. Takas koruması ve erken serbest bırakma.
Her gönderim, yanıtı ve yeniden denemeleri paneldeki Webhook'lar bölümünde listelenir. Hiçbir şey gelmiyorsa bkz. Webhook'lar gelmiyor: neler kontrol edilmeli.