Fee Structure

Understanding Fee Structure

The basic fee structure is made up of core fee configuration information required for all fee types and optional advanced fee configuration options. The following are the four high-level configurations required to create and apply a new Fee:

An Entity or Group - Choose the entity or group being monitored by the Fee Schedule.
A Fee Schedule - Select the time or event-related Fee Trigger that sets the fee charge in motion.
A Fee Rule - Provide specific conditional logic to further refine the Fee Schedule to more specific criteria.
A Fee Modifier - (Optional) Modify the entity paying this newly created fee charge and add markup.

Click here to read about each fee setup parameter in more detail.

Core Fee Setup Parameters

Setup Parameter	Description
Fee Schedule	Determines the trigger that initiates the fee to be charged to the intended entity or group. Note: If a time interval is chosen (e.g. “Days”) you’ll be required to enter a numerical value for the interval. Example: “Days” every “3”.
Unit of Measurement	The measurement of the Fee Amount as Actual (flat currency amount) or Percentage (of the total transaction).
Amount	The fee numerical amount for the specified unit of measurement in basis points
Start Date	The date that the new fee will become active.
Name	The custom name/description for the Fee as it appears in the Portal and API.
Currency	The currency the fee will be charged in, USD or CAD.

Advanced Fee Setup Parameters

Setup Parameter	Description
End Date	The last date that the new fee will be active.
Active [Status]	Whether the fee is in “Active” or “Inactive” status, being applied or not.
Deduct From Entity	The specific entity that the fee is charged to. Note: This is a part of the Fee Modifer flow which can be configured here or individually on the Fee Modifiers page on each Group or Entity Profile page respectively.
Charging Entity	The specific entity that will receive the amount charged in the fee to the first entity. Note: This is a part of the Fee Modifer flow which can be configured here or individually on the Fee Modifiers page on each Group or Entity Profile page respectively.
Collection	Applies the fee based on the volume of a resource. Determines the base amount used to calculate fee amount, by transaction total amount, transaction totals by Tax ID Number (TIN), or transaction totals by entity ID. Note: This is a part of the Fee Modifer flow which can be configured here or individually on the Fee Modifiers page on each Group or Entity Profile page respectively.
Collection Factor	The time interval chosen to adjust the collection calculation. A multiplier that adjusts the set of data to be used in the collection calculation. This field is specified as an integer and its value determines the period of time to be used. Note: This is a part of the Fee Modifer flow which can be configured here or individually on the Fee Modifiers page on each Group or Entity Profile page respectively.
Collection Offset	The number of days, weeks, months or years to go back when selecting data for collection calculation. Note: This is a part of the Fee Modifer flow which can be configured here or individually on the Fee Modifiers page on each Group or Entity Profile page respectively.
Fee Rule(s)	Conditional logic that further refines the Fee Schedule circumstances.

Fee Rules

Fee Rules offer more advanced ways to refine your Fee Schedule to require very specific circumstantial criteria to be met before the Fee will be charged to the assigned entity.

Click here to see each of the Fee Rules available.

Fee Rule	Description
Transaction is less than	Applies only if the triggered amount is lower than the amount set in the 'value' field of the Fee Rule
Transaction is equal to	Applies only if the transaction amount is exactly the same as the amount set in the 'value' field of the Fee Rule
Transaction is not equal to	Applies only if the transaction amount is not exactly equal to the amount set in the 'value' field of the Fee Rule
Transaction is more than	Applies only if the transaction amount is higher than the amount set in the 'value' field of the Fee Rule
Credit card magnetic strip was	Applies based on a determination of whether the cardholder was present during the transaction.
Credit Card EMV Chip was	Applies only to transactions processed using an EMV chip.
Signature was received	Applies based on a determination of whether the cardholder added a signature to the transaction or not.
Transaction type is	Applies based on the type of transaction.
Transaction originates from	Applies based on the origin of a transaction.
Payment Card Brand is	Applies based on method of payment.
Payment Card Type is	Applies based on the given payment method.
Interchange type is	Applies based on a specific interchange type.
CVV result is	Applies based on the results of a CVV check.
AVS result is	Applies based on the results of an AVS check.
Card Issuer Country	Applies only to transactions where the credit card used was issued in the given country.
Merchant Country is	Applies only to merchants from the given country.
3ds result is	Applies based on the results of a 3DS check.
Merchant MCC is	Applies only to merchants with the given MCC.
Same day payout	Applies only to withdrawal schedules setup as “Same Day” payouts.
Subscription	Applies only to Subscription payment transactions.
Imported	Applies only to transactions that are imported from another platform.
Transaction is International	Applies based on the payment method being international or domestic, depending on the value set.
Transaction is on this Platform	Applies only to transactions processed through the given platform.
Misuse	Applies only to either misused or not misused transactions.
Bin	Applies only to transactions where the payment method matches the given bin number.
Business Bins	Applies only to transactions where the payment method is a business BIN type.
Corporate Bin	Applies only to transactions where the payment method is a corporate BIN type.
Entity matches	Applies only to transactions where the entity performing the transactions matches the defined entity ID in the rule setup.
Funding currency is	Applies only to transactions where the funding currency equals the given currency.
Settled currency mismatch	Applies only to transactions where the funding currency and settled currency does not match.
Funding currency is not	Applies only to transactions where the funding currencys does not equal the given currency.
Funding currency mismatch	Applies only to transactions where the funding currency and purchase currency does not match.
Funding Enabled	Applies only to transactions with the given fundingCurrency value.
Status	Applies based on the txn status.
Transaction related to another transaction	The Fee only applies if the transaction is part of a series of related transactions.
Related transaction is this many days apart	The Fee only applies if the related supplementary transaction occurs a specific number of days after the first transaction.
Related transaction amount is this percentage lower	Applies only if the related supplementary transaction’s total amount is a specific percentage (or less) lower than the first transaction.
Related transaction amount is this percentage higher	Applies only if the related supplementary transaction’s total amount is a specific percentage (or more) greater than the first transaction.

Fee Modifiers

Fee Modifiers offer the ability to set an entity of your choice as liable for paying a specific fee and whether or not the final fee amount paid by the chosen entity is marked up.

Tip: This is very similar to the configuration shown in the Advanced Fee Setup Parameters section above.

All that is required for a Fee Modifier to be implemented is to provide the type of modifier Actual (Dollar Amount) or Percentage (of Fee totals), the Fee ID for the Fee you wish to modify, and the entity ID that will now be charged the modified Fee.

Note: The Type and Amount fields refer to conditional setup for fee markup for the specific entity. For example, a Fee Modifier could apply a 10% markup on the fee total for a specific org.

Setting up Fees

Once you become familiarized with Fee Structure, types, and rules, you’re now prepared to setup fees using our Portal or API. Visit the Create and Apply a Fee article for steps to set up fees in your portfolio based on your enablement preferred method.