Setting up payment routing by item
Background |
---|
Before starting this tutorial, make sure you understand the following topics from the Quick start section:
|
After you understand the complexities of payment routing by item (see How do I route all transactions with a specific item to a relationship?), you are ready to set it up.
To set up payment routing by item
-
Work with Integrations Support to set up your Nexio account and merchant accounts (MIDs) so that they are optimized for payment routing by item.
In general, this means having a single API user with a MID that contains the specific relationship (merchant account provider, processor, or acquirer/bank) that applies for the item routing as well as one or more additional relationships for cases where that item is not in the request.
-
Open the Nexio Dashboard and log in.
For the sandbox: https://dashboard.nexiopaysandbox.com
For production: https://dashboard.nexiopay.com -
Navigate to Settings > Payment Routing.
The tab shows user accounts and the types of rules.
-
Locate the user account that you want to add to or modify item routing rules for. Click that row in the table.
The Payment Routing Rules page displays.
-
Click Add New Rule.
The Add Routing Rule dialog displays.
-
Select Item Routing as the rule type and then select the MID you want to add this rule to.
For example, select MID #1.
-
Specify one or more attributes for the item routing rule.
For example, if you have a CBD item in your catalog (where
data.cart.items[n].item
contains the text 'CBD') and want to route any transactions with that item to a specific gateway that is associated with MID #1, do the following:Example Rule 1a:
If `Item` `Contains` `CBD`
You may also want to add a second rule in case the text is lowercase:Example Rule 1b:
If `Item` `Contains` `cbd`
Alternately, you can create only one rule if you use a regular expression that matches on the letters "cbd" in the item, regardless of the case of any of the letters, such as the following:Example Rule 2:
If `Item` `RegEx(ECMAScript)` `[c|C][b|B][d|D]`
-
You can then add more attributes if you want. For a rule with multiple attributes, the system only matches when ALL the specified attributes match.
-
When you are done creating the rule, click Save.
-
For the transaction request, configure the API as follows.
Each payment request must include the following parameters for item routing:
data.amount
data.currency
data.cart.items[n]
Updated 8 months ago