Developer Guide > Ecommerce Partners & Platforms >Opencart 3 – Payment Plugin
Guide to install Openpay Payment Gateway & Assests to Opencart 3.
Est. integration time:
How can I add Openpay to my Opencart 3 store?
A complete step-by-step guide on how to install and configure Openpay app.
By adding all informative assets helps promote the use of Openpay throughout your site or store.
Sign up for a live account and you're all set to take payments.
This guide describes how to install and configure the Openpay Payment Gateway Extension to OpenCart. You should have an existing OpenCart installed.
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.
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: http://docs.opencart.com/requirements/
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.
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
- Readme.md (have information about that module)
Upload the module folder “admin,catalog,vqmod” along with all the files into the OpenCart root directory
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:
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’.
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.
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.
Shows the placement of all the Openpay widgets and assets. You can test an Openpay plan creation on this site.
Openpay Demo Site
Take a test drive of our demo e-comm site and see how Openpay widgets and assets are set on an ecommerce website and understand end-to-end customer journey.
This section provides the credentials for test user and test merchant account on Openpay Training Environment to create and check your Openpay plan.
Username: [email protected]
Please note: Openpay does not provide LIVE / Production test credentials. Our team is happy to test and certify your LIVE / Production site.
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
Updated 3 months ago