Looking for the v10 manual? Visit our new user's guide!
Search Descriptions Version
This article applies to: ML8

eSELECT Plus (Moneris) Payment Gateway

Obtaining your credentials:
Once you have received your activation letter/fax from Moneris, go to https://esplus.moneris.com/usmpg/activate/ as instructed. You will need to input the store ID and merchant ID provided in the email, then click on ‘Activate’. In this process you will need to create an administrator account that you will use to log into the Merchant Resource Centre to access and administer your eSELECTplus store. You will need to use the Store ID and API Token to send transactions through the API.

Once you have created your first Merchant Resource Centre user, please log on to the Interface by clicking the “eSELECTplus” button. Once you have logged in please proceed to ADMIN and then STORE SETTINGS. At the top of the page you will locate your production API Token, which you will need to configure the store as directed below:

Configuring the store:

1. In the AspDotNetStorefront admin site, go to Configuration → Advanced → AppConfig Settings

2. In the Config Search box, enter “eSelectPlus”, then click Search.

3. The following AppConfigs will need to be populated with your personal account information, obtained from eSelectPlus. Do not change the other AppConfigs unless instructed to do so!

- eSelectPlus.api_token.Live
- eSelectPlus.store_id.Live

4. Choose between US or CA in the eSelectPlus.country AppConfig. NOTE: If you're going to use the Canada integration, you will also need to change your default locale and currency.

5. Finally, go to Configuration → Site Configuration Wizard in the AspDotNetStorefront admin site and select “Moneris eSELECTplus” from the Payment Gateways section. Click the “Submit” button, and your gateway setup is complete.

Gateway Messages
Unlike most other gateways, with Moneris store admins can customize the transaction result messages that customers see when attempting to check out - things like "Authentication failed", "Card not accepted", etc through the String Resource Manager. This also allows these messages to be translated into other languages. See here for more information on doing that.

To review/edit these messages, go to the String Resource Mgr page and search for 'gw.moneris'.

Testing Notes

Moneris' test server uses a shared order number system. If an order number has ever been used by another customer on any other platform, the order will fail even if everything else about the request is valid. If you encounter unexpected errors during checkout testing, try another order number and it should go through.

Also, please note that the Moneris gateway differs from many gateways in that it does not allow voids on orders until they have been captured. Stores using delayed capture that need to cancel orders will have to do so through the Moneris terminal, or by capturing the order and then voiding/refunding it.