{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","img","admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"Create rulesets","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-rulesets","__idx":0},"children":["Create rulesets"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a ruleset, add rules with routing conditions, enable them, and activate the ruleset to start routing payments."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-ruleset","__idx":1},"children":["Create a ruleset"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-create-an-empty-ruleset","__idx":2},"children":["Step 1: Create an empty ruleset"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create an empty ruleset:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Merchant groups"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a merchant group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Services"]}," tab, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," next to ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Smart Routing service"]},".",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/edit-smart-routing-service.0c996803f27f0d7166354b259a23440adf3fb638534094cf710c6d80db4fa487.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If this is your first time accessing this page, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get started"]}," in the top right."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create new ruleset"]}," button.",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/create-new-ruleset.7e05480954782ec6e51e57e90dd2880c25e814e4eeaffce45ddd9f8e26baf3d1.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["New ruleset"]}," modal opens. Enter a unique name for your ruleset and optionally, add a description.",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/new-ruleset-modal.c540b132bb0613ad5d4158e451bc1ba403bdef2d0deceb8e66b904919b0019a3.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your empty ruleset is created and you're taken to the ruleset configuration screen."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also create rulesets at the merchant or site level. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/smart-routing/how-it-works#inheritance-and-hierarchy"},"children":["Learn more about ruleset inheritance and hierarchy"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-add-rules-to-your-ruleset","__idx":3},"children":["Step 2: Add rules to your ruleset"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can choose between creating an entirely new rule, or copying an existing one."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"New rule","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a new rule:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New rule"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["New rule"]}," modal opens. Enter a unique name for your rule and optionally, add a description."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to confirm.",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/new-rule.a9487aac61023323d460e84fed69c77df3802456b3d39cd32e5344ff45177a1c.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your empty rule is created and you're taken to the rule configuration screen.",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/rule-configuration.fe1e04b209ddcdf445e6a2c86d823f1c635664ce0214c38cc5a4fae6bda03424.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]},"This is where you add routing conditions. Start by setting an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IF"]}," statement:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose the first parameter."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose an operator. The possible operators vary depending on the first parameter."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a value."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Next, add a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["THEN"]}," statement:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a routing strategy:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval rate optimized routing:"]}," Select this option to route transactions based on optimised approval rates at the merchant category code and acquirer level."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Specific processor:"]}," Select a processor from the dynamic list. Options available will depend on your contract."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Volume split:"]}," Select this option to split the transaction volume across multiple acquirers. You can then use the drop-down to select your first processor and enter a percentage to allocate to them. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add processor"]}," to add another processor and percentage. Options available will depend on your contract."]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally, add a fallback ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ELSE"]}," statement:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Switch the toggle to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ON"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a routing strategy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally, tick the box to split the volume. Note that this isn't available for all routing strategies."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save rule"]}," again to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your rule is created but not yet enabled. You can switch the toggle on the left to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ON"]}," to enable it now, or do it from the ruleset details screen."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Existing rule","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To copy an existing rule:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy rule"]},". The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Copy rule"]}," modal opens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a ruleset from the drop-down. The rules belonging to that set are displayed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tick the rules you want to copy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy selected rules"]}," to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your rules are added to the ruleset."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also use the search bar on the left to search for a specific rule by name."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-enable-your-rules","__idx":4},"children":["Step 3: Enable your rules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ruleset details screen, switch a rule's toggle to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ON"]}," to enable it if you haven't already. You can enable as many rule as you like. Any rules that are left switched off won't be evaluated."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/activated-rule-in-ruleset.680e1b37709ab181d187ccb283760297e51a10131817e9ba167d1a369461ed97.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rules are automatically ordered by creation date, with the newest rule appearing at the top. During evaluation, rules are processed from oldest to newest."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your changes are automatically saved."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-enable-your-ruleset","__idx":5},"children":["Step 4: Enable your ruleset"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Still in the ruleset details screen, switch your ruleset's ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Active"]}," toggle to on."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Enable ruleset"]}," window, enter a descriptive reason."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable ruleset"]},". A success message is displayed at the top of your screen.",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/activate-ruleset.0e476fe12e5e55eeb4d59682664cb802098b3e70a3b0aa9b1804e8eaa5966576.d7f22b19.png","alt":"","withLightbox":true,"className":"screenshot","width":"","height":"","align":"center"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ruleset is now active and used to route your payments."]}]},"headings":[{"value":"Create rulesets","id":"create-rulesets","depth":1},{"value":"Create a ruleset","id":"create-a-ruleset","depth":2},{"value":"Step 1: Create an empty ruleset","id":"step-1-create-an-empty-ruleset","depth":3},{"value":"Step 2: Add rules to your ruleset","id":"step-2-add-rules-to-your-ruleset","depth":3},{"value":"Step 3: Enable your rules","id":"step-3-enable-your-rules","depth":3},{"value":"Step 4: Enable your ruleset","id":"step-4-enable-your-ruleset","depth":3}],"frontmatter":{"seo":{"title":"Create rulesets"}},"lastModified":"2026-06-25T10:36:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/smart-routing/create-rulesets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}