-
Tami Sanal POS
Tami Sanal POS
İşlem Sorgulama İşlemi Genel Açıklama
Tami üzerinden gerçekleşen işlemlerin son durumunu öğrenmek için kullanılacak servistir. İşlemin sipariş numarası ve işlem detay görüntüleme true gönderilerek sorgulanır. İşlemin son durumu ve bu siparişle ilgili yapılan tüm işlemlere ait bilgileri gösteren servistir.
İşlemin tüm detayı değil sadece son statusune ait bilgiler görüntülenmek istenirse işlem detay görüntüleme false gönderilir.
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 | 147854 | 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.
Sorgulama İşlemi API Bilgileri
Test ortamında yapılacak çalışmalarda "https://sandbox-paymentapi.tami.com.tr/payment/query" url'i kullanılacaktır.
Üretim ortamında yapılacak çalışmalarda ise "https://paymentapi.tami.com.tr/payment/query" url'i kullanılacaktır.
İstek Parametreleri ve Açıklamaları
| Alan | Format | Uzunluk | (O)psiyonel / (Z)orunlu | Açıklama |
|---|---|---|---|---|
| orderId | String | (2-36) | Z | iptal edilmek istenen satış işlemine ait sipariş numarası bilgisidir. |
| isTransactionDetail | String | O | Eğer true gönderilirse siparişin başından geçen tüm işlemler paylaşılacaktır. Eğer false ya da boş gönderilirse siparişin sadece son statüsüne ait bilgiler iletilir. | |
| 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 Örneği
{\n \"orderId\": \"orderquery\", \n \"isTransactionDetail\": \"true\",\n \"securityHash\": \"4djd40585YY95U8375wdkdT==\"\n}
API İstek Cevabı Örneği
{\n \"success\": true,\n \"securityHash\": \"873e78gedceb378937==\",\n \"systemTime\": \"2023-09-15T14:48:45.755\",\n \"correlationId\": \"correlation3962\",\n \"amount\": 50,\n \"orderDate\": \"2023-08-17T16:47:54.012\",\n \"currency\": \"TRY\",\n \"installmentCount\": 7,\n \"orderStatus\": \"AUTH\",\n \"card\": {\n \"binNumber\": \"41556501\",\n \"cardBrand\": \"DİĞER BANKA\",\n \"cardOrganization\": \"VISA\",\n \"cardType\": \"CREDIT\"\n },\n \"transactions\": [\n {\n \"amount\": 50,\n \"transactionType\": \"AUTH\",\n \"transactionStatus\": \"SUCCESS\",\n \"transactionDate\": \"2023-08-17T16:47:54.833\"\n }\n ]\n}
İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| success | String | İşlem sorgulamanın sonucudur. True olması durumunda işleme ait diğer bilgiler de dönecektir. |
| errorCode | String | Success alanı False olması durumunda alınan hatanın kodudur. |
| errorMessage | String | Success alanı False olması durumunda alınan hatanın açıklamasıdır. |
| systemTime | DateTime | Yapılan işlem sorgulamanın zamanıdır |
| correlationId | String | Üye işyeri tarafından iletilen sorgulama işleminin işlem numarasıdır |
| amount | Number | İşlemin işlem yapılabilir tutar bilgisidir. Örneğin 100 tllik bir işlem 20 tllik bir iade transactionı geçirdiyse tutar 80 tl görünecektir. |
| orderDate | dateTime | İşlemin oluşturulma tarihidir. |
| currency | String | İşlemin döviz kodudur |
| installmentCount | Number | İşlemin taksit sayısıdır |
| orderStatus | String | İşlemin son statüsüdür |
| card | Object | İşlem yapan karta ait bilgiler içermektedir. |
| card/binNumber | String | İşlem yapılan kartın ilk 8 hanesi |
| card/cardBrand | String | Kart ödül grubu bilgisidir. BONUS, WORLD, AXESS vb. |
| card/cardOrganization | String | Kart organizasyon bilgisidir. AMEX, TROY, MASTERCARD, VISA vb. |
| card/cardType | String | Kart tipidir. CREDIT, DEBIT |
| transactions | List | isTransactionDetail='true' gönderilirse ilgili orderın başından geçen tüm transaction verisi dönülecektir. |
| transactions/amount | Number | ilgili kaydın tutarı |
| transactions/transactionType | String | ilgili kaydın işlem türü |
| transactions/transactionStatus | String | ilgili kaydın başarı durumu |
| transactions/transactionDate | dateTime | ilgili kaydın tarihi |
| transactions/reason | String | İşlem iade/iptal edilirken bir reason alanı gönderilirse sorgulamada da bu alan dönülecektir. |
| securityHash | String | İşlemin sonucunun doğru kaynaktan geldiğini belirlemek için kullanılacak değer. Belgeler bunun nasıl hesaplanması gerektiğini belirtir. |
POST
Merchant ID
Terminal ID
Secret Key
{\n \"orderId\": \"\",\n \"isTransactionDetail\": true\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 yararlanabilirsiniz.
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 inceleyebilirsiniz.
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özlemleyebilirsiniz. Bu sayede tercih ettiğiniz programlama diline dair daha iyi anlaşılır ve özgün örneklerle çalışma imkanı bulabilirsiniz.
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ız gerekebilir.
Hata Kodları
Hata kodları listesine bu sayfadan ulaşabilirsiniz.
Test Kartları
Test kartları listesine bu sayfadan ulaşabilirsiniz.
