1. Webhook
Sipay API Documentation
TR
  • EN
  • TR
  • Genel Bakış
    • IP Kısıtlaması
    • Başlangıç
    • Test Kartları
  • Kimlik Doğrulama
    • Token Oluşturma
      POST
  • Taksitler & Komisyonlar
    • Taksit Bilgisi Sorgulama
      POST
    • Komisyon Bilgisi Sorgulama
      POST
    • Üye İşyeri Taksit Bilgisi Sorgulama
      POST
  • Non-3DS Ödeme
    • Non-3DS Ödeme Akışı
    • Non-3DS Kart Ödemesi
      POST
    • Non-3DS Tekrarlayan Ödeme
      POST
    • Non-3DS Sigorta Ödemesi
      POST
    • Non-3DS Ön Provizyon Ödemesi
      POST
    • Ödeme Onaylama
      POST
  • 3D Secure Ödemesi
    • 3D Secure Ödeme Akışı
    • 3D Secure 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-3DS ve 3D Ödeme
    • Purchase Link Örneği
    • Sipay ile Non-3DS ve 3D Secure Ödeme
      POST
  • Ödeme Durumu Sorgulama
    • Durum Sorgulama
  • Kayıtlı Kart ile Ödeme
    • Kart Kaydetme
    • 3D Secure Kart Token ile Ödeme
    • Kayıtlı Kart Bilgilerini Sorgulama
    • Kayıtlı Kart Düzenleme
    • Kayıtlı Kart Silme
    • Non-3DS Kart Token ile Ödeme
  • HASH
    • Hash Oluşturma
    • Hash Doğrulama
  • 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 Durum Kodları
    • Durum Kodları
  • Plugin
    • Magento v1
    • Magento v2
    • Opencart
    • Presta
    • Woocommerce
    • Shopify
  1. Webhook

Webhook

Sistem olaylarıyla ilgili gerçek zamanlı bildirimler almak için webhook kullanılması önerilir.
Webhook’lar, sürekli sorgulama (polling) yapılmasına gerek kalmadan olay tabanlı güncellemelerin doğrudan üye işyeri sistemine iletilmesini sağlar. Başarılı ödemeler, iadeler (refund), chargeback işlemleri ve abonelik güncellemeleri gibi olaylar, yapılandırılmış payload içeren HTTP POST istekleriyle gerçek zamanlı olarak iletilir.
Bildirimleri alabilmek için bir webhook URL’si tanımlanmalıdır. Bu yapılandırma Sipay Merchant Panel üzerinden aşağıdaki adımlar izlenerek yapılabilir:
Merchant Panel → API & Settings → Webhook → Add
Webhook özelliğini etkinleştirmek için ödeme isteğinde sale_web_hook_key parametresi gönderilmelidir. Bu parametre için üye işyerinin tercih ettiği bir webhook anahtarı kullanılabilir.
sale_web_hook_key parametresi isteğe bağlıdır. Ancak gönderilmesi durumunda webhook sürecinin çalışabilmesi için geçerli ve doğru yapılandırılmış bir anahtar kullanılmalıdır.
Webhook bildirimleri güvenli şekilde işlenmeli ve veri bütünlüğünü sağlamak amacıyla doğrulanmalıdır. Alınan olaylara uygun şekilde yanıt verilmesi, mükerrer işlemlerin önlenmesi ve üye işyeri sistemi ile Sipay servisleri arasındaki senkronizasyonun korunması açısından önemlidir.
Örnek Webhooklar :
Satış Webhook
İade Webhook
Tekrarlayan Webhook
Ödeme itirazı Webhook
Previous
Banka Hesabına Para Aktarımı
Next
Durum Kodları
Built with