Modern ödeme altyapısı için güçlü ve esnek API çözümü
Webhook’lar, ödeme durumu değişiklikleri hakkında uygulamanızı gerçek zamanlı olarak bilgilendirdiği HTTP POST istekleridir. Ödeme tamamlandığında, iptal edildiğinde veya başarısız olduğunda sistem otomatik olarak belirlediğiniz URL’e bildirim gönderir.Bu mekanizma sayesinde uygulamanızın sürekli API’yi kontrol etmesine gerek kalmaz. Tahsilat, önemli olaylar gerçekleştiğinde doğrudan size haber verir.
Webhook URL’inizi üye işyeri arayüzü webhook yönetimi sayfasından ayarlayabilirsiniz. Hangi olayların tetikleneceğini ve hangi URL’e bildirim gönderileceğini buradan belirleyebilirsiniz.
Yalnızca Başarılı olayına abone olursanız reddedilen ödemelerden haberiniz olmaz ve siparişiniz beklemede kalır. Siparişi kesin sonuca bağlamak için en az Başarılı, Başarısız ve Şüpheli İşlem (SmartCheck engeli) olaylarına abone olun. payment_status değeri 2 olan her bildirim kesin bir rettir; karttan tahsilat yapılmamıştır ve müşteri tekrar ödeme deneyebilir.
Webhook bildirimleri, başarısız durumlarda artan sürelerle (30 saniyeden başlayarak) yeniden gönderilmeye çalışılır. Maksimum 10 deneme yapılır ve HTTP 200 OK yanıt alındığında süreç tamamlanır.
Webhook endpoint’iniz harici bir POST isteği aldığı için CSRF korumasından muaf tutulmalıdır. Laravel kullanıyorsanız webhook route’unu CSRF doğrulamasından hariç tutun, aksi takdirde 419 (Page Expired) hatası alırsınız.
Ön Provizyon (Pre-Authorization) işlemlerinde, işlem tamamlandığında pre_auth parametresi true olarak döner. Bu durumda, işlemin kesinleştirilmesi için provizyonun tamamlanması gerekmektedir aksi takdirde karttan herhangi bir tahsilat yapılmaz.
Abonelik (tekrarlayan ödeme) tahsilatları da aynı webhook ile bildirilir. Her dönem tahsilatı ve Tahsilat’ın çektiği POS’lardaki her yeniden deneme yeni bir transaction_id ile ayrı bir işlem olarak gelir;
yükteki subscription bloğu abonelik kimliğini, durumunu ve dönem numarasını taşır (abonelik dışı işlemlerde null).
Ayrıntılar için Abonelik Yaşam Döngüsü sayfasına bakın.
İmza Doğrulama
Her webhook isteği X-Tahsilat-Signature başlığı ile HMAC-SHA256 imzası içerir. İmza formatı: t=timestamp,v1=signature. Bu sayede isteklerin Tahsilat tarafından geldiğini doğrulayabilirsiniz.