-
Tami Sanal POS
Tami Sanal POS
İşlem Sorgulama İşlemi Genel Açıklama
Tami üzerinden gerçekleşen işlemlerin son durumunu ve komisyon bilgilerini öğrenmek için kullanılacak servistir. Belirli bir işlem özelinde veya belirli tarih aralığındaki tüm işlemler sorgulanabilir.
İşlemin son durumu ve bu siparişle ilgili yapılan tüm işlemlere ait bilgileri gösteren servistir. Her bir işlemin son durumu görüntülenmek istenirse işlem detay görüntüleme parametresi false gönderilir.
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 {
public static String sha256(Long merchantNumber, Long terminalNumber, String secretKey) {
String text = merchantNumber.toString() + terminalNumber.toString() + secretKey;
try {
MessageDigest digest = MessageDigest.getInstance("SHA-256");
byte[] hash = digest.digest(text.getBytes(StandardCharsets.UTF_8));
String sha256Hex = DatatypeConverter.printBase64Binary(hash);
return sha256Hex;
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
return null;
}
}
}
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.
Sorgulama İşlemi API Bilgileri
Test ortamında yapılacak çalışmalarda "https://sandbox-paymentapi.tami.com.tr/payment/orderQuery" url'i kullanılacaktır.
Üretim ortamında yapılacak çalışmalarda ise "https://paymentapi.tami.com.tr/api/v0/payment/orderQuery" url'i kullanılacaktır.
İstek Parametreleri ve Açıklamaları
| Alan | Format | (O)psiyonel/(Z)orunlu / (Ş)artlı | Açıklama |
|---|---|---|---|
| orderId | String | Ş | Sorgulanmak istenen satış işlemine ait sipariş numarası bilgisidir. StartDate, endDate girilmezse bu alanın iletilmesi zorunludur. |
| isTransactionDetail | String | O | Eğer true gönderilirse siparişin başından geçen tüm işlemler paylaşılacaktır. Eğer false , boş ya da hiç gönderilmezse siparişin sadece son statüsüne ait bilgiler iletilir. |
| startDate | String | Ş | Eğer sipariş numarasına göre değil tarih aralığına göre sorgulama yapılmak istenirse bu alan zorunludur. Örnek format: "DD-MM-YYYY HH:MM:SS"Başlangıç bitiş tarihi arasına maximum 30 günlük bir aralık verilebilir. |
| endDate | String | Ş | Eğer sipariş numarasına göre değil tarih aralığına göre sorgulama yapılmak istenirse bu alan zorunludur. Örnek format: "DD-MM-YYYY HH:MM:SS" |
| page | Integer | O | Sorgulanmak istenen tarih aralığındaki işlemler sayfa sayfa çekilmek istenirse iletilir. İlk sayfanın datası çekilirken “0” gönderilmelidir. |
| size | Integer | O | Sayfalandırma yapıldığında bir sayfada kaç işlem gösterilmesi isteniyorsa bu değerle iletilir. |
| sortField | String | O | Sorgulama sonucunun belirli bir değere göre sıralı gelmesi için kullanılır. Örn: “orderDate” |
| sortDirection | Enum | O | Dönen cevaptaki sıralamanın artan, azalan olarak sıralanmasını belirleyen alandır. Alabileceği değerler; ASC, DESC |
| securityHash | String | Z | Dokumanda belirtilen şekilde hesaplanıp iletilmesi beklenen değerdir. Eksik veya hatalı iletilirse sorgulama yapılamaz. |
API İstek Örneği
{
"isTransactionDetail": true,
"startDate": "01-06-2026 00:00:00",
"endDate": "30-06-2026 23:59:59",
"page": 0,
"size": 30,
"sortField": "orderDate",
"sortDirection": "ASC",
"securityHash":"eyJraWQiOiIyNTfssz947nxöcsY0YmZmZC04MTI5LTQ4ZDMtYTAzZS04ZjUwOWM3MmYxYWIiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWNjZXNzIjp0cnVlLCJzeXN0ZW1UaW1lIjoiMjAyNi0wOC0xMlQxMTo0MzozMC41MjI1OTkyMjQiLCJjb3JyZWxhdGlvbklkIjoiMTQ4ZmFmZDAtNWQ4Yi00MDBmLWFjNTItZTQ1YjM1NTU2MjQ3IiwiYmFua0F1dGhDb2RlIjoiMTI0MDE1IiwiYmFua1JlZmVyZW5jZU51bWJlciI6IjYyMjQzNjkwOTIzNSIsInRyYW5zYWN0aW9uRGF0ZSI6IjIwMjYtMDgtMTJUMTE6NDM6MjkuMjIyMjI4Iiwib3JkZXJJZCI6Im5pbHVmZXJhdHQxMTRPcmRlcjYwMDAyMyIsImFtb3VudCI6Mi4zMCwiY3VycmVuY3kiOiJUUlkiLCJpbnN0YWxsbWVudENvdW50IjoyLCJjYXJkIjp7ImJpbk51bWJlciI6IjY1MDE3MDAxIiwibWFza2VkTnVtYmVyIjoiNjUwMS03MDAxLXh4eHgteHgwMyIsImNhcmRCcmFuZCI6IlQuIFZBS0lGTEFSIEJBTktBU0kgVC5BLk8iLCJjYXJkT3JnYW5pemF0aW9uIjoiVFJPWSIsImNhcmRUeXBlIjoiQ1JFRElUIn19.1n0FHzNIR_XvH6SyGX4gdyAcRjzcI3Rxuw6v3WA6vzF_G9NLqBtn1pICLo2G46zDC0BnmoNBircrQ8GE6aTolg"
}
API İstek Cevabı Örneği
{
"content": [
{
"success": true,
"systemTime": "2026-08-13T12:33:24.355643202",
"correlationId": "tami1",
"orderId": "tamiorder1",
"amount": 0,
"orderDate": "2026-06-30T23:47:20.912199",
"currency": "TRY",
"installmentCount": 1,
"orderStatus": "REVERSE",
"paymentStatus": "SUCCESS",
"card": {
"binNumber": "54070941",
"cardBrand": "T. GARANTİ BANKASI A.Ş.",
"cardOrganization": "MASTERCARD",
"cardType": "CREDIT"
},
"transactions": [
{
"amount": 1,
"transactionType": "AUTH",
"fraudStatus": false,
"transactionStatus": "SUCCESS",
"transactionDate": "2026-06-30T23:47:20.934855",
"bankAuthCode": "510824",
"bankReferenceNumber": "618104143464"
},
{
"amount": 1,
"transactionType": "REVERSE",
"fraudStatus": false,
"transactionStatus": "SUCCESS",
"transactionDate": "2026-06-30T23:47:29.834026",
"bankAuthCode": "510824",
"bankReferenceNumber": "618104143840"
}
]
},
{
"success": true,
"systemTime": "2026-08-13T12:33:24.436938985",
"correlationId": "tami2",
"orderId": "tamiorder2",
"amount": 1,
"orderDate": "2026-06-30T23:50:33.963278",
"currency": "TRY",
"installmentCount": 1,
"orderStatus": "AUTH",
"paymentStatus": "NOT_COMPLETED",
"card": {
"binNumber": "54070941",
"cardBrand": "T. GARANTİ BANKASI A.Ş.",
"cardOrganization": "MASTERCARD",
"cardType": "CREDIT"
},
"transactions": [
{
"amount": 1,
"transactionType": "AUTH",
"fraudStatus": false,
"transactionStatus": "NOT_COMPLETED",
"transactionDate": "2026-06-30T23:50:34.096657"
}
]
},
{
"success": true,
"systemTime": "2026-08-13T12:33:24.522274735",
"correlationId": "tami3",
"orderId": "tamiorder3",
"amount": 1,
"orderDate": "2026-06-30T23:51:15.205225",
"currency": "TRY",
"installmentCount": 3,
"orderStatus": "AUTH",
"paymentStatus": "FAIL",
"commissionRate": 7.95,
"commissionAmount": 0.0795,
"transactionFee": 0,
"holdPeriod": 40,
"card": {
"binNumber": "54308115",
"cardBrand": "T. HALK BANKASI A.Ş.",
"cardOrganization": "MASTERCARD",
"cardType": "CREDIT"
},
"transactions": [
{
"amount": 1,
"transactionType": "PRE_AUTH",
"fraudStatus": false,
"transactionStatus": "FAIL",
"transactionDate": "2026-07-14T10:35:00.214856",
"bankAuthCode": "000000",
"bankReferenceNumber": "619649378415"
},
{
"amount": 1,
"transactionType": "AUTH",
"fraudStatus": false,
"transactionStatus": "FAIL",
"transactionDate": "2026-07-22T07:56:02.571932",
"bankAuthCode": "000000",
"bankReferenceNumber": "620332959105"
}
]
}
],
"pageInfo": {
"page": 0,
"size": 30,
"totalElements": 3,
"totalPages": 1,
"isFirst": true,
"isLast": true,
"hasNext": false,
"hasPrevious": false
},
"securityHash": "eyJraWQiOiIyNTY0YmZmZC04MTI5LTQ4ZDMtYTAzZS04ZjUwOWM3MmYxYWIiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJjb250ZW50IjpbeyJzdWNjZXNzIjp0cnVlLCJzeXN0ZW1UaW1lIjoiMjAyNi0wOC0xM1QxMjozMzoyNC4zNTU2NDMyMDIiLCJjb3JyZWxhdGlvbklkIjoibmlsdXRlc3QxOTQ0NjUzNjQ1NTQ1NDY1MzE4NTU0MTM5NTQ0NTM0NDU0Iiwib3JkZXJJZCI6IlJORDQzODAwMSIsImFtb3VudCI6MCwib3JkZXJEYXRlIjoiMjAyNi0wNi0zMFQyMzo0NzoyMC45MTIxOTkiLCJjdXJyZW5jeSI6IlRSWSIsImluc3RhbGxtZW50Q291bnQiOjEsIm9yZGVyU3RhdHVzIjoiUkVWRVJTRSIsInBheW1lbnRTdGF0dXMiOiJTVUNDRVNTIiwiY2FyZCI6eyJiaW5OdW1iZXIiOiI1NDA3MDk0MSIsImNhcmRCcmFuZCI6IlQuIEdBUkFOVMSwIEJBTktBU0kgQS7Fni4iLCJjYXJkT3JnYW5pemF0aW9uIjoiTUFTVEVSQ0FSRCIsImNhcmRUeXBlIjoiQ1JFRElUIn0sInRyYW5zYWN0aW9ucyI6W3siYW1vdW50IjoxLCJ0cmFuc2FjdGlvblR5cGUiOiJBVVRIIiwiZnJhdWRTdGF0dXMiOmZhbHNlLCJ0cmFuc2FjdGlvblN0YXR1cyI6IlNVQ0NFU1MiLCJ0cmFuc2FjdGlvbkRhdGUiOiIyMDI2LTA2LTMwVDIzOjQ3OjIwLjkzNDg1NSIsImJhbmtBdXRoQ29kZSI6IjUxMDgyNCIsImJhbmtSZWZlcmVuY2VOdW1iZXIiOiI2MTgxMDQxNDM0NjQifSx7ImFtb3VudCI6MSwidHJhbnNhY3Rpb25UeXBlIjoiUkVWRVJTRSIsImZyYXVkU3RhdHVzIjpmYWxzZSwidHJhbnNhY3Rpb25TdGF0dXMiOiJTVUNDRVNTIiwidHJhbnNhY3Rpb25EYXRlIjoiMjAyNi0wNi0zMFQyMzo0NzoyOS44MzQwMjYiLCJiYW5rQXV0aENvZGUiOiI1MTA4MjQiLCJiYW5rUmVmZXJlbmNlTnVtYmVyIjoiNjE4MTA0MTQzODQwIn1dfSx7InN1Y2Nlc3MiOnRydWUsInN5c3RlbVRpbWUiOiIyMDI2LTA4LTEzVDEyOjMzOjI0LjQzNjkzODk4NSIsImNvcnJlbGF0aW9uSWQiOiJuaWx1dGVzdDE5NDQ2NTM2NDU1NDU0NjUzMTg1NTQxMzk1NDQ1MzQ0NTQiLCJvcmRlcklkIjoiUk5ENjI2OTgwIiwiYW1vdW50IjoxLCJvcmRlckRhdGUiOiIyMDI2LTA2LTMwVDIzOjUwOjMzLjk2MzI3OCIsImN1cnJlbmN5IjoiVFJZIiwiaW5zdGFsbG1lbnRDb3VudCI6MSwib3JkZXJTdGF0dXMiOiJBVVRIIiwicGF5bWVudFN0YXR1cyI6Ik5PVF9DT01QTEVURUQiLCJjYXJkIjp7ImJpbk51bWJlciI6IjU0MDcwOTQxIiwiY2FyZEJyYW5kIjoiVC4gR0FSQU5UxLAgQkFOS0FTSSBBLsWeLiIsImNhcmRPcmdhbml6YXRpb24iOiJNQVNURVJDQVJEIiwiY2FyZFR5cGUiOiJDUkVESVQifSwidHJhbnNhY3Rpb25zIjpbeyJhbW91bnQiOjEsInRyYW5zYWN0aW9uVHlwZSI6IkFVVEgiLCJmcmF1ZFN0YXR1cyI6ZmFsc2UsInRyYW5zYWN0aW9uU3RhdHVzIjoiTk9UX0NPTVBMRVRFRCIsInRyYW5zYWN0aW9uRGF0ZSI6IjIwMjYtMDYtMzBUMjM6NTA6MzQuMDk2NjU3In1dfSx7InN1Y2Nlc3MiOnRydWUsInN5c3RlbVRpbWUiOiIyMDI2LTA4LTEzVDEyOjMzOjI0LjUyMjI3NDczNSIsImNvcnJlbGF0aW9uSWQiOiJuaWx1dGVzdDE5NDQ2NTM2NDU1NDU0NjUzMTg1NTQxMzk1NDQ1MzQ0NTQiLCJvcmRlcklkIjoibmlsdWZlcmF0dDEwT3JkZXI2MDAwMDEiLCJhbW91bnQiOjEsIm9yZGVyRGF0ZSI6IjIwMjYtMDYtMzBUMjM6NTE6MTUuMjA1MjI1IiwiY3VycmVuY3kiOiJUUlkiLCJpbnN0YWxsbWVudENvdW50IjozLCJvcmRlclN0YXR1cyI6IkFVVEgiLCJwYXltZW50U3RhdHVzIjoiRkFJTCIsImNvbW1pc3Npb25SYXRlIjo3Ljk1LCJjb21taXNzaW9uQW1vdW50IjowLjA3OTUsInRyYW5zYWN0aW9uRmVlIjowLCJob2xkUGVyaW9kIjo0MCwiY2FyZCI6eyJiaW5OdW1iZXIiOiI1NDMwODExNSIsImNhcmRCcmFuZCI6IlQuIEhBTEsgQkFOS0FTSSBBLsWeLiIsImNhcmRPcmdhbml6YXRpb24iOiJNQVNURVJDQVJEIiwiY2FyZFR5cGUiOiJDUkVESVQifSwidHJhbnNhY3Rpb25zIjpbeyJhbW91bnQiOjEsInRyYW5zYWN0aW9uVHlwZSI6IlBSRV9BVVRIIiwiZnJhdWRTdGF0dXMiOmZhbHNlLCJ0cmFuc2FjdGlvblN0YXR1cyI6IkZBSUwiLCJ0cmFuc2FjdGlvbkRhdGUiOiIyMDI2LTA3LTE0VDEwOjM1OjAwLjIxNDg1NiIsImJhbmtBdXRoQ29kZSI6IjAwMDAwMCIsImJhbmtSZWZlcmVuY2VOdW1iZXIiOiI2MTk2NDkzNzg0MTUifSx7ImFtb3VudCI6MSwidHJhbnNhY3Rpb25UeXBlIjoiQVVUSCIsImZyYXVkU3RhdHVzIjpmYWxzZSwidHJhbnNhY3Rpb25TdGF0dXMiOiJGQUlMIiwidHJhbnNhY3Rpb25EYXRlIjoiMjAyNi0wNy0yMlQwNzo1NjowMi41NzE5MzIiLCJiYW5rQXV0aENvZGUiOiIwMDAwMDAiLCJiYW5rUmVmZXJlbmNlTnVtYmVyIjoiNjIwMzMyOTU5MTA1In1dfV0sInBhZ2VJbmZvIjp7InBhZ2UiOjAsInNpemUiOjMwLCJ0b3RhbEVsZW1lbnRzIjozLCJ0b3RhbFBhZ2VzIjoxLCJpc0ZpcnN0Ijp0cnVlLCJpc0xhc3QiOnRydWUsImhhc05leHQiOmZhbHNlLCJoYXNQcmV2aW91cyI6ZmFsc2V9fQ.1ohi56qXQtzhI517CXmfhDZymZtxMN4S_1Sd2Q6vsKTrp3xx9cGutreItj4NZhC5UG11LOKuZ1u8DeThCT51sA"
}
İstek Cevabı Parametreleri ve Açıklamaları
| Parametre Adı | Format | Açıklama |
|---|---|---|
| success | String | Sorgulama işleminin sonucudur. True olması istenen işleme ait veriler dönülür |
| errorCode | String | Success alanı false olması durumunda bu alan cevapta yer alır ve alınan hatanın kodudur |
| errorMessage | String | Success alanı false olması durumunda bu alan cevapta yer alır ve 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 | Satış işleminin oluşturulma tarihidir |
| currency | String | İşlemin döviz kodudur |
| installmentCount | Number | İşlemin taksit sayısıdır |
| orderStatus | String | Siparişin son işlem tipini gösterir. AUTH/REVERSE/REFUND/PARTIAL_REFUND/PRE_AUTH/POST_AUTH/CHARGEBACK değerlerini alabilir |
| PaymentStatus | String | İşlemin son statüsünü gösterir. NOT_COMPLETED/SUCCESS/FAIL/TIME_OUT değerlerini alabilir |
| commissionRate | Big Decimal | İşleme ait komisyon oranı bilgisidir. |
| commissionAmount | Big Decimal | İşleme ait hesaplanmış komisyon tutarını ifade eder |
| transactionFee | Big Decimal | İşlem ücreti bilgisidir |
| holdPeriod | Integer | İşlemin bloke gün sayısını ifade eder |
| 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. |
| transactions/bankAuthCode | String | Banka Onay Kodu |
| transactions/bankReferenceNumber | String | İşleme ait Retref numarası |
| transactions/fraudStatus | String | Fraud kontrolleri sonrasındaki statü durumudur |
| securityHash | String | İşlemin sonucunun doğru kaynaktan geldiğini belirlemek için kullanılacak değer. Belgeler bunun nasıl hesaplanması gerektiğini belirtir. |
| pageInfo | Object | Dönen cevaptaki işlemlerin sayfalandırılması ile ilgili bilgiler içerir |
| pageInfo/page | Integer | Sorgulama yapılan datanın döndüğü sayfa sayısını ifade eder |
| pageInfo/size | Integer | Sorgulama yapılan data için dönen cevaptaki sayfada satış işlem adedini belirtir. |
| pageInfo/totalElements | Integer | Requestte sayfa sayfa dönüş istendiyse, istenen tarih aralığındaki toplam işlem adedini ifade eder.Not: Her farklı sipariş numarası 1 işlem demektir. İşleme ait iptal/iade gibi işlemler bu işlem sayısına dahil edilmez |
| pageInfo/totalPages | Integer | Requestte sayfa sayfa dönüş istendiyse istenen size’a göre, girilen tarih aralığında toplam kaç sayfa olduğunu ifade eder |
| pageInfo/isFirst | Boolean | Sorgulama cevabında gösterilen sayfa, ilk sayfa ise true olarak gösterilir. Alabileceği değerler true/false |
| pageInfo/isLast | Boolean | Sorgulama cevabında gösterilen sayfa, son sayfa ise true olarak gösterilir. Alabileceği değerler true/false |
| pageInfo/hashNext | Boolean | Sorgulama cevabında gösterilecek farklı sayfa var ise true olarak gösterilir. Alabileceği değerler true/false |
| pageInfo/hashPrevious | Boolean | Sorgulama cevabında gösterilen sayfadan önce farklı bir sayfa varsa true gösterilir. Alabileceği değerler true/false |
POST
Merchant ID
Terminal ID
Secret Key
{
"orderId": "",
"isTransactionDetail": true
}
İstek başarısız
İstek 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.
