Ödeme API ve Webhook Entegrasyonu: Geliştiriciler İçin Rehber
SDK ile ilk ödemeyi almak, webhook bildirimlerini güvenli işlemek, sandbox ile canlı arasındaki fark ve üretimde sizi kurtaracak pratikler.
·6 dakikalık okuma
Entegrasyon modelleri: hazır ödeme sayfası mı, API mi?
En hızlı yol hazır ödeme sayfasıdır: sunucunuz bir ödeme oturumu oluşturur, müşteri Tahsilat'ın barındırdığı sayfada kartını girer, sonuç size bildirilir. Kart verisi sisteminize hiç uğramadığı için PCI kapsamınız en dar seviyede kalır.
Tam kontrol isteyen ekipler REST API ile kendi ödeme akışını kurar. PHP, Node.js, Python, .NET ve Java için hazır SDK'lar, istek imzalama ve hata yönetimini üstlenir; ilk başarılı ödeme genellikle bir öğleden sonra içinde alınır.
Sandbox ortamında geliştirme
Sandbox, canlı ortamla birebir aynı API'yi test anahtarları ve test kartlarıyla sunar. Başarılı ödeme, banka reddi, 3D Secure hatası, zaman aşımı ve kısmi iade gibi senaryolar test kartlarıyla tetiklenir.
Canlıya geçişte yalnız API anahtarları ve uç nokta adresi değişir; kod değişmez. Anahtarları ortam değişkenlerinde tutmak ve asla depoya commit etmemek temel kuraldır.
Webhook ile ödeme bildirimi
Ödeme sonucunu yalnız müşterinin tarayıcısından dönen yanıta göre işlemek güvenilir değildir; kullanıcı sayfayı kapatabilir, bağlantı kopabilir. Doğru yöntem webhook'tur: ödeme durumu değiştiğinde Tahsilat, belirlediğiniz adrese imzalı bir bildirim gönderir.
Webhook işleyicisinde üç kural vardır. İmzayı doğrulayın, aynı bildirim birden fazla gelebileceği için işlemi idempotent tutun, ağır işleri kuyruğa atıp hızlıca 200 dönün. Webhook test araçlarıyla bildirimleri geliştirme ortamında yeniden oynatabilirsiniz.
Üretim ortamı pratikleri
Her ödeme isteğine benzersiz bir sipariş numarası ekleyin; ağ hatasında tekrar gönderilen istek çift çekime yol açmaz. Zaman aşımı sonrası sonucu tahmin etmeyin, işlem sorgulama uç noktasından gerçek durumu okuyun.
Birden fazla POS bağlıysa akıllı yönlendirme ve otomatik yedekleme sunucu tarafında çalışır; kodunuz tek bir uç noktayla konuşur, POS seçimi ve devir sizin için yönetilir. Panel üzerindeki canlı işlem takibi, entegrasyon hatalarını dakikalar içinde görünür kılar.
Bu özellikler hesabınızda hazır
Ücretsiz başvurun, dakikalar içinde tahsilata başlayın.