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 calculate the fee for a specific account in Tuum.
Posting date is the date the transaction is posted. The format is YYYY-MM-DD.
Transaction type
Amount details
Labels are used to define the association between transaction types and fee types.
Card account technical identifier
Card technical identifier
Always include the cardId in fee calculation requests for debit, prepaid, or gift cards. This ensures the correct card-level price list is used, as multiple cards may be linked to the same current account.
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": "2025-07-01",
"transactionTypeCode": "CARD_CREDIT",
"transactionAmount": {
"amount": 100,
"currencyCode": "EUR"
},
"labels": [
"CASH_DEPOSIT"
],
"accountId": "C001664282533",
"cardId": "C001664282530"
}curl --location 'https://card-api.sandbox.tuumplatform.com/api/v1/transactions/calculate-fees' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA2LTEwVDEwOjQ2OjA4IiwiZXhwIjoxNzQ5NTUyMzY4LCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.GENLDkd1m0fp44xPYqMZ_vgNgdVDWcQcHcyOLwMghIY' \
--header 'Content-Type: application/json' \
--data '{
"postingDate": "2025-07-01",
"transactionTypeCode": "CARD_CREDIT",
"transactionAmount": {
"amount": 100,
"currencyCode": "EUR"
},
"labels": [
"CASH_DEPOSIT"
],
"accountId": "C001664282533",
"cardId": "C001664282530"
}'Below you will find the response to the sample request:
"postingDate": "2027-12-10""transactionTypeCode": "CARD_CREDIT""transactionAmount": {
"amount": 100,
"currencyCode": "EUR"
} "labels": [
"CASH_DEPOSIT"
]"accountId": "C001664282533""cardId": "C001664282530"