OpenCart Installation Guide

Last Updated: Mar 06, 2017 02:21PM CST
The following is needed before you get started:
Working Installation of OpenCart
Web Server (Apache suggested)
PHP 5.3+
Database (MySQLi suggested)
SSL/HTTPS setup — to keep customer data safe (not required if testing sandbox accounts)

Installation Steps

This guide assumes that a version of OpenCart is already installed and running. 

Important: A backup of the site should be taken before installing new software or making any changes. 

1. Download Artifact and unzip the latest release from here: https://github.com/simplifycom/simplify-opencart-module/releases/latest.

2. Upload the contents of the 'upload' folder (in the downloaded Simplify files) to the root directory of the OpenCart installation. 

3. As of version 1.1.0 this is the upload folder containing the following folders (Simplify → src → upload) - 'admin', 'catalog' and 'system'. These are new files and no files should be overwritten. Windows and Mac will merge folders of the same name.

4. Login to the OpenCart administration application. 

5. Go to System → User Groups and click on administrator. Make sure the box is ticked for the payments/simplifycommerce options in both access and modify permissions like the screenshot below.

6. From the menu select Extensions → Payments on the left hand side menu.

7. From the list of Payment extensions click the 'install' (green box) link next to Simplify Commerce and then click the 'edit' (blue box) link. The Simplify Commerce setup page will show up on screen.

8. Select between using live mode or test payments using the sandbox.

9. Choose the Payment Mode. See Hosted Payments for more information.

10. If using the Hosted Payments mode, choose the desired button color.

11. Enter the public and private API keys into the appropriate fields for the live and sandbox mode. For information on API keys click here
Note: When using Hosted Payments, an API key pair must be created which has Hosted Payments enabled

12. Your API keys can be found from the menu setting on Simplify Commerce:

13. The API keys are as follows:

Live Private API Key – This is the live key found on the API Keys section for live payments. SSL is needed.
Live Public API Key – This is the live key found on the API Keys section for live payments. SSL is needed.
Sandbox Private API Key (Test Mode) – Sandbox must be enabled to use this field.
Sandbox Public API Key (Test Mode) – Sandbox must be enabled to use this field.

14. Enter a Payment Title. This will be the name shown to the users on the checkout form.

15. Map the Successful and Declined status to suit the workflow being used. This does not affect the Simplify Commerce configuration.

16. Enable or Disable the plugin using the Status dropdown.

17. If using multiple Payment Providers, the Sort Order can be used to configure how they're shown on the checkout form.

18. Save the changes and then the Simplify Payments option should be visible on the checkout page:

19. If the standard payment mode checkout form is being used the next step should look like this:

20. If Hosted Payments mode is enabled, the customer will be presented with a button to confirm the order which when clicked will launch a secure form where the customer can input their card details.

21. If the website has an SSL certificate with HTTPS enabled, then the form will be overlayed on top of the existing webpage. Otherwise the user will be taken to a secured page in a new window. When the customer completes the payment, they will be taken back to the success page.

22. The merchant is now set up to take payments using the Simplify Commerce Extension.


Possible Pitfalls

The default username/password combo to log into phpMyAdmin is 'root' and whatever password that was used when installing OpenCart originally.

Make sure the keys are correct and if the hosted payment module is being used, make sure the API keys are enabled for hosted payments in the Simplify Commerce Account. 

The whole directory layout changed in version 2.1 of opencart so the plugin will not work on or after this version.

Make sure the version of the Simplify extension is the latest version if version 2+ of opencart is being used.

If there are permission issues when trying to edit the extension make sure the user group has permissions necessary (as can be seen in step 7 above). 

Frequently Asked Questions

Where can I find the OpenCart page for downloading the plugin? 
The page can be found here.

Is Simplify Commerce bundled with OpenCart?
No, it does not come pre-bundled with OpenCart, it will have to be installed using the instructions above.

Is Simplify Commerce Supported on the latest version of OpenCart?
The Versions of OpenCart that are supported with the specific Simplify Commerce extension can be found here.


Contact Us

seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found