It calculates the applicable fee for a given transaction based on parameters such as transaction amount, currency, associated fees, tiers, and labels. The response consists of a calculated total price along with a breakdown of associated fees.
Here, you will learn how to use the fee quotation service to test the price list that will be in effect in the future in Tuum.
Posting date is the date the transaction is posted. The format is YYYY-MM-DD.
Transaction type
Amount details
Enter a list of labels when label-based pricing is applied.
Situation code refers to the transaction status.
The allowed values are NORMAL and OVERLIMIT.
Price list code
Enter the monthly transaction amount when pricing is based on monthly transaction amount.
Enter the monthly transaction count when pricing is based on monthly transaction count.
To request the fee quotation, use the following endpoint:
https://card-api.sandbox.tuumplatform.com/api/v1/transactions/calculate-fees
The sample request body is as follows:
{
"postingDate": "2027-12-01",
"transactionTypeCode": "ATM_WITHDRAWAL",
"transactionAmount": {
"amount": 100,
"currencyCode": "EUR"
},
"labels": [
"OTHER_CURRENCY",
"ATM_FOREIGN"
],
"situationCode": "NORMAL",
"priceListCode": "DEBIT_CARD",
"currentTransactionAmount": {
"amount": 1320,
"currencyCode": "EUR"
},
"currentTransactionCount": 8
}curl --location 'https://card-api.sandbox.tuumplatform.com/api/v1/transactions/calculate-fees' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA2LTEwVDExOjA1OjMyIiwiZXhwIjoxNzQ5NTUzNTMyLCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.ks3EOPYI1b-vAApsiJpwoRKHrAXrLRzm8oncKVQ84_A' \
--header 'Content-Type: application/json' \
--data '{
"postingDate": "2027-12-01",
"transactionTypeCode": "ATM_WITHDRAWAL",
"transactionAmount": {
"amount": 100,
"currencyCode": "EUR"
},
"labels": [
"OTHER_CURRENCY",
"ATM_FOREIGN"
],
"situationCode": "NORMAL",
"priceListCode": "DEBIT_CARD",
"currentTransactionAmount": {
"amount": 1320,
"currencyCode": "EUR"
},
"currentTransactionCount": 8
}'Below you will find the response to the sample request:
"postingDate": "2027-12-01""transactionTypeCode": "ATM_WITHDRAWAL""transactionAmount": {
"amount": 100,
"currencyCode": "EUR"
}"labels": [
"OTHER_CURRENCY",
"ATM_FOREIGN"
]"situationCode": "NORMAL""priceListCode": "DEBIT_CARD""currentTransactionAmount": {
"amount": 1320,
"currencyCode": "EUR"
}"currentTransactionCount": 8