3D Secure Ödeme
3D Ödeme (3D Secure), kartlı online ödemelerde kart sahibinin banka tarafından doğrulanmasını sağlayan, iki aşamalı bir ödeme sürecidir. Bu yöntemle yapılan işlemlerde ödeme, bankanın 3D Secure altyapısı üzerinden kullanıcı doğrulaması alındıktan sonra kesinleştirilir.
3D Ödeme süreci yalnızca ödeme başlatma adımıyla tamamlanmaz. Kullanıcının bankadaki doğrulama adımını tamamlamasının ardından, işlem sonucunun ayrıca doğrulanarak ödemenin başarılı veya başarısız olarak sonlandırılması gerekir.
3D Ödeme Süreci
3D Ödeme aşağıdaki iki ana adımdan oluşur:
3D Ödeme Başlatma (Init3d)
3D Ödeme Tamamlama (Auth3d)
Her iki adımın da eksiksiz şekilde uygulanması gerekmektedir.
1. 3D Ödeme Başlatma (Init3d)
Bu adımda üye işyeri, kart bilgileri ve işlem detayları ile birlikte 3D ödeme başlatma isteği gönderir.
API, bankaya yönlendirme için Base64 encoded 3D içeriği döner
Bu içerik decode edilerek kullanıcı tarayıcısında render edilir
Kullanıcı bankanın 3D Secure doğrulama ekranına yönlendirilir
Bu aşamada ödeme henüz tamamlanmış sayılmaz.
3D Doğrulama ve Kullanıcı Aksiyonu
Kullanıcı, bankanın 3D Secure ekranında:
SMS / mobil uygulama / banka doğrulaması gibi yöntemlerle
İşlemi onaylar veya reddeder
Bu aksiyon bankanın altyapısında gerçekleşir.
2. 3D Ödeme Tamamlama (Auth3d)
Kullanıcının 3D doğrulama adımını tamamlamasının ardından banka:
İşlem sonucunu
Başarılı veya başarısız durum bilgilerini
üye işyerinin Init3d adımında tanımladığı returnUrl veya failUrl adresine Request olarak iletir.
Üye işyeri bu gelen Request içeriğini kullanarak:
Auth3d endpoint’ine son bir çağrı yapar
İşlemi sistemsel olarak başarılı veya başarısız şekilde kesinleştirir
Bu adım tamamlanmadan ödeme süreci kapanmış sayılmaz.
Sonuç Bildirimi ve Zamanlama
Bankadan dönüş genellikle kullanıcı aksiyonuna bağlı olarak ~1 dakika içerisinde gerçekleşir
Return / Fail URL’e gelen veriler doğrulanmalı ve Auth3d çağrısında kullanılmalıdır
Nihai ödeme sonucu Auth3d response’u ile belirlenir
İlgili Endpoint’ler
3D Ödeme sürecinde kullanılan endpoint’ler:
3D Ödeme Başlatma:
POST /v1/Payment/Init3d3D Ödeme Tamamlama:
POST /v1/Payment/Auth3d
Bu endpoint’lere ait request ve response detayları aşağıdaki bölümlerde açıklanmaktadır.
Last updated