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 kontrolWebhook 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.
Güvenlik ve 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
Her ödeme olayı sunucunuza bildirilir
Tahsilat.com imzalı bir POST isteği gönderir, sunucunuz imzayı doğrulayıp 200 döner. Yanıt alınamazsa bildirim artan aralıklarla yeniden denenir.
Ödeme
Tahsilat.com
Sunucunuz
Webhook günlüğü
Son 4 bildirim
- 14:31:1821325480405673İade1. deneme200
- 14:30:3121325480405672Başarılı ödeme2. deneme200
- 14:29:4421325480405671Başarısız ödeme1. deneme200
- 14:28:5721325480405670Başarılı ödeme1. deneme200
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.