Installment Inquiry General Concepts

Tami is a service where member merchants can query the first 8 digits or 6 digits of the card information and learn the information and installment options of the card. They can also display the installment options they can make in the response.

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 {\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 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.

Installment Inquiry API Information

In test environment, the "https://sandbox-paymentapi.tami.com.tr/installment/installment-info" URL will be used.

In production environment, the "https://paymentapi.tami.com.tr/installment/installment-info" URL will be used.

API Request Parameters and Descriptions

Field	Format	Uzunluk	(O)psiyonel / (M)andatory	Description
binNumber	Number	8	Z	The first 6 or 8 digits of the card number whose details are requested should be sent.
securityHash	String		M	It is the value expected to be calculated and transmitted as specified in the document. If it is missing or incorrectly transmitted, the transaction is not routed to the bank, an error is given.

API Request Example

{\n \"binNumber\": \"45438877\",\n \"securityHash\": \"4djd40585YY95U8375wdkdT==\",\n}

API Response Example

{\n \"bankName\": \"T. GARANTİ BANKASI A.Ş.\",\n \"bankId\": \"62\",\n \"cardType\": \"CREDIT\",\n \"cardOrg\": \"VISA\",\n \"commercial\": false,\n \"rewardType\": \"Bonus\",\n \"force3ds\": false,\n \"forceCvc\": false,\n \"installments\": [\n 1,\n 2,\n 3\n ],\n \"success\": true,\n \"systemTime\": \"2023-09-15T14:05:06.422\",\n \"correlationId\": \"correlation5291\",\n \"isInstallment\": true,\n \"securityHash\": \"74hsjw84746eekro747463ye==\"\n}

API Response Parameters and Descriptions

Parametre Adı	Format	Açıklama
bankName	String	Name of the bank
bankId	String	Bank EFT code
cardType	String	Card type. Debit/Credit
cardOrg	String	Card organization information. VISA/MASTERCARD/TROY/AMEX etc.
commercial	Boolean	Whether the card is a corporate card or not. If true, it is a corporate card, if false, it is an individual card.
rewardType	String	Reward group of the card. BONUS, AXESS, CHIP, WORLD etc.
force3ds	Boolean	Indicates that the transaction must be done with 3d by looking at the merchant authorization. If true, an error will be received when the transaction is sent without 3d.
forceCvc	Boolean	Indicates that the transaction must be done with cvv based on the merchant authorization. If true, an error will be received when the transaction is sent without cvv.
installments	list	It gives the installment options that can be made according to the BIN number queried by the merchant.
isInstallment	Boolean	If false, an error will be received when the transaction is sent in installments.
success	Boolean	Returns the success/failure information of the service. True means that data belonging to the card was found. If False, it means that no data belonging to the card was found.
systemTime	dateTime	Response time
correlationId	String	The transaction number value sent by the merchant in the cancellation/refund request.
errorCode	String	This parameter is passed if the operation fails. Error code information.
errorMessage	String	This parameter is passed if the operation fails. Error message information.
securityHash	String	The value to be used to determine that the result of the operation came from the correct source. The documentation specifies how it should be calculated.

POST

Merchant ID

Terminal ID

Secret Key

{\n \"binNumber\": 123\n}

Hata Oluştu

Başarılı

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.

Inquiry >> BIN Inquiry Inquiry >> Transaction Inquiry

Multi Bank Virtual POS