1. Webhook
Sipay API Documentation
TR
  • EN
  • TR
  • Genel Bakış
    • Başlangıç
    • Test Kartları
  • Kimlik Doğrulama
    • Token Oluşturma
      POST
  • Non-Secure Ödeme
    • Non-Secure Ödeme Akışı
    • Non-Secure Kart Ödemesi
      POST
    • Non-Secure Tekrarlayan Ödeme
      POST
    • Non-Secure Sigorta Ödemesi
      POST
    • Non-Secure Ön Provizyon Ödemesi
      POST
    • Ödeme Onaylama
      POST
  • 3D Secure Ödemesi
    • 3D Secure Ödeme Akışı
    • 3D Secure Kredi Kart Ödemesi
      POST
    • 3D Secure Tekrarlayan Ödeme
      POST
    • 3D Secure Ön Provizyon Ödemesi
      POST
    • Ödeme Tamamlama
      POST
    • Ödeme Onaylama
      POST
    • 3D Secure Tarım Ödemesi
      POST
  • Sipay ile Non-Secure ve 3D Ödeme
    • Purchase Link Örneği
    • Sipay ile Non-Secure ve 3D Secure Ödeme
      POST
  • Ödeme Durumu Sorgulama
    • Durum Sorgulama
      POST
  • Taksitler & Komisyonlar
    • Taksit Bilgisi Sorgulama
      POST
    • Komisyon Bilgisi Sorgulama
      POST
    • Üye İşyeri Taksit Bilgisi Sorgulama
      POST
  • HASH
    • Hash Oluşturma
    • Hash Doğrulama
  • Kayıtlı Kart ile Ödeme
    • 3D Secure Kart Token ile Ödeme
    • Kart Kaydetme
    • Kayıtlı Kart Bilgilerini Sorgulama
    • Kayıtlı Kart Düzenleme
    • Kayıtlı Kart Silme
    • Non-Secure Kart Token ile Ödeme
  • Tekrarlayan Ödeme
    • Tekrarlayan Ödeme Sorgulama
    • Tekrarlayan Ödeme Plan Süreci
    • Tekrarlayan Ödeme Planı Güncelleme
  • İade
    • İade
  • Para Dağıtımı
    • Banka Hesabına Para Aktarımı
  • Webhook
    • Webhook
  • Hata Statü Kodları
    • Statü Kodları
  1. Webhook

Webhook

Sistem olayları için gerçek zamanlı bildirimler almak amacıyla webhook kullanılması önerilen yaklaşımdır.
Webhook'lar, sürekli polling yapılmasına gerek kalmadan olay tabanlı güncellemelerin doğrudan merchant sistemine iletilmesini sağlayan bir mekanizma sunar.
Başarılı ödemeler, iadeler (refund), chargeback işlemleri veya abonelik güncellemeleri gibi event türleri, yapılandırılmış payload verileri içeren HTTP POST istekleri aracılığıyla gerçek zamanlı olarak iletilir.
Bu bildirimleri alabilmek için bir webhook URL'sinin tanımlanması gerekmektedir.
Bu yapılandırma Sipay Merchant Panel üzerinden gerçekleştirilir:
Merchant Panel → API & Settings → Webhook → Add
Bu özelliğin aktif hale getirilebilmesi için ödeme isteğinde sale_web_hook_key parametresi (tercih edilen herhangi bir webhook key kullanılabilir) gönderilmelidir.
Bu key opsiyoneldir; ancak gönderildiğinde webhook sürecinin aktif olarak çalışabilmesi için geçerli ve doğru şekilde yapılandırılmış bir key gereklidir.
Webhook yanıtları güvenli bir şekilde işlenmeli ve veri bütünlüğünü sağlamak amacıyla doğrulama işlemleri gerçekleştirilmelidir.
Alınan event'lerin uygun şekilde onaylanması (acknowledgement), mükerrer işlemlerin önlenmesi ve merchant sistemi ile Sipay servisleri arasındaki senkronizasyonun korunması için önerilir.
Örnek Webhooklar :
Satış Webhook
İade Webhook
Tekrarlayan Webhook
Ödeme itirazı Webhook
Modified at 2026-07-10 14:31:29
Previous
Banka Hesabına Para Aktarımı
Next
Statü Kodları
Built with