Define merchant order thresholds

Last updated:
Edit on GitHub

This doc describes how to manage merchant order thresholds in the Back Office.

Prerequisites

To start working with merchant order thresholds, do the following:

  1. Go to Administration > Merchant Relationships Threshold. This opens the Merchant Relationships Threshold page.
  2. Next to the merchant relationship you want to set up the threshold for, click Edit.

Define a minimum hard threshold for a merchant relationship

  1. On the Edit Merchant Relationship Threshold page, select STORE AND CURRENCY.
  2. In the Hard Threshold pane, for ENTER THRESHOLD VALUE, enter a price value.
  3. Enter a MESSAGE for all the locales.
  4. Scroll down the page and select Save.

The page refreshes with a success message displayed.

Define a maximum hard threshold for a merchant relationship

  1. On the Edit Merchant Relationship Threshold page, select the STORE AND CURRENCY you want to configure the threshold for.
  2. In the Hard Maximum Threshold pane, for ENTER THRESHOLD VALUE field.
  3. Enter a MESSAGE for all the locales.
  4. Scroll down the page and select Save.

The page refreshes with a success message displayed.

Define a minimum soft threshold for a merchant relationship

  1. On the Edit Merchant Relationship Threshold page, select STORE AND CURRENCY.
  2. In the Soft Threshold pane, select a soft threshold type.
  3. Fill the ENTER THRESHOLD VALUE field.
  4. Based on the threshold type you have selected:
    • For the Soft Threshold with fixed fee, enter a Enter fixed fee.
    • For the Soft Threshold with flexible fee, enter a Enter flexible fee.
  5. Enter a MESSAGE for all the locales.
  6. Select Save.

The page refreshes with a success message displayed.

Reference information: Define merchant order thresholds

ATTRIBUTE DESCRIPTION
STORE AND CURRENCY Defines the store to which the threshold is applied and the currency in which it is displayed.
ENTER THRESHOLD VALUE Depending on the threshold type, defines the value that should be reached or not reached.
MESSAGE Short message that informs the customer about the threshold conditions. For example, You should add items for {{threshold}} to pass a recommended threshold. You can’t proceed with checkout.

Enter {{threshold}} or {{fee}} to reference the threshold name or the defined fee respectively. When the message is rendered on the Storefront, the placeholders are replaced with the values from Enter threshold value and Enter flexible fee or Enter fixed fee fields.
ENTER FIXED FEE Adds this value to cart if the threshold is not reached.
ENTER FLEXIBLE FEE Percentage of an order’s sub-total that is added to cart if the threshold is not reached.

Tips and tricks
In the MESSAGE field, enter {{threshold}} or {{fee}} to reference the threshold name or the defined fee, respectively. When the message is rendered on the Storefront, the placeholders are replaced with the values from ENTER THRESHOLD VALUE and Enter flexible fee or Enter fixed fee fields.