-
Tami Sanal POS
Tami Sanal POS
Puan Sorgulama Genel Açıklama
Kartta bulunan kullanılabilir puanı sorgulayan istek tipidir.
Ödül Grubu Maximum, Bonus, Axess ve CardFinans olan debit kartlarda puan kullanılamaz. Buna uygun olarak ödeme sayfanızda belirtilen debit kartlar için puan kullanımı gösterilmemelidir. Bu ödül gruplarına sahip kredi kartlarında böyle bir kısıt yoktur.
Test/Prod Ortamları API Kullanıcı Bilgisi
Tami üzerinden gerçekleştirilen Sanal POS işlemleri için üye işyerleri test ortamında gerçekleştirmek istedikleri kontrolleri aşağıdaki tabloda verilen üye işyeri bilgilerini kullanabilirler.
Üretim ortamında Tami üzerinden gerçekleştirilecek Sanal POS işlemleri için başvuru yapılarak üye işyeri numarası alınır ve bu bilgilerle işlem geçirilir.
Sandbox test portaline https://sandbox-portal.tami.com.tr adresinden ulaşabilirsiniz. Aşağıda iletilen 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.
| Kullanıcı Telefon Numarası | Kullanıcı Şifre | Sms / Email Otp | İşyeri Numarası | Terminal Numarası | Secret Key |
|---|---|---|---|---|---|
| 5346484700 | 147850 | 147852 | 77006950 | 84006953 | 0edad05a-7ea7-40f1-a80c-d600121ca51b |
| 5346484709 | 147850 | 147852 | 77006951 | 84006954 | c8581bb6-a4b2-4925-8c94-529fc651399e |
| 5346484803 | 147850 | 147852 | 77006952 | 84006955 | ff7d4895-0c32-4f48-86ab-fb9ecca9f3d7 |
| 5346484807 | 147850 | 147852 | 77006953 | 84006956 | 33124ff0-0b19-4cf9-b002-13a35eae865b |
| 5346484800 | 147850 | 147852 | 77006954 | 84006957 | 7daf9631-e136-4164-9ddb-dd1c02df851d |
| 5346484808 | 147850 | 147852 | 77006956 | 84006959 | fe6f3fff-0434-4932-a27d-bb3dac9de49d |
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üleyebilirsiniz.
Üretim ortamı bilgileriniz için https://portal.tami.com.tr adresinden üye olabilir veya e-ticaret destek birimine başvurabilirsiniz.
Puan Sorgulama İşlemi API Bilgileri
Test ortamında yapılacak çalışmalarda "https://sandbox-paymentapi.tami.com.tr/vas/bonusQuery" url'i kullanılacaktır.
Üretim ortamında yapılacak çalışmalarda ise "https://paymentapi.tami.com.tr/vas/bonusQuery" url'i kullanılacaktır.
API İstek Örneği
{\n \"ipAddress\" : \"1.1.111.111\",\n \"emailAddress\" : \"Cem@cem.com\",\n \"cardNumber\" : \"4546711234567894\",\n \"expireMonth\" : 12,\n \"expireYear\" : 26,\n \"cvv\" : \"\",\n \"currencyCode\" : 949 ,\n \"amount\" : 10,\n \"securityHash\" : \"748dnskwo404040lel==\"\n}
İstek Parametreleri ve Açıklamaları
| Alan | Format | (O)psiyonel / (Z)orunlu/ (Ş)artlı | Açıklama |
|---|---|---|---|
| ipAddress | String | Z | Alıcıya ait ip adresi. |
| emailAddress | String | Z | Üye işyerine ait mail bilgisi |
| cardNumber | Number | Z | Kredi kartı numarası |
| expireMonth | Number | Z | Sorgulamanın yapılacağı kartın son kullanma tarihi ay bilgisi. |
| expireYear | Number | Z | Sorgulamanın yapılacağı kartın son kullanma tarihi yıl bilgisi. |
| cvv | Number | O | Ödemenin alınacağı kartın güvenlik kodu bilgisi. |
| currencyCode | Number | Z | Döviz Tipi |
| amount | Number | Z | Tutar |
| securityHash | String | Z | Dokumanda belirtilen şekilde hesaplanıp iletilmesi beklenen değerdir. Eksik veya hatalı iletilirse işlem bankaya yönlendirilmez, hata verilir. |
API İstek Cevabı Örneği
{\n \"approved\": true,\n \"orderId\": \"SISTC7BA89DA0BE1476F81AD3A476EF10C80\",\n \"returnCode\": \"00\",\n \"errorMessage\": \"\",\n \"retRefNum\": \"401609748852\",\n \"provisionDate\": \"20240116 17:05:15\",\n \"rewardList\": [\n {\n \"type\": \"CARD\",\n \"amount\": 0.022,\n \"name\": \"BNS\"\n }\n ],\n \"securityHash\": \"74hsjw84746eekro747463ye==\"\n}
İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| approved | String | İşlem Onay durumunu belirlen alan |
| orderId | String | Sipariş Numarası |
| returnCode | Number | hata kodu |
| errorMessage | Number | Hata Mesajı |
| retRefNum | Number | Referans Numarası |
| provisionDate | DateTime | İşlem Tarihi |
| type | Char | Kart Tipi |
| amount | Number | Kullanılabilir Puan Tutarı |
| name | Char | Kullanılabilir Puan Tipi |
| securityHash | String | İşlemin sonucunun doğru kaynaktan geldiğini belirlemek için kullanılacak değer. Belgeler bunun nasıl hesaplanması gerektiğini belirtir. |
Security Hash Hesaplama
Yapılacak servis isteklerinde ve gelen servis cevaplarında securityHash alanının hesaplanması için buradaki dokümantasyondan yararlanabilirsiniz.
Hata Kodları
Hata kodları listesine bu sayfadan ulaşabilirsiniz.
Test Kartları
Test kartları listesine bu sayfadan ulaşabilirsiniz.
