Opencart 3

Developer Guide > Ecommerce Partners & Platforms >Opencart 3 – Payment Plugin

Guide to install Openpay Payment Gateway & Assests to Opencart 3.

Est. integration time:

2 hours

Supported countries:


How can I add Openpay to my Opencart 3 store?

Install & configure Openpay payment app

A complete step-by-step guide on how to install and configure Openpay app.

Download & Install assets and marketing assets

By adding all informative assets helps promote the use of Openpay throughout your site or store.

Openpay is live!

Sign up for a live account and you're all set to take payments.

OpenCart 3.X – Openpay Payment Plugin / Extension

Objectives and Target Audience

This guide describes how to install and configure the Openpay Payment Gateway Extension to OpenCart. You should have an existing OpenCart installed.


What is OpenCart Extension?

OpenCart is an eCommerce platform, built on open source technology, which provides online merchants with not only a flexible shopping cart system, but also control over the look‐and‐feel of the content and functionality of their online store.

OpenCart can be fully integrated with Openpay’s online payment solutions. Installing and configuring the Hosted Payment Solution module of Openpay provide a simple, secure and convenient option for connecting to Openpay’s online payment processing platform via OpenCart.


Signing up for an Openpay merchant account

In order to start taking payments through Openpay, you need to sign up and get approval for an Openpay merchant account. Once your application is approved, you can configure Openpay Hosted Payment Solution module and start taking payments.

Openpay provides a test account and users for training and testing purpose.

Installing and Configuring Openpay Payment Extension



Before installing the Openpay module, make sure that your web server meets the following criteria:

  • There should be an existing OpenCart installation on your web server. The Openpay module is compatible with OpenCart version 3.x. The installation procedure described here has been tested on OpenCart version 3.x
  • Supported Web Servers : Apache
  • SSL: A valid security certificate is required to work over a secure channel (HTTPS) from the OpenCart Admin Panel or while submitting the form data from the store‐front. Self‐signed SSL certificates are not supported
  • MySQL database with sample data
  • At least 5.6 or the later version of PHP, MySQL and web browser
  • Curl (version 7.20.0 ‐ 7.44.0)

For further details on PHP compatibility, MySQL, supported Web servers and other requirements, refer to the OpenCart website:

Running OpenCart on a Windows server

OpenCart can be run on a Windows server, although this is not officially supported by OpenCart. Please visit the OpenCart website for details.

For this module, Vqmode needs to be installed earlier within the OpenCart setup.

Installation Steps

To install the extension, download and extract the zip file.

The folder contains the required files and folders that are listed below:

  • Upload folder => containing admin,catalog,vqmod folders
  • (have information about that module)

Upload the module folder “admin,catalog,vqmod” along with all the files into the OpenCart root directory

Admin Setup

Log in to your OpenCart admin account

Navigate to System > Users > User Groups > Edit ‘Administrator’ > Select installed module ‘extension/payment/Openpay’ in Access Permission and Modify Permission Section > Save

Extensions > Extensions > Choose the extension type > Select ‘Payment’ from the dropdown > Openpay > Install

Then click on Edit button

Populated the fields for Openpay Payment as follows:


Openpay configuration

  • Status: Enabled

  • Country: Set it to Australia.

  • Jam Auth Token: Please enter Jam Auth Token provided by Openpay or
    Use the Test Jam Token below for testing:

  • Sandbox Mode: If the website is live then set it to ‘No’. If the website is under production or under development, then set it to ‘Yes’.

  • Minimum Order Amount: Will populate once Update Min Max button is clicked.

  • Maximum Order Amount: Will populate once Update Min Max button is clicked.

  • Run Min Max: Click ‘Update Min – Max’ to get the min-max amount.
    (Order amount should be greater than minimum and less than maximum to enable Openpay payment method on the frontend of your site. This value is displayed on the on Jam Token provided.)

  • Click on ‘Save’.

How does Openpay work on your site

If the customer chooses to checkout with items that are worth less than the total amount provided in the admin total, then Openpay will not show in the ‘Payment Method’.

If the amount is greater than the Minimum Order Value and Less than the Maximum Order Value which is set on admin configuration, it will allow the users to pay using Openpay Payment Method.

Click on the ‘Continue’ tab, and the Order Confirm Order Option will be shown.

Click on the ‘Confirm Order’ and it will be redirected to the Openpay Payment Gateway page. This will perform a HTTP POST request to Openpay and redirect user to Openpay to complete payment.

Openpay Plan Creation

Learn more about Openpay plan creation journey


Use our test customer

Username: [email protected]
Password: Testing123 (DO NOT reset the password)

Once the plan is successfully submitted in Openpay, you will be redirected back to retailer site - order confirmation page.

Demo Site

Shows the placement of all the Openpay widgets and assets. You can test an Openpay plan creation on this site.

Test Credentials

This section provides the credentials for test user and test merchant account on Openpay Training Environment to create and check your Openpay plan.


Test Credentials

Test JamAuthToken for payment plugin config

JamAuthToken: 30000000000001183|abfea8e7-9c15-4889-bc44-0df8a05ad73c

Test User for creating a plan on Openpay

Username: [email protected]
Password: Testing123

Test Retailer’s Account to check plan created on Openpay’s Retailer’s Portal
Username: adminopencart
Password: Test123

Please note: Openpay does not provide LIVE / Production test credentials. Our team is happy to test and certify your LIVE / Production site.

OpenCart Order Status


After successful payment order status will be ‘Processing’.


If the order is shipped or dispatch by the admin, then orders status change to complete.


If the order is cancelled by an admin user.


If the order is fully refunded by an admin user, then orders status change to Refunded.

Please note: A full refund on Openpay plans can be made from your OpenCart website backend, but OpenCart does not allow a partial refund. To make a partial refund on Openpay Plans use the special login credentials below to login to OpenpayRetailer Portal.

Below is the detailed order status to share with your staff who look after orders, dispatch and refunds.


Refund can be done easily from the Admin panel of OpenCart.

Admin can check the placed order in the admin area from Sales > Order > Order list

Select the Openpay order you wish to refund and click Edit.

Under ‘Add Order History’ > Order Status > select ‘Refunded’ on the dropdown menu and click ‘Add history’ button.

The order will be refunded back to the customer’s account automatically.


Navigate to Extensions> Extensions > Select ‘Payment’ from Choose the extension type dropdown > Openpay > Uninstall

Did this page help you?