triPOS®

Convenience Fee Amount

Convenience Fee Amount

For a sale request, the PIN pad prompts the cardholder to confirm various amounts. In order for the PIN pad to prompt the cardholder to confirm the convenienceFeeAmount, set the configuration value confirmConvenienceFeeAmount to true. If this value is set to false, we recommend also setting confirmOriginalAmount to false. If confirmOriginalAmount is set to true when confirmConvenienceFeeAmount is set to false, consider the example below:

convenienceFeeAmount: 1.00
transactionAmount: 99.00

The PIN pad will prompt the cardholder to confirm the original amount of $99.00. Then, it will skip the confirmation of the $1.00 convenienceFee. Since the total amount is different from the transaction amount, the PIN pad will then prompt the cardholder to confirm the total amount of $100.00. This results in a confusing cardholder experience. For this reason, it is recommended to set confirmOriginalAmount to the same value as confirmConvenienceFeeAmount when using convenience fees.