-
Multi Bank Virtual POS
Multi Bank Virtual POS
Transaction Inquiry General Concepts
This service is used to retrieve the current status and commission details of transactions processed via Tami. Queries can be performed for a specific transaction or for all transactions within a designated date range.
This service displays the current status of a transaction and details regarding all operations associated with that order. To view the current status of each individual transaction, the transaction detail display parameter should be set to "false".
Test/Prod Envirenement API User Information
You can access the Sandbox Test Portal at https://sandbox-portal.tami.com.tr. When you log in to the test portal using a test user account, you can view the transactions performed by the merchant associated with that user. These transactions can also be cancelled or refunded.To obtain the test user credentials, please contact TeknikDestek@tami.com.tr.
Hash Calculation
The request sent for many transaction types should include the PG-Auth-Token in the header information. The PG-Auth-Token consists of the values "MerchantNumber:TerminalNumber:Hash".
When calculating the hash here, the merchantNumber, terminalNumber, and secretKey information belonging to the merchant are hashed with sha256 and converted to a string.
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 Information
You can access the Tami test portal at https://sandbox-portal.tami.com.tr. From this address, you can view the portal screen with the users specified above.
For your production environment information you can become a member at https://portal.tami.com.tr or You can apply to the e-commerce support unit.
Query Process API Information
The URL "https://sandbox-paymentapi.tami.com.tr/payment/orderQuery" will be used for operations in the test environment.
The URL "https://paymentapi.tami.com.tr/api/v0/payment/orderQuery" will be used for operations in the production environment.
API Request Parameters and Descriptions
| 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 | Boolean | 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 Request Example
{
"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 Response Example
{
"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"
}
API Response Parameters and Descriptions
| Field | Format | Description |
|---|---|---|
| success | String | The transaction outcome is directly linked to the query. Should it prove to be accurate, additional details pertaining to the transaction will likewise be provided. |
| errorCode | String | If the "Success" field is set to "False," it represents the error code that was encountered. |
| errorMessage | String | This parameter is passed if the operation fails. Error message information. |
| systemTime | DateTime | It is now time to consider the actions that have been taken. |
| correlationId | String | The provided information pertains to the transaction number associated with the inquiry transaction submitted by the member merchant. |
| amount | Number | The provided information represents the net amount of the transaction. For instance, in a transaction valued at 100 Turkish Lira with a refund transaction of 20 Turkish Lira, the amount will be displayed as 80 Turkish Lira. |
| orderDate | dateTime | The transaction creation date. |
| currency | String | The foreign currency code of the transaction. |
| installmentCount | Number | The number of installments of the transaction |
| orderStatus | String | Shows the last transaction status of the order. It can take the values AUTH/REVERSE/REFUND/PARTIAL_REFUND/PRE_AUTH/POST_AUTH/CHARGEBACK. |
| PaymentStatus | String | Indicates the final status of the operation. It can take the values NOT_COMPLETED, SUCCESS, FAIL, or TIME_OUT. |
| commissionRate | Big Decimal | This is the commission rate information for the transaction. |
| commissionAmount | Big Decimal | It represents the calculated commission amount for the transaction. |
| transactionFee | Big Decimal | This is the transaction fee information. |
| holdPeriod | Integer | It indicates the number of days the transaction is blocked. |
| card | Object | The following document provides information regarding the transaction card. |
| card/binNumber | String | The first eight digits of the card being processed. |
| card/cardBrand | String | Card reward group information includes BONUS, WORLD, AXESS, and other relevant reward categories. |
| card/cardOrganization | String | Card organization information comprises well-known entities such as American Express (AMEX), Troy, Mastercard, Visa, and others. |
| card/cardType | String | It is a card type, either CREDIT or DEBIT. |
| transactions | List | If the parameter `isTransactionDetail='true'` is included in the request, the system will return all transaction data starting from the initiation of the respective order. |
| transactions/amount | Number | The amount of the relevant record |
| transactions/transactionType | String | The transaction type of the relevant record. |
| transactions/transactionStatus | String | the success status of the relevant record |
| transactions/transactionDate | dateTime | Date of the relevant record |
| transactions/reason | String | Date of the relevant record |
| transactions/bankAuthCode | String | Bank Approval Code |
| transactions/bankReferenceNumber | String | Reference number for the transaction |
| transactions/fraudStatus | String | This is the status following fraud checks. |
| securityHash | String | This is the value to be checked to verify that the result of the operation was sent by Tami. Its calculation is specified in the Security Hash Calculation document. |
| pageInfo | Object | Contains information regarding the pagination of the operations in the returned response. |
| pageInfo/page | Integer | It represents the number of pages returned for the queried data. |
| pageInfo/size | Integer | It indicates the number of sales transactions on the page of the response returned for the queried data. |
| pageInfo/totalElements | Integer | If the request specifies a paginated response, this figure represents the total number of transactions within the requested date range. Note: Each distinct order number counts as one transaction. Actions related to the transaction, such as cancellations or returns, are not included in this count. |
| pageInfo/totalPages | Integer | If a page-by-page response was requested, it indicates the total number of pages within the specified date range, based on the requested size. |
| pageInfo/isFirst | Boolean | The page indicated in the query response is marked as `true` if it is the first page. Possible values are `true`/`false`. |
| pageInfo/isLast | Boolean | If the page shown in the query response is the last page, it is indicated as true. Possible values: true/false. |
| pageInfo/hashNext | Boolean | Set to `true` if there are additional pages to display in the query response. Possible values: `true`/`false`. |
| pageInfo/hashPrevious | Boolean | Returns `true` if there is a different page preceding the page shown in the query response. Possible values: `true`/`false`. |
POST
Merchant ID
Terminal ID
Secret Key
{
"orderId": "",
"isTransactionDetail": true
}
Request failed
Request succeeded
Security Hash Calculation
You can use the documentation here to calculate the securityHash field in service requests and incoming service responses.
Error Codes
You can access the list of error codees on this page.
Test Cards
You can access the list of test cards on this page.
