NS8 User Guides

Creating a Basic Order Rule

How to create a rule to manage selected orders.

What is an Order Rule?

An Order Rule is used to manage the status of selected orders. The available actions will adjust the risk level of the order and/or request SMS verification of the order. This is accomplished by changing the NS8 Status field and/or cancelling the order.

Order Rule Logic

Order Rules are run in the order they appear on the Order Rules screen from top to bottom. When an order is processed, the first rule that applies to an order is executed, and Order Rule processing is complete for that order. For example: if you have four Order Rules in place, and an order meets the conditions of the second rule, but not the first rule, that order will not be examined by the third and fourth rules.
The best practice for many eCommerce merchants would be to build Order Rules with the following priorities, however your uses may vary, so plan carefully:

  • Whitelist: Build a rule that identifies known "good customers" who have had issues with being identified as fraudulent in the past, and adjust their order risk to the appropriate level.
  • Blacklist: Build a rule that blocks orders based on selected conditions, and perform the appropriate action for those orders. This rule may be based on a variety of factors like shipping location, EQ8 Score, customer email address, or dollar amount, among others.
  • Verification: Build a rule that identifies conditions where orders should be SMS verified for customers that are not identified by the whitelist rule. This rule may be based on a variety of factors like shipping location, EQ8 Score, or dollar amount, among others.
  • Logic: Orders that meet conditions outside those outlined above would be processed by this rule or set of rules.

Order Rule Actions

Each eCommerce platform has its own unique way of processing orders and reacting to risk updates for an order. To meet the needs of customers on each platform, NS8 has developed actions for each platform as outlined in the articles linked below.

Magento Order Rule Actions

Important: There is an additional feature in Magento that is required for placing orders on hold using an Order Rule. Below the "Action to Take" drop-down menu is a toggle switch labeled "Put Order on Hold" that will cause any rule to put an order in Magento's "Holded" status.

  • Set recommendation to "Investigate": This action changes both the NS8 Status field and Recommendation to "Investigate." This action does not automatically request SMS Verification. The order will also be held if the option on the Order Rule screen to "Put Order on Hold" is turned on.
  • Set recommendation to "Cancel": This action changes both the NS8 Status field and Recommendation to "Cancel." The order will also be held if the option on the Order Rule screen to "Put Order on Hold" is turned on.
  • Set recommendation to "Accept": This action changes both the NS8 Status field and Recommendation to "Accept." The order will also be held if the option on the Order Rule screen to "Put Order on Hold" is turned on.
  • Set recommendation to "Investigate" and SMS check order: This action changes both the NS8 Status field and Recommendation to "Investigate." This action will automatically request SMS Verification. The order will also be held if the option on the Order Rule screen to "Put Order on Hold" is turned on.
  • Approve Order: This action changes the NS8 Status field to “Approved.” It also removes the Magento “Holded” status on a pending order and makes it available for fulfillment.
  • Cancel Order: This action changes the NS8 Status field to “Cancel” and changes the Magento status to ”Holded.” You will still need to cancel the order within Magento.

    PrestaShop Order Rule Actions

  • High risk - Set recommendation to “Cancel”: This action changes the NS8 Status field to “Cancel.” This action will not automatically request SMS Verification. The order will be placed on hold until you either cancel or approve the order.
  • Medium risk - set recommendation to “Investigate”: This action changes the NS8 Status field to Investigate. This action will not automatically request SMS Verification. The order will be placed on hold until you either cancel or approve the order.
  • Whitelist - accept order: This action changes the NS8 Status field to “Accept.” The order will be placed on hold until you either cancel or approve the order.
  • SMS check order: This action changes the NS8 Status field to ”Investigate. ” This action will automatically request SMS Verification. The order will be placed on hold pending SMS Verification results, unless you either approve or cancel the order.

    Shopify Order Rule Actions

  • Set order risk to ”High”: This action changes the NS8 Status field to ”Cancel. ” This action will not automatically request SMS Verification. The order will be placed on hold until you either cancel or approve the order.
  • Set order risk to ”Medium”: This action changes the NS8 Status field to ”Investigate.” This action will not automatically request SMS Verification. The order will be placed on hold until you either cancel or approve the order.
  • Whitelist: This action changes the NS8 Status field to ”Approved,” and if the order is on hold, it will remove the hold status.
  • SMS check order: This action changes the NS8 Status field to ”Investigate.” This action will automatically request SMS Verification. The order will be placed on hold until you either cancel or approve the order.
  • Cancel, refund, and restock order (for orders that do not auto-fulfill): This action changes the NS8 Status field to “Cancel.” The cancellation of the order will be passed on to Shopify and processed using your settings within the Shopify platform. Shopify's help center has more information on how the order fulfillment process works.

    WooCommerce Order Rule Actions

  • Set Recommendation to ”Investigate”: This action changes both the NS8 Status field and Recommendation to “Investigate.” This action will not automatically request SMS Verification. The order will be placed on hold until you either cancel or approve the order.
  • Set Recommendation to ”Cancel”: This action changes the NS8 Status field to ”Cancel” and also sets the Recommendation to ”Cancel.” The order will be placed on hold until you either cancel or approve the order.
  • Set Recommendation to ”Accept”: This action changes both the NS8 Status field and Recommendation to “Accept.”
  • Set recommendation to ”Investigate” and SMS check order: This action changes both the NS8 Status and Recommendation to “Investigate.” This action will automatically request SMS Verification. The order will be placed on hold pending SMS Verification results, unless you either cancel or approve the order.
  • Approve Order: This action changes the NS8 Status field to ”Approved.” The order will be placed on hold until you either cancel or approve the order.
  • Cancel Order: This action changes the NS8 Status field to ”Cancel.” The order will be placed on hold until you either cancel or approve the order.

Order Rule Conditions

Conditions identify which orders a rule is applied to. There are many fields that can be used, based on criteria like customer identities, EQ8 Score, dollar amounts, shipping location, and so on. Rules can have a complex set of criteria using "and/or" logic to determine their outcome. The image below shows a rule that will SMS verify orders originating from a university with a total price over $200.

Getting Started with Order Rules

Now that you know what an Order Rule is and how they work, there are a few other articles to review before you jump in and start building them. The first item to examine is the Order Rules screen; this is the home of the Order Rules and the screen used to display and access them. Secondly, the Create Order Rule screen is where you will build an individual Order Rule. We also have an article that demonstrates building an Order Rule that falls below a chosen EQ8 Score range.

Creating a Basic Order Rule


How to create a rule to manage selected orders.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.