3D ile Ödeme

Üye iş yerleri saklanan kart verisi ya da açık kart verisi ile Switch 3D Gateway’e HTML POST metodu ile istek göndermek sureti ile birden fazla banka Sanal PoS’una satış, taksitli satış ve ön otorizasyon ve taksitli ön otorizasyon işlemleri için 3D ödeme isteği gönderebilir. 

Üye iş yerlerinden üretim ortamında oluşturulan 3D istek formunu Switch 3D Gateway’e post etmeden önce, Switch Yönetim Ekranları’ında yer alan Banka Tanımlama menüsü altında hali hazırda kullandıkları bankalar için PoS credential bilgilerini girmeleri beklenmektedir. Bu adımdan sonra Switch sistemi ilgili Üye İşyerinin her banka için tanımladığı değerleri şifreli olarak saklar.

Akıllı Switch sistemi, üye işyerinin 3D istek tetiklemek sureti ile başlattığı işlemlerde hangi bankaya ödeme isteği gönderileceğine karar verir, sistemde şifreli olarak sakladığı banka credential bilgileri ile 3D Ödeme formunu hazırlar ve ilgili Acquirer bankaya isteği iletir.

Acquirer banka tarafından alınan 3D istek, 3D işlem formuna dönüştürülerek diğer modüller aracılığı ile kart bankasına iletilir ve kart sahibine doğrulama işlemi yapacağı ekran gösterilir.

Kart sahibi 3D doğrulama işlemini tamamlamasının ardından Switch 3D Gateway, üye işyerinin HTML POST içerisinde belirttiği success ya da fail URL üzerinden 3D işlem sonucunu işyerine döner.

Akıllı Switch sistemi ile;

➢ Üye işyeri tarafından API içerisinde gönderilen banka ID’sine istinaden direkt olarak ilgili bankaya ödeme isteği gönderilebilir

➢ Üye işyeri api içerisinde banka ID göndermez ise işlem yapılan kartın bankasına ödeme isteği gönderilebilir

➢ Üye işyeri API içerisinde banka ID göndermez ve işlem yapılan kartın bankası Switch sisteminde entegre bir banka değil ise üye işyerinin default olarak tanımladığı banka üzerinden ödeme isteği gönderilebilir

➢ Default banka tanımlanmamış ise tanımlı bankalardan herhangi birine istek gönderilebilir.

3D İstek Formu ve Alanları

Üye işyeri tarafından hazırlanacak HTML formunda POST isteğinin gönderileceği adresler ve forma alanları aşağıdaki gibidir. Alanların her biri String olarak gönderilebilir.

3D Cevap Formu ve Alanları

3D secure response mesajı, üye işyerinin istek mesajında gönderdiği successUrl ya da failureUrl adreslerine aşağıda yer alan data seti ile birlikte Switch 3D Secure Gateway tarafından Html Form olarak POST edilecektir.

3D ile Ödeme Request Hash Hesaplama

3D ile ödeme yaparken gönderilmesi gereken alanlardan biri hashedData isimli alandır. Bu alanda gönderilen 3D isteğinin içeriğinde yer alan belli başlı alanlar kullanılarak üretilen hash değeri beslenmelidir. Hash değeri hesaplamasında istek içerisinde gönderilen aşağıdaki parametrelerin yan yana String olarak concat edilip, Switch kullanıcısı için üretilen şifre değerinin hesaplamaya konulması gerekmektedir. Elde edilen son String değeri SHA256 algoritması kullanılarak hash hesabı için kullanılır. Hash sonucunda üretilen String büyük harflere çevrilip hashedData alanına beslenir. Yöntem ve örnek aşağıdaki gibidir :

3D ile Ödeme Response Hash Hesaplama

3D ile ödeme alındıktan sonra merchanta gönderilen cevap formunda da hashedData isimli alan yer alacaktır. Merchant, 3D cevap formundadönülen alanlardan aşağıdakilerini kullanarak hashedData alanındaki değeri üretmek süreti ile gelen datanın validitesini kontrol edebilir. Response hashi de yine Request hash’i hesabında olduğu gibi bazı alanların yan yana String olarak concat edilip, Switch kullanıcı şifresini de String’in sonuna concat edip SHA256 algoritması ile hashini alıp, büyük harflere çevirerek elde edilebilir. Yöntem ve örnek aşağıdaki gibidir :

Örnek 3D İstek ve Cevap Formu

3D ile ödeme için örnek HTML formu HTML Table formatında aşağıda verilmiştir. Buradaki alanlar istenilen şekilde doldurulup, 3D request hash hesabı yapılıp hashedData alanına set edildikten sonra aşağıda verilen test veya prod url’ine Form Submit edilerek 3D ile ödeme isteği tetiklenebilir. Post edilen data application/x-www-form-urlencoded tipinde olmalıdır.

3D_PAY HTML Response Form Sample (Satış)

3D_PAY HTML Request Form Sample (Ön Otorizasyon)

3D_PAY HTML Response Form Sample (Ön Otorizasyon)

Test Ortamında Örnek 3D İsteği Atma

3D request HTML’indeki alanlar set edilip hash hesabı yapıldıktan sonra ve hashedData alanı da set edildikten sonra test ortamı için aşağıdaki URL’e form submit edilerek 3D işlemi tetiklenir.

Aşağıdaki datalar, test ortamında formlar submit edilirken alınmıştır.

Bu alanlar submit edildikten sonra Garanti Bankası 3D Secure sayfası açılacaktır, burada yer alan dropdown’dan gelen default telefon numarası seçilip TAMAM butonuna basmak gerekmektedir :

Tamam butonunabastıktan sonraaşağıdaki gibi bir sayfaya yönlenme olacaktır, buradaki SMS Şifre kısmına her istek için sabit 123456 yazılmalıdır. Şifre girildikten sonra bu sayfada yer alan TAMAM butonuna basılıp 3D Doğrulama yapılmıştır olacaktır :

3D Doğrulaması’ndan sonra sonuç olarak form içerisinde aşağıdaki alanlar dönecektir :

3D_PAY Form Response Data Sample