Set up International Fees and Coupons Pro

Before you start

• Your licence key. It starts with IFCP- and was shown after checkout and emailed to you. Lost it? Resend my key.
• A WordPress login that can manage WooCommerce (an administrator or shop manager).
• WordPress 5.8 or later, WooCommerce 3.0 or later and PHP 7.4 or later.

Install and activate

1. Install the free plugin first. Pro adds to Bloodweb International Fees and Coupons and needs version 4.4.0 or later, installed and active. Download it from its page, then Plugins → Add Plugin → Upload Plugin (Add New Plugin on older WordPress), Install Now and Activate.
2. Download Pro. The page you saw after checkout has a download link that works for an hour. Any time after that, and from your licence email, enter your key under Download with your licence key on the Pro page. Keep the file zipped.
3. Upload it. Plugins → Add Plugin → Upload Plugin, choose the zip, press Install Now, then Activate Plugin. The Plugins screen then says “International Fees and Coupons Pro is installed but not switched on” until the next step.
4. Paste your key. Go to WooCommerce → Fees and Coupons Pro. On the Licence tab, paste the key into Licence key and press Activate. Spaces and letter case don’t matter.

The three settings that matter

Pro has no settings screen of its own. Its fields appear on every rule on the free plugin’s screen, WooCommerce → Fees and Coupons. To try them, add a region (for example United States) with Add region, press Add fee, and give it a name such as “US import duty”.

1. Charge on

   Every fee gets a Charge on choice:

   • the whole order, which is how the free plugin works, and the default;
   • only these products, then search for the products or variations;
   • only these categories, then pick the product categories.

   For US duty, choose the categories that attract duty and leave out the ones that don’t. Shipping is never included in a scoped fee, because postage can’t be split between lines.

2. Amount: a percentage or a fixed sum

   The free plugin’s Amount field, with % or your currency beside it, behaves like this once a fee is scoped:

   • A percentage is worked out on the matching lines only. 10% on one category is 10% of what the customer spends in that category, not 10% of the whole order.
   • A fixed amount is charged once, and only when the cart holds something that matches. A flat handling charge for one category never lands on an order without it.

   Add a What is this? (shown to the customer) note, such as “US import duty, which we pay on your behalf when your parcel is lodged”, and a “?” beside the fee explains it at checkout.

3. Active between

   Every fee and coupon code gets a first and last day. Both days count, and either can be left empty for no limit. When a rate change is announced, add a second fee with the new rate starting on the day it takes effect, and set the old fee to end the day before: the switch happens by itself. Dates follow your store’s timezone under Settings → General.

Press Save Changes at the bottom of the screen when you’re done.

Check it worked

1. The Licence tab says “Active” with its renewal date, and a second tab, Fees collected, has appeared beside it.
2. The fields are there. On WooCommerce → Fees and Coupons, open any fee with Edit: you should see Charge on and Active between.
3. Try it in the cart. In a private browser window, add one product from a scoped category and one from outside it, then enter a delivery address in the region. The fee appears as its own line, worked out on the scoped product only. Remove the scoped product and the fee disappears.
4. See what it collected. Once real orders come in, WooCommerce → Fees and Coupons Pro → Fees collected shows each region’s fees over the dates you choose, counted from Processing and Completed orders, in the currency each order was paid in.

Moving to a new site

• On the old site, open WooCommerce → Fees and Coupons Pro and press Deactivate on this site. Then install Pro on the new site and activate the same key there.
• Deactivating or deleting the plugin doesn’t release the key by itself; the button does. If the old site is already gone, email us its address and we’ll release it.
• Switching between http and https, or adding or dropping www, is the same site and needs nothing.
• Local development copies (localhost, .local or .test addresses) are free and never use up the licence. A staging copy on a public address counts as a site.
• Your scopes and dates are saved with your rules, so they move with the site’s database.

If something goes wrong

• “That licence key was not recognised”: check it against your purchase email, or use Resend my key.
• “This key is already activated on another site”: deactivate it there first (see above), or email us.
• “The licence server could not be reached”: nothing to do. Pro keeps working and the check is retried daily.
• “International Fees and Coupons Pro needs Bloodweb International Fees and Coupons 4.4.0 or later”: update the free plugin from its page. Pro switches on by itself.