You will find examples of different pricing models in this section of the card how-to guide. They aim to help you create prices in the card price lists.
In the second example we will configure a price list for the ATM_WITHDRAWAL_FEE, where the fee to be charged depends on the origin of the transaction with count based condition:
Free cash withdrawals from ATMs - up to 9 times per month.
From the 10th transaction - the fee is charged.
To use the count range based pricing, it is required to set up a counting group for the ATM_WITHDRAWAL_FEE type.
Below we will review the setup model.
Calculation rule: Fix
Fixed amount: 0.50 EUR
Count range: 10
No labels.
Description: Price is used starting from the tenth transaction when more accurate price is not available.
Calculation rule: Fix
Fixed amount: 1.50 EUR
Labels:
transactionOrigination: ATM_EU
Description: Price is used starting from the tenth transaction if transaction has been originated from EU country.
Calculation rule: Fix
Fixed amount: 2 EUR
Labels:
transactionOrigination: ATM_FOREIGN
Description: Price is used starting from the tenth transaction if transaction has been originated from any other country outside EU.
Let us consider several use cases to show case how the fee is calculated.
The total transaction count is 9 or less:
The fee is not charged as the transaction limit count is not reached.
The total transaction count is 10; it mates to the count range set above:
The transaction has no labels - price 1 is charged.
The transaction has labels that are not used to describe prices - price 1 is charged.
The transaction has a label that matches a price label - the price with a matching label is selected.
The transaction has multiple labels - The Tuum system selects a price with a biggest number of matching labels.
To configure this sample price list, we will go to the to add the following prices for the ATM_WITHDRAWAL_FEE:
In the fourth example, we will configure a price list for the ATM_WITHDRAWAL_FEE, where the calculated fee depends on the amount-based condition with the count threshold.
The calculated fee will apply when reaching at least one of the following monthly thresholds.
The number of ATM withdrawals exceeds 5.
The cumulative sum of the ATM withdrawals reaches or exceeds 3000 EUR.
ATM withdrawals staying within the limits of the thresholds above are free of charge.
Please ensure you have set up the counting and summing groups for the ATM_WITHDRAWAL_FEE type.
Below we will review the setup model.
Calculation rule: Percent
Percent: 0.5 %
Amount range: 3000 EUR
Count threshold: 5
Description:
ATM withdrawals staying within the limits of the thresholds below are free of charge.
The calculated fee will apply when reaching at least one of the following monthly thresholds.
The number of ATM withdrawals exceeds 5.
The cumulative sum of the ATM withdrawals reaches or exceeds 3000 EUR.
Let us consider several use cases to show how the fee is calculated.
The customer makes the first 5 withdrawals, and their cumulative amount does not reach or exceed 3000 EUR.
All five transactions are free of charge.
The customer makes the first 5 withdrawals; with the third one, the cumulative amount reaches or exceeds 3000 EUR.
The two first transactions are free of charge.
Starting from the third transaction, price 1 is charged.
The customer makes over five withdrawals, and their cumulative amount does not reach or exceed 3000 EUR.
The first five transactions are free of charge.
Starting from the sixth transaction, price 1 is charged.
To configure this sample price list, we will go to the to add the following prices for the ATM_WITHDRAWAL_FEE:
In the third example we will configure a price list for the ATM_WITHDRAWAL_FEE, where the fee depends on the transaction currency and amount:
Free cash withdrawals from ATMs - up to 1000 EUR per month.
Above 1000 EUR - the fee is charged.
To use amount range based pricing, it is required to set up a summing group for the ATM_WITHDRAWAL_FEE type.
Below we will review the setup model.
Calculation rule: Percent
Percent: 1%
Amount range: 1000 - 5000
Labels:
transactionCurrency: CARD_CURRENCY
Description: The price is used if the total monthly amount is between 1000 and 5000 EUR.
Calculation rule: Percent
Percent: 2%
Amount range: 1000 - 5000
Labels:
transactionCurrency: OTHER_CURRENCY
Description: The price is used if the total monthly amount is between 1000 and 5000 EUR, and the transaction and card currency are different.
Calculation rule: Percent
Percent: 1.5%
Amount range: 5000
Labels:
transactionCurrency: CARD_CURRENCY
Description: The price is used if the total monthly amount exceeds 5000 EUR, and the transaction and card currency are the same.
Calculation rule: Percent
Percent: 2.5%
Amount range: 5000
Labels:
transactionCurrency: OTHER_CURRENCY
Description: The price is used if the total monthly amount exceeds 5000 EUR, and the transaction and card currency are different.
Let us consider several use cases to show how the fee is calculated.
The total monthly transaction amount is 999.99 EUR or less:
The fee is not charged as the transaction limit amount is not reached.
The total monthly transaction amount falls into 1000-5000 EUR interval:
The transaction is in the card currency - price 1 is charged.
The transaction is in the other currency - price 2 is charged.
The total monthly transaction amount is 5000 EUR or higher:
The transaction is in the card currency - price 3 is charged.
The transaction is in the other currency - price 4 is charged.
The total monthly transaction amount is 2000 EUR and the user withdrawn 5000 EUR from ATM. In this case 2 prices are applied:
The price 1 is applied for 3000 EUR.
The price 3 is applied for the remaining 2000 EUR, as the outstanding amount falls to the next amount range.
In the first example, we will configure a label based price list for the ATM_WITHDRAWAL_FEE where the fee depends of the following factors:
origin of the transaction,
transaction currency.
Suppose you have set up the card product with card currency EUR. Now you would like to enforce the the ATM withdrawal pricing based on principles listed below.
To configure this price list, we will go to the Price list prices page to add the following prices for the ATM_WITHDRAWAL_FEE:
Calculation rule: Fix
Fixed amount: 0.50 EUR
No labels
Description: Price is used when more accurate price (with labels) is not described.
Calculation rule: Fix
Fixed amount: 1 EUR
Labels:
transactionCurrency: OTHER_CURRENCY
Description: Price is used for all transactions is foreign currency when more accurate price is not described.
Calculation rule: Fix
Fixed amount: 2 EUR
Labels:
transactionOrigination: ATM_EU
transactionCurrency: OTHER_CURRENCY
Description: Price is used for transactions in other than card currency from EU.
Calculation rule: Fix/Percent
Fixed amount: 1 EUR
Percent: 1
Labels:
transactionOrigination: ATM_FOREGN
transactionCurrency: CARD_CURRENCY
Description: Price is used for transactions in card currency from any country outside EU.
Calculation rule: Fix/Percent
Fixed amount: 2 EUR
Percent: 1
Labels:
transactionOrigination: ATM_FOREGN
transactionCurrency: OTHER_CURRENCY
Description: Price is used for transactions in other than card currency from any country outside EU.
If a transaction is posted with labels, the related fee is going to be calculated based on the number of matching labels. Let's consider some examples:
Transaction is posted with no labels - price 1 is selected.
Transaction is posted with labels that are not used for the price setup - price 1 is selected.
Transaction has a label that matches a price label - the price with a matching label is selected.
Transaction has multiple labels - The Tuum system selects a price with a biggest number of matching labels.
To configure this sample price list, we will go to the to add the following prices for the ATM_WITHDRAWAL_FEE:
