Checkout for OpenCart

This guide describes how to install, configure, and use the Checkout webshop module for OpenCart 2.3.

Compatibility: Opencart 2.3+

Latest version: 1.1.2 (2022-03-20)

Before you start

Before you start, you need an Checkout Portal account. See the guide Create account for more information about creating a free test account.

Download

Checkout for OpenCart 2.3 (zip)

Source

Checkout for OpenCart 2.3

Overview

Our OpenCart plugin is the perfect extension to enable the Checkout checkout to its full potential for your OpenCart store. Checkout supports most popular payment methods.

You may see below all the payment methods offered by Checkout. This list refers to all markets.

Depending on your country or region, the list may vary. If you are uncertain about a specific payment method and whether it is available in your country or region, please contact Support for more information.

Apple Pay configuration for OpenCart plugin is described on the Apple Pay payment method page.

Shop features

The fast checkout with "remember me" functionality.
Embedded checkout for an optimized user experience. Users are not redirected outside OpenCart.
A smart mix of payment methods to suit all preferences.
Multiple checkout languages and currencies for selling in your domestic market and abroad.
Fully syncronized payment statuses in admin order page with Checkout portal.
Intuitive order management with synchronized captures and refunds from admin order details page.
Custom webhook events for real-time payment statuses.
Custom Build-in debugging features.

The following screenshot shows a checkout page provided by the Checkout module:

Admin panel features

Quick setup and flexible configuration.
Intuitive order management with synchronized captures and refunds.
Compatibility with discounts, tax (VAT), and shipping options.
Compatibility OpenCart Multi-Store setups.

The screenshot below shows the settings page for the Checkout module:

Installation

Follow the step below to install the Checkout module in Opencart.

Step 1: Install module

You have two options when installing the Checkout module for OpenCart:

Alternative 1:
1. Download the plugin archive: https://github.com/Nets-eCom/opencart2.3_easy/archive/refs/heads/master.zip.
2. Extract all files to your OpenCart installation directory.
Alternative 2:
1. Install modman by running the command git clone https://github.com/sitewards/modman-php or simply copy the modman-php files into the OpenCart root directory.
2. Install the Checkout module files by running the command php modman.php clone https://github.com/Nets-eCom/opencart2.3_easy.

Step 2: Refresh Opencart Admin

Navigate to Modifications in OpenCart Admin.
Click the Refresh button.

The module is now installed and ready to be configured for your Checkout account.

Configuration

After installing the module, you need to do some basic configuration of the module:

Navigate to Extensions and choose the extension type Payments.
Locate the Checkout module and press the Edit button to access the configuration.
Fill out the required fields, such as merchant ID and integration keys (secret keys and checkout keys).
(Optional) Customize the module according to your needs using the additional settings on the configuration page.

Both the merchant ID and the integration keys can be found in Checkout Portal. See the following pages for more help:

The screenshot below shows the configuration page for the module:

The following table lists all the settings you can configure in the administration area for the Checkout module:

Configuration setting	Description
Nets Merchant ID	Your merchant ID which can be found in Checkout Portal.
Secret key (Live)	Your live secret key from Checkout Portal.
Checkout key (Live)	Your live checkout key from Checkout Portal.
Secret key (Test)	Your secret key for test purchases from Checkout Portal.
Checkout key (Test)	Your checkout key for test purchases from Checkout Portal.
Terms & conditions	The URL to the terms and conditions of your webshop.
Merchant Terms & conditions	The URL to the privacy and cookie settings of your webshop.
Order Status	The status that new orders will be assigned when placed through Checkout.
Shipping method	Defines the shipping method to be used.
Status	Enables or disables the module.
Checkout type	Embedded or Redirect. An embedded checkout inserts the payment window directly on the checkout page. Redirect (Nexi Group Hosted) loads a new payment page.
Test	Toggles between test mode (Enabled) and live mode (Disabled). Choose test mode if you want to make test purchases using the test environment. There are sample card numbers and invoice addresses for testing purposes. Live mode requires an approved account.
Language	The language displayed on the checkout page. Default value is English.
Webhook URL	It is the custom webhook event listener url, that handles payment statuses on your orders paid with Checkout.
Webhook Auth	Set your custom authorization password on incoming webhook event data to tighten security.
Backend Debug Mode	It displays the api request content in order detail page. Optionally activate this feature and copy/send debug content to our support in case you experience issues with your transactions.
Frontend Debug Mode	It displays the api request content in checkout page. Optionally activate this feature and copy/send debug content to our support in case you experience issues with your transactions.

🎉

Congratulations!

You've now installed and configured the Checkout webshop module. If you have further questions, please see the troubleshooting section below or reach out to our support.

Order management

Orders placed using Checkout can be managed in the Checkout portal. There you can charge, refund, or cancel payments.

It's also possible to view the status of orders placed using Checkout directly in OpenCart Admin by navigating to Sales > Orders.

All transactions performed by Nexi Group are accessible in Checkout Portal.

Troubleshooting

Below are some of the most common configuration errors, their cause and steps that you can follow to solve them.

Nexi Group payment plugin is not visible as a payment method

Ensure that the Nets plugin is available under Extensions > Payments.
Temporarily switch to the Opencart 2.3 standard template. Custom templates might need additional changes to ensure correct display. Consult with your web designer or developer.

Nexi Group payment window is blank

Ensure your integration keys in the Nexi Group plugin settings are correct and do not contain additional blank spaces.
Temporarily deactivate third party plugins that might affect the functionality of the plugin.
Check if there are any temporary technical inconsistencies: https://nets.eu/Pages/operational-status.aspx

Payments in live mode don't work

Ensure you have an approved Live Checkout account for production.
Ensure your Live Checkout account is approved for payments with the selected currency.
Ensure payment method data is correct and supported by your Checkout agreement.

Go live checklist

For more information, refer to the section Go-live checklist.