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.