TahsilatE Logo
Geliştirici Ortamı

3D Sonrası Sonuç Doğrulama

3D doğrulamadan sonra kullanıcının tarayıcısı, ödeme isteğinde gönderdiğiniz returnUrl adresine GET ile yönlendirilir. Sonuç query string'de gelir. returnUrl'inizde zaten query string varsa parametreler onun sonuna eklenir.

returnUrl Parametreleri

ParametreAçıklama
statusSUCCESSFUL, FAILED veya PENDING. PENDING'de sonuç bankadan sonradan gelir; işlem sorgulama veya webhook ile takip edin.
transactionIdÖdeme isteğinde gönderdiğiniz işlem ID'si.
messageSonuç mesajı (URL-encoded).
amountÖdeme tutarı, 2 ondalıkla (örn. 80.50).
installmentTaksit sayısı.
rndHer yönlendirmede değişen rastgele değer.
signaturestatus dahil tüm sonucu kapsayan imza.

Örnek Parametreler

123456789

1. İmzayı Doğrulayın

Parametreler kullanıcının tarayıcısından geçtiği için değiştirilebilir. Sonucu kullanmadan önce signature değerini secretKey'inizle doğrulayın:

signature = HMAC-SHA256(transactionId|status|amount|installment|rnd, secretKey)
amount, geldiği haliyle (2 ondalıklı) kullanılır

İmza Doğrulama

Karşılaştırmayı sabit zamanlı yapın

TypeScript logoTypeScript

2. Durumu Sunucunuzdan Sorgulayın

Siparişi onaylamadan önce GET /external/vpos/v1/payments/{transactionId} ile ödemenin durumunu sunucunuzdan sorgulayın ve content.status değeri SUCCESSFUL ise siparişi onaylayın. Ayrıntılar İşlem Sorgulama sayfasında.

Kullanıcı 3D ekranından sonra tarayıcıyı kapatırsa returnUrl'e hiç gelmez. Sonucu kaçırmamak için webhook bildirimlerini de kullanın.