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.

Core Fee Setup Parameters

Setup Parameter

Description

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

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.

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.

Collection Offset

The number of days, weeks, months or years to go back when selecting data for collection calculation.

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.

Fee Rule

Description

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.

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.


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.