-
Sanal Pos
Security Platform
Cirom Güvende Genel Kavram
Bu dokümanda Garanti BBVA Fraud Modülü entegrasyonu yapacak işyerleri için gereksinimler detaylandırılmıştır.
Dokümandaki bilgilere ek olarak aşağıdaki link üzerinden de kullanılan endpointler, request/response alan isimleri ve tipleri hata kodları gibi bilgilere ulaşılabilir ve örnek post isteği gönderilebilir.
Test Ortamı
Test ortam adresi: atalantegwtest.garanti.com.tr
Swagger: https://atalantegwtest.garanti.com.tr/swagger-ui.html
| Başlık | Değer |
|---|---|
| MerchantId | 7000679 |
| Password | 123qweASD/ |
| MerchantId | 3424113 |
| Password | 123qweASD/ |
Üretim Ortamı
Prod ortam adresi: https://atalantegw.garanti.com.tr
Garanti Bankası Güvenlik Platformu Teknik Entegrasyon Dokümanı
Tam yetkili kullanıcı ekranda yer alan "Şifre" input alanlarına ilgili değerlerin giriş yapılması suretiyle işyeri sistemi ve Atalante servisleri arasındaki mesajlaşma esnasında encoded hash değeri oluşturulurken kullanılacak şifreyi belirler.
Tam yetkili kullanıcı Fraud Modülüne ilk eriştiğinde bu değer sistemde default olarak tutulmaktadır.
Kullanıcı belirlediği şifreyi "Şifre", "Şifre Tekrar" alanlarına girerek ve ekranda yer alan captchadaki değerleri ilgili alan yazarak KAYDET butonuna basar ve şifre resetlenir.
Calling the PageLoad Service
Merchants who will use Garanti Bank Fraud Module can add the following code snippet to the payment page of the relevant online shopping site, allowing the PageLoad service to be called, the behavioural data of the customer to be collected and the device id information to be detected.
The relevant code snippet is given below.
TEST Environment URL: https://atalantegwtest.garanti.com.tr\nPROD Environment URL: https://atalantegw.garanti.com.tr
var url = 'https://atalantegw.garanti.com.tr';\nvar options = {\n\tcardNameId: 'cardholderid',\n\tcardNumberId: 'cardnumberid',\n\tmerchantNum: '789456123',\n\ttrackingId: 'ATL_FF6633',\n\tto: 2000,\n\tsite: url,\n\tcallback: callbackOOS\n};\nvar _atl = _atl || [];\n_atl.push(['setOptions', options]);\nvar startDate;\n(function() {\n\tvar c = document.createElement('script');\n\tc.type = 'text/javascript';\n c.async = true;\n\tc.src = url + '/atl.js';\n\tvar s = document.getElementsByTagName('script')[0];\n\ts.parentNode.insertBefore(c, s);\n\tstartDate = new Date();\n var uniqueIdToSent;\n\n\tfunction callbackOOS(uniqueId) {\n\t uniqueIdToSent = uniqueId;\n\t var outputInfo = \"Time took to calculate the fingerprint: \" + (new Date() - startDate) + \" ms, uniqueId: \" + uniqueId;\n\t //log(outputInfo);\n\t}\n\n\tfunction getBResults() {\n\t var results = AtalanteModule.getBResults();\n\t return results;\n\t}\n});
There are configurable fields in the "options" content in the code snippet. These fields and their descriptions that the relevant workplace should configure are as follows.
| Data Field | Description |
|---|---|
| cardNameId | İşyeri, kart sahibinin ad-soyad bilgisinin girildiği alanın doldurulma süresinin ölçülmesini isterse, bu alana ilgili html textbox alanının id’si konulmalıdır. |
| cardNumberId | If the workplace wants to measure the typing time of the field where the card number information is entered, the id of the related html textbox field should be placed in this field. If the card number is taken with 4 separate textboxes, the field ids can be written by separating them with commas. For example; 'id1,id2,id3,id4'. |
| merchantNum | Merchant number |
| to | The PageLoad process ends in 2 seconds on average. The workplace can update this field for control purposes by adding the time they want the PageLoad process to be terminated. |
| callback | If information about the end of the pageload process is required and the corresponding uniqueId value generated after the end of the pageload process should be collected, the javascript callback method (callbackOOS) can be defined with the uniqueId parameter as in the example code snippet. |
When the payment button is pressed, the behavioural information expected to be sent in the score query step must first be received on the frontend with the getBResults javascript method at the time of pressing the button, and then sent in the field named "data" in the score query request
The fields to be sent in the score query request will be detailed in the Score Query Process document.
Code Examples
Below are links to custom code examples written in various programming languages. You can examine the codes written with predetermined values in detail through the link of your preferred programming language.
These examples contain the codes containing the relevant operation type and since they are written in different languages, you can also observe various approaches and practices. In this way, you can find the opportunity to work with better understandable and original examples of your preferred programming language.
Click for C# Code Examples.
Click for VB.Net Code Examples.
Click for Java Code Examples..
Click here for PHP Code Examples.
Please note that these examples are written with predefined values and you may need to take necessary adaptation and security measures for use in real projects.
Country - Province - District Codes
You can access the list of country codes from this page..
You can access the list of province codes from this page.
You can access the list of district codes from this page.
Product Category Codes
You can access the list of product category codes from this page.
Transaction Type Values
You can access the list of transaction type values from this page.
Test Cards
You can find the list of test cards on this page.
