ProPluginsLab Docs

Pro plugin Version 1.0.3 Updated

Mercenza - B2B for WooCommerce documentation

Mercenza turns a WooCommerce store into a trade counter. Buyers apply for an account, you approve them, and from that moment they see their own prices, their own minimum quantities, and only the products you want them to see.

Try the live demo Get Mercenza

Overview

Mercenza turns a WooCommerce store into a trade counter. Buyers apply for an account, you approve them, and from that moment they see their own prices, their own minimum quantities, and only the products you want them to see.

Requirements

  • WordPress 6.4 or later
  • PHP 7.4 or later
  • WooCommerce 8.2 or later
  • Required plugins: woocommerce

Installation

Download Mercenza - B2B for WooCommerce from your ProPluginsLab account, then upload it to WordPress.

  1. Log in to your ProPluginsLab account and open My Account > Downloads.

  2. Download the plugin zip file.

  3. In your WordPress admin, go to Plugins > Add New Plugin > Upload Plugin.

  4. Choose the zip file, click Install Now, then Activate.

License and automatic updates

Mercenza works fully as soon as it is activated. The license key turns on automatic updates, so new versions arrive in WordPress like any other plugin update. Pro features never depend on it.

Activate your license

  1. Find your license key in My Account on propluginslab.io, in the license keys section. It is also in your order confirmation email.

  2. In WordPress, open Mercenza > License. When two or more ProPluginsLab plugins or add-ons are active on the site, WooCommerce > Licenses also appears and lists all of them in one place.

  3. Paste the key into the Mercenza - B2B for WooCommerce Pro row and click Activate. The status changes to Active and automatic updates are on.

The license screen with a license key field, an Activate button and the license status
Mercenza > License: paste the key and click Activate.

Receive updates automatically

Once the license is active, new versions of Mercenza show up under Dashboard > Updates and on the Plugins screen. Click Update now, or click Enable auto-updates in the Mercenza row on the Plugins screen and WordPress installs every future release for you.

Good to know

  • Keys are checked once a day in the background, so your site never waits for the license server. If the server is briefly unreachable, the plugin keeps its last known status.
  • An expired key or a key that is not accepted only stops updates. Mercenza keeps working. After renewing, click Check now in its row.
  • Moving to a new domain: click Deactivate on the old site first, then activate the key on the new one. The status shows Site address changed, checking until the new address is confirmed.
  • On the command line: wp ppl-license list, wp ppl-license activate <plugin> <key>, wp ppl-license check and wp ppl-license deactivate <plugin>.

Quick start

  1. Open Mercenza Dashboard

    Go to wp-admin/admin.php?page=mercenza in your WordPress admin.

  2. Open Mercenza Groups

    Go to wp-admin/admin.php?page=mercenza-groups in your WordPress admin.

  3. Open Mercenza Registrations

    Go to wp-admin/admin.php?page=mercenza-registrations in your WordPress admin.

  4. Open Mercenza - B2B for WooCommerce Pro License

    Go to wp-admin/admin.php?page=cwg-license-mercenza-b2b-for-woocommerce-pro in your WordPress admin.

#Mercenza Dashboard

Location: wp-admin/admin.php?page=mercenza

On this screen:

  • Mercenza Dashboard
  • Dashboard
  • TOP WHOLESALE CUSTOMERS
Screenshot: Mercenza Dashboard
Mercenza Dashboard

#Mercenza Groups

Location: wp-admin/admin.php?page=mercenza-groups

On this screen:

  • Mercenza Groups
  • Groups
Screenshot: Mercenza Groups
Mercenza Groups

#Mercenza Registrations

Location: wp-admin/admin.php?page=mercenza-registrations

On this screen:

  • Mercenza Registrations
  • Registrations
Screenshot: Mercenza Registrations
Mercenza Registrations

#Mercenza - B2B for WooCommerce Pro License

Location: wp-admin/admin.php?page=cwg-license-mercenza-b2b-for-woocommerce-pro

On this screen:

  • Mercenza - B2B for WooCommerce Pro License
Screenshot: Mercenza - B2B for WooCommerce Pro License
Mercenza - B2B for WooCommerce Pro License

#Customers

Location: wp-admin/admin.php?page=mercenza-customers

On this screen:

  • Mercenza Customers
  • Customers
Screenshot: Customers
Customers

#Pricing

Location: wp-admin/admin.php?page=mercenza-pricing

On this screen:

  • Mercenza Pricing
  • Pricing
Screenshot: Pricing
Pricing

#Pricing: SET AS = Price

Location: wp-admin/admin.php?page=mercenza-pricing

