Documentation

How to Setup Your MerchantPlus NaviGate Account with OpenCart

in

OpenCart is a popular open-source shopping cart system that is designed feature rich and user friendly. Many hosting companies provide OpenCart as an installable option with their hosting packages or you can download and install the product from the OpenCart website.  Setting up your OpenCart-based eCommerce website to work with NaviGate is quick and easy.  And, with the MerchantPlus Starter account, you can offer fully-integrated credit card payments on your own website with no monthly fee.  Learn more or create your account here (instant signup) and then come back to follow this guide on how to configure OpenCart to work with NaviGate.

Setup Time: 5-10 Minutes

 

Step 1 - Configure API Settings

 

First, login to your NaviGate portal, located at https://gateway.merchantplus.com/ using the login credentials you received when your account was setup.  Then, quickly browse to the Profile & Settings section of the gateway interface.  This is where you'll configure the important bits about getting NaviGate to work with your shopping cart, as well as any email receipts or reports you want to receive via email.  You should see several sub categories on the left hand menu, but for now you can edit the settings on the main page, including:  Live/Test Mode, what email receipts are sent FROM, which email to receive administrative settlement reports and if you'd like to send customer receipts.  Please note: you must still configure email receipts under the sub menu called Email Notifications.

Scroll down to the API Settings section and click on "Edit".  Then, ensure the response is set to be delimited.  We recommend using the pipe (" | ") character as a delimiter and leaving the encapsulation character blank.  Click to save these settings.

NaviGate API Settings Configuration

Step 2 - Generate a Transaction Key

After you've configured the API settings of NaviGate, you need to generate a transaction key.  The transaction key is like a password to be used by your shopping cart when authenticating transactions it is sending to the NaviGate API.  You can only have one active transaction key at a time, so if you regenerate the transaction key, you'll need to update your ZenCart configuration.

Click to the Security sub menu and click on the "edit" button next to the Transaction Key section.  It will give you the option to generate a new transaction key -- click to generate a new key and then copy the key that NaviGate provides to you.  You should save it on a notepad or text file while you finish your configuration.

navigate_generate_transkey

 

Step 3 - Download and Install the NaviGate Module for OpenCart

 

Download the NaviGate module for OpenCart. (Right click on Opencart_NaviGate.rar and 'Save link as")

Extract the Opencart_NaviGate.rar file to your OpenCart root directory.

 

Step 4 - Enable and Adjust the Module in OpenCart Admin

 

The last part of the setup is to enable the module in your OpenCart administration area.

  • Sign in to your OpenCart admin (usually, www.yoursite.com/admin/)
  • Click the Extensions tab and then Payments sub tab
  • Under MerchantPlus NaviGate click Install and then click Edit
  • Enter your NaviGate Username into the Login ID field.
  • Enter your NaviGate Transaction Key into the Transaction Key field.
  • Select Live under  Transaction Server under  Transaction Mode
  • Select Capture under Transaction Method
  • You may leave the Total field empty.
  • Select Complete under Order Status
  • Select All Zones under Geo Zone
  • Select Enabled under Status
  • Save your changes.

 

Step 5 - Test it!

 

You've now done all the necessary steps to activate NaviGate within your OpenCart shopping cart. You should now test the  integration thoroughly. Our suggestion is to first put the gateway into TEST mode and then use our pre-defined test cards to ensure the configuration is working properly.  You can view our help guide on testing with NaviGate here.  Then, put things into LIVE mode (both in NaviGate and in OpenCart module) and test a transaction using a live card.  You can then login to NaviGate and void the transaction so it doesn't end up settling.

If you have any questions or problems setting up your OpenCart shopping cart installation with your NaviGate gateway, please simply contact the MerchantPlus support team and we'll be happy to assist you.