A fee’s structure includes required configuration details and optional advanced settings.
Fees are made up of several core components:
Entity or Group: The entity or group being monitored and charged.
Schedule: The time or event that triggers the fee.
Rules: Conditional logic that refines the schedule.
Modifiers: Optional adjustments about the paying entity or markup.
Required Setup Parameters
The following parameters are required for all fee configurations:
Schedule: Defines when the fee is triggered. Time-based schedules, such as Days, require a number interval.
Unit of Measurement: Defines how the fee is calculated: Actual, Percentage, or Surcharge.
Amount: The fee dollar amount or percentage in basis points.
Start Date: When the new fee becomes active.
Currency: The fee currency: USD or CAD.
Optional and Advanced Setup Parameters
After setting required parameters to create a fee, you can also configure optional and advanced parameters to enhance the functionality of your fee. You can set optional and advanced values as you create the fee, or update a pre-existing fee from the Group or entity’s profile page.
The following parameters are optional for fee configurations, but provide helpful functionality:
Name: Custom name shown in the Portal and API responses.
End Date: When the fee becomes inactive.
Active: Indicates whether the fee currently applies. When the End Date is reached, the fee status automatically becomes inactive.
Deduct From Entity: The entity being charged.
Charging Entity: The entity receiving the fee.
Collection: Determines the base amount for fee calculation: Total Transaction Volume, Total Transaction Volume per Tax ID, or Total Transaction Volume per Merchant
Collection Factor: Time-based multiplier for collection data.
Collection Offset: Additional logic refining the schedule.
Fee Rules: Optional conditions that must also be met before charging the fee.
Fee Modifiers: Optional adjustments to the payer or markup.
Fee Rules
Fee Rules will apply a fee only when certain conditions are met, such as fees by individual card brand, total transaction amount, or CVV/AVS results. This allows you to set up pricing that is tailored to your clients and offer optimized rates based on payment best practices, such as reduced rates for card-present transactions or transactions that have a full CVV/AVS authorization.
Use Fee Rules to refine your fee schedule requirements for specific criteria to be met before charging a fee to the assigned entity. See Fee Rules for more details about available fee rule options.
Fee Modifiers
By default, when you set up a fee, it is applied directly to the merchant and paid to your Available Balance. Another fee customization is the ability to configure the entity liable for a specific fee. By setting up Fee Modifiers you can change who is paying the fee. As an example, if you have a fee that you want to charge to one client based on the activity of another account, such as if they were linked businesses, you can set up a fee modifier so that when one merchant triggers a fee the funds are taken from a different merchant entity.
Note
If you adjust/modify a fee this can impact how the client is charged. For example, if you have a monthly fee set to apply on the 1st of the month and update it to the 15th, the merchant can potentially incur two monthly fees if you make this modification in between the original and new trigger dates (e.g. you make this change on the 7th of the month).
Additionally, if you wanted to change a fee type from authorization to capture, you would need to time this change after the batch has closed so the client does not incur multiple fees.
Use Fee Modifiers to set a specified entity as the payer for a specific fee and whether the final fee amount paid by the chosen entity is marked up. See Fee Modifiers for more information on applying fee modifications.
Set Up Fees
When you’re ready to start setting up your fees, see Fee Type Configuration Parameters for steps to create fees in your portfolio for your use cases.