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.
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.
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.