Skip to content
English
  • There are no suggestions because the search field is empty.

Create a new rule

Before you create a rule, set objects, fields, and value sets applicable to this account.

To create a new rule, follow the steps below:

  1. Go to the Smart Routing tab.

  2. Select the required flow.

  3. Follow any of the steps below:

    1. Select Add Rule in the rule menu.

    2. Select +Add Rule below the list of existing rules.

  4. Fill in the form to add a new rule as described in the table below.

  5. Click Add Rule.

The form for creating a new rule consists of two panes:

  • A pane of general settings;

  • A pane of rule configuration to set conditions and an expected result of the check.

The List view and Code view buttons switch the mode of the rule configuration pane from interactive to coding, respectively. You can create and edit a rule in any mode. To edit the settings in the code view, click Unlock the code to edit.

Table: Rule parameters

Parameter

Description

General settings

Rule name*

A unique name of the rule.

Description*

A description of the rule and/ or an expected result of the check.

Priority

The ordinal number of the rule in a queue of rules.

When processing a transaction, the Smart Routing service runs checking against flows and rules according to their priority set by the user. Only active flows and rules are applicable.

When a rule is created, the next ordinal number applies by default. Further on, you can edit it.

Active

The state of the flow.

Set as active when the toggle is on. When a rule is created, it is inactive by default. Further on, you can edit it.

 image-20240502-093222

 

The toggle that activates the schedule for the rule.

add new rule

Time zone

Time zone, according to which the dates and time of the rule activation/deactivation will be applied. By default, UTC + 00:00

Active from

Date and time of the rule activation.

Active to

Date and time of the rule deactivation.

Days and periods of week

The drop-down list for selecting weekdays and periods of week (weekends or Monday to Friday) for when the rule needs to be activated. By default, every day.

00:00

The field for setting up the time for rule activation on the selected day/period of week.

23:59

The field for setting up the time for rule deactivation on the selected day/period of week.

Preconditions block

If the condition in the Preconditions block is not met, the check against the corresponding rule is not performed, thus decreasing the time required for Smart Routing checks.

Field

The field (field display name) for the precondition.

Operator

A logical operator. Possible values in the drop-down list depend on fields and the settings for an account.

Value

Field value for the precondition. See more details on values in the value description in the If block.

If block

Fx

A checkbox to create a complex condition.

Field

The display name of the parameter used in checking a transaction against the rule.

Possible values in the drop-down list depend on the field settings for an account.

Operator

A logical operator or link.

Possible values in the drop-down list depend on fields and the settings for an account.

Value

A parameter value.

Possible values in the drop-down list depend on fields and the settings for an account:

  • A simple value (for example, “payment”);

  • Boolean: true/false;

  • A set (for example, “Prohibited countries”);

  • A number range in the “number-number” format (for example, “6-98”);

  • A comma-separated array of values (for example, “443448400-43448499, 43448500-43448599, 434667788”).

Period

A calendar time period.

Available for complex conditions only when Fx is selected. Possible values:

  • Current day;

  • Current week;

  • Current month;

  • Previous day;

  • Previous week;

  • Previous month.

When referring to date and time, the service applies the time zone as indicated in the PSP settings in the system.

Specify period

A checkbox to set an arbitrary time period.

Available for complex conditions only when Fx is selected.

Value of period

A number of time units when setting an arbitrary time period.

Available for complex conditions only when Specify period is active.

Unit

A time unit when setting an arbitrary time period.

Available for complex conditions only when Specify period is active. Possible values:

  • Day: last 24 hours before the check;

  • Hour: last 60 minutes before the check.

VfR

A checkbox to use a value of the parameter from a transaction request as a value of the field.

See the list of fields matching the system request parameters.

Notify of the threshold breach (% оf limit)

This option is displayed only if the complex condition is activated (Fx checkbox is selected).

Selecting the Notify of the threshold breach checkbox displays fields for inputting the percent value. Once the specified percent value of the aggregated sum or count in the complex condition is reached, the system will send notifications to the following emails:

  • To the email specified in the PSP settings in the E-mail Smartrouting field.

Please make sure you specify an email in the E-mail Smartrouting field in the back office: Admin > Settings. If the field is empty, the notifications won’t be sent.

  • To the email specified in the merchant settings in the E-mail field (only if the rule is created on a merchant account level or on a shop level and the shop belongs to the merchant).

The notification email will contain the UID of the transaction after which the specified % of limit was reached.

The maximum number of the percent values that can be specified per rule is 5.

Then block

Then (for an action flow)

A parameter to indicate an action that the payment processing system should do with a transaction.

Possible values:

  • Allow: the system will send the transaction to the next rules in the flow;

  • Force 3ds: The system will initiate 3D Secure check for the transaction. If both Force 3ds and Skip 3ds actions are assigned to the transaction as a result of the Smart Routing check, Force 3ds action will be applied;

  • Notify: The system will notify the PSP admin once the rule condition is met, the email is sent to the email address specified in the E-mail Smartrouting field in the PSP settings;

  • Reject: The system will decline a transaction;

  • Review: The system will mark a payment as a high risk transaction. It will get into the list of fraudulent transactions. If an anti-fraud email is indicated in the shop settings, the system will send a notification;

  • Skip 3DS: The system will not apply the 3D Secure check when processing a transaction. If both Force 3ds and Skip 3ds actions are assigned to the transaction as a result of the Smart Routing check, Force 3ds action will be applied.

Then use (for an object flow)

A parameter to indicate an object or a group of objects that should process a transaction.

Possible actions:

  • exclude objects: do not route transactions to the selected gateways;

  • use only these objects: to route transactions to the selected gateways only. Other gateways will not process a transaction.

Possible values in the drop-down list depend on the settings of objects for an account.

Click +Add to include several objects to the list.

*required.

The Add Rule button in the flow menuThe Add Rule button in the flow menu

The +Add Rule button under the list of flow rulesThe +Add Rule button under the list of flow rules

The Add new Rule pageThe Add new Rule page

The Unlock the code to edit button upon a rule creation in the code viewThe Unlock the code to edit button upon a rule creation in the code view

Example 1: A rule to reject all transactions over USD 5000.00

The rule parameters can be set as shown in the image below:

SR_ENG_rules add exampGeneral settings for the sample rulele1

General settings for the sample rule
Rule condition settings for the sample ruleRule condition settings for the sample rule
 
 

Example 2: A rule to reject Payment transactions, if the total processed amount per month is more than EUR 2500000. A rule with threshold breach notifications.

The rule parameters can be set as shown in the picture below:

General settings for the sample ruleGeneral settings for the sample rule

The sample rule condition settingsThe sample rule condition settings