Create a routing rule
Send certain payments to a provider you choose, with a fallback provider, measure a rule's effect on your latest payments, then test the routing.
A routing rule sends the payments that meet its conditions to the provider of your choice, for example Orange Money in Cameroon to a cheaper connection.
The owner, an Administrator, a Developer or a custom role with Manage settings or Manage developer settings creates rules; View settings is enough to read them, not to run the preview or the simulator. Rules are part of the Growth, Scale and Enterprise plans: with Pay as you go, the tab does not appear. They only exist in Live, and no security code is asked for. You need at least one connected provider.
The steps
Step 1, Open the dialog
In Live, open Orchestration, the Routing rules tab, then Create rule. With no connected provider, the page shows Connect a provider first.
Step 2, Name the rule
Enter a Rule name that says what it does: the list and the simulator show it.
Step 3, Choose the provider
Under Route to provider, choose the connection that will take these payments. The optional Fallback provider is tried right after it if it fails, and in its place when it cannot take the payment.
Step 4, Set the conditions
Under Conditions, fill in what matters among Country, Channel, Currency, Minimum amount and Maximum amount, the last two in the payment's currency. An empty condition accepts every value, and the rule only applies when all of them are met. Advanced conditions adds Time windows, Customer segments, Metadata filters and Frequency caps, and Tags that only help you find the rule again.
Step 5, Measure the impact
Under Preview impact, click Run preview. Your payments from the last 7 days are replayed: the panel says how many would have gone to another provider, provider by provider.
The preview gives the most the rule can move, not a forecast. Step 6, Create the rule
Leave Active on, then click Create rule. The message Routing rule created successfully. appears, and the rule takes its place in the list.
Rule order
A payment goes to the first rule in the list that matches it: the highest priority first, then, at equal priority, the one with the most conditions. Move up and Move down move a rule, and every priority is then renumbered from the top. Rules with the same priority and as many conditions share the payments according to their Weight. Which rule wins explains the ranking, and The most specific instruction goes first says what decides when no rule matches.
Each row shows the matching payments over 30 days and their acceptance rate. Its menu offers Edit rule and Delete rule: the payments it targeted then follow your other rules, then the channel's policy, then the priority of your connections.
Testing the routing
Test routing opens the Routing simulator. Choose one of the Quick scenarios, or a Payment channel and an Amount with its currency, then click Run simulation. The result gives the provider tried first, the order of the next ones, the connections set aside under Left out with their reason, and the Decision log. Nothing is charged. The simulator says what it cannot reproduce.