On this screen:

  • Mercenza Pricing
  • Pricing
Screenshot: Pricing: SET AS = Price
Pricing: SET AS = Price

#Pricing: SET AS = Amount off retail

Location: wp-admin/admin.php?page=mercenza-pricing

On this screen:

  • Mercenza Pricing
  • Pricing
Screenshot: Pricing: SET AS = Amount off retail
Pricing: SET AS = Amount off retail

#Pricing: Tiers

Location: wp-admin/admin.php?page=mercenza-pricing

On this screen:

  • Mercenza Pricing
  • Pricing
Screenshot: Pricing: Tiers
Pricing: Tiers

#Pricing: Import and export

Location: wp-admin/admin.php?page=mercenza-pricing

On this screen:

  • Mercenza Pricing
  • Pricing
  • Recent imports
Screenshot: Pricing: Import and export
Pricing: Import and export

#Pricing: Inspector

Location: wp-admin/admin.php?page=mercenza-pricing

On this screen:

  • Mercenza Pricing
  • Pricing
Screenshot: Pricing: Inspector
Pricing: Inspector

#Quotes and invoices

Location: wp-admin/admin.php?page=mercenza-quotes

On this screen:

  • Mercenza Quotes
  • Quotes
Screenshot: Quotes and invoices
Quotes and invoices

#Quotes and invoices: Templates

Location: wp-admin/admin.php?page=mercenza-quotes

On this screen:

  • Mercenza Quotes
  • Quotes
Screenshot: Quotes and invoices: Templates
Quotes and invoices: Templates

#Sales team

Location: wp-admin/admin.php?page=mercenza-sales-reps

On this screen:

  • Mercenza Sales Reps
  • Sales Reps
Screenshot: Sales team
Sales team

#Sales team: Commission rules

Location: wp-admin/admin.php?page=mercenza-sales-reps

On this screen:

  • Mercenza Sales Reps
  • Sales Reps
Screenshot: Sales team: Commission rules
Sales team: Commission rules

#Sales team: Commissions

Location: wp-admin/admin.php?page=mercenza-sales-reps

On this screen:

  • Mercenza Sales Reps
  • Sales Reps
Screenshot: Sales team: Commissions
Sales team: Commissions

#Sales team: Dormant accounts

Location: wp-admin/admin.php?page=mercenza-sales-reps

On this screen:

  • Mercenza Sales Reps
  • Sales Reps
Screenshot: Sales team: Dormant accounts
Sales team: Dormant accounts

#Sales team: Offline orders

Location: wp-admin/admin.php?page=mercenza-sales-reps

On this screen:

  • Mercenza Sales Reps
  • Sales Reps
Screenshot: Sales team: Offline orders
Sales team: Offline orders

#Settings

Location: wp-admin/admin.php?page=mercenza-settings

On this screen:

  • Mercenza Settings
  • Settings
  • General
Screenshot: Settings
Settings

#Help

Location: wp-admin/admin.php?page=mercenza-help

On this screen:

  • Mercenza Help
  • Help
  • Getting Started
  • Requirements
  • Installation
  • Admin screens
  • General settings
  • Security settings
Screenshot: Help
Help

#Rules

Location: wp-admin/admin.php?page=mercenza-pricing-rules

On this screen:

  • Mercenza Pricing Rules
  • Rules
Screenshot: Rules
Rules

#Catalog

Location: wp-admin/admin.php?page=mercenza-catalog

On this screen:

  • Mercenza Catalog
  • Catalog
Screenshot: Catalog
Catalog

Settings reference

Mercenza Registrations

SettingTypeDefaultWhat it does
STATUS select Pending (0) Options: All, Pending (0), Approved (0), Rejected (0).
SEARCH EMAIL OR ANSWERS text -

Mercenza - B2B for WooCommerce Pro License

SettingTypeDefaultWhat it does
License key text -

Customers

SettingTypeDefaultWhat it does
SEARCH text -
GROUP select Any group Options: Any group, No group, Distributor, Wholesale.

Pricing

