How to enable surcharging with PaySimple V5

Turn on credit card surcharging

Credit card surcharging is available on PaySimple Payments API (V5). A surcharge is added to a credit card payment and shown to the customer before the card is charged. Bank account (ACH) payments are not surcharged. Debit cards are not surcharged.

Your company is responsible for following card-network rules and the laws where the customer is located. Some states and provinces limit or prohibit surcharging.

Set the income account

Open Settings, then System Settings, then the Payments tab.

API Version must be Payments API (V5).

Set Surcharge Income Account to the QuickBooks income account that should receive the surcharge. The field is marked required. The payment settings cannot be saved with surcharging on until this account is selected. The help text is Required when surcharging is enabled.

image_2026-11-14_092500743.png

Turn surcharging on

Set Enable Credit Card Surcharging to Yes.

The Enable Credit Card Surcharging window opens. It stays closed until you check I acknowledge and agree to the above. Then click Enable Surcharging. Cancel leaves surcharging off.

The window states:

  • Surcharges may only be applied to credit card payments, not debit cards.
  • Maximum surcharge rates are 3% in the US and 2.4% in Canada.
  • You must disclose the surcharge amount to customers before payment is processed.
  • You are responsible for compliance with applicable federal, state/provincial, and card network rules. Some jurisdictions restrict or prohibit surcharging.

The acknowledgment also covers the PaySimple Terms of Service and Acceptable Use Policy. The system records the user who turns surcharging on or off.

settings-surcharge-confirm.png

This window does not save the setting. Click Save Changes at the bottom of the Payments tab. The page confirms Payment Settings Updated.

Choose the rate

After surcharging is set to Yes, the rate fields appear.

Use country default rate uses the maximum allowed for the company country. In the US that rate is 3.00%. In Canada it is 2.40%. While the box is checked, Surcharge Rate (%) is locked to that rate.

Uncheck Use country default rate to enter a lower rate. The rate must be from 0.01% through the country maximum. A higher rate is rejected, and the settings are not saved. The message is Surcharge rate must be within the allowed maximum for your country.

The help text under the rate is Maximum rate is 3.00% for your country. Uncheck country default to set a lower custom rate. A Canadian company sees 2.40% in that sentence.

The note under the setting is When enabled, credit card payments will include a surcharge fee (max 3% in US, 2.4% in Canada). Customers will be notified before payment is processed.

settings-surcharge-rate.png

Click Save Changes after the rate is set.

Where the customer sees the surcharge

When surcharging is on, a credit card payment shows the surcharge before it is processed. The screen shows Surcharge and Total Charged. The notice starts with We impose a surcharge on credit card payments.

That notice appears in the office, on PayNow, in the customer portal, and in the mobile app. Auto pay and recurring payments have their own approval steps. Those steps are in Run auto payments and Set up recurring payments.

To skip the surcharge for one saved card, open that customer’s Payment Profiles tab and check No Surcharge on that row. That column is shown only while surcharging is on.

image_2026-11-14_093153786.png