This article explains how to configure surcharge settings for individual Payment Processors. This feature allows you to apply surcharge fees only when specific processors are used for credit card transactions.

Credit Card Surcharge Configuration in Payment Processor

Two fields in the Payment Processor settings:

• Surcharge When Paying by Credit Card – The surcharge percentage applied when the customer selects a credit card as the payment method.

• Surcharge Minimum Amount – Specifies the minimum amount at which the surcharge will be triggered for the selected processor.

Set up

• To locate the fields, go to Payment Center Settings, select your processor.

• If the fields are not available, you need to add it to the Payment Processor Page Layout.

These settings provide more granular control over how and when surcharges are applied during credit card transactions.

Testing

To simulate payment processing in a test environment, follow the steps below:

1. Configure Test Mode in Processor Settings

• Go to Processor Settings and select any available processor.

• Enable Test Mode by toggling the switch to Test.

• Enter your test credentials to complete the test integration setup.

2. Use the Pre-installed Kulturra Test Account (Optional)

• Alternatively, enable the Use Kulturra Test Account checkbox to use the built-in test processor credentials.

• Ensure the Live flag is unchecked.

• Check the Use as Default box for the processor you want to use for testing.

3. Configure Surcharge Settings

• Enter values for the following fields:

  • Surcharge When Paying By Credit Card

  • Surcharge Minimum Amount

These settings help simulate how surcharge fees will be displayed and calculated during payment.

4. Execute a Test Payment

• Navigate to an unpaid invoice and click Pay Invoice.

• On the Payment Page, choose Credit Card as the payment method.

• Use the following test credit card information:

  • Credit Card Number: 4111111111111111

  • Expiration: 12/25

• On the Payment Page, there will be a message showing the Surcharge fee being applied to a specific amount.

5. Complete the Payment

• Follow the on-screen instructions to complete the test payment process.

• You should see a success message confirming that the test payment was processed.

• Observe how surcharges are applied based on the entered values.

Availability: Spring '25