Gatemi Checkout Fees Settings Reference

Everything is on one screen: WooCommerce → Checkout Fees. It needs the manage_woocommerce capability.

Both editions store their configuration in the same two options, in the same shape:

  • gmfe_rules — the list of fee rules, in the order you wrote them.
  • gmfe_settings — the shipping-insurance settings.

So moving between editions keeps every rule. The free edition writes back everything it does not show — a percentage, a base, taxability, extra conditions — exactly as it found it.

The Checkout Fees settings screen
The free edition’s screen: three fee rules and the shipping-insurance card.

Fee rules

The free edition shows three rule rows. The full edition shows every saved rule, an empty row at the end, and an Add another rule button.

Each rule is stored as an array with these keys.

Active

  • Key: enabled · Default: on for a new rule
  • Unticked, the rule is kept but never charged.

What the shopper sees on the total

  • Key: label · Default: empty
  • The name of the fee line on the cart, the checkout, the order and the emails. Leave it empty to delete the rule — a fee with no name is not saved.
  • The rule's id is made from this name the first time it is saved (Small order handling → small-order-handling) and then kept. Two rules never share an id; a duplicate gets -2 added.

A flat amount (free edition) / Charge and Of (full edition)

  • Keys: kind (fixed or percent, default fixed) and amount (default empty, read as 0)
  • Free edition: the field is A flat amount — a fixed sum added to the total.
  • Full edition: Charge chooses A flat amount or A percentage, and Of is the number. A negative number is a discount: -2 with a percentage is "2% off".
  • Amounts are read the way people type them. 2,50 is 2.50 and 1.250,00 is 1250 — when both separators appear, the rightmost one is the decimal point.
  • A rule that works out at nothing is not added at all, so no order ever reads "Handling: 0.00".

Measured against — Full edition

  • Key: base · Default: goods
  • Only used by a percentage.
Choice Key Base
the goods after coupons, before shipping and tax goods The cart lines' totals after coupons
the goods after coupons and the shipping, before tax goods_shipping Those goods plus the shipping total
everything the customer pays after coupons, tax included total Those goods plus shipping plus the tax on both

A card surcharge should normally be measured against total, because that is what the gateway takes its cut of. See How it works.

Taxable — Full edition

  • Key: taxable · Default: off
  • On, WooCommerce charges tax on the fee at the standard rate. A tax_class key is stored beside it (default empty, the standard class); the screen does not edit it.
  • In the free edition every fee is untaxed.

When (conditions)

  • Key: conditions — a list of { type, value } pairs
  • Free edition: one condition per rule, chosen in When, with its number or list in Value. Always — no condition charges every cart.
  • Full edition: as many as you like. After each save a new empty condition box appears under the rule. Every condition on a rule must be satisfied for it to charge.
Label Type Value Edition
The goods are worth at least min_total A number both
The goods are worth at most max_total A number both
There are at least this many items min_items A whole number both
The shipping country is one of country Country codes, comma-separated: FR, DE both
The shipping country is not one of not_country Country codes both
The chosen payment method is one of payment_method Gateway ids: cod, bacs Full edition
The chosen shipping method is one of shipping_method Method ids: flat_rate or flat_rate:3 Full edition
The cart holds something from these categories category Category ids: 12, 15 Full edition
The cart holds something in these shipping classes shipping_class Shipping-class slugs: bulky Full edition
The customer's role is one of user_role Role slugs: customer, wholesale_customer; guest for a visitor who is not signed in Full edition

"The goods" is the sum of the cart lines' subtotals before coupons, shipping and tax. The country is the shipping country, or the billing country when there is no shipping address.

Rules the free edition does not charge

A rule the full edition wrote with a percentage, a negative amount, more than one condition, or a condition only the full edition offers is shown on the free edition's screen with a note saying it is kept for that plugin. It is never charged by the free edition, and saving the screen does not change it. Rules past the third are left in the option untouched and do not run.

Shipping insurance

Stored in gmfe_settings.

Label Key Default Edition
Offer shipping insurance insurance_enabled no both
What the box says insurance_label empty, shown as "Shipping insurance" both
A flat amount insurance_amount 0 both
Plus a percentage of the goods insurance_percent 0 Full edition
But never less than insurance_minimum 0 Full edition
The insurance charge is taxable insurance_taxable no Full edition
Show the box on insurance_where both (cart, checkout) Full edition
A note under the box (free) / A note beside the box (full) insurance_note empty both
  • The box is never ticked for the shopper, and there is no setting to tick it.
  • The box does not appear while its price is nothing.
  • Negative amounts are stored as 0.
  • Free edition: the price is the flat amount, the charge is untaxed, and the box shows on both the cart and the checkout.
  • Full edition: the price is the flat amount plus the percentage of the goods, raised to But never less than when it falls below it.

License & updates — Full edition

Paste the licence key from your gatemi.com account and press Activate. It is stored in its own option, gmfe_license. The card shows the state ("Active — updates until …", "Expired — renew for updates", "Revoked") and a Deactivate on this site button. If the last check could not reach gatemi.com, the state is left as it was. The plugin keeps charging fees whatever the licence says; the key switches on updates and support.

Filters — Full edition

The full edition's screen ends with a Filters card listing every filter the plugin applies. They are documented in the developer reference.

Shopping Cart
Scroll to Top