There are multiple ways in which fees can be applied on the Platform:
Directly to Entities - Applied to individual Merchants or Partners
Using Groups - Applied to a group of Merchant or Partner entities.
Per Transaction - Applied to Entities or Groups as each transaction is processed. (Fee Listener)
Now that you’re familiar with the Fee Structure and available setup options, we’ll get started by setting up the Fee type of your choice using your preferred method. If you are familiar with basic fee structure information, jump ahead to the Setting up a Fee section below.
Getting Started
Before you begin, it’s important to understand the makeup of a Fee configuration and the various components used to create the Fee setup exactly to your specifications.
Each section below covers the major components of setting up a fee with all available customizations and refinements. Each of these major steps offers instructions for your preferred fee use case:
Set up a Fee: Learn the process of how and where to set up a Fee.
Set Up a Fee by Type: Learn the specific parameters required to set specific types of Fees.
Add Fee Rules: Learn the process of adding Fee rules to further refine Fee Schedule (Trigger) criteria.
Prerequisites
To ensure your experience is streamlined, make sure you’re familiar with the following information:
Fee Types: The different categories of fees that can be created and charged.
Fee Structure: Overview of the basic layout for a Fee configuration.
Fee Schedules: Available time or event-based triggers used to initiate a Fee charge.
Fee Rules: Options to further refine the criteria of the Fee Schedule.
Fee Modifiers: Options to redirect the Fee collection flow and who will pay the Fee.
Fee Collection Process: Overview of how Fee payments are collected and where they can be found.
Warnings
Review the following warnings before you begin to avoid issues and potential legal complications:
Do not create or apply Surcharges as legal complications can occur. Visa and MasterCard specifically prohibit the application of Surcharges to cardholders on their card brand networks respectively.
Convenience Fees can only be charged to customers using an alternative payment method (e.g. a website instead of in-person or mail/telephone orders).
Tips
The following tips will provide you with extra insight useful to the process:
If you’re unsure of how much to charge for specific fee types, refer to the Visa and MasterCard card brand network guidelines.
Set Up a Fee
This quick overview will demonstrate the steps necessary to begin setting up the Fee configuration of your choice. For simplicity, this will serve as the foundation to set up all Fee Types. Each Fee Type will be covered in its own section with additional context added where necessary.
Fees can be set up for Merchants or Groups. See the following content for general steps to configure each basic fee application:
Use the following steps to start setting up a Fee for an individual Merchant entity:
Access the Merchants page, from the left navigation panel.
Click the relevant Merchant to enter their Merchant Profile page.
Click Fees from the Merchant Profile left menu.
Click Add Fees.
Jump to the Fee Type section of this guide for the required parameters for the fee of your choice.
Result: You can now customize your basic Merchant fee to meet your use cases.
Use the following steps to start setting up a Fee for a Group:
Access the Groups page (located under Management).
Select the relevant Group to access the Group Profile page.
In the Group Profile, select Fees from the left menu.
Click Add Fees.
Jump to the Fee Type section of this guide for the required parameters for the fee of your choice.
Result: You can now customize your basic Group fee to meet your use cases.
Note
Fees can also apply on a per-transaction basis. See the Transaction Fees section for steps on configuring a fee applicable to transactions or their amounts.
Set Up a Fee by Type
In the Fee Type Setup steps below, we’ll simply include the required parameter settings necessary to enable that particular Fee Type. Additional context and information will be provided within each section.
Choose the Fee Type you’d like to set:
Boarding Fees - Fees collected from your Merchants as they board the platform.
Chargeback/Dispute Fees - Fees collected for managing Merchants’ dispute responses.
Convenience Fees - Fees collected from Cardholders for alternative payment method acceptance.
External Fees - Fees collected for services provided outside of the platform such as Visa Fixed Acquirer Network Fee (FANF), Visa Integrity Fees, and MasterCard Merchant Location Fees or Value-Added Services like Omnitoken and SaferPayments.
Interchange & Processing Fees - Fees collected to reimburse Interchange and other costs assessed by the processor and/or card brands.
Platform Service Fees - Fees collected for custom Platform Service enablement
Risk Decision Fees - Fees collected for triggering automated Risk Decisions on an entity.
Risk Service Fees - Fees collected for performing a Risk Policy check on an entity at a cost.
Surcharge Fees - Fees collected from cardholders by Merchants as an additional charge, usually to cover specific costs associated with the transaction, such as platform transaction fees.
Transaction Fees - Fees collected when transactions are authorized and/or captured.
If you’re already familiar with the essential Fee Type setups, jump ahead to Fee Rules to learn how to further refine the Schedule (Triggers) of your Fees.
Boarding Fees
This customization allows our partners to seamlessly implement a portfolio-wide or individual new account creation fee to collect from their clients.
Example: As a Partner, you would like to charge a Fee to your Merchants for boarding and whenever they board Sub-Merchants. This Fee allows the Partner to generate revenue from Merchants boarding under their portfolio, even if the Merchant ultimately has little or no activity after boarding.
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Board | The Fee triggers when the Merchant is boarded. |
How much is the fee? | Actual | N/A |
Amount | {yourFeeAmount} | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Chargeback Fees
Chargeback Fees (also known as Dispute Fees) are fees set and charged to Merchants by Partners for offering the platform to process the Chargeback.
Example: A Merchant has received an initial dispute opening the chargeback process, also known as Retrieval. When a Chargeback Fee is configured and “Retrieval” is chosen as the Fee Schedule (Trigger) ("schedule": 19) , the Merchant will now be assessed a fee when the Chargeback Cycle is opened and Dispute Stage is “Retrieval”
Begin by following the steps in the Set up a Fee section and use the parameters below to complete the process:
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Chargeback | This fee triggers when a first chargeback dispute stage is reached against a Merchant. You can also use the following options for different Chargeback cycles:
|
How much is the fee? | Actual | N/A |
Amount | {yourFeeAmount} | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
This Fee is now configured to trigger to charge a Merchant whenever a Chargeback is created (First Chargeback Dispute Stage).
Convenience Fees
Convenience fees are fees set and charged by Merchants to Cardholders for the “alternative” payment method acceptance. “Alternative” refers to the non-primary payment methods provided by Merchants to Cardholders. This convenience fee amount is then charged to the Merchant by the Partner, based on the Partner’s Fee Modifier settings.
Example: A Merchant that typically accepts in-person payments and over-the-phone/mail order. The Cardholder requests to make a payment using the Merchant’s website to send a card-not-present payment. As the website is not the primary method accepted by the Merchant, they can charge a convenience fee to the Cardholder.
Begin by following the steps in the Set up a Fee section and use the parameters below to complete the process:
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Capture | N/A |
How much is the fee? | Actual | Percentage or Surcharge may not be used in any form of Transaction Fee configuration. |
Amount | {yourFeeAmount} | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Transaction Fee | Enabled | The toggle checkbox is available in the “Advanced Options” section of the Add Fee dialog. |
Important!
Convenience Fees can cause legal complications if configured incorrectly or not meeting the general card brand network requirements:
Convenience Fees must be disclosed to customer before completion of a transaction.
You must allow cardholders to cancel the transaction upon reading this disclosure.
Convenience Fees are only allowed for credit and signature debit card types.
Convenience Fees are only allowed for card-not-present transaction types.
Convenience fees cannot be applied to recurring, subscription or installment transactions.
Tip
Use a Fee Rule to only charge Convenience Fees over a specific amount.
External Fees
External Fees are fees that are assessed from external platforms, such as Visa’s Fixed Acquirer Network Fee (FANF) or MasterCard Merchant Location (MC Location), to a Partner for the usage of those services. In scenarios where Partners would like to charge a Merchant to cover the costs of those fees. In some cases, you may want to charge a markup for providing the service through your platform to your Merchants.
Example: A Partner is enrolled in both MasterCard Merchant Location (MC Location) and Visa Fixed Acquirer Network Fee (FANF) programs for its Merchants to improve interchange rates and reduce fraud. As both of these programs assess Fees to the Partner based on each individual Merchant’s information (such as number of locations, online-only, etc.) the Partner would like to charge 100% of the external services’ costs to the Merchant, or could even assess a 102.5% (as an example) for a small markup percentage for enabling the external service.
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | {externalService} | Any of the following values are supported as External Fees:
|
How much is the fee? | Actual | Percentage or Surcharge may not be used in any form of Transaction Fee configuration. |
Amount | {yourFeeAmount} | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Interchange & Processing Fees
If you want to pass along these to your merchants you can set up an interchange fee schedule at 100% so that they are responsible for covering the fees.
Example: A Partner would like to pass along the cost of acceptance for debit and credit card interchange to your Merchant.
Interchange fees require a more involved setup due to the various types of interchange events that occur. First, you must start building a percentage-based fee triggered by Interchange events. Then, you can apply conditional rules to assess debit network interchange fees, if applicable, and apply them to the Merchant or Group accordingly.
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Interchange | The Fee triggers based on the interchange type of this Merchant. |
How much is the fee? | Percentage | N/A |
Amount | 100.00 | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Tip: Use a Fee Rule to define the Interchange type or specific processor.
Debit Network Interchange Fees: Conditional Rules
After building the initial interchange fee order to properly assess debit network interchange fees, you must configure the following conditional rule settings under the Advanced Options section of the Add Fee modal:
Conditional Rule | Required Value | Note |
---|---|---|
Payment Card Type is: | Debit | This helps the fee engine differentiate between credit interchange and debit interchange costs. |
Payment Card Brand is: | {Debit - [Network]} | Valid Values:
|
Platform Service Fees
This customization allows our partners to seamlessly implement a portfolio-wide or individual new account creation fee to collect from their clients. creating a custom platform service fee in Payrix Pro is an ideal way to automatically bill your clients for your services based on your user agreement with them.
Example: The payment acceptance platform you offer as a Partner comes at a cost to the Merchant, usually in the form of monthly service plan costs or subscription costs. As the Merchant has agreed to your platform’s terms and conditions, it accepts the costs setup as a Monthly Fee Schedule eliminating the need for a third-party billing solution.
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Months | The Fee triggers every X number of months.
|
Every how many monthly? | 1 | This sets the interval to as recurring once per month. This can also be changed to be bi-monthly (2), quarterly (3), or semi-anually (6) as examples. |
How much is the fee? | Actual | N/A |
Amount | {yourFeeAmount} | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Fee Name | {yourBusinessName} Platform Service Fee | Optional. This will help more easily identify your Fee when viewing the Portal. |
Risk Decision Fees
Risk Decision Fees allow you to charge fees to a Merchant when core platform risk services are used to evaluate when a risk decision is made for a boarding Merchant or when a processed Transaction has risk checks performed to ensure compliance.
Example: A Partner would like to charge a Merchant when the platform risk service performs an automated transaction check. This happens when specific risk criteria are met and delay the disbursement of transaction funds in addition to fraud and risk compliance concerns. As a result, the Partner will charge a fee when these events occur to actively discourage the Merchant from high-risk transaction actions and behaviors.
Add Fee Parameter | Required Value | Notes and Valid Values |
---|---|---|
When to trigger the fee? | Internal Decision V2 | Payrix Pro automated Risk decision services. You can also use the following valid values for different supported Risk Services:
|
How much is the fee? | Actual | N/A |
Amount | {yourFeeAmount} | N/A |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Fee Name | {yourBusinessName} Risk Decision Service Fee | Optional. This will help more easily identify your Fee when viewing the Portal. |
Tip
Use Fee Rules to refine the specific risk decision status or additional misuse criteria.
Risk Service Fees
Risk Service Fees allow you to charge additional fees for the use of integrated third-party risk service. This flexibility enables Partners to assess fees to Merchants that are higher risk requiring manual validations of the entity and its transactions on a regular basis in addition to fees assessed from the given risk service(s).
Example: A Partner would like to assess fees to their Merchants to cover the costs of external risk services they use to ensure their Merchants' compliance. These services could include OFAC checks, personal credit pulls, or other necessary risk items needed for boarding or ongoing risk reviews.
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Internal Decision V2 | Payrix Pro automated Risk decision services. You can also use the following options for different supported Risk Services:
|
How much is the fee? | Percentage | N/A |
Amount | 100% | You can create a markup on this fee by going above 100% such as 103.5%. |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Surcharge Fees
Surcharging allows Partners to charge a per-transaction fee each time a credit card is used by cardholder that is charged to the Merchant but can be passed to the cardholder directly.
Example: The payment acceptance platform you offer as a Partner assesses a 3% surcharge to Merchants for processing credit-only transactions to offset associated processing fees. As a result, you enable each of your Merchants to collect this surcharge from their customers using credit cards.
Important!
There are individual registration requirements and regulations by card brand before you can enable surcharges. The following steps will demonstrate how to enable the Surcharge once all prerequisits are met. Visit Understanding Surcharges for more details on the enablement requirements.
Surcharging is still illegal in a few US states/territories: Connecticut, Massachusetts, and Puerto Rico. Be sure to follow your local and regional regulations accordingly.
Add Fee Parameter | Required Value | Note |
---|---|---|
When to trigger the fee? | Capture | The Fee is triggered at the time of credit card capture for a transaction. |
How much is the fee? | Surcharge | N/A |
Amount | 3% | Warning: When setting up a surcharge, do not exceed 3% to adhere with all credit card brand regulations. |
Fee Start Date | {yourStartDate} | It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately. |
Transaction Fee | Enabled | Checkbox available under the Advanced Options section of the dialog. |
Conditional Rule | Payment Card Type is | Credit Warning: This is required when setting up a surcharge as credit cards are the only payment method that allow surcharging. |
Transaction Fees
Transaction Fees allow Partners to charge their Merchants on a per-transaction basis to generate revenue as a Partner.
Example: The payment acceptance platform you offer as a Partner charges a per-transaction fee in the form of a flat rate authorization fee and a captured amount percentage. This is a common Fee model in the Payments industry commonly seen as “Transaction Processing Fees: 10¢ + 3%” for example.
This Transaction fee will use a two-part fee setup that involves the creation of multiple fees. First, set up a flat rate fee for all credit card authorizations. Then, create another percentage-based fee for credit card captures transactions. The reason this process requires two steps is because two fees are triggered simultaneously. The flat rate auth fee ensures that a fee is charged each time a credit card transaction is processed. Then, an additional percentage is calculated when the funds are captured to offset any processor batching or settlement costs associated with the transaction.
The following example is modeled after industry-standard payment processing fees: Flat Fee + % of the transaction total:
First, you’ll setup a flat rate authorization fee using the parameters below:
Add Fee Parameter
Required Value
Note
When to trigger the fee?
Auth
The Fee is triggered at the time of authorization of a transaction.
You can also use the following Fee Schedules:
Refund. The Fee triggers when a refund transaction is processed.
How much is the fee?
Actual
N/A
Amount
{yourFeeAmount}
The numerical fee amount, written in basis points to represent a dollar amount (Example:
015
= $0.15).Warning: Refer to each card brand and processor’s policies on Transaction fees to ensure compliance.
Fee Start Date
{yourStartDate}
It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately.
Transaction Fee
Enabled
Checkbox available under the “Advanced Options” section of the dialog.
Then, you must configure another percentage-based fee for the transaction’s total amount:
Add Fee Parameter
Required Value
Note
When to trigger the fee?
Capture
The Fee triggers at the capture time of a Transaction.
How much is the fee?
Percentage
Amount
{yourFeeAmount}
The percentage amount, written in basis points. (Example:
300
= 3.00%).Warning: Refer to each card brand and processor’s policies on Transaction fees to ensure compliance.
Fee Start Date
{yourStartDate}
It is recommended to use “today’s” date as the Fee Start Date to make the Fee effective immediately.
Transaction Fee
Enabled
Checkbox available under the “Advanced Options” section of the dialog.
Result: Your Flat Rate + Percentage transaction fee is active and all transactions processed through your integration will be charge your according transaction fee.
Tip
Use Fee Rules to define the specific method of payment acceptance can trigger the Fee.
Add Fee Modifiers
To change the entity that will be paying the cost for the Fee charge, you’ll need to setup a Fee Modifier.
After you’ve configured your new Fee, use the following steps to add additional Fee Modifiers:
Click Advanced Options in the Add Fee dialog after your initial Fee setup.
Check the “Deduct this Fee from Another Entity” checkbox, then under the DEDUCT FEE FROM drop-down, select the entity that the fee charge will be paid by.
Result: Finish configuring the rest of your Advanced Options for your fee and click the ADD button when finished to save the new Fee Modifier within the new Fee.
Use the following steps to add Fee Modifiers to your existing Fee:
Navigate to the Merchants or Groups page, located under Management.
Click the Merchant or Group you want to charge the Fee to enter its Merchant Profile or Group Profile page.
In the Merchant Profile or Group Profile, click Fees from the left-hand menu. Then, click the Fee setup you’d like to add the Fee Rule to from the Active Fees Section to enter the Fee Details page.
On the Fees Details page, click the dropdown under the Fee Modifiers section and click the Add Fee Modifier button in the upper-right of the section.
Set the the unit of measurement, amount, group (if applicable) and the ID for the “From Entity” (the entity that will be paying the fee) in the new field that has appeared.
Result: Click the ADD button when finished to save the new Fee Modifier to the existing fee.
After you’ve configured you’re initial Fee Type, to add additional Fee Rules, follow the steps below:
Add Fee Rules
To configure and refine the criteria of the Fee Schedule or “When to trigger the fee?” selection of a fee you’ve just created, follow the steps below. This process will not work if you have not set up a new Fee or are selecting an existing Fee configuration. See Setting up a Fee above for steps to set up a Fee if you’re not using an existing Fee setup.
See the following steps to add a Fee Rule:
After you’ve configured your new Fee, use the following steps to add additional Fee Rules:
Click Advanced Options in the Add Fee dialog after your initial Fee setup.
Click Conditional Rules and select a Fee Rule option. See Fee Rules for a list of available options with descriptions.
Set the amount or value in the new field that has appeared.
(Optional) After setting up your first Fee Rule, you can click the + button next to your first rule to add another.
Click the ADD button when finished to save the new Fee Rule(s).
Result: The Fee Rule has been created and applied to your new fee.
Use the following steps to add Fee Rules to your existing Fee:
Navigate to the Merchants or Groups page, located under Management.
Click the Merchant or Group you want to charge the Fee to enter its Merchant Profile or Group Profile page.
In the Merchant Profile or Group Profile, click Fees from the left-hand menu. Then, click the Fee setup you’d like to add the Fee Rule to from the Active Fees Section to enter the Fee Details page.
On the Fees Details page, click the dropdown under the Fee Rules section and select a Fee Rule option. See Fee Rules for a list of available options with descriptions.
Set the amount or value in the new field that has appeared.
(Optional) After setting up your first Fee Rule, you can click the + button next to your first rule to add another.
Click the Checkmark button in the upper right to save the new Fee Rule(s).
Result: The Fee Rule has been created and applied to your existing fee configuration.
Additional Resources
For additional Fee-related resources, see the associated articles: