-
Tami Sanal POS
Tami Sanal POS
3D'li Ön Otorizasyon İşlemi Genel Açıklama
Tami üzerinden gerçekleştirilmek istenen 3d'li ödeme için belirtilen tutar kadar karttan bakiyenin bloke edilmesini sağlar. İşlem ilk olarak 3d doğrulama adımından başlatılır. Başarılı sonuçlanan 3d doğrulama sonrasında 3d tamamlama adımında işlem gerçek bir ön otorizasyon işlemi gerçekleştirilmiş olur.
Ön otorizasyon işleminde karttan tutar bloke edilmiş olur. Ön otorizasyon kapama işlemi ile birlikte karttan ödeme alınmış olur.
Test/Prod Ortamları API Kullanıcı Bilgisi
Sandbox test portaline https://sandbox-portal.tami.com.tr adresinden ulaşabilirsin. Test kullanıcıları ile test portale giriş yapıldığında bu kullanıcıya bağlı işyeri tarafından gerçekleştirilen işlemleri görüntülenebilir. İşlemler iptal/iade edilebilir. Test kullanıcı bilgileri için TeknikDestek@tami.com.tr adresine ulaşabilirsin.
Hash Hesaplama
Bir çok işlem tipi için gönderilen isteğin header bilgisine PG-Auth-Token eklenmelidir. PG-Auth-Token değeri “MerchantNumber:TerminalNumber:Hash” değerlerinden oluşur.
Burada hash hesabı yapılırken üye işyerine ait merchantNumber, terminalNumber ve secretKey bilgileri sha256 ile hashleyip stringe çevrilerek elde edilir.
public class SHA256Example {\n public static String sha256(Long merchantNumber, Long terminalNumber, String secretKey) {\n String text = merchantNumber.toString() + terminalNumber.toString() + secretKey;\n try {\n MessageDigest digest = MessageDigest.getInstance(\"SHA-256\");\n byte[] hash = digest.digest(text.getBytes(StandardCharsets.UTF_8));\n String sha256Hex = DatatypeConverter.printBase64Binary(hash);\n return sha256Hex;\n } catch (NoSuchAlgorithmException e) {\n e.printStackTrace();\n return null;\n }\n }\n }
TAMİ Test Portalı Bilgileri
Tami test portalına https://sandbox-portal.tami.com.tr adresinden erişebilirsiniz. Bu adresten yukarıda iletilen kullanıcılar ile portal ekranını görüntüleyebilirsin.
Üretim ortamı bilgileriniz için https://portal.tami.com.tr adresinden üye olabilir veya e-ticaret destek birimine başvurabilirsin.
3D'li Ön Otorizasyon İşlemi API Bilgileri
Test ortamında yapılacak çalışmalarda "https://sandbox-paymentapi.tami.com.tr/payment/pre-auth" url'i kullanılacaktır.
Üretim ortamında yapılacak çalışmalarda ise "https://paymentapi.tami.com.tr/payment/pre-auth" url'i kullanılacaktır.
İstek Parametreleri ve Açıklamaları
Sanal POS 3D’li Peşin/Taksitli satış işlemleri için gerekli olan istek yapısı aşağıdaki tabloda belirtilmiştir. İstek mesajındaki bilgi ve açıklamalar incelenmeli ve istek mesajı bu tabloda belirtilen kurallara göre sağlanmalıdır:
| Parametre Adı | Format | Uzunluk | (O)psiyonel / (Z)orunlu/ (Ş)artlı | Açıklama |
|---|---|---|---|---|
| orderId | String | (2-36) | Z | Ödeme isteğinin Tami-müşteri arasındaki iletişiminde kullanılan tekil bir iletişim bilgisidir. Üye işyeri ve pos çifti için bu değer tekil olmalıdır. OrderId alanı, alfanümerik karakterler ile yalnızca '-' ve '_' karakterlerini içerebilir. Ancak, '-' ve '_' karakterlerini art arda içermemelidir. |
| amount | Decimal | Z | İşlem tutarıdır. Küsurat ayracı nokta (.) ile yapılmalıdır. | |
| currency | String | 3 | Z | İşlemin döviz kodunu belirtir. Örnek: TL için TRY gönderilmeli. |
| installmentCount | Number | Z | Yapılmak istenen işlemin taksit bilgisidir. Peşin işlem için 1 gönderilmelidir. 0 gönderilmesi kabul edilmez. | |
| paymentGroup | String | Z | Ödeme grubu, varsayılan PRODUCT. | |
| paymentChannel | enum | O | Ödeme kanalı. Geçerli değerler enum içinde sunulmaktadır: WEB, MOBILE, MOBILE_WEB, MOBILE_IOS, MOBILE_ANDROID, MOBILE_WINDOWS, MOBILE_TABLET, MOBILE_PHONE | |
| callbackUrl | String | Ş | İşlem 3d'li olarak yapılmak isteniyorsa gönderilmesi zorunludur. 3d doğrulama sonucunun döneceği adrestir. Üye işyerine ait bir adres olmalıdır. | |
| card | Object | Z | ||
| cvv | String | Z | Ödemenin alınacağı kartın güvenlik kodu bilgisi. | |
| expireMonth | Number | (1-12) | Z | Ödemenin alınacağı kartın son kullanma tarihi ay bilgisi. |
| expireYear | Number | 4 | Z | Ödemenin alınacağı kartın son kullanma tarihi yıl bilgisi. |
| holderName | String | 30 | Z | Ödemenin alınacağı kart sahibinin adı soyadı bilgisi. |
| number | String | (5-35) | Z | Ödemenin alınacağı kart numarası bilgisi. |
| billingAddress | Object | O | ||
| address | String | 400 | O | Üye işyeri tarafındaki fatura adresi bilgisi. |
| emailAddress | String | O | Üye işyerine ait mail bilgisi | |
| city | String | 30 | O | Üye işyeri tarafındaki fatura adresi şehir bilgisi. |
| companyName | String | 100 | O | Üye işyerinin ticari unvan bilgisi. |
| country | String | 50 | O | Üye işyeri tarafındaki fatura adresi ülke bilgisi. |
| contactName | String | 30 | O | Üye işyeri tarafındaki fatura adresi, ad soyad bilgisi. |
| phone | String | O | Üye işyeri tarafındaki alıcıya ait GSM numarası. | |
| zipCode | String | 15 | O | Üye işyeri tarafındaki fatura adresi posta kodu. |
| district | String | 50 | O | Üye işyeri tarafındaki fatura adresi semt bilgisi. |
| shippingAddress | Object | O | ||
| address | String | 400 | O | Üye işyeri tarafındaki teslimat adresi bilgisi. |
| emailAddress | String | O | Üye işyerine ait mail bilgisi | |
| city | String | 30 | O | Üye işyeri tarafındaki teslimat adresi şehir bilgisi. |
| country | String | 50 | O | Üye işyeri tarafındaki teslimat adresi ülke bilgisi. |
| contactName | String | 30 | O | Üye işyeri tarafındaki teslimat adresi, ad soyad bilgisi. |
| zipCode | String | 15 | O | Üye işyeri tarafındaki teslimat adresi posta kodu bilgisi. |
| district | String | 50 | O | Üye işyeri tarafındaki teslimat adresi semt bilgisi. |
| buyer | Object | Z | Üye işyeri tarafındaki alıcıya ait bilgileri içerir. | |
| ipAddress | String | Z | Üye işyeri tarafındaki alıcıya ait ip adresidir. Alıcının gerçek ip adresi iletilmesi gerekmektedir. | |
| buyerId | String | 50 | Z | Üye işyeri tarafındaki alıcıya ait id bilgisidir. |
| name | String | 30 | Z | Üye işyeri tarafındaki alıcıya ait ad bilgisidir. |
| surName | String | 30 | Z | Üye işyeri tarafındaki alıcıya ait soyad bilgisidir. |
| identityNumber | String | 11 | O | Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası. |
| city | String | 50 | O | Üye işyeri tarafındaki alıcıya ait şehir bilgisi. |
| country | String | 50 | O | Üye işyeri tarafındaki alıcıya ait ülke bilgisi. |
| emailAddress | String | Z | Üye işyeri tarafındaki alıcıya ait e-posta bilgisi. E-posta adresi alıcıya ait geçerli ve erişilebilir bir adres olmalıdır. | |
| phoneNumber | String | Z | Üye işyeri tarafındaki alıcıya ait GSM numarasıdır | |
| registrationAddress | String | 400 | O | Üye işyeri tarafındaki alıcıya ait kayıt adresi. |
| zipCode | String | 15 | O | Üye işyeri tarafındaki alıcıya ait posta kodu. |
| registrationDate | Date | O | Üye işyeri tarafındaki alıcıya ait kayıt tarihi. Tarih formatı 2015-09- 17 23:45:06 şeklinde olmalıdır. | |
| lastLoginDate | Date | O | Üye işyeri tarafındaki alıcıya ait son giriş tarihi. Tarih formatı 2015- 09-17 23:45:06 şeklinde olmalıdır. | |
| basket | O | |||
| basketId | String | 50 | Ş | Üye işyeri tarafındaki sepete ait id. Basket içerisinde item iletilirse basketId gönderilmesi zorunlu olur. |
| basket/basketItems | List | 0 | ||
| itemId | String | 50 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait id. Basket içerisinde item iletilirse itemId gönderilmesi zorunlu olur. |
| itemType | String | 50 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL. Basket içerisinde item iletilirse itemType gönderilmesi zorunlu olur. |
| name | String | 50 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait ismi. Basket içerisinde item iletilirse name gönderilmesi zorunlu olur. |
| category | String | 50 | O | Üye işyeri tarafındaki sepetteki ürüne ait kategori . |
| subCategory | String | 100 | O | Üye işyeri tarafındaki sepetteki ürüne ait alt kategori. |
| unitPrice | Decimal | min 0.0 | O | Üye işyeri tarafındaki sepetteki ürünün tekil tutarıdır. |
| totalPrice | Decimal | min 0.0 | Ş | Üye işyeri tarafındaki sepetteki ürüne ait toplam tutar. 0 ve 0’dan küçük olamaz, tutarlar toplamı sepet tutarına (amount) eşit olmalıdır. Unitprice * numberOfProducts = totalPrice olmalı. Basket objesi içerisinde item iletilirse totalPrice gönderilmesi zorunlu olur. |
| numberOfProducts | Number | 1-99999 | O | Üye işyeri tarafındaki sepetteki ürünün adedidir. |
| securityHash | String | Z | Dokumanda belirtilen şekilde hesaplanıp iletilmesi beklenen değerdir. Eksik veya hatalı iletilirse işlem bankaya yönlendirilmez, hata verilir. |
3D'li Ön Otorizasyon API İsteği Örneği
{\n \"amount\": 15,\n \"orderId\": \"order\",\n \"currency\": \"TRY\",\n \"installmentCount\": 1,\n \"card\": {\n \"holderName\": \"Kemal Sunal\",\n \"cvv\": \"\",\n \"expireMonth\": 4,\n \"expireYear\": 2026,\n \"number\": \"4824910501747014\"\n },\n \"billingAddress\": {\n \"emailAddress\": \"email@email.com\",\n \"address\": \"Nisbetiye Barbaros Bulvarı Boulevard, No:96, 34340 Beşiktaş/İstanbul\",\n \"city\": \"İstanbul\",\n \"companyName\": \"SirketAdı\",\n \"country\": \"Türkiye\",\n \"district\": \"Bebek Mah.\",\n \"contactName\": \"İsim Soyisim\",\n \"phoneNumber\": \"\",\n \"zipCode\": \"343400\"\n },\n \"shippingAddress\": {\n \"emailAddress\": \"email@email.com\",\n \"address\": \"Nisbetiye Barbaros Bulvarı Boulevard, No:96, 34340 Beşiktaş/İstanbul\",\n \"city\": \"İstanbul\",\n \"companyName\": \"SirketAdı\",\n \"country\": \"Türkiye\",\n \"district\": \"Levent\",\n \"contactName\": \"İsim Soyisim\",\n \"phoneNumber\": \"\",\n \"zipCode\": \"3434221\"\n },\n \"buyer\": {\n \"ipAddress\": \"192.168.1.70\",\n \"buyerId\": \"678654\",\n \"name\": \"Adı\",\n \"surName\": \"Soyadı\",\n \"identityNumber\": 28629160374,\n \"city\": \"İstanbul\",\n \"country\": \"Türkiye\",\n \"zipCode\": \"348222\",\n \"emailAddress\": \"email@email.com\",\n \"phoneNumber\": \"\",\n \"registrationAddress\": \"Ortaköy Mah. Ulus Sok. Beşiktaş\",\n \"lastLoginDate\": \"2022-11-05T13:39:11.332\",\n \"registrationDate\": \"2022-10-11T12:59:11.332\"\n },\n \"basket\": {\n \"basketId\": \"6489494\",\n \"basketItems\": [\n {\n \"itemId\": \"7448\",\n \"name\": \"basketname1\",\n \"itemType\": \"PHYSICAL\",\n \"numberOfProducts\": 1,\n \"totalPrice\": 15,\n \"unitPrice\": 15\n }\n ]\n },\n \"paymentGroup\": \"PRODUCT\",\n \"callbackUrl\": \"https://gbtunelemulator-d.fw.garantibbva.com.tr/secure3d\", \n \"securityHash\": \"647494994F8494H94894849K849==\"\n}
3D'li Ön Otorizasyon API İstek Cevabı Örneği
{\n \"success\": true,\n \"systemTime\": \"2026-09-04T08:16:38.117789665\",\n \"correlationId\": \"fecdf6af-4b26-43fd-a876-022e27ea35a5\",\n \"securityHash\": \"eyJraWQiOiIxNTAxZTU2MS00ODM3LTQ0NmUtYjVkZi02ZTdiNGY3OGE2NmYiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWNjZXNzIjp0cnVlLCJzeXN0ZW1UaW1lIjoiMjAyNi0wOS0wNFQwODoxNjozOC4xMTc3ODk2NjUiLCJjb3JyZWxhdGlvbklkIjoiZmVjZGY2YWYtNGIyNi00M2ZkLWE4NzYtMDIyZTI3ZWEzNWE1IiwidHJhbnNhY3Rpb25EYXRlIjoiMjAyNi0wOS0wNFQwODoxNjozNy4zNDQ3MjYiLCJvcmRlcklkIjoibmlsdWZlcmF0dDU1T3JkZXI2MDAwMDYiLCJhbW91bnQiOjEwLCJjdXJyZW5jeSI6IlRSWSIsImluc3RhbGxtZW50Q291bnQiOjEsImNhcmQiOnsiYmluTnVtYmVyIjoiNTQyMTE5MDEiLCJtYXNrZWROdW1iZXIiOiI1NDIxLTE5MDEteHh4eC14eDIyIiwiY2FyZEJyYW5kIjoiVC4gVkFLSUZMQVIgQkFOS0FTSSBULkEuTyIsImNhcmRPcmdhbml6YXRpb24iOiJNQVNURVJDQVJEIiwiY2FyZFR5cGUiOiJDUkVESVQifSwidGhyZWVEU0h0bWxDb250ZW50IjoiUENGa2IyTjBlWEJsSUdoMGJXdytDanhvZEcxc0lHeGhibWM5SW1WdUlqNEtJQ0E4YUdWaFpENEtJQ0FnSUR4dFpYUmhJR052Ym5SbGJuUTlJblJsZUhRdmFIUnRiRHNnWTJoaGNuTmxkRDFWVkVZdE9DSWdhSFIwY0MxbGNYVnBkajBpUTI5dWRHVnVkQzFVZVhCbElpQXZQZ29nSUNBZ1BHMWxkR0VnWTI5dWRHVnVkRDBpU1VVOVpXUm5aU0lnYUhSMGNDMWxjWFZwZGowaVdDMVZRUzFEYjIxd1lYUnBZbXhsSWlBdlBnb2dJQ0FnUEcxbGRHRWdZMjl1ZEdWdWREMGlkMmxrZEdnOVpHVjJhV05sTFhkcFpIUm9MQ0JwYm1sMGFXRnNMWE5qWVd4bFBURXNJSE5vY21sdWF5MTBieTFtYVhROWJtOGlJRzVoYldVOUluWnBaWGR3YjNKMElpQXZQZ29nSUNBZ1BIUnBkR3hsUGxSQlRjU3dJTU9XWkdWdFpTQkJjbUZqeExFZ1MzVnlkV3gxeFo5MUlId2dSMkZ5WVc1MGFTQkNRbFpCSU1PV1pHVnRaU0JUYVhOMFpXMXNaWEpwUEM5MGFYUnNaVDRLSUNBZ0lEeHpkSGxzWlQ0S0lDQWdJQ0FnTG14dllXUmxjaUI3Q2lBZ0lDQWdJQ0FnWW05eVpHVnlPaUF4Tm5CNElITnZiR2xrSUNObU0yWXpaak03Q2lBZ0lDQWdJQ0FnWW05eVpHVnlMWEpoWkdsMWN6b2dOVEFsT3dvZ0lDQWdJQ0FnSUdKdmNtUmxjaTEwYjNBNklERTJjSGdnYzI5c2FXUWdJelEwTXpFNFlqc0tJQ0FnSUNBZ0lDQjNhV1IwYURvZ05qQndlRHNLSUNBZ0lDQWdJQ0JvWldsbmFIUTZJRFl3Y0hnN0NpQWdJQ0FnSUNBZ0xYZGxZbXRwZEMxaGJtbHRZWFJwYjI0NklITndhVzRnTW5NZ2JHbHVaV0Z5SUdsdVptbHVhWFJsT3dvZ0lDQWdJQ0FnSUdGdWFXMWhkR2x2YmpvZ2MzQnBiaUF5Y3lCc2FXNWxZWElnYVc1bWFXNXBkR1U3Q2lBZ0lDQWdJSDBLQ2lBZ0lDQWdJRUF0ZDJWaWEybDBMV3RsZVdaeVlXMWxjeUJ6Y0dsdUlIc0tJQ0FnSUNBZ0lDQXdKU0I3Q2lBZ0lDQWdJQ0FnSUNBdGQyVmlhMmwwTFhSeVlXNXpabTl5YlRvZ2NtOTBZWFJsS0RCa1pXY3BPd29nSUNBZ0lDQWdJSDBLSUNBZ0lDQWdJQ0F4TURBbElIc0tJQ0FnSUNBZ0lDQWdJQzEzWldKcmFYUXRkSEpoYm5ObWIzSnRPaUJ5YjNSaGRHVW9Nell3WkdWbktUc0tJQ0FnSUNBZ0lDQjlDaUFnSUNBZ0lIMEtDaUFnSUNBZ0lFQnJaWGxtY21GdFpYTWdjM0JwYmlCN0NpQWdJQ0FnSUNBZ01DVWdld29nSUNBZ0lDQWdJQ0FnZEhKaGJuTm1iM0p0T2lCeWIzUmhkR1VvTUdSbFp5azdDaUFnSUNBZ0lDQWdmUW9nSUNBZ0lDQWdJREV3TUNVZ2V3b2dJQ0FnSUNBZ0lDQWdkSEpoYm5ObWIzSnRPaUJ5YjNSaGRHVW9Nell3WkdWbktUc0tJQ0FnSUNBZ0lDQjlDaUFnSUNBZ0lIMEtJQ0FnSUR3dmMzUjViR1UrQ2lBZ1BDOW9aV0ZrUGdvZ0lEeGliMlI1UGdvZ0lDQWdDaUFnSUNBS0lDQWdJQW9nSUNBZ0NpQWdJQ0FLSUNBZ0lBb2dJQ0FnUEdScGRnb2dJQ0FnUGdvZ0lDQWdJQ0E4WkdsMlBnb2dJRHhtYjNKdZFdVOUlqSXdNamdpUGdvZ0lDQWdQR2x1Y0hWMElHNWhiV1U5SW1aaGFXeFZjbXdpSUhSNWNHVTlJbWhwWkdSbGJpSWdkbUZzZFdVOUltaDBkSEJ6T2k4dmNHRjViV1Z1ZEdGd2FTMTBMbWRoY21GdWRHbGlZblpoTG1OdmJTNTBjaTloY0drdmRqQXZNMlF2Wlc1bmFXNWxQMjl5WkdWeVNXUTlPVnBZY0ZGNVUyRlNVVFpWYUZwQmMyZHVWalpUZDBGTElqNEtJQ0FnSUR4cGJuQjFkQ0J1WVcxbFBTSm9ZWE5vSWlCMGVYQmxQU0pvYVdSa1pXNGlJSFpoYkhWbFBTSnVWVTVIZVZCdGJFRkpSV2xPVkZOSFVHdFRlSEYxY0hKT1ExWnJWME5HTTNWWVQwWkdVVmx1TVhaelNqRnlRV2wyWTI0M1JrTnJaV05ZV0ZnNFNtd3ZVVVpLUTFOVlNWcE1ZMVV5UkVkb01XOXpUM1FyZHowOUlqNEtJQ0FnSUR4cGJuQjFkQ0J1WVcxbFBTSm9ZWE5vUVd4bmIzSnBkR2h0SWlCMGVYQmxQU0pvYVdSa1pXNGlJSFpoYkhWbFBTSjJaWEl6SWo0S0lDQWdJRHhwYm5CMWRDQnVZVzFsUFNKcGMyeGxiWFJwY0draUlIUjVjR1U5SW1ocFpHUmxiaUlnZG1Gc2RXVTlJa0YxZEdnaVBnb2dJQ0FnUEdsdWNIVjBJRzVoYldVOUlteGhibWNpSUhSNWNHVTlJbWhwWkdSbGJpSWdkbUZzZFdVOUluUnlJajRLSUNBZ0lEeHBibkIxZENCdVlXMWxQU0p2YVdRaUlIUjVjR1U5SW1ocFpHUmxiaUlnZG1Gc2RXVTlJamxhV0hCUmVWTmhVbEUyVldoYVFYTm5ibFkyVTNkQlN5SStDaUFnSUNBOGFXNXdkWFFnYm1GdFpUMGliMnRWY213aUlIUjVjR1U5SW1ocFpHUmxiaUlnZG1Gc2RXVTlJbWgwZEhCek9pOHZjR0Y1YldWdWRHRndhUzEwTG1kaGNtRnVkR2xpWW5aaExtTnZiUzUwY2k5aGNHa3ZkakF2TTJRdlpXNW5hVzVsUDI5eVpHVnlTV1E5T1ZwWWNGRjVVMkZTVVRaVmFGcEJjMmR1VmpaVGQwRkxJajRLSUNBZ0lEeHBibkIxZENCdVlXMWxQU0p3WVc0aUlIUjVjR1U5SW1ocFpHUmxiaUlnZG1Gc2RXVTlJalUwTWpFeE9UQXhNakk1TkRRMU1qSWlQZ29nSUNBZ1BHbHVjSFYwSUc1aGJXVTlJbkp1WkNJZ2RIbHdaVDBpYUdsa1pHVnVJaUIyWVd4MVpUMGlVazVFVkVsTlJURTNPRGcwT1RnNU9UZ3dPRFFpUGdvZ0lDQWdQR2x1Y0hWMElHNWhiV1U5SW5OMGIzSmxkSGx3WlNJZ2RIbHdaVDBpYUdsa1pHVnVJaUIyWVd4MVpUMGlNMlFpUGdvZ0lDQWdDaUFnSUNBOGFXNXdkWFFnYm1GdFpUMGlkR0ZyYzJsMElpQjBlWEJsUFNKb2FXUmtaVzRpSUhaaGJIVmxQU0lpUGdvZ0lDQWdQR2x1Y0hWMElHNWhiV1U5SWxOVlFrMUZVa05JUVU1VVRrRk5SU0lnZEhsd1pUMGlhR2xrWkdWdUlpQjJZV3gxWlQwaVFtOXlZU0JIYVdSaElGVnlkVzVzWlhKcElFeFVSQzRnVTFSSkxpSStDaUFnUEM5bWIzSnRQZ284TDJScGRqNEtJQ0FnSUR3dlpHbDJQZ29nSUNBZ0NpQWdJQ0FLSUNBZ0lBb2dJQ0FnQ2lBZ0lDQThaR2wyQ2lBZ0lDQWdJR2xrUFNKc2IyRmthVzVuUm1Gc2JHSmhZMnNpQ2lBZ0lDQWdJSE4wZVd4bFBTSUtJQ0FnSUNBZ0lDQndiM05wZEdsdmJqb2dabWw0WldRN0NpQWdJQ0FnSUNBZ2RHOXdPaUExTUNVN0NpQWdJQ0FnSUNBZ2JHVm1kRG9nTlRBbE93b2dJQ0FnSUNBZ0lIUnlZVzV6Wm05eWJUb2dkSEpoYm5Oc1lYUmxLQzAxTUNVc0lDMDFNQ1VwT3dvZ0lDQWdJQ0FnSUdKaFkydG5jbTkxYm1RNklIZG9hWFJsT3dvZ0lDQWdJQ0FnSUhCaFpHUnBibWM2SURNd2NIZzdDaUFnSUNBZ0lDQWdlaTFwYm1SbGVEb2dPVGs1T1RzS0lDQWdJQ0FnSUNCMFpYaDBMV0ZzYVdkdU9pQmpaVzUwWlhJN0NpQWdJQ0FnSUNBZ1pHbHpjR3hoZVRvZ2JtOXVaVHNLSUNBZ0lDQWdJZ29nSUNBZ1Bnb2dJQ0FnSUNBOFpHbDJJR05zWVhOelBTSnNiMkZrWlhJaVBqd3ZaR2wyUGdvZ0lDQWdQQzlrYVhZK0NpQWdJQ0E4WkdsMkNpQWdJQ0FnSUdsa1BTSnlaV1JwY21WamRFWmhiR3hpWVdOcklnb2dJQ0FnSUNCemRIbHNaVDBpQ2lBZ0lDQWdJQ0FnY0c5emFYUnBiMjQ2SUdacGVHVmtPd29nSUNBZ0lDQWdJSFJ2Y0RvZ05UQWxPd29nSUNBZ0lDQWdJR3hsWm5RNklEVXdKVHNLSUNBZ0lDQWdJQ0IwY21GdWMyWnZjbTA2SUhSeVlXNXpiR0YwWlNndE5UQWxMQ0F0TlRBbEtUc0tJQ0FnSUNBZ0lDQmlZV05yWjNKdmRXNWtPaUIzYUdsMFpUc0tJQ0FnSUNBZ0lDQndZV1JrYVc1bk9pQXpNSEI0T3dvZ0lDQWdJQ0FnSUhvdGFXNWtaWGc2SURrNU9UazdDaUFnSUNBZ0lDQWdkR1Y0ZEMxaGJHbG5iam9nWTJWdWRHVnlPd29nSUNBZ0lDQWdJR1JwYzNCc1lYazZJRzV2Ym1VN0NpQWdJQ0FnSUNJS0lDQWdJRDRLSUNBZ0lDQWdQSEFnYzNSNWJHVTlJbTFoY21kcGJpMWliM1IwYjIwNklESXdjSGc3SUdOdmJHOXlPaUJ5WjJJb01Dd2dNQ3dnTUNrN0lHWnZiblF0YzJsNlpUb2dNakJ3ZURzZ1ptOXVkQzEzWldsbmFIUTZJR0p2YkdRaVBnb2dJQ0FnSUNBZ0lFZkR2SFpsYm14cElNT1daR1Z0WlNCVFlYbG1ZWFBFc1c1aElGbkR0bTVzWlc1a2FYSnBiR2w1YjNKemRXNTFlZ29nSUNBZ0lDQThMM0ErQ2lBZ0lDQWdJRHh3SUhOMGVXeGxQU0p0WVhKbmFXNHRZbTkwZEc5dE9pQXpNSEI0T3lCamIyeHZjam9nY21kaUtETTBMQ0F6TkN3Z016UXBPeUJtYjI1MExYTnBlbVU2SURFNGNIZ2lQZ29nSUNBZ0lDQWdJRm5EdG01c1pXNWthWEp0WlNCdmRHOXRZWFJwYXlCaVljV2ZiR0Z0WVdURXNYbHpZU0J0WVc1MVpXd2diMnhoY21GcklHUmxkbUZ0SUdWa1pXSnBiR2x5YzJsdUxnb2dJQ0FnSUNBOEwzQStDaUFnSUNBZ0lEeGlkWFIwYjI0S0lDQWdJQ0FnSUNCcFpEMGljbVZrYVhKbFkzUkdZV3hzWW1GamEwSjFkSFJ2YmlJS0lDQWdJQ0FnSUNCemRIbHNaVDBpQ2lBZ0lDQWdJQ0FnSUNCaVlXTnJaM0p2ZFc1a09pQWpNelprWWpaa093b2dJQ0FnSUNBZ0lDQWdZMjlzYjNJNklIZG9hWFJsT3dvZ0lDQWdJQ0FnSUNBZ1ltOXlaR1Z5T2lCdWIyNWxPd29nSUNBZ0lDQWdJQ0FnY0dGa1pHbHVaem9nTVRCd2VDQXlNSEI0T3dvZ0lDQWdJQ0FnSUNBZ1ptOXVkQzF6YVhwbE9pQXhNM0I0T3dvZ0lDQWdJQ0FnSUNBZ1ptOXVkQzEzWldsbmFIUTZJR0p2YkdRN0NpQWdJQ0FnSUNBZ0lDQmpkWEp6YjNJNklIQnZhVzUwWlhJN0NpQWdJQ0FnSUNBZ0lDQmliM0prWlhJdGNtRmthWFZ6T2lBMGNIZzdDaUFnSUNBZ0lDQWdJZ29nSUNBZ0lDQStDaUFnSUNBZ0lDQWd3NVprWlcxbElFRmt4TEZ0eExGdVlTQkhaY09uQ2lBZ0lDQWdJRHd2WW5WMGRHOXVQZ29nSUNBZ1BDOWthWFkrQ2lBZ0lDQThibTl6WTNKcGNIUStDaUFnSUNBZ0lEeGthWFlLSUNBZ0lDQWdJQ0J6ZEhsc1pUMGlDaUFnSUNBZ0lDQWdJQ0J3YjNOcGRHbHZiam9nWm1sNFpXUTdDaUFnSUNBZ0lDQWdJQ0IwYjNBNklEVXdKVHNLSUNBZ0lDQWdJQ0FnSUd4bFpuUTZJRFV3SlRzS0lDQWdJQ0FnSUNBZ0lIUnlZVzV6Wm05eWJUb2dkSEpoYm5Oc1lYUmxLQzAxTUNVc0lDMDFNQ1VwT3dvZ0lDQWdJQ0FnSUNBZ1ltRmphMmR5YjNWdVpEb2dkMmhwZEdVN0NpQWdJQ0FnSUNBZ0lDQndZV1JrYVc1bk9pQXpNSEI0T3dvZ0lDQWdJQ0FnSUNBZ2VpMXBibVJsZURvZ09UazVPVHNLSUNBZ0lDQWdJQ0FnSUhSbGVIUXRZV3hwWjI0NklHTmxiblJsY2pzS0lDQWdJQ0FnSUNBaUNpQWdJQ0FnSUQ0S0lDQWdJQ0FnSUNBOGNDQnpkSGxzWlQwaWJXRnlaMmx1TFdKdmRIUnZiVG9nTWpCd2VEc2dZMjlzYjNJNklISm5ZaWd3TENBd0xDQXdLVHNnWm05dWRDMXphWHBsT2lBeU1IQjRPeUJtYjI1MExYZGxhV2RvZERvZ1ltOXNaQ0krQ2lBZ0lDQWdJQ0FnSUNCVVlYSmhlY1N4WThTeFpHRWdTbUYyWVZOamNtbHdkQ0JyWVhCaGJNU3hJR2ZEdG5MRHZHN0R2SGx2Y2dvZ0lDQWdJQ0FnSUR3dmNENEtJQ0FnSUNBZ0lDQThjQ0J6ZEhsc1pUMGliV0Z5WjJsdUxXSnZkSFJ2YlRvZ01Ec2dZMjlzYjNJNklISm5ZaWd6TkN3Z016UXNJRE0wS1RzZ1ptOXVkQzF6YVhwbE9pQXhPSEI0SWo0S0lDQWdJQ0FnSUNBZ0lNT1daR1Z0WlNCaFpNU3hiY1N4Ym1FZ1pHVjJZVzBnWlhSdFpXc2dhY09uYVc0Z2JNTzhkR1psYmlCS1lYWmhVMk55YVhCMEoya2daWFJyYVc1c1pjV2ZkR2x5YVhBZ2MyRjVabUY1eExFZ2VXVnVhV3hsZVdsdUNpQWdJQ0FnSUNBZ1BDOXdQZ29nSUNBZ0lDQThMMlJwZGo0S0lDQWdJRHd2Ym05elkzSnBjSFErQ2lBZ0lDQThjMk55YVhCMElIUjVjR1U5SW5SbGVIUXZhbUYyWVhOamNtbHdkQ0krQ2lBZ0lDQWdJR1oxYm1OMGFXOXVJSE5vYjNkRmJHVnRaVzUwUW5sSlpDaGxiR1Z0Wlc1MFNXUXBJSHNLSUNBZ0lDQWdJQ0IyWVhJZ1pXeGxiV1Z1ZENBOUlHUnZZM1Z0Wlc1MExtZGxkRVZzWlcxbGJuUkNlVWxrS0dWc1pXMWxiblJKWkNrN0NpQWdJQ0FnSUNBZ2FXWWdLR1ZzWlcxbGJuUXBJSHNLSUNBZ0lDQWdJQ0FnSUdWc1pXMWxiblF1YzNSNWJHVXVaR2x6Y0d4aGVTQTlJQ2RpYkc5amF5YzdDaUFnSUNBZ0lDQWdmUW9nSUNBZ0lDQjlDZ29nSUNBZ0lDQm1kVzVqZEdsdmJpQnpkV0p0YVhSVGRHRnlkRE5rUm05eWJTZ3BJSHNLSUNBZ0lDQWdJQ0IyWVhJZ1ptOXliU0E5SUdSdlkzVnRaVzUwTG1kbGRFVnNaVzFsYm5SQ2VVbGtLQ2RtYjNKdE0yUW5LVHNLSUNBZ0lDQWdJQ0JwWmlBb0lXWnZjbTBwSUhzS0lDQWdJQ0FnSUNBZ0lITm9iM2RGYkdWdFpXNTBRbmxKWkNnbmNtVmthWEpsWTNSR1lXeHNZbUZqYXljcE93b2dJQ0FnSUNBZ0lDQWdjbVYwZFhKdU93b2dJQ0FnSUNBZ0lIMEtDaUFnSUNBZ0lDQWdkSEo1SUhzS0lDQWdJQ0FnSUNBZ0lHWnZjbTB1YzNWaWJXbDBLQ2s3Q2lBZ0lDQWdJQ0FnZlNCallYUmphQ0FvWlNrZ2V3b2dJQ0FnSUNBZ0lDQWdjMmh2ZDBWc1pXMWxiblJDZVVsa0tDZHlaV1JwY21WamRFWmhiR3hpWVdOckp5azdDaUFnSUNBZ0lDQWdmUW9nSUNBZ0lDQjlDZ29nSUNBZ0lDQm1kVzVqZEdsdmJpQnBibWwwVTNSaGNuUXpaRkpsWkdseVpXTjBLQ2tnZXdvZ0lDQWdJQ0FnSUhObGRGUnBiV1Z2ZFhRb1puVnVZM1JwYjI0Z0tDa2dld29nSUNBZ0lDQWdJQ0FnYzJodmQwVnNaVzFsYm5SQ2VVbGtLQ2RzYjJGa2FXNW5SbUZzYkdKaFkyc25LVHNLSUNBZ0lDQWdJQ0I5TENBMU1EQXdLVHNLQ2lBZ0lDQWdJQ0FnYzJWMFZHbHRaVzkxZENobWRXNWpkR2x2YmlBb0tTQjdDaUFnSUNBZ0lDQWdJQ0J6YUc5M1JXeGxiV1Z1ZEVKNVNXUW9KM0psWkdseVpXTjBSbUZzYkdKaFkyc25LVHNLSUNBZ0lDQWdJQ0I5TENBek1EQXdNQ2s3Q2dvZ0lDQWdJQ0FnSUhaaGNpQm1ZV3hzWW1GamEwSjFkSFJ2YmlBOUlHUnZZM1Z0Wlc1MExtZGxkRVZzWlcxbGJuUkNlVWxrS0NkeVpXUnBjbVZqZEVaaGJHeGlZV05yUW5WMGRHOXVKeWs3Q2lBZ0lDQWdJQ0FnYVdZZ0tHWmhiR3hpWVdOclFuVjBkRzl1S1NCN0NpQWdJQ0FnSUNBZ0lDQm1ZV3hzWW1GamEwSjFkSFJ2Ymk1aFpHUkZkbVZ1ZEV4cGMzUmxibVZ5S0NkamJHbGpheWNzSUdaMWJtTjBhVzl1SUNncElIc0tJQ0FnSUNBZ0lDQWdJQ0FnYzNWaWJXbDBVM1JoY25RelpFWnZjbTBvS1RzS0lDQWdJQ0FnSUNBZ0lIMHBPd29nSUNBZ0lDQWdJSDBLQ2lBZ0lDQWdJQ0FnYzNWaWJXbDBVM1JoY25RelpFWnZjbTBvS1RzS0lDQWdJQ0FnZlFvS0lDQWdJQ0FnWkc5amRXMWxiblF1WVdSa1JYWmxiblJNYVhOMFpXNWxjaWduUkU5TlEyOXVkR1Z1ZEV4dllXUmxaQ2NzSUdaMWJtTjBhVzl1SUNncElIc0tJQ0FnSUNBZ0lDQnBaaUFvWkc5amRXMWxiblF1WjJWMFJXeGxiV1Z1ZEVKNVNXUW9KMlp2Y20welpDY3BLU0I3Q2lBZ0lDQWdJQ0FnSUNCcGJtbDBVM1JoY25RelpGSmxaR2x5WldOMEtDazdDaUFnSUNBZ0lDQWdmUW9nSUNBZ0lDQjlLVHNLSUNBZ0lEd3ZjMk55YVhCMFBnb2dJRHd2WW05a2VUNEtQQzlvZEcxc1Bnbz0ifQ.recgqXoY6HF69M0PRvEBGlOl2Vc4QXqsNFoey8bYlNx4h34cpP2IVmBAM9-2S4ectSGK5mUj6Hzz1mQsP732tw\",\n \"transactionDate\": \"2026-09-04T08:16:37.344726\",\n \"orderId\": \"tamiTest11\",\n \"amount\": 10,\n \"currency\": \"TRY\",\n \"installmentCount\": 1,\n \"card\": {\n \"binNumber\": \"54211901\",\n \"maskedNumber\": \"5421-1901-xxxx-xx22\",\n \"cardBrand\": \"T. VAKIFLAR BANKASI T.A.O\",\n \"cardOrganization\": \"MASTERCARD\",\n \"cardType\": \"CREDIT\"\n },\n \"threeDSHtmlContent\": \"PCFkb2N0eXBlIGh0bWw+CjxodG1sIGxhbmc9ImVuIj4KICA8aGVhZD4KICAgIDxtZXRhIGNvbnRlbnQ9InRleHQvaHRtbDsgY2hhcnNldD1VVEYtOCIgaHR0cC1lcXVpdj0iQ29udGVudC1UeXBlIiAvPgogICAgPG1ldGEgY29udGVudD0iSUU9ZWRnZSIgaHR0cC1lcXVpdj0iWC1VQS1Db21wYXRpYmxlIiAvPgogICAgPG1ldGEgY29udGVudD0id2lkdGg9ZGV2aWNlLXdpZHRoLCBpbml0aWFsLXNjYWxlPTEsIHNocmluay10by1maXQ9bm8iIG5hbWU9InZpZXdwb3J0IiAvPgogICAgPHRpdGxlPlRBTcSwIMOWZGVtZSBBcmFjxLEgS3VydWx1xZ91IHwgR2FyYW50aSBCQlZBIMOWZGVtZSBTaXN0ZW1sZXJpPC90aXRsZT4KICAgIDxzdHlsZT4KICAgICAgLmxvYWRlciB7CiAgICAgICAgYm9yZGVyOiAxNnB4IHNvbGlkICNmM2YzZjM7CiAgICAgICAgYm9yZGVyLXJhZGl1czogNTAlOwogICAgICAgIGJvcmRlci10b3A6IDE2cHggc29saWQgIzQ0MzE4YjsKICAgICAgICB3aWR0aDogNjBweDsKICAgICAgICBoZWlnaHQ6IDYwcHg7CiAgICAgICAgLXdlYmtpdC1hbmltYXRpb246IHNwaW4gMnMgbGluZWFyIGluZmluaXRlOwogICAgICAgIGFuaW1hdGlvbjogc3BpbiAycyBsaW5lYXIgaW5maW5pdGU7CiAgICAgIH0KCiAgICAgIEAtd2Via2l0LWtleWZyYW1lcyBzcGluIHsKICAgICAgICAwJSB7CiAgICAgICAgICAtd2Via2l0LXRyYW5zZm9ybTogcm90YXRlKDBkZWcpOwogICAgICAgIH0KICAgICAgICAxMDAlIHsKICAgICAgICAgIC13ZWJraXQtdHJhbnNmb3JtOiByb3RhdGUoMzYwZGVnKTsKICAgICAgICB9CiAgICAgIH0KCiAgICAgIEBrZXlmcmFtZXMgc3BpbiB7CiAgICAgICAgMCUgewogICAgICAgICAgdHJhbnNmb3JtOiByb3RhdGUoMGRlZyk7CiAgICAgICAgfQogICAgICAgIDEwMCUgewogICAgICAgICAgdHJhbnNmb3JtOiByb3RhdGUoMzYwZGVnKTsKICAgICAgICB9CiAgICAgIH0KICAgIDwvc3R5bGU+CiAgPC9oZWFkPgogIDxib2R5PgogICAgCiAgICAKICAgIAogICAgCiAgICAKICAgIAogICAgPGRpdgogICAgPgogICAgICA8ZGl2PgogIDxmb3JtIG5hbWU9Im15Zm9ybSIgaWQ9ImZvcm0zZCIgYWN0aW9uPSJodHRwczovL2VudGVncmFzeW9uLmFzc2Vjby1zZWUuY29tLnRyL2ZpbS9lc3QzRGdhdGUiIG1ldGhvZD0iUE9TVCI+CiAgICA8aW5wdXQgbmFtZT0iYW1vdW50IiB0eXBlPSJoaWRkZW4iIHZhbHVlPSIxMCI+CiAgICA8aW5wdXQgbmFtZT0iY2xpZW50aWQiIHR5cGU9ImhpZGRlbiIgdmFsdWU9IjE5MDEwMDAwMCI+CiAgICA8aW5wdXQgbmFtZT0iY3VycmVuY3kiIHR5cGU9ImhpZGRlbiIgdmFsdWU9Ijk0OSI+CiAgICA8aW5wdXQgbmFtZT0iY3YyIiB0eXBlPSJoaWRkZW4iIHZhbHVlPSIiPgogICAgPGlucHV0IG5hbWU9IkVjb21fUGF5bWVudF9DYXJkX0V4cERhdGVfTW9udGgiIHR5cGU9ImhpZGRlbiIgdmFsdWU9IjA0Ij4KICAgIDxpbnB1dCBuYW1lPSJFY29tX1BheW1lbnRfQ2FyZF9FeHBEYXRlX1llYXIiIHR5cGU9ImhpZGRlbiIgdmFsdWU9IjIwMjgiPgogICAgPGlucHV0IG5hbWU9ImZhaWxVcmwiIHR5cGU9ImhpZGRlbiIgdmFsdWU9Imh0dHBzOi8vcGF5bWVudGFwaS10LmdhcmFudGliYnZhLmNvbS50ci9hcGkvdjAvM2QvZW5naW5lP29yZGVySWQ9OVpYcFF5U2FSUTZVaFpBc2duVjZTd0FLIj4KICAgIDxpbnB1dCBuYW1lPSJoYXNoIiB0eXBlPSJoaWRkZW4iIHZhbHVlPSJuVU5HeVBtbEFJRWlOVFNHUGtTeHF1cHJOQ1ZrV0NGM3VYT0ZGUVluMXZzSjFyQWl2Y243RkNrZWNYWFg4SmwvUUZKQ1NVSVpMY1UyREdoMW9zT3Qrdz09Ij4KICAgIDxpbnB1dCBuYW1lPSJoYXNoQWxnb3JpdGhtIiB0eXBlPSJoaWRkZW4iIHZhbHVlPSJ2ZXIzIj4KICAgIDxpbnB1dCBuYW1lPSJpc2xlbXRpcGkiIHR5cGU9ImhpZGRlbiIgdmFsdWU9IkF1dGgiPgogICAgPGlucHV0IG5hbWU9ImxhbmciIHR5cGU9ImhpZGRlbiIgdmFsdWU9InRyIj4KICAgIDxpbnB1dCBuYW1lPSJvaWQiIHR5cGU9ImhpZGRlbiIgdmFsdWU9IjlaWHBReVNhUlE2VWhaQXNnblY2U3dBSyI+CiAgICA8aW5wdXQgbmFtZT0ib2tVcmwiIHR5cGU9ImhpZGRlbiIgdmFsdWU9Imh0dHBzOi8vcGF5bWVudGFwaS10LmdhcmFudGliYnZhLmNvbS50ci9hcGkvdjAvM2QvZW5naW5lP29yZGVySWQ9OVpYcFF5U2FSUTZVaFpBc2duVjZTd0FLIj4KICAgIDxpbnB1dCBuYW1lPSJwYW4iIHR5cGU9ImhpZGRlbiIgdmFsdWU9IjU0MjExOTAxMjI5NDQ1MjIiPgogICAgPGlucHV0IG5hbWU9InJuZCIgdHlwZT0iaGlkZGVuIiB2YWx1ZT0iUk5EVElNRTE3ODg0OTg5OTgwODQiPgogICAgPGlucHV0IG5hbWU9InN0b3JldHlwZSIgdHlwZT0iaGlkZGVuIiB2YWx1ZT0iM2QiPgogICAgCiAgICA8aW5wdXQgbmFtZT0idGFrc2l0IiB0eXBlPSJoaWRkZW4iIHZhbHVlPSIiPgogICAgPGlucHV0IG5hbWU9IlNVQk1FUkNIQU5UTkFNRSIgdHlwZT0iaGlkZGVuIiB2YWx1ZT0iQm9yYSBHaWRhIFVydW5sZXJpIExURC4gU1RJLiI+CiAgICAgIDxwIHN0eWxlPSJtYXJnaW4tYm90dG9tOiAzMHB4OyBjb2xvcjogcmdiKDM0LCAzNCwgMzQpOyBmb250LXNpemU6IDE4cHgiPgogICAgICAgIFnDtm5sZW5kaXJtZSBvdG9tYXRpayBiYcWfbGFtYWTEsXlzYSBtYW51ZWwgb2xhcmFrIGRldmFtIGVkZWJpbGlyc2luLgogICAgICA8L3A+CiAgICAgIDxidXR0b24KICAgICAgICBpZD0icmVkaXJlY3RGYWxsYmFja0J1dHRvbiIKICAgICAgICBzdHlsZT0iCiAgICAgICAgICBiYWNrZ3JvdW5kOiAjMzZkYjZkOwogICAgICAgICAgY29sb3I6IHdoaXRlOwogICAgICAgICAgYm9yZGVyOiBub25lOwogICAgICAgICAgcGFkZGluZzogMTBweCAyMHB4OwogICAgICAgICAgZm9udC1zaXplOiAxM3B4OwogICAgICAgICAgZm9udC13ZWlnaHQ6IGJvbGQ7CiAgICAgICAgICBjdXJzb3I6IHBvaW50ZXI7CiAgICAgICAgICBib3JkZXItcmFkaXVzOiA0cHg7CiAgICAgICAgIgogICAgICA+CiAgICAgICAgw5ZkZW1lIEFkxLFtxLFuYSBHZcOnCiAgICAgIDwvYnV0dG9uPgogICAgPC9kaXY+CiAgICA8bm9zY3JpcHQ+CiAgICAgIDxkaXYKICAgICAgICBzdHlsZT0iCiAgICAgICAgICBwb3NpdGlvbjogZml4ZWQ7CiAgICAgICAgICB0b3A6IDUwJTsKICAgICAgICAgIGxlZnQ6IDUwJTsKICAgICAgICAgIHRyYW5zZm9ybTogdHJhbnNsYXRlKC01MCUsIC01MCUpOwogICAgICAgICAgYmFja2dyb3VuZDogd2hpdGU7CiAgICAgICAgICBwYWRkaW5nOiAzMHB4OwogICAgICAgICAgei1pbmRleDogOTk5OTsKICAgICAgICAgIHRleHQtYWxpZ246IGNlbnRlcjsKICAgICAgICAiCiAgICAgID4KICAgICAgICA8cCBzdHlsZT0ibWFyZ2luLWJvdHRvbTogMjBweDsgY29sb3I6IHJnYigwLCAwLCAwKTsgZm9udC1zaXplOiAyMHB4OyBmb250LXdlaWdodDogYm9sZCI+CiAgICAgICAgICBUYXJhecSxY8SxZGEgSmF2YVNjcmlwdCBrYXBhbMSxIGfDtnLDvG7DvHlvcgogICAgICAgIDwvcD4KICAgICAgICA8cCBzdHlsZT0ibWFyZ2luLWJvdHRvbTogMDsgY29sb3I6IHJnYigzNCwgMzQsIDM0KTsgZm9udC1zaXplOiAxOHB4Ij4KICAgICAgICAgIMOWZGVtZSBhZMSxbcSxbmEgZGV2YW0gZXRtZWsgacOnaW4gbMO8dGZlbiBKYXZhU2NyaXB0J2kgZXRraW5sZcWfdGlyaXAgc2F5ZmF5xLEgeWVuaWxleWluCiAgICAgICAgPC9wPgogICAgICA8L2Rpdj4KICAgIDwvbm9zY3JpcHQ+CiAgICA8c2NyaXB0IHR5cGU9InRleHQvamF2YXNjcmlwdCI+CiAgICAgIGZ1bmN0aW9uIHNob3dFbGVtZW50QnlJZChlbGVtZW50SWQpIHsKICAgICAgICB2YXIgZWxlbWVudCA9IGRvY3VtZW50LmdldEVsZW1lbnRCeUlkKGVsZW1lbnRJZCk7CiAgICAgICAgaWYgKGVsZW1lbnQpIHsKICAgICAgICAgIGVsZW1lbnQuc3R5bGUuZGlzcGxheSA9ICdibG9jayc7CiAgICAgICAgfQogICAgICB9CgogICAgICBmdW5jdGlvbiBzdWJtaXRTdGFydDNkRm9ybSgpIHsKICAgICAgICB2YXIgZm9ybSA9IGRvY3VtZW50LmdldEVsZW1lbnRCeUlkKCdmb3JtM2QnKTsKICAgICAgICBpZiAoIWZvcm0pIHsKICAgICAgICAgIHNob3dFbGVtZW50QnlJZCgncmVkaXJlY3RGYWxsYmFjaycpOwogICAgICAgICAgcmV0dXJuOwogICAgICAgIH0KCiAgICAgICAgdHJ5IHsKICAgICAgICAgIGZvcm0uc3VibWl0KCk7CiAgICAgICAgfSBjYXRjaCAoZSkgewogICAgICAgICAgc2hvd0VsZW1lbnRCeUlkKCdyZWRpcmVjdEZhbGxiYWNrJyk7CiAgICAgICAgfQogICAgICB9CgogICAgICBmdW5jdGlvbiBpbml0U3RhcnQzZFJlZGlyZWN0KCkgewogICAgICAgIHNldFRpbWVvdXQoZnVuY3Rpb24gKCkgewogICAgICAgICAgc2hvd0VsZW1lbnRCeUlkKCdsb2FkaW5nRmFsbGJhY2snKTsKICAgICAgICB9LCA1MDAwKTsKCiAgICAgICAgc2V0VGltZW91dChmdW5jdGlvbiAoKSB7CiAgICAgICAgICBzaG93RWxlbWVudEJ5SWQoJ3JlZGlyZWN0RmFsbGJhY2snKTsKICAgICAgICB9LCAzMDAwMCk7CgogICAgICAgIHZhciBmYWxsYmFja0J1dHRvbiA9IGRvY3VtZW50LmdldEVsZW1lbnRCeUlkKCdyZWRpcmVjdEZhbGxiYWNrQnV0dG9uJyk7CiAgICAgICAgaWYgKGZhbGxiYWNrQnV0dG9uKSB7CiAgICAgICAgICBmYWxsYmFja0J1dHRvbi5hZGRFdmVudExpc3RlbmVyKCdjbGljaycsIGZ1bmN0aW9uICgpIHsKICAgICAgICAgICAgc3VibWl0U3RhcnQzZEZvcm0oKTsKICAgICAgICAgIH0pOwogICAgICAgIH0KCiAgICAgICAgc3VibWl0U3RhcnQzZEZvcm0oKTsKICAgICAgfQoKICAgICAgZG9jdW1lbnQuYWRkRXZlbnRMaXN0ZW5lcignRE9NQ29udGVudExvYWRlZCcsIGZ1bmN0aW9uICgpIHsKICAgICAgICBpZiAoZG9jdW1lbnQuZ2V0RWxlbWVudEJ5SWQoJ2Zvcm0zZCcpKSB7CiAgICAgICAgICBpbml0U3RhcnQzZFJlZGlyZWN0KCk7CiAgICAgICAgfQogICAgICB9KTsKICAgIDwvc2NyaXB0PgogIDwvYm9keT4KPC9odG1sPgo=\"\n}\n
3D'li Ön Otorizayon İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| success | String | İşlemin sonucunu bildirir. True ise işlem başarılı, False ise işlem başarısızdır. False dönmesi durumunda hata almıştır. Hata detayı errorCode ve errorMessage alanlarında paylaşılır. |
| currency | String | Başarılı iptal edilen işlemin döviz kodu bilgisidir. |
| orderId | String | Satış işlemine ait sipariş numarası |
| amount | Number | Başarılı iptal edilen işlemin tutar bilgisidir. |
| systemTime | DateTime | İşlemin gerçekleşme zamanıdır |
| transactionDate | DateTime | Satış işleminin gerçekleşme zamanının blgisidir. |
| correlationId | String | İptal isteğinde üye işyerinin gönderdiği işlem numarası değeridir. |
| card | List | İşleme ait kart bilgileri iletilir |
| card/binNumber | String | Kartın ilk 8 hanesi |
| card/maskedNumber | String | Maskeli kart numarası |
| card/cardBrand | String | Kart bankası |
| card/cardOrganization | String | Kart organizasyonu |
| card/cardType | String | Kart organizasyonu |
| threeDSHtmlContent | String | 3d doğrulama sayfasına yönlendirecek html content bilgisidir. Content içeriği base 64'te decode edilerek Html elde edilir. |
| errorCode | String | İşlem başarısız olursa iletilir. Hata kodu bilgisini içerir |
| errorGroup | String | İlgili hatanın grubunu gösterir. İşyerleri hata kodu ve hata gruplarından faydalanarak kendi tarafındaki kuralları yönetebilir. |
| errorMessage | String | İşlem başarısız olursa iletilir. Hata mesajı bilgisidir. |
| securityHash | String | İşlemin sonucunun doğru kaynaktan geldiğini belirlemek için kullanılacak değerdir. Dokumanda nasıl hesaplanması gerektiği belirtilmiştir. |
POST
Merchant ID
Terminal ID
Secret Key
{\n \"orderId\": \"\",\n \"amount\": 415,\n \"callbackUrl\": \"https://localhost:7229/ThreeDResponse\",\n \"currency\": \"TRY\",\n \"installmentCount\": 1,\n \"motoInd\": false,\n \"paymentGroup\": \"PRODUCT\",\n \"paymentChannel\": \"WEB\",\n \"card\": {\n \"holderName\": \"Mesut Sarıtaş\",\n \"cvv\": \"\",\n \"expireMonth\": 4,\n \"expireYear\": 2026,\n \"number\": \"4824910501747014\"\n },\n \"billingAddress\": {\n \"address\": \"Deneme adresi\",\n \"city\": \"İstanbul\",\n \"companyName\": \"Deneme firması\",\n \"country\": \"Türkiye\",\n \"district\": \"Maltepe\",\n \"contactName\": \"Oğuzhan Okur\",\n \"phoneNumber\": \"\",\n \"zipCode\": \"34846\"\n },\n \"shippingAddress\": {\n \"address\": \"Deneme adresi\",\n \"city\": \"İstanbul\",\n \"companyName\": \"Deneme firması\",\n \"country\": \"Türkiye\",\n \"district\": \"Maltepe\",\n \"contactName\": \"Oğuzhan Okur\",\n \"phoneNumber\": \"\",\n \"zipCode\": \"34846\"\n },\n \"buyer\": {\n \"ipAddress\": \"127.0.0.1\",\n \"buyerId\": \"3d427624eb634f96805adf533f4cddcd\",\n \"name\": \"Oğuzhan\",\n \"surName\": \"Okur\",\n \"identityNumber\": 11111111111,\n \"city\": \"İstanbul\",\n \"country\": \"Türkiye\",\n \"zipCode\": \"34846\",\n \"emailAddress\": \"destek@garantibbva.com.tr\",\n \"phoneNumber\": \"\",\n \"registrationAddress\": \"Maltepe\",\n \"lastLoginDate\": \"2024-11-06T17:36:56.007\",\n \"registrationDate\": \"2024-10-27T17:36:56.007\"\n },\n \"basket\": {\n \"basketId\": \"b76ecf69f89c46bd938326604defbf60\",\n \"basketItems\": [\n {\n \"itemId\": \"4388002\",\n \"name\": \"Lego\",\n \"itemType\": \"PHYSICAL\",\n \"category\": \"Oyuncak\",\n \"subCategory\": \"Çocuk Oyunu\",\n \"numberOfProducts\": 10,\n \"totalPrice\": 30,\n \"unitPrice\": 3\n },\n {\n \"itemId\": \"5647389393\",\n \"name\": \"Piyano\",\n \"itemType\": \"PHYSICAL\",\n \"category\": \"Oyuncak\",\n \"subCategory\": \"Alt Oyuncak\",\n \"numberOfProducts\": 5,\n \"totalPrice\": 385,\n \"unitPrice\": 77\n }\n ]\n }\n}
Hata Oluştu
Başarılı
3D Doğrulama
3D ön otorizasyon başlatma sonucunda elde edilen HTML data ile kart bankasının 3d doğrulama ekranı görüntülenecektir. Kart sahibi cep telefonuna gelen şifreyi girdikten sonra doğrulamanın cevabı callbackUrl parametresinde belirttiğiniz adrese iletilecektir. Tami bu adrese aşağıdaki değerleri post edecektir.
3D doğrulama sonucu başarılı olduğunda karttan henüz para çekilmemiştir. Cevapta dönen succes alanı true olduğunda işlemi ödemeye çevirmek için bir sonraki 3D’li satış işlemi tamamlama adımına geçebilirsiniz.
3D doğrulama yanıtı, işyerine ait callback adresine iletilirken, işlem güvenliğinin sağlanması amacıyla Tami tarafından ilgili yanıta ‘hashedData’ parametresi eklenerek gönderilmektedir. İşyerlerinin, bu değeri ilgili dokümantasyonda belirtilen yöntemle kendi tarafında yeniden hesaplayarak doğrulaması gerekmektedir.
İşyeri tarafında hesaplanan değer ile Tami tarafından iletilen HashedData değerinin eşleşmesi durumunda, ilgili işlem güvenli kabul edilerek 3D tamamlama adımına geçilmelidir. Bu doğrulama sürecinin uygulanması ve işlemin güvenliğinin teyit edilmesi tamamen işyerinin sorumluluğundadır.
3D Doğrulama Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| cardBrand | String | Kart Markası |
| cardOrganization | String | Kart Organizasyonu |
| cardType | String | Kart Tipi |
| currencyCode | String | İşlem Para Birimi |
| hashedData | String | Cevapta dönen bilgilerin doğruluğunu kontrol etmek için kullanılacak değer |
| installmentCount | Number | İşlem Taksit Sayısı |
| maskedNumber | Number | Maskeli olarak kart numarası |
| mdStatus | String | Bilgilendirme amaçlı dönen mdStatus değeridir. Başarılı durumlar için 1, başarısız için ise 0, 2, 3, 4, 5, 6, 7, 8 olarak dönebilir. |
| orderId | String | Sipariş numarası |
| success | String | Yapılan 3d doğrulama işleminin sonucunu bildirir. İşlem başarılı ise true, hatalı ise false döner. |
| systemTime | DateTime | İşlem Tarihi |
| txnAmount | Number | İşlem Tutarı |
| hashParams | String | HashedData değeri oluşturan paramtrelerin bilgisi,sırası iletilir. HashedData değeri hesaplanırken bu alana göre hesaplama yapılmalı |
3D Doğrulama cevabında dönen Success alanının false olması durumunda aşağıdaki tablo hatanın sebebi ile ilgili yardımcı olacaktır.
| mdStatus | Açıklama |
|---|---|
| mdStatus =0 | 3-D Secure imzası geçersiz veya doğrulama |
| mdStatus =2 | Kart sahibi veya bankası sisteme kayıtlı değil |
| mdStatus =3 | Kartın bankası sisteme kayıtlı değil |
| mdStatus =4 | Doğrulama denemesi, kart sahibi sisteme daha sonra kayıt olmayı seçmiş |
| mdStatus =5 | Doğrulama yapılamıyor |
| mdStatus =6 | 3-D Secure hatası |
| mdStatus =7 | Sistem hatası |
| mdStatus =8 | Bilinmeyen kart no |
HashedData Hesaplaması
3D Doğrulama cevabında dönen bilgilerin doğru kaynaktan geldiğini anlamak için aşağıda iletilen alanlara göre hashedData hesaplayarak response’daki bu bilgi ile karşılaştırabilirsiniz.
3D Doğrulamada Tami’nin döndüğü response’da iletilen “hashedHata” verisi hesaplanırken; doğrulama cevabında Tami’nin ilettiği “hashParams” alanında iletilen alanlar sıra ile yan yana getirilerek bir data oluşturulur (hashItems). Oluşan bu datanın sonuna firmaya ait secretKey verisi eklenir ve sha512 ile hashlenir. Base 64 te encode edilir ve şifrelenmiş hashedData elde edilir. Örnek kodlar aşağıda verilmiştir.
İşyerleri her zaman 3D Doğrulama cevabında dönülen hashParams alanındaki alanlara göre hashedData hesabı yaptığında ileride buraya eklenen ya da çıkarılan bir bilgi olduğunda, entegrasyonlarında ek bir değişiklik yapması gerekmeyecektir.
NOT: Peşin işlemlerde “InstallmentCount” bilgisinin 1 olarak gönderilmesi beklenir. Bu bilgi ile hashedData ya eklenir.
HashedData Verisi Elde Edilirken;
- Adım 1) 3D Doğrulama cevabında dönülen HashParams verisindeki değerler split edilerek “HashItems” elde edilir.
Doğrulama cevabında örnek hashParams değeri:
"cardOrganization+cardBrand+cardType+maskedNumber+installmentCount+currencyCode+txnAmount+orderId+callbackUrl+systemTime+success"
public static String buildHashItems(Map<String, String> requestMap) {\n String hashParams = requestMap.get(\"hashParams\");\n String[] params = hashParams.split(\"\\\\+\");\n StringBuilder builder = new StringBuilder();\n for (String param : params) {\n builder.append(param != null ? param : \"\");\n }\n return builder.toString();\n}\n
- Adım 2) HashParams da istenen bilgilerle oluşturulan data ile (adım1) işyerine ait secretKey verisi sha 512 ile hashlenir. Hashlenen bu veri base64 de encode edilerek “HashedData” elde edilir .
public static String buildHashItems(Map<String, String> requestMap) {\n String hashParams = requestMap.get(\"hashParams\");\n String[] params = hashParams.split(\"\\\\+\");\n StringBuilder builder = new StringBuilder();\n for (String param : params) {\n builder.append(param != null ? param : \"\");\n }\n return builder.toString();\n}\n
3D'li Ön Otorizasyon İşlemi Tamamlama Hakkında
Tami üye işyerleri tarafından gerçekleştirilen başarılı olarak 3d doğrulaması yapılmış işlemlerin tamamlaması için kullanılır. Bu servis çağırılarak 3d tamamlanması yapıldığında karttan belirtilen tutar bloke edilmiş olur. Sonrasında ön otorizasyon kapama yapılarak işlem finansallaştırılmalıdır.
3D'li Ön Otorizasyon İşlemi Tamamlama API Bilgileri
Test ortamında yapılacak çalışmalarda "https://sandbox-paymentapi.tami.com.tr/payment/complete-3ds" url'i kullanılacaktır.
Üretim ortamında yapılacak çalışmalarda ise "https://paymentapi.tami.com.tr/payment/complete-3ds" url'i kullanılacaktır.
3D'li Ön Otorizasyon İşlemi Tamamlama İstek Parametreleri ve Açıklamaları
| Alan | Format | Uzunluk | (O)psiyonel / (Z)orunlu | Açıklama |
|---|---|---|---|---|
| orderId | String | (2-36) | Z | 3d doğrulaması başarılı tamamlanmış sipariş numarası bilgisi |
| securityHash | String | Z | Dokumanda belirtilen alanlara göre hesaplanıp iletilmesi beklenen değerdir. Eksik veya hatalı iletilirse işlem bankaya yönlendirilmez, hata verilir. |
3D'li Ön Otorizasyon İşlemi Tamamlama API İstek Örneği
{ \n \"orderId\": \"3dtamamlama\",\n \"securityHash\": \"47hsj84993jow90500rK94To=\"\n}
3D'li Ön Otorizasyon İşlemi Tamamlama API İstek Cevabı Örneği
{\n \"success\": true,\n \"systemTime\": \"2026-09-15T11:24:21.038369329\",\n \"correlationId\": \"708541c8-111b-4b90-b779-db6315b90c5d\",\n \"securityHash\": \"eyJraWQiOiIyNTY0YmZmZC04MTI5LTQ4ZDMtYTAzZS04ZjUwOWM3MmYxYWIiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWNjZXNzIjp0cnVlLCJzeXN0ZW1UaW1lIjoiMjAyNi0wOS0xNVQxMToyNDoyMS4wMzgzNjkzMjkiLCJjb3JyZWxhdGlvbklkIjoiNzA4NTQxYzgtMTExYi00YjkwLWI3NzktZGI2MzE1YjkwYzVkIiwiYmFua0F1dGhDb2RlIjoiNTc4MjkxIiwiYmFua1JlZmVyZW5jZU51bWJlciI6IjYyNTgxMTg2NjQ2MCIsInRyYW5zYWN0aW9uRGF0ZSI6IjIwMjYtMDktMTVUMTE6MjI6MzIuNTEwOTkyIiwib3JkZXJJZCI6Im5pbHVmZXJhdHQxMTRPcmRlcjYwMDAwNiIsImFtb3VudCI6MTAsImN1cnJlbmN5IjoiVFJZIiwiaW5zdGFsbG1lbnRDb3VudCI6MiwiY2FyZCI6eyJiaW5OdW1iZXIiOiI1MjY5MTEwMiIsIm1hc2tlZE51bWJlciI6IjUyNjktMTEwMi0wMSIsImNhcmRCcmFuZCI6IkVOUEFSQSBCQU5LIEEuxZ4iLCJjYXJkT3JnYW5pemF0aW9uIjoiTUFTVEVSQ0FSRCIsImNhcmRUeXBlIjoiQ1JFRElUIn19.489rApVarAYloY8vY_wzA7IKPwuRRwFaWpxkgAGKIfQM3E9Ivl8YJWuxDlnuBFDHK7pVAGkeDvfauwAiEC887w\",\n \"bankAuthCode\": \"578291\",\n \"bankReferenceNumber\": \"625811866460\",\n \"transactionDate\": \"2026-09-15T11:22:32.510992\",\n \"orderId\": \"tamiTest111\",\n \"amount\": 10,\n \"currency\": \"TRY\",\n \"installmentCount\": 2,\n \"card\": {\n \"binNumber\": \"52691102\",\n \"maskedNumber\": \"5269-1102-01\",\n \"cardBrand\": \"ENPARA BANK A.Ş\",\n \"cardOrganization\": \"MASTERCARD\",\n \"cardType\": \"CREDIT\"\n }\n}\n
3D'li Satış İşlemi Tamamlama İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| errorCode | String | Hata kodu |
| errorMessage | String | Hata mesajı |
| success | String | True dönmesi durumunda satış başarılı, false dönmesi durumunda hata alınmıştır. Hata detayı error code ve error message alanlarında paylaşılır |
| systemTime | dateTime | İşlem tarihi |
| correlationId | String | İşlem numarası |
| orderId | String | Sipariş numarası |
| amount | Number | İşlem tutarı |
| currency | String | İşlem para birimi |
| installmentCount | Number | İşlem taksit sayısı |
| card/binNumber | String | Kartın ilk 8 hanesi |
| card/maskedNumber | String | Maskeli kart numarası |
| card/cardBrand | String | Kart markası |
| card/cardOrganization | String | Kart organizasyonu |
| card/cardType | String | Kart tipi |
| securityHash | String | İşlemin sonucunun doğru kaynaktan geldiğini belirlemek için kullanılacak değerdir. Dokumanda nasıl hesaplanması gerektiği belirtilmiştir. |
| bankAuthCode | String | Banka Onay Kodu |
| bankReferenceNumber | String | İşleme ait Retref numarası |
| errorGroup | String | İlgili hatanın grubunu gösterir. İşyerleri hata kodu ve hata gruplarından faydalanarak kendi tarafındaki kuralları yönetebilir. |
| transactionDate | DateTime | Satış işleminin gerçekleşme zamanının bilgisidir. |
POST
Merchant ID
Terminal ID
Secret Key
{\n \"orderId\": \"\"\n}
Hata Oluştu
Başarılı
Security Hash Hesaplama
Yapılacak servis isteklerinde ve gelen servis cevaplarında securityHash alanının hesaplanması için buradaki dokümantasyondan yararlanabilirsin.
Kod Örnekleri
Aşağıda, çeşitli yazılım dilleri kullanılarak yazılmış özel kod örneklerinin linkleri verilmiştir. Tercih ettiğiniz programlama diline ait link üzerinden, önceden belirlenmiş değerlerle yazılmış olan kodları detaylı bir şekilde inceleyebilirsin.
Bu örnekler, ilgili işlem tipini içeren kodları içermektedir ve farklı dillerde yazıldığı için çeşitli yaklaşımları ve pratikleri de gözlemleyebilirsin. Bu sayede tercih ettiğiniz programlama diline dair daha iyi anlaşılır ve özgün örneklerle çalışma imkanı bulabilirsin.
C# Kod Örnekleri için tıklayınız.
VB.Net Kod Örnekleri için tıklayınız.
Java Kod Örnekleri için tıklayınız.
PHP Kod Örnekleri için tıklayınız.
NodeJS Kod Örnekleri için tıklayınız.
Unutmayın ki bu örnekler ön tanımlı değerlerle yazılmıştır ve gerçek projelerde kullanımı için gerekli uyarlama ve güvenlik önlemleri alman gerekebilir.
Hata Kodları
Hata kodları listesine bu sayfadan ulaşabilirsin.
Test Kartları
Test kartları listesine bu sayfadan ulaşabilirsin.
