When enabled, we will perform certain actions on requests processed on your site reference using rules configured on your account.
Rule types
Trust Payment Rules
Rules with a Rule ID of “STR-x” (where x is a number) are Trust Payments Rules. e.g. STR-1
We provide a number of pre-defined rules that can be activated on any of your site references (inactive by default). These rules are displayed within the Rule Manager interface in Portal and can be activated or deactivated by following the instructions outlined on this page. Trust Payments Rules are always performed before User-Defined Rules.
User-Defined Rules
Rules with a Rule ID of “UDR-x” (where x is a number) are User-Defined Rules. e.g. UDR-129
Using Portal, you can create, modify and activate your own custom rules on any of your site references.
Activating rules
Using Portal
Rules can be activated/deactivated on any of your site references by using the Rule Manager.
Click here for further information.
In the POST to Payment Pages
Rules can be activated for individual requests by submitting the unique rule identifier in the ruleidentifier field. Rules specified in the request will lead certain actions to be performed if pre-defined criteria are met (regardless of whether or not said rules are active on your site references). The following code snippet is from an HTML form where two rules – STR-1 and STR-2 – are specified:
<form method="POST" action="<DOMAIN>/process/payments/choice">
…
<input type="hidden" name="ruleidentifier" value="STR-1">
<input type="hidden" name="ruleidentifier" value="STR-2">
…
<input type="submit" value="Pay">
</form>
Replace <DOMAIN> with a supported domain. Click here for a full list.
Important: Any rule identifiers submitted (e.g. “STR-1”) must be included in the string used to generate your request site security hash. Failure to do so will result in the customer being shown an “Invalid details” error message.
