Routing Rules

Sometimes you want to fine tune the orchestrator and tell it exactly what to do in special cases. That’s where rules come in.

• You can make rules that override (change) the algorithm.

• Each rule can have up to 3 conditions (and they must all be true at the same time).

• This lets you fine-tune payment routing without writing code.

To setup a rule, on your orchestrator create or edit screen, scroll down and click on "Add Rule" in the routing rules box.

In the popup, give your new rule a name and choose how important it is.

• 0 = most important → this rule runs first.

• 1, 2, 3… = less important → these rules are only checked if the higher-priority rule(s) before them don’t apply.

Next, select your conditions (each rule can use 1-3 of these conditions):

• currency = (USD, EUR, etc.)

• amount = (greater than, less than, or between numbers)

• country = / in [list] (like “US only” or “any in Europe”)

• card_brand = (Visa, MasterCard, etc.)

• card_bin = (exact number, starts with, or range)

• card_type = (credit, debit, prepaid)

• issuer = (the bank that gave the card)

• 3ds_required = true/false (does it need 3D Secure?)

• fraud_score >= (only if fraud service is turned on)

• campaign_id = (specific campaign)

• gateway_category = (type of gateway)

• time_of_day = (between certain hours)

• day_of_week = (like Monday only)

• gateway_volume_used >= % (if a gateway has used up part of its limit)

• is_subscription = true (recurring payments)

• is_initial_subscription = true (the very first subscription payment)

Rules must have at least one condition and no more than three.

Lastly, select which gateway is to best used when the conditions in this rule all return as true.

Click "Save Rule" and you're done!