Wholesale Pricing
Wholesale buyers expect a lower price than the public one, and bigger orders expect a bigger break. Running two stores, or handing out coupons to every trade customer, gets messy fast, and a coupon code can leak to anyone.
Wholesale Pricing gives chosen WordPress roles their own prices and adds quantity breaks: a percentage off, an amount off or a fixed unit price, per product, per option or store-wide. Wholesale buyers see their price on product pages, and the cart and checkout price every line on the server, in every checkout currency. It works without FluentCart Pro.
Turn On the Module
- Go to FluentCart → Stackless and switch on Wholesale Pricing on the Stackless Dashboard.
- Open Settings on the card, choose the wholesale roles and click Save changes.
- Give your trade customers the Wholesale customer role under Users, or use a role you already have.
- Open a product in FluentCart and choose Wholesale pricing from its menu.
It needs FluentCart 2.3 or newer. On an older FluentCart it stays off and the admin says so.
Module Settings
- Wholesale roles: customers with these roles get wholesale prices. Wholesale customer is a role the module adds. Administrator can’t be chosen.
- Store-wide discount: one field per saved role, as a percentage off every product that has no rows of its own for that role. Leave it empty for none. A role you’ve just ticked gets its field after you save.
- Quantity breaks count: Every option of a product together (the default) or Each cart line on its own.
- Show the buyer’s price for each quantity on product pages: the quantity table, on by default.
- Price label: shown beside the price for wholesale customers, such as “Wholesale price”. Empty shows nothing.
- FluentCart Pro Dynamic Pricing: see below. It only matters while Dynamic Pricing is on.
Set Prices on a Product
The Wholesale pricing screen has a This product panel, and one panel per option when the product has more than one. Click Add price row for each price, then Save. Each row has:
- Who: a wholesale role, or Everyone (quantity break).
- From quantity: the price applies from this many units.
- Price rule: % off, Amount off per unit or Fixed unit price.
- Amount: in your store currency, or the percentage.
Rules apply to the price the shopper would otherwise pay, which is the sale price while a sale runs. An option without rows of its own uses the product’s rows. Subscription options keep their own price and get no panel.
Example: a role row for Wholesale customer at 20% off from 1 unit, plus an Everyone row at 10% off from 10 units. A wholesale buyer pays 20% less on any quantity, and anyone buying 10 or more gets 10% off.
Rows for Everyone start at 2 units, so single-unit prices stay public. A row that would raise the price is skipped, and rows with no amount are dropped when you save.
Which Price Applies
- Levels: an option’s own rows, then the product’s rows, then the store-wide discount. Each role takes its prices from the first level that has rows for it.
- Tiers: the row with the highest From quantity the cart reaches.
- Several roles: the buyer pays the lowest price any of their roles, or an Everyone break, gives for that quantity.
- Quantity: by default every line of a product counts together. With Each cart line on its own, lines of the same option still count together, so one option split into several lines by add-on choices reaches its tier.
- Sales: rules start from the Sale Campaigns price while a campaign runs.
- Never higher: a wholesale price is only used when it’s lower than the price the shopper would otherwise pay.
- Guests and other customers: public prices, apart from quantity breaks for Everyone.
What Buyers See
- Product pages and cards: the buyer’s price, with the public price struck through, and the price label if you set one.
- Products with options: “Your price from” and the lowest wholesale price.
- Quantity table: a “Price per unit” table under the price, with rows such as “2 to 9” and “10 or more”. It follows the option picker, and shows only when the price changes with quantity.
- Cart and checkout: each line says which tier priced it, such as “10+ unit price”, or your price label.
- Orders: the tier stays on the order item, and the order gets one “Wholesale pricing” note.
Prices are worked out on the server on every cart change and again at Place order. If a price moved in between, for example because a role was removed or a sale ended, the buyer sees “Some prices in your cart have changed. Please review your order and place it again.” The second try goes through at the new price.
Add-ons and Other Price Changes
- A line with Product Add-ons starts from the buyer’s wholesale price for the counted quantity, with the add-ons charged on top. It counts toward the tier, carries the tier label and the order note, and is kept out of Dynamic Pricing like other wholesale lines. The live total on the product page uses the buyer’s price and quantity breaks.
- These are left at their own price: Pay What You Like products, gift card products, order bump offers, invoice lines and subscriptions.
FluentCart Pro Dynamic Pricing
Dynamic Pricing’s role and quantity rules are checkout discounts. By default, a line priced by Wholesale Pricing gets no Dynamic Pricing discount, so a buyer never gets both on the same line. Dynamic Pricing fees still apply. Choose Dynamic Pricing discounts apply on top to let them stack.
Currencies
Enter amounts in your store currency. With Multi-Currency Checkout, a percentage applies to the price in the buyer’s currency, including fixed prices you set there, and amounts are converted. With FluentCart’s own multi-currency, the line is converted from its wholesale price in the store currency.
Limits
- Up to 30 rows per panel.
- Option panels only appear for products with two or more options.
- Amounts are in the store currency only.
- An amount off can bring a price down to 0.
- The Wholesale customer role stays after you turn the module off. Your price rows stay saved too.
- With the module off, lines it priced go back to the catalog price on the next cart change. At Place order the order is refused once with “Some prices in your cart have changed”, and the next try goes through at the catalog price.
- To hide prices from guests altogether, use Hide Price Until Login. For minimum order quantities, use Min/Max Quantity.
For Developers
| Hook | Type | Use |
|---|---|---|
gtfc/wholesale_pricing/viewer_roles | filter | The wholesale roles a viewer is priced with: ($roles, $user). Return an empty array for public prices. |
gtfc/wholesale_pricing/skip_item | filter | Leave a cart line at its own price: ($skip, $item). |
gtfc/wholesale_pricing/public_price | filter | The price in the store currency that rules start from: ($price, $variation), in cents. |
gtfc/wholesale_pricing/table_html | filter | The quantity table’s HTML: ($html, $rows). |
Price a customer by a user meta flag instead of a role:
add_filter('gtfc/wholesale_pricing/viewer_roles', function ($roles, $user) {
if ($user && get_user_meta($user->ID, 'trade_account', true)) {
$roles[] = 'gtfc_wholesale';
}
return array_unique($roles);
}, 10, 2);
Rows are stored in the _gtfc_wholesale_pricing product meta, and a priced cart line carries other_info.gtfc_wholesale.