SettingTypeDefaultWhat it does
FIND PRODUCTS search -
Distributor checkbox on
Wholesale checkbox on
GROUP select Distributor Options: Distributor, Wholesale.
SET AS select % off retail Options: Price, % off retail, Amount off retail.
PERCENT text -
Select all on this page checkbox off
Select Brass Desk Lamp checkbox off
Price type for Brass Desk Lamp in Distributor select = Options: =, %, -.
Amount for Brass Desk Lamp in Distributor text -
Price type for Brass Desk Lamp in Wholesale select = Options: =, %, -.
Amount for Brass Desk Lamp in Wholesale text -
Select Canvas Tote Bag checkbox off
Price type for Canvas Tote Bag in Distributor select = Options: =, %, -.
Amount for Canvas Tote Bag in Distributor text -
Price type for Canvas Tote Bag in Wholesale select = Options: =, %, -.
Amount for Canvas Tote Bag in Wholesale text -
Select Ceramic Coffee Mug checkbox off
Price type for Ceramic Coffee Mug in Distributor select = Options: =, %, -.
Amount for Ceramic Coffee Mug in Distributor text -
Price type for Ceramic Coffee Mug in Wholesale select = Options: =, %, -.
Amount for Ceramic Coffee Mug in Wholesale text 12.000000
Select Classic Cotton T-Shirt checkbox off
Price type for Classic Cotton T-Shirt in Distributor select = Options: =, %, -.
Amount for Classic Cotton T-Shirt in Distributor text -
Price type for Classic Cotton T-Shirt in Wholesale select = Options: =, %, -.
Amount for Classic Cotton T-Shirt in Wholesale text -
Select Dot Grid Notebook checkbox off
Price type for Dot Grid Notebook in Distributor select = Options: =, %, -.
Amount for Dot Grid Notebook in Distributor text -
Price type for Dot Grid Notebook in Wholesale select = Options: =, %, -.
Amount for Dot Grid Notebook in Wholesale text 10.500000
Select Everyday Hoodie checkbox off
Price type for Everyday Hoodie in Distributor select = Options: =, %, -.
Amount for Everyday Hoodie in Distributor text -
Price type for Everyday Hoodie in Wholesale select = Options: =, %, -.
Amount for Everyday Hoodie in Wholesale text -
Select Leather Card Wallet checkbox off
Price type for Leather Card Wallet in Distributor select = Options: =, %, -.
Amount for Leather Card Wallet in Distributor text -
Price type for Leather Card Wallet in Wholesale select = Options: =, %, -.
Amount for Leather Card Wallet in Wholesale text -
Select Linen Tea Towel Set checkbox off
Price type for Linen Tea Towel Set in Distributor select = Options: =, %, -.
Amount for Linen Tea Towel Set in Distributor text -
Price type for Linen Tea Towel Set in Wholesale select = Options: =, %, -.
Amount for Linen Tea Towel Set in Wholesale text -
Select Pour-Over Coffee Set checkbox off
Price type for Pour-Over Coffee Set in Distributor select = Options: =, %, -.
Amount for Pour-Over Coffee Set in Distributor text -
Price type for Pour-Over Coffee Set in Wholesale select = Options: =, %, -.
Amount for Pour-Over Coffee Set in Wholesale text -
Select Scented Soy Candle checkbox off
Price type for Scented Soy Candle in Distributor select = Options: =, %, -.
Amount for Scented Soy Candle in Distributor text -
Price type for Scented Soy Candle in Wholesale select % Options: =, %, -.
Amount for Scented Soy Candle in Wholesale text 20.000000
Select cedar checkbox off
Price type for cedar in Distributor select = Options: =, %, -.
Amount for cedar in Distributor text -

Pricing: SET AS = Price

SettingTypeDefaultWhat it does
FIND PRODUCTS search -
Distributor checkbox on
Wholesale checkbox on
GROUP select Distributor Options: Distributor, Wholesale.
SET AS select Price Options: Price, % off retail, Amount off retail.
AMOUNT text -
Select all on this page checkbox off
Select Brass Desk Lamp checkbox off
Price type for Brass Desk Lamp in Distributor select = Options: =, %, -.
Amount for Brass Desk Lamp in Distributor text -
Price type for Brass Desk Lamp in Wholesale select = Options: =, %, -.
Amount for Brass Desk Lamp in Wholesale text -
Select Canvas Tote Bag checkbox off
Price type for Canvas Tote Bag in Distributor select = Options: =, %, -.
Amount for Canvas Tote Bag in Distributor text -
Price type for Canvas Tote Bag in Wholesale select = Options: =, %, -.
Amount for Canvas Tote Bag in Wholesale text -
Select Ceramic Coffee Mug checkbox off
Price type for Ceramic Coffee Mug in Distributor select = Options: =, %, -.
Amount for Ceramic Coffee Mug in Distributor text -
Price type for Ceramic Coffee Mug in Wholesale select = Options: =, %, -.
Amount for Ceramic Coffee Mug in Wholesale text 12.000000
Select Classic Cotton T-Shirt checkbox off
Price type for Classic Cotton T-Shirt in Distributor select = Options: =, %, -.
Amount for Classic Cotton T-Shirt in Distributor text -
Price type for Classic Cotton T-Shirt in Wholesale select = Options: =, %, -.
Amount for Classic Cotton T-Shirt in Wholesale text -
Select Dot Grid Notebook checkbox off
Price type for Dot Grid Notebook in Distributor select = Options: =, %, -.
Amount for Dot Grid Notebook in Distributor text -
Price type for Dot Grid Notebook in Wholesale select = Options: =, %, -.
Amount for Dot Grid Notebook in Wholesale text 10.500000
Select Everyday Hoodie checkbox off
Price type for Everyday Hoodie in Distributor select = Options: =, %, -.
Amount for Everyday Hoodie in Distributor text -
Price type for Everyday Hoodie in Wholesale select = Options: =, %, -.
Amount for Everyday Hoodie in Wholesale text -
Select Leather Card Wallet checkbox off
Price type for Leather Card Wallet in Distributor select = Options: =, %, -.
Amount for Leather Card Wallet in Distributor text -
Price type for Leather Card Wallet in Wholesale select = Options: =, %, -.
Amount for Leather Card Wallet in Wholesale text -
Select Linen Tea Towel Set checkbox off
Price type for Linen Tea Towel Set in Distributor select = Options: =, %, -.
Amount for Linen Tea Towel Set in Distributor text -
Price type for Linen Tea Towel Set in Wholesale select = Options: =, %, -.
Amount for Linen Tea Towel Set in Wholesale text -
Select Pour-Over Coffee Set checkbox off
Price type for Pour-Over Coffee Set in Distributor select = Options: =, %, -.
Amount for Pour-Over Coffee Set in Distributor text -
Price type for Pour-Over Coffee Set in Wholesale select = Options: =, %, -.
Amount for Pour-Over Coffee Set in Wholesale text -
Select Scented Soy Candle checkbox off
Price type for Scented Soy Candle in Distributor select = Options: =, %, -.
Amount for Scented Soy Candle in Distributor text -
Price type for Scented Soy Candle in Wholesale select % Options: =, %, -.
Amount for Scented Soy Candle in Wholesale text 20.000000
Select cedar checkbox off
Price type for cedar in Distributor select = Options: =, %, -.
Amount for cedar in Distributor text -

Pricing: SET AS = Amount off retail

SettingTypeDefaultWhat it does
FIND PRODUCTS search -
Distributor checkbox on
Wholesale checkbox on
GROUP select Distributor Options: Distributor, Wholesale.
SET AS select Amount off retail Options: Price, % off retail, Amount off retail.
AMOUNT text -
Select all on this page checkbox off
Select Brass Desk Lamp checkbox off
Price type for Brass Desk Lamp in Distributor select = Options: =, %, -.
Amount for Brass Desk Lamp in Distributor text -
Price type for Brass Desk Lamp in Wholesale select = Options: =, %, -.
Amount for Brass Desk Lamp in Wholesale text -
Select Canvas Tote Bag checkbox off
Price type for Canvas Tote Bag in Distributor select = Options: =, %, -.
Amount for Canvas Tote Bag in Distributor text -
Price type for Canvas Tote Bag in Wholesale select = Options: =, %, -.
Amount for Canvas Tote Bag in Wholesale text -
Select Ceramic Coffee Mug checkbox off
Price type for Ceramic Coffee Mug in Distributor select = Options: =, %, -.
Amount for Ceramic Coffee Mug in Distributor text -
Price type for Ceramic Coffee Mug in Wholesale select = Options: =, %, -.
Amount for Ceramic Coffee Mug in Wholesale text 12.000000
Select Classic Cotton T-Shirt checkbox off
Price type for Classic Cotton T-Shirt in Distributor select = Options: =, %, -.
Amount for Classic Cotton T-Shirt in Distributor text -
Price type for Classic Cotton T-Shirt in Wholesale select = Options: =, %, -.
Amount for Classic Cotton T-Shirt in Wholesale text -
Select Dot Grid Notebook checkbox off
Price type for Dot Grid Notebook in Distributor select = Options: =, %, -.
Amount for Dot Grid Notebook in Distributor text -
Price type for Dot Grid Notebook in Wholesale select = Options: =, %, -.
Amount for Dot Grid Notebook in Wholesale text 10.500000
Select Everyday Hoodie checkbox off
Price type for Everyday Hoodie in Distributor select = Options: =, %, -.
Amount for Everyday Hoodie in Distributor text -
Price type for Everyday Hoodie in Wholesale select = Options: =, %, -.
Amount for Everyday Hoodie in Wholesale text -
Select Leather Card Wallet checkbox off
Price type for Leather Card Wallet in Distributor select = Options: =, %, -.
Amount for Leather Card Wallet in Distributor text -
Price type for Leather Card Wallet in Wholesale select = Options: =, %, -.
Amount for Leather Card Wallet in Wholesale text -
Select Linen Tea Towel Set checkbox off
Price type for Linen Tea Towel Set in Distributor select = Options: =, %, -.
Amount for Linen Tea Towel Set in Distributor text -
Price type for Linen Tea Towel Set in Wholesale select = Options: =, %, -.
Amount for Linen Tea Towel Set in Wholesale text -
Select Pour-Over Coffee Set checkbox off
Price type for Pour-Over Coffee Set in Distributor select = Options: =, %, -.
Amount for Pour-Over Coffee Set in Distributor text -
Price type for Pour-Over Coffee Set in Wholesale select = Options: =, %, -.
Amount for Pour-Over Coffee Set in Wholesale text -
Select Scented Soy Candle checkbox off
Price type for Scented Soy Candle in Distributor select = Options: =, %, -.
Amount for Scented Soy Candle in Distributor text -
Price type for Scented Soy Candle in Wholesale select % Options: =, %, -.
Amount for Scented Soy Candle in Wholesale text 20.000000
Select cedar checkbox off
Price type for cedar in Distributor select = Options: =, %, -.
Amount for cedar in Distributor text -

Pricing: Inspector

SettingTypeDefaultWhat it does
PRODUCT search -
CUSTOMER search -
QUANTITY number 1

Quotes and invoices

SettingTypeDefaultWhat it does
STATUS select All statuses Options: All statuses, New (1), In review, Sent (1), Revised, Accepted, Declined, Expired, Converted.
SEARCH QUOTES text -

Quotes and invoices: Templates

SettingTypeDefaultWhat it does
NEW TEMPLATE NAME text -

Sales team

SettingTypeDefaultWhat it does
ADD A PERSON TO THE SALES TEAM search - They keep any role they already have. To add someone new, create their user account first under Users.
COMPANY search -
LOOKED AFTER BY select Nobody (remove the rep) Options: Nobody (remove the rep), Demo Admin.

Sales team: Commissions

SettingTypeDefaultWhat it does
Show select All Options: All, Pending, Paid, Void.

Settings

SettingTypeDefaultWhat it does
FIND A SETTING search -
B2B area label text B2B
Keep data on uninstall checkbox on
Developer mode checkbox off
Audit log retention (days) number 365

Help

SettingTypeDefaultWhat it does
FIND A TOPIC search -

Shortcodes

[mercenza_shop]

Shortcode registered by the plugin.

[mercenza_shop]

[mercenza_quick_order]

Shortcode registered by the plugin.

[mercenza_quick_order]

[mercenza_quote_basket]

Shortcode registered by the plugin.

[mercenza_quote_basket]

[mercenza_add_to_quote]

Shortcode registered by the plugin.

[mercenza_add_to_quote]

[mercenza_registration_form]

Shortcode registered by the plugin.

[mercenza_registration_form]

On your site

These pages show what visitors see on your site.

Screenshot: Ceramic Coffee Mug
Ceramic Coffee Mug
Screenshot: B2B
B2B
Screenshot: Quick order
Quick order

Frequently asked questions

Do retail customers see wholesale prices?

No. A price belongs to a group, and a visitor who is not in a group sees your normal WooCommerce price.

Can I hide products or a whole category from retail customers?

Yes. Set the audience on a product in its Mercenza tab, or on a product category when you edit it. Products that are wholesale only vanish from the shop, search, feeds, and the API for everyone else, and their links return a 404.

Which price wins when a customer is in two groups?

The most specific one: a price for that customer beats a group price, and a nearer group beats a parent group. The price inspector on the Pricing screen shows the decision for any product and customer.

Does it work with variable products?

Yes. Prices and tiers can be set per variation, and the variation picker shows the wholesale price.

Can I import existing wholesale prices?

Yes. Tools has CSV importers for customers, companies, sub accounts, applications, group prices, customer prices, tiers, and pricing rules, each with a dry run and an error report. There are also migrators for B2BKing, Wholesale Suite, Wholesale X, and WHOLS.

Do I need the free edition as well?

No. Pro contains everything the free edition has. If both are active, the free copy stays idle and shows a notice so you can deactivate it on the Plugins screen. Pro uses the same settings, groups, prices, and customers.

What happens when my licence expires?

The plugin keeps working exactly as before. You stop receiving automatic updates until you renew.

Can a customer ask for a price instead of buying?

Yes. Turn on quotes and choose where the button appears: next to add to cart, instead of it, or only for selected groups. Quotes can also be created in the admin and sent to a customer.