Webhook & Test Araçları

Webhook & Test Araçları

Ödeme olaylarını takip edin, entegrasyonunuzu test edin. Callback URL tanımları, test senaryoları, event izleme.

Hata yakalama • Anlık bildirimler • Tam kontrol

Webhook ile Anlık Bildirimler

Ödeme durumu değişikliklerinde uygulamanız gerçek zamanlı HTTP POST ile bilgilendirilir. Sürekli API kontrolüne gerek kalmaz.

Webhook Yanıt Örneği

Güvenlik & Retry

  • HMAC-SHA256 imza doğrulama (X-Tahsilat-Signature)
  • İmza formatı: t=timestamp,v1=signature
  • Başarısız bildirimlerde artan sürelerle 10 deneme
  • HTTP 200 OK alındığında süreç tamamlanır
  • CSRF korumasından muaf tutulmalıdır

Webhook Özellikleri

Tahsilat.com Webhook sistemi ile anlık bildirimler, güvenli doğrulama, hata yakalama imkanı.

Anlık Bildirimler

Ödeme durumu değişikliklerini anında webhook ile alın

Güvenli İmzalama

HMAC-SHA256 ile imzalanmış webhook'lar güvenli doğrulama

Retry Mekanizması

Başarısız webhook'lar otomatik olarak yeniden denenr

Test Araçları

Webhook URL'lerinizi test edin ve entegrasyonu doğrulayın

Webhook Entegrasyonu

Webhook URL'inizi üye işyeri panelinden ayarlayın ve ödeme olaylarını dinleyin

Durum Kodları

Başarılı Ödeme

payment_status: 1, transaction_status: 2

Başarısız Ödeme

payment_status: 2, transaction_status: 2

İade İşlemi

payment_status: 1, transaction_status: 5

Ön Provizyon (Pre-Auth)

is_pre_auth: true döndüğünde tutar karttan çekilmemiş, sadece bloke edilmiştir. Provizyonun kapatılması gerekir.

PHP Entegrasyon Örneği

Webhook Karşılama

Webhook Veri Okuma

Event Alanları