There may be cases where you don't want to use Nexio's smart routing feature and you want to send all transactions for a specific transaction currency to one specific merchant account (MID).
You can limit the routing by specifying the
processingOptions.merchantId in the transaction request (such as Run card transaction).
merchantId parameter is a unique code that Nexio assigns to each MID on your account.
Before you begin using merchantId, Nexio recommends that you understand the following notes.
When you specify a value for
processingOptions.merchantId, Nexio uses only this information to process the transaction. The system will not attempt to use any other possible merchant IDs (MIDs).
Therefore, using a specific value for this parameter means that Nexio does not attempt any other routing, even if other routing rules or paymentOptionTags have been specified in the account.
If the value provided for
merchantIdin the transaction request is invalid for the account, Nexio sends an error rather than attempt the transaction.
If the transaction would be disqualified because of the specified parameter, Nexio responds with an error message and does not attempt to process the transaction further.
Contact Integrations Support to learn the
merchantIdfor each MID on your Nexio account.
paymentOptionTags for USD as official currency in different countries MID #1 - merchantId is 100000000039 - USD currency for United States: usa - USD currency for Puerto Rico: pri - USD currency for Ecuador: ecu MID #2 - merchantId is 100000000041 - USD currency for Ecuador: ecu
Go to Settings > Merchant Management.
A list displays of all merchant accounts for your account, including the merchant ID value.
Make note of the merchant ID value that you want to use.
For the transaction request, configure the API as follows:
Each payment request must include the following parameters for payment routing with the
After you know and assign the merchantId you want to use to transaction rerquests, the following process happens for each transaction:
A consumer adds an item to the shopping cart and submits payment with a specific transaction currency.
For example, The consumer with an address in Ecuador uses a card to pay in USD.
processingOptions.merchantIdparameter is set to '100000000041'.
The Nexio system checks that the MID has support for the transaction currency.
For address in Ecuador and MID of 100000000041 MID #2 is valid because it has support for the currency.
For address in Puerto Rico and MID of 100000000041 Nexio returns an error message because that MID does not support that currency for that country.
The system routes the payment to the MID or responds with an error message.
Updated 2 months ago