Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Surcharge

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Surcharge adds one or more fees to the WooCommerce cart and checkout. Each fee is either a fixed amount or a percentage of the cart subtotal. Fees use the official WooCommerce fees API (WC_Cart::add_fee), so they appear in the cart totals, on the checkout page and on the resulting order, the same way shipping or tax does, with no extra wiring for emails or reports.

What the free edition does

Section titled “What the free edition does”
  • As many fees as you need, each one a fixed amount or a percentage of the cart contents subtotal.
  • Taxable per fee, tick Taxable and WooCommerce runs the fee through your standard tax rules; leave it off for a tax-free line.
  • Master switch, Enable fees turns every fee off at once without deleting the rows you set up.
  • Per-fee enable toggle, keep a fee row saved but stop charging it, independently of the master switch.
  • One settings screen under WooCommerce → Surcharge, a repeatable fee table that works with or without JavaScript.
  • No external services, no account, no tracking. Everything stays in your database.

How fees are applied

Section titled “How fees are applied”

On every cart calculation (woocommerce_cart_calculate_fees), Surcharge checks the master switch, then adds each enabled fee that has a label and a resolved amount above zero. A fixed fee adds its amount once. A percentage fee is calculated on the cart contents subtotal including line tax, before existing fees and shipping, and is capped at 100%. Two fees that share a label stay distinct, the second gets a #N suffix so WooCommerce never silently merges them.

There are no conditional rules (cart minimums, payment-method or country targeting) in the free edition. A fee that is enabled and has an amount applies to every cart while the master switch is on.

Compatibility

Section titled “Compatibility”

Surcharge declares compatibility with HPOS (custom order tables) and the Cart and Checkout Blocks, so fees apply on both the classic and block-based checkout. It requires WooCommerce to be active and shows an admin notice if it is not.

Surcharge PRO

Section titled “Surcharge PRO”

Surcharge Pro extends the free plugin with advanced features:

  • Fee-exempt user roles, exempt specific customer roles (e.g. wholesale or staff) from checkout fees.
  • Tiered fees by cart value, vary fee amounts based on the customer’s cart subtotal range.
  • Per-product fees and scheduling (planned), apply fees based on cart items or date/time windows.

Next steps

Section titled “Next steps”