Payment Router

A Payment Router is used when multiple Merchant Accounts can be used for the same campaign. A Payment Router is set up to determine which transaction is assigned to which Merchant Account based on the criteria & rules setup within the Payment Router. 


In this Article


To add a Payment Router

Processing -> Payment Routing -> +Add New


Name of the Payment Router
Select ITR Type
Initial Transaction Routing (ITR) is how an initial transaction should be handled. Any subsequent transactions will not go through the Payment Router. ITR Types:
Round Robin
Custom - (please reach out to for custom route options)
Rate Currency
Type of currency allowed on this router. One Currency per Router.
Note: the price is driven from the Offer. If currency is set in Euro, it will charge the offer price in Euro. Example: Offer A is $25 but setup on a Euro router, the customer will be charged €25.
Auto Merchant Deactivate
Automatically deactivate the route merchants that have continuous initial declines.
Set Count of subsequent initial declines to trigger deactivation
Set User to be alerted of deactivation
Criteria that must be met for Auto Merchant Deactivation: first attempt, same merchant, same route, cycle 1 and attempt 1.
Is this Payment Router Active, check if Yes


Initial Transaction Routing (ITR) Types:

Round Robin

Round Robin will transition through each merchant evenly. A, B, C, A, B, C, A...
Within Round Robin there is an additional option to "Include Declines"
  • When checked, a declined transaction will trigger the router to use the next merchant on the next transaction
  • When unchecked, a declined transaction will not trigger the router to use the next merchant. The next transaction will hit the same merchant as the previous decline
A weighted router uses percentages of transactions set on the Merchant to determine what Merchant to use. 
  • Once the merchants have been added, configure the weight on each Merchant by clicking into that Merchant Screen_Shot_2021-06-04_at_10.30.09_AM.png

If ITR = Weight

Once the merchants have been added, configure the weight on each Merchant by clicking into that Merchant

A volume router is based on the revenue of successful transactions for the month.
  • This logic will look at the volume total of what is available for the month. It will then divide what is remaining of the total and set the volume percentage across each merchant.
  • The Monthly Current Volume will include ALL transactions on that merchant (Initials & subsequent renewals OR any transaction submitted through the API and forced onto that Merchant ID)
  • Volume Calculations are calculated every 5 mins
  • Merchant Capacity must be set to use Volume Routing

Next add Merchants to the Router


Select all Merchants that belong to the Router: 


Once the Merchants have been added, Activate the Merchants by selecting Active Yes/No: 


Edit Route Merchant

Within each specific Merchant in the Router, you can set rules specific to that merchant. 


Advanced Router Options

Item Routing

If only specific merchants are allowed to sell specific Items, set those Items on the Route Merchant to limit which Merchants are available for the checkout.

Items are set on the specific Merchant Account within the Payment Router


Item Routing Logic relies on 2 configuration components: 

    1. Items to be set on the Route Merchant  
    2. Setting if the system should Force Item Routing 

Force Item Routing:

If checked, any item on the merchant restrictions are in the cart, ONLY the merchants with those Items configured will be available for use.
If no merchants are available, a validation error will display
If left unchecked, any merchants with those Items configured OR any merchants with no Item Restrictions will be used.

Business Use Case

A store sells women's skincare and CBD lotions. One merchant does not allow CBD at all and two merchants do. By setting up the Item Restrictions on the Merchant Route, if the CBD Item is in the cart, only the 2 Merchants that accept CBD are allowed


Initial Decline Routing (IDR)

Initial Decline Routing (IDR) is an optional feature which provides configuration to immediately reattempt a failed checkout payment while the customer is still within the checkout process. The goal of this feature is to improve checkout conversion by reattempting the customer on a new payment gateway to capture payment.

To activate IDR:

  1. Within the Payment Router Details, check Reattempt Initial Declined
  2. There are two configuration options with IDR: 
    1. Reattempt on a specific Merchant - if checked this will only reattempt once to a designated merchant that is selected in the dropdown
    2. Reattempt within the router a set number of additional attempts - this will put the customer back into the router logic and reattempt on an available merchant, using router logic. 

Priorities and Caps


Set MID priority to force a set amount of initials for a given timeframe

Priority Weight
First x successful transactions before it moves to the next merchant in the router.
This is a numeric value (1,2,3..) to determine which merchant order to go in.
Priority Amount
Count of initials that you want to cap on the Merchant before moving to the next priority or moving to the router settings.
Timeframe you want the Priority Amount to apply to - day, week, month, etc


Order Cap 

Set a cap on initial orders. Once that cap is hit, the merchant is disabled from the router

Order Cap Amount
Set a cap on initial orders. Once that cap is hit, the merchant is disabled from the router
Timeframe you want the Order Cap to apply to - day, week, month, etc


Order Cap trumps Priority Amount



What if I set a Merchant Priority on a Weighted Router?
Priority will be checked first. If Priority is set that merchant will be used first at the associated weight.
What if my weight does not equal 100%
Sublytics will adjust the weight based on 100% always. If you accidentally have weight set that equals 95%, Sublytics will get the weighted average to calculate to equal 100%


What happens if I Auth then add additional products then Auth again? 
The second Auth will go back to the Payment Router to determine the merchant to use. This must be done in case there are any Item Restrictions on the merchant. 
Pass merchant_id to force the second Auth on the original merchant.


Test your Route

Once you have your route set, use the test feature to ensure the transactions will route the way you intend. 

Within the Test, you can see totals, which merchant was used and why it was used, based on the rules set. 

Set the Payment Router to be used within the Campaign. See more here.

Was this article helpful?
0 out of 0 found this helpful