Transaction Fees
This chapter describes the option for the EPX processor to calculate fees on the back end and apply them to the total amount of the sale or authorization request.
Platform Support:
Transaction fees can be applied as a percentage or as a flat fee to a Sale (CCx1) or an Auth Only (CCx2) transaction.
With the percentage option, a Minimum Fee and Maximum Fee amount can be configured in the merchant profile at the terminal level.
When enabled, EPX will perform the fee calculation on the back end, apply it to the total amount (AUTH_AMOUNT_REQUESTED) in the transaction request, and return specific details in the response message via the AUTH_FEE and AUTH_FEE_TEXT tags. To enable this feature in the Production environment, the client must submit a request directly through EPX Client Services or their relationship manager.
Flat Fee
EPX will add the fee to the total amount of the sale/authorization request and the response will contain tags AUTH_FEE and AUTH_FEE_TEXT that reflect the flat fee amount set in the terminal profile.
Example:
Percentage
EPX will calculate the percentage amount into the total amount of the sale/authorization request; the response will contain tags AUTH_FEE reflecting the percentage amount and AUTH_FEE_TEXT reflecting the percentage rate with the maximum amount in parenthesis set in the terminal profile.
Example:
Transaction Response Fields
AUTH_FEE
The AUTH_FEE field contains the actual surcharge fee amount that was added and applied to the total AMOUNT in the transaction request.
- Variable Type: Numeric
- Max Length: 19
- Format: N.NN
Example:
AUTH_FEE_TEXT
The AUTH_FEE_TEXT field reflects the transaction (surcharge) percentage rate or flat fee amount that was used during the EPX platform’s transaction fee calculation.
- Variable Type: Numeric
- Max Length: Var
Example:
Client Application Management / Support:
The client application has the ability to manage the transaction fee calculation on their end.
- For convenience fees, the amount would be indicated in the CONVENIENCE_FEE tag as a reference field for reporting purposes. The client application would be responsible for adding the convenience fee amount into the total AMOUNT prior to initiating the transaction request. Please reference the CONVENIENCE_FEE field definition for additional information.
- For surcharge fees, the amount would be indicated in the TRAN_FEE tag and the EPX platform will add that to the total transaction AMOUNT prior to going out to the Networks for authorization. Please reference the TRAN_FEE field definition for additional information.