-
Tami Sanal POS
Tami Sanal POS
İptal İşlemi Genel Açıklama
TAMİ üzerinden gerçekleştirilen ödeme, aynı gün içinde (gün sonu yapılmadan) iptal edilebilir. İptal yapılabilmesi için ödemeye ait sipariş numarası (orderId) gönderilmesi gerekir. Tutar ve reason gönderilmesi zorunlu değildir. İptal işlemi başarılıysa iptal edilen tutar (amount) servisten döner.
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.
İptal İşlemi API Bilgileri
Test ortamında yapılmak istenen iade işlemlerinde "https://sandbox-paymentapi.tami.com.tr/api/v0/payment/refund" url'i kullanılacaktır.
Üretim ortamında yapılmak istenen iptal işlemlerinde ise "https://paymentapi.tami.com.tr/api/v0/payment/refund" 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. |
| reason | String | 150 | O | İptal nedeni iletilmelidir |
| securityHash | 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\": \"tamiTest005\",\n \"securityHash\": \"eyJraWQiOiIxNTAxZTU2MS00ODM3LTQ0NmUtYjVkZi02ZTdiNGY3OGE2NmYiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWNjZXNzIjp0cnVlLCJzeXN0ZW1UaW1lIjoiMjAyNi0wOC0yNVQxNzozNzoxNi42OTUxNDc2ODMiLCJjb3JyZWxhdGlvbklkIjoiOGNiNGY0MTQtNzA4Ny00NGFmLWI0YTYtYTJhZDZiNTc3OGJjIiwiYmFua0F1dGhDb2RlIjoiMjU2MzUyIiwiYmFua1JlZmVyZW5jZU51bWJlciI6IjYyMzcwODM5NTA4MSIsInRyYW5zYWN0aW9uRGF0ZSI6IjIwMjYtMDgtMjVUMTc6Mzc6MTUuNTQ2NDgzIiwib3JkZXJJZCI6Im5pbHVmZXJhdHQ1NU9yZGVyNjAwMDAxIiwiYW1vdW50IjoxMC4wMCwiY3VycmVuY3kiOiJUUlkiLCJpbnN0YWxsbWVudENvdW50IjoxLCJjYXJkIjp7ImJpbk51bWJlciI6IjU1NDk2MDA3IiwibWFza2VkTnVtYmVyIjoiNTU0OS02MDA3LXh4eHgteHgxOCIsImNhcmRCcmFuZCI6IlQuIEdBUkFOVMSwIEJBTktBU0kgQS7Fni4iLCJjYXJkT3JnYW5pemF0aW9uIjoiTUFTVEVSQ0FSRCIsImNhcmRUeXBlIjoiQ1JFRElUIn19.mGYPjY7BumOg8-M-ahB72DZ3RShg3neWE2B0wre-ynOZwiZCka-OVpjyhccOfHWZmwQfZNW0UCmZqWNW4MtqZg\"\n}\n
API İstek Cevabı Örneği
{\n \"amount\": 10,\n \"currency\": \"TRY\",\n \"orderId\": \"tamiTest005\",\n \"success\": true,\n \"systemTime\": \"2026-08-27T15:05:43.133900233\",\n \"correlationId\": \"21d2f05f-366b-425f-a02b-d3f367faaa5d\",\n \"securityHash\": \"eyJraWQiOiIxNTAxZTU2MS00ODM3LTyrQ0NmUtYjVkZi02ZTdiNGY3OGE2NmYiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJhbW91bnQiOjEwLCJjdXJyZW5jeSI6IlRSWSIsIm9yZGVySWQiOiJuaWx1ZmVyYXR0NTVPcmRlcjYwMDAwMyIsInN1Y2Nlc3MiOnRydWUsInN5c3RlbVRpbWUiOiIyMDI2LTA4LTI3VDE1OjA1OjQzLjEzMzkwMDIzMyIsImNvcnJlbGF0aW9uSWQiOiIyMWQyZjA1Zi0zNjZiLTQyNWYtYTAyYi1kM2YzNjdmYWFhNWQiLCJiYW5rQXV0aENvZGUiOiIzMTQ4OTgiLCJiYW5rUmVmZXJlbmNlTnVtYmVyIjoiNjIzOTA4NDA0NDc2IiwidHJhbnNhY3Rpb25EYXRlIjoiMjAyNi0wOC0yN1QxNTowNTo0My4wMjQ1NTIifQ.OY-jt1pGHj-dX-0nFdYNcyuHMzVMzB2Lxv9wTfjAluCbx0jJivtTjiYGUOedwfeJMJozKS1-NHf7nY5_cY7ykg\",\n \"bankAuthCode\": \"314898\",\n \"bankReferenceNumber\": \"623908404476\",\n \"transactionDate\": \"2026-08-27T15:05:43.024552\"\n}\n
İ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. |
| 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. |
| 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. |
| bankAuthCode | String | Banka Onay Kodu |
| bankReferenceNumber | String | İşleme ait bankadan dönen referans numarası. |
POST
Merchant ID
Terminal ID
Secret Key
{\n \"orderId\": \"\",\n \"amount\": 10\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.
