Skip to main content

Payment Method Surcharge

Set up and use automatic payment method surcharges in Blackpurl to pass card processing fees to customers at checkout, deposit, and AR payment.

Blackpurl can automatically calculate and apply a percentage surcharge to a customer's transaction when they pay using specific payment methods — such as Visa, Mastercard, Amex, Discover, an integrated payment processor, or Preferred Payment (if applicable). This article covers how to set up the surcharge and where it appears in Blackpurl.

Setup

Three setup steps must be completed before the Payment Method Surcharge will automatically calculate for customers.

A — Accounting Integration

A Control Account must be configured in your Accounting Integration so that surcharge revenue posts to the correct General Ledger account in your accounting package. See Control Accounts: Payment Method Surcharges for full instructions.

B — User Permission

To allow users to modify or override a surcharge at the time of payment, the Modify Payment Method Surcharge user permission must be enabled. See Modify Payment Method Surcharge Permission for details.

C — Setting the Rate

To configure the surcharge percentage for each payment method:

1. Go to System Settings > Settings & Controls > Payment Methods.

2. Enable Automatic Payment Method Surcharge.

3. For each applicable payment method — Integrated payment processor, Visa, Mastercard, Amex, Discover, or Preferred Payment — enter the surcharge percentage to charge customers when they use that method on a customer order.

4. Scroll down and click Apply Settings to save.

Shows the Payment Methods settings screen with a collapsible section titled 'PAYMENT METHODS' at the top. Below is an 'A


For example, a dealership without an integrated payment processor could set a 1.25% surcharge on the Visa payment method. Any customer who pays by Visa on a customer order will automatically have the 1.25% surcharge added to their total.

Shows a condensed view of the Payment Methods settings. The 'Automatic payment method surcharges' toggle is enabled. Bel


Where the Surcharge Applies in Blackpurl

The automatic surcharge is calculated in three areas: Checkout, Deposit, and AR Payment. The examples below use a 1.25% Visa surcharge to illustrate how the surcharge appears in each area.

Checkout

When a user selects Visa as the payment method in Checkout, the surcharge calculates immediately. The checkout screen displays four values:

Shows a checkout interface with two main sections. On the left is 'SELECT WHAT YOU WANT TO CHECKOUT' showing a widget it

A — Checkout amount (before surcharge)

The pre-surcharge total. This is the amount the surcharge percentage is applied to.

B — Surcharge %

The percentage configured in System Settings > Settings & Controls > Payment Methods. Users with the Modify Payment Method Surcharge permission can override this value, including setting it to 0% to waive the surcharge entirely.

C — Surcharge amount ($)

The calculated dollar value of the surcharge.

D — Total charged

The total amount that will be charged to the customer's Visa card, including the surcharge.

Complete the checkout as normal by adding the payment and finalising the invoice.

Tip: To override the surcharge, change the percentage at field B. To waive the surcharge entirely, set the percentage to 0%.

Deposit

When a user selects Visa as the payment method and enters a deposit amount, the surcharge calculates automatically. The Add Deposit dialog displays four values:

Shows an 'Add deposit' dialog box with payment method selection at the top. Multiple blue buttons are visible (Cash, Vis

E — Deposit amount

The deposit amount being paid to the dealership. The user enters this value.

F — Surcharge %

The percentage configured in System Settings > Settings & Controls > Payment Methods. Users with the Modify Payment Method Surcharge permission can override this value, including setting it to 0% to waive the surcharge.

G — Surcharge amount ($)

The calculated dollar value of the surcharge based on the deposit amount.

H — Total charged

The total amount that will be charged to the customer's Visa card.

Finalise the deposit as normal. The deposit will be available to apply at checkout when you are ready.

Tip: To override the surcharge, change the percentage at field F. To waive the surcharge entirely, set the percentage to 0%.

AR Payment

The surcharge also applies when a customer pays outstanding Charge on Account invoices using a payment method that has a surcharge configured. This is based on the AR Credit Payment Method feature.

For example, if a customer selects Visa to pay their outstanding invoices, the surcharge calculates as soon as the payment method is chosen. The payment dialog displays four values:

Shows a customer record screen for Cathy Price. The left sidebar shows customer information and navigation options. The
Shows a 'Choose a payment method' dialog overlay on the customer screen. The dialog contains multiple blue payment metho

I — Payment amount (before surcharge)

The amount being paid before the surcharge is added. This is the amount the surcharge percentage is applied to.

J — Surcharge %

The percentage configured in System Settings. Users with the Modify Payment Method Surcharge permission can override this value, including setting it to 0% to waive the surcharge entirely.

K — Surcharge amount ($)

The calculated dollar value of the surcharge based on the payment amount.

L — Total charged

The total amount that will be charged to the customer's Visa card.

Complete the payment by clicking Receive Payment as normal.

Tip: To override the surcharge, change the percentage at field J. To waive the surcharge entirely, set the percentage to 0%.

Customer Refunds

When a refund is processed using a payment method that has a surcharge configured, Blackpurl will also calculate and refund the surcharge amount automatically.

For example, if a customer requires a refund on a part and the dealership refunds via Mastercard — which has a 1.25% automatic surcharge — the surcharge will appear as a negative amount in the checkout refund screen and will be refunded along with the original payment amount.

Users with the Modify Payment Method Surcharge permission can override the surcharge percentage at the time of refund, including setting it to 0% to waive the surcharge refund entirely.

Shows a checkout refund interface with payment method selection on the left and payment calculation details on the right
Did this answer your question?