Skip to content
WPPoland Documentation

Getting started

Most stores can add a working checkout fee in a few minutes. Surcharge ships ready — install, open the settings screen, add a fee.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce active (classic checkout and Cart/Checkout Blocks supported)
  • PHP 8.1 or newer

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Surcharge from the plugin directory (when live on WordPress.org) or upload the surcharge folder to /wp-content/plugins/.
  3. Activate the plugin.

Add your first fee

Section titled “Add your first fee”

Open WooCommerce → Surcharge:

  • Master switch — keep fees enabled (toggle off any time to pause everything).
  • Add fee — give it a label shoppers will see in the totals.
  • Type — choose fixed amount or percentage of the cart subtotal.
  • Taxable — turn on if WooCommerce should apply your tax rules to the fee.
  • Conditions (all optional, combinable):
    • Minimum cart total — fee applies only above this amount.
    • Payment method — pick a gateway so the fee applies only for it (e.g. Cash on Delivery).
    • Shipping countries — enter comma-separated two-letter codes (e.g. US, CA, GB).

Save. The fee is now live on the cart and checkout.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Add a product and open the cart — the fee should appear in the totals when its conditions match.
  2. Go to checkout and switch payment methods — a payment-method-scoped fee should appear or disappear accordingly.
  3. Place a test order — the fee should show on the order and in the confirmation email.

How a percentage is calculated

Section titled “How a percentage is calculated”

A percentage fee is taken from the cart contents subtotal, before existing fees and shipping.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers unlimited fixed and percentage fees with cart-total, payment-method and country conditions, taxable fees and a master switch.

Surcharge PRO (planned) adds tiered fees by cart value, per-product and per-category fees, customer-role rules, schedule windows and per-fee reporting — not basic fee access.

Need help?

Section titled “Need help?”