Webhook, bir sistemde belirli bir olayın gerçekleştiğinde başka bir sistemin önceden tanımladığı URL'e otomatik HTTP isteği göndererek bilgi vermesi yöntemidir. Reverse API olarak da bilinir.

Tipik Ödeme Webhook Olayları

payment.succeeded — Tahsilat başarılı
payment.failed — Tahsilat başarısız
refund.completed — İade tamamlandı
chargeback.opened — Chargeback açıldı
subscription.renewed — Abonelik yenilendi

Webhook Best Practice

HMAC imza doğrulama (sahte istekleri reddetme)
Idempotent işleme (aynı event ID birden fazla gelebilir)
Hızlı 200 OK dön (5 sn'den uzun süren işleri queue'ya at)
Retry yönetimi (200 değilse sağlayıcı yeniden dener)
Whitelist IP (mümkünse)

Örnek Kullanım

Tahsilat başarılı webhook'unu alır almaz siparişi paid yapıyoruz.
Webhook HMAC imzasını doğrulayıp idempotent işliyoruz.

İlgili Terimler

Callback

Ödeme işlemi tamamlandığında veya durumu değiştiğinde, ödeme sağlayıcısının önceden tanımlanmış URL'ye yaptığı asenkron HTTP geri çağrısıdır.

API

Yazılımların birbiriyle veri alışverişi yapabilmesi için tanımlanmış uygulama programlama arayüzüdür; ödeme entegrasyonlarının temel iletişim katmanıdır.

Idempotency Key

Aynı API isteğinin yanlışlıkla tekrar gönderilse bile yalnızca bir kez işlenmesini sağlayan benzersiz tanımlayıcıdır.

Tahsilat360 ile

Webhook tahsilatlarınızı tek panelden yönetin

Sanal POS, link ile ödeme, vade takibi ve cari mutabakat — hepsi tek hesapta. 14 gün ücretsiz deneyin.

Ücretsiz Başla Demo Talep Et