Erste Schritte mit dem Regel-Manager

  Zuletzt aktualisiert: 

  Leider ist das hier dokumentierte Produkt derzeit nur in englischer Sprache erhältlich.

 

  This feature is available to merchants using our TRU Connect gateway.

The Rule Manager allows you to create your own customised Rules (or activate/deactivate pre-defined system rules) on your site references.

For example:

  • Send email notifications to you and your customers.
  • Submitting a notification to your system when a transaction has been processed on your site.
  • Cancelling or suspending a transaction based on the outcome of certain checks performed.

  Required user roles

Admin, Developer


  How to access

Rules are configured separately for each site reference you have access to.
Select your site from the “Sites” page and click the “Rule Manager” icon.

 

Process overview

When configuring Rules on your account, you will first need to understand Conditions and Actions:

portal-condition-en.png

A Condition defines the circumstances under which an Action will be performed.

(e.g. The Condition could be: for all successful Visa authorisations)

portal-action-en.png

Trust Payments will perform an Action when all criteria of a Condition have been met.

(e.g. The Action could be: send the customer a receipt email)

portal-rca-flipped-en.png

Conditions and Actions are joined together to establish a Rule.

(e.g. The Rule could be: for all successful Visa authorisations, send the customer a receipt email)

 

Creating a Rule

To create a Rule, you must first create a Condition and an Action. Expand the drop-downs below to learn how.

  If you already have a Condition and/or Action configured, you can skip ahead to the Create Rule section.

Create   portal-condition-en.png
  1. Navigate to the Rule Manager, select the relevant Action type from the drop-down box and click “Go”.

    myst-createrule-3009-02-en.png

      Learn about the different Action types


  2. Click “Add new condition”.

    portal-rulemanager-0709-01-en.png


  3. Type a unique and descriptive name into the “Condition name” text field (e.g. "successful Visa AUTH").

    myst-createcondition-3009-03.png


  4. Use the checkboxes to specify the terms under which the Action is triggered. Be aware of the drop-down boxes found above each group of checkboxes, as these determine the operation of the conditions you define here.

    • When the drop-down is set to “in” (default), the Action will be performed when the request matches any of the fields ticked in the box beneath it.
    • When set to “not in”, the Action will be performed when the request does not match the fields ticked in the box beneath it.

    myst-createcondition-3009-04.png

    e.g. If “Payment types” “in” “American Express”, “Mastercard” and “Visa”
    The Action will only be performed when the customer uses any of the aforementioned payment types.

      When creating a Condition, ensure that you specify at least one Request type and Error code. Failure to do so may cause unexpected issues.


  5. When you have finished setting up the Condition, click “Save”.

Create   portal-action-en.png
  1. Navigate to the Rule Manager, select the relevant Action type from the drop-down box and click “Go”.

    myst-createrule-3009-02-en.png

      Learn about the different Action types


  2. Click “Add new action”.

    portal-rulemanager-0709-02-en.png


  3. You will be presented with a page allowing you to create a new Action. Type a unique and descriptive name into the “Action name” text field.

    The page displayed is dependent on the type of Action you are creating. For example, the following is a screenshot of the page used to create a URL notification Action

    You will need to carefully fill out the form, specifying the actions to be taken when the Condition is met.

    myst-createaction-3009-01-en.png

    When configuring an Action, we recommend having the documentation for the Action type to hand to better understand the different fields being displayed on screen, and also to learn about additional steps you may need to take that are specific to the Action type you have selected.

      Open the Action type documentation in a new tab.


  4. When you have finished setting up the Action, click “Save”.

Create   portal-rule-en.png
  1. Navigate to the Rule Manager.


  2. From the top of the page, select the site reference for the Rule to be applied to. For new Conditions and Actions, you should select your test site reference, allowing you to test before deploying to your production environment. Once you have completed testing, you can repeat these steps to recreate the same rule on your live site reference.

    myst-createrule-3009-01-en.png

      Each Rule created is assigned to the one site reference you select here. To apply a Rule to multiple site references, you will need to recreate it for each site reference by following these steps again.


  3. Select the relevant Action type from the drop-down box and click “Go”.

    myst-createrule-3009-02-en.png

      Learn about the different Action types


  4. Use the drop-downs provided to assign a Condition to an Action. Then click "Create rule" to save.

    portal-rulemanager-0709-03-en.png

      New rules are set to status "Active" immediately upon creation, meaning they will start acting on all relevant requests from then onward. Please be mindful of this behaviour when saving any new rules to a live site reference.

      If you do not see any Conditions and Actions in the drop-down boxes, you will need to create some by following the instructions in the sections above.

    The drop-downs only contain Conditions and Actions you have created previously.
    You cannot see Conditions and Actions created by other users.


When a rule is added successfully, this is confirmed with a green success message displayed at the top of the page and the on-screen table will update to show the new rule:

portal-rulemanager-0709-04-en.png

 

  Video tutorial

War dieser Artikel hilfreich?
0 von 0 Personen fanden dies hilfreich