Calculate fee for specific account

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.

Use case

Here, you will learn how to use the fee quotation service to calculate the fee for a specific account in Tuum.

If accountId is provided, the parameters situationCode, priceListCode, currentTransactionAmount, and currentTransactionCount are not used. In this case, the system uses current data from the specified account.

Use case data	API parameters with values
Posting date is the date the transaction is posted. The format is YYYY-MM-DD.	"postingDate": "2027-12-10"
Transaction type	"transactionTypeCode": "CARD_CREDIT"
Amount details	"transactionAmount": { "amount": 100, "currencyCode": "EUR" }
Labels are used to define the association between transaction types and fee types.	"labels": [ "CASH_DEPOSIT" ]
Card account technical identifier	"accountId": "C001664282533"
Card technical identifier	"cardId": "C001664282530"

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.

Sample API call

To request the fee quotation, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v1/transactions/calculate-fees

Learn more about the calculate fee quotation for transaction endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

{
	"postingDate": "2025-07-01",
	"transactionTypeCode": "CARD_CREDIT",
	"transactionAmount": {
		"amount": 100,
		"currencyCode": "EUR"
	},
	"labels": [
		"CASH_DEPOSIT"
	],
        "accountId": "C001664282533",
        "cardId": "C001664282530"
}

cURL

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"
}'

Sample response

Below you will find the response to the sample request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "totalFeeAmount": {
            "amount": 3.00,
            "currencyCode": "EUR"
        },
        "fees": [
            {
                "feeTypeCode": "ATM_CASH_DEPOSIT_FEE",
                "feeMoney": {
                    "amount": 3.00,
                    "currencyCode": "EUR"
                }
            }
        ]
    }
}