1. Hızlı Başlangıç
  • Hızlı Başlangıç
    • Giriş
    • Ürün Özeti
    • Ödeme yaşam döngüsü
    • 3D Akışı ve Hash Doğrulaması
    • İade mantığı
    • Webhook ve bildirimler
    • Hata yönetimi
    • Güvenlik özeti
    • Entegrasyon mantığı
    • Sık sorulan sorular
  • Geliştiriciler
    • API referansı
    • İstek / Yanıt içeriği
    • Kimlik ve ortamlar
    • Webhook teknik ayrıntılar
    • Finekstra LLM / Kod asistanı
  • API Dökümanı
    • Çıkış IP bilgisi
      GET
    • Servis sağlık kontrolü
      GET
    • Ödeme başlat
      POST
    • Ön provizyon başlat
      POST
    • Ödeme linki oluştur
      POST
    • İşlem durumu sorgula
      GET
    • İşlem listesi sorgula
      GET
    • Ön provizyonu tahsil et
      POST
    • İade talebi oluştur
      POST
  1. Hızlı Başlangıç

3D Akışı ve Hash Doğrulaması

3D Secure akışında müşteri banka doğrulama adımına gider ve sonra işyeri sistemine geri döner. Bu dönüşte gelen sonucun doğrulanması, sahte yönlendirme veya parametre oynanması riskini azaltır.

3D akışın kısa özeti#

1.
Ödeme başlatılır
İşlem 3D adımı gerektiriyorsa müşteri banka doğrulama ekranına yönlendirilir.
2.
Müşteri doğrular
SMS / mobil onay gibi banka adımı tamamlanır.
3.
Geri dönüş yapılır
Sonuç parametreleri ile işyerinin dönüş adresine yönlendirme olur.
4.
İmza doğrulanır
İşyeri, gelen alanlardan hash üretip gelen hash ile karşılaştırır.
5.
Sipariş güncellenir
Doğrulama başarılıysa sipariş / ödeme durumu güncellenir; değilse başarısız kabul edilir.

Hash mantığı (teknik)#

3D dönüş hash'i, aşağıdaki alanlarla ve sabit sırayla üretilir:
1.
transaction_id
2.
status
3.
amount
4.
currency
5.
reference_no
Canonical string formatı:
{transaction_id}|{status}|{amount}|{currency}|{reference_no}
Kurallar:
amount daima iki ondalık basamakla formatlanır (ör. 10.50).
Algoritma: HMAC-SHA256
Secret: işyerinin secret_key değeri
Sonuç: 64 karakter hex string (hash)
Not: Query içinde gelen payment_return_outcome, payment_return_verified, message gibi alanlar imzaya dahil değildir.

Örnek doğrulama (Python)#

Dikkat edilmesi gerekenler#

Doğrulama yapılmadan ödeme başarılı kabul edilmemelidir.
Aynı dönüşün birden fazla gelmesi ihtimaline karşı işlem idempotent olmalıdır.
Test ve canlı ortam anahtarları ayrılmalıdır.

Sonraki adımlar#

İade mantığı
Webhook ve bildirimler
Previous
Ödeme yaşam döngüsü
Next
İade mantığı
Built with