UniPay Gateway Documentation

Are you ready?

In this tutorial we are going to learn how to set up Convenience Fees processing configuration.
We will use the following parameters:

The merchant we will use is My First Merchant from Creating a merchant tutorial.
In this tutorial, convenience fees will be withdrawn from Visa, MasterCard, American Express, Discover and direct debit transactions.

Convenience fees will be calculated as follows:
For transactions between $0 and $100 percentage fee will be 2.5% and flat fee will be $0.25.
For transactions between $100 and $500 percentage fee will be 2.25% and flat fee will be $0.15.
For transactions over $500 percentage fee will be 1.88% and flat fee will be $0.10.
Log in to the system using your Username and Password and switch to the Management => Merchant Perspective.

Note: To learn how to log in and select perspectives, use the prerequisite tutorial Logging in and navigating the application.
Select appropriate Merchant or Merchant Account in the top left section of the screen.
Click Detailsbutton in the top left section of the screen.
Locate Processing menu item
Choose Convenience Fees menu item from the dropdown menu.
Click Addbutton
Locate Convenience Fees groupbox.

Note: You can copy convenience fees configuration from/to an existing merchant account using Actions button.
Locate Account Type groupbox
Locate Visa, MasterCard, American Express, Discover and direct debit checkboxes and check them off.
Locate Processing Cost groupbox
Click Ignore radio button to calculate fees only on the basis of the rules entered into table below.

Note: If include radio button is chosen, fees calculation logic will include not just rules set up in the gateway, but processor's fee value as well.
Locate Rules groupbox
Locate Enter Transaction Amount column and select between in the dropdown below.
Locate Upper Limit textbox next to 0.
Enter 100 into the Upper Limittextbox
Enter 2.5 into the Percentage Feetextbox
Enter 0.25 into the Flat Feetextbox
Locate Upper Limit textbox next to 100.00.
Enter 500 into the Upper Limittextbox
Enter 2.25 into the Percentage Feetextbox
Enter 0.15 into the Flat Feetextbox
Locate Enter Transaction Amount column and select over in the third dropdown.
Locate Percentage Fee textbox next to 500.00.
Enter 1.88 into the Percentage Feetextbox
Enter 0.10 into the Flat Feetextbox
After you are done, your screen will look similiar to the screenshot.
Now let's learn how to test our convenience fees calculation mechanism.
Locate Test Rules groupbox
Enter 2000 into the Transaction Amounttextbox
Click Calculate Feebutton
Locate Convenience Fee readonly field to check the result. For $2000 it should be $37.70
Click Savebutton
Congratulations, you are done!

You have learned how to set up convenience fees. Now you can do this by yourself.

Setting up convenience fee

Useful Terms

Setting up convenience fee

Tags