Nexi Checkout for OpenCart
This guide describes how to install, configure, and use the Nexi Checkout webshop module for OpenCart 3.0.
Before you start
Before you start, you need an Nexi Checkout Portal account. See the guide Create account for more information about creating a free test account.
Overview
Our OpenCart plugin is the perfect extension that enables you to use the Nexi Checkout to its full potential for your OpenCart store. Nexi Checkout supports most popular payment methods.
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 Nexi 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 Nexi 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.
- Compatiblility OpenCart Multi-Store setups.
The screenshot below shows the settings page for the Nexi Checkout module:
Installation
Follow the step below to install the Nexi Checkout module in Opencart.
Step 1: Install module
You have two options when installing the Nexi Checkout module for OpenCart:
- Alternative 1:
- Download the plugin archive: https://github.com/Nets-eCom/opencart30_easy/archive/refs/heads/master.zip.
- Extract all files to your OpenCart installation directory.
- Alternative 2:
- Install modman by running the command
git clone https://github.com/sitewards/modman-phpor simply copy the modman-php files into the OpenCart root directory. - Install the Nets Easy module files by running the command
php modman.php clone https://github.com/Nets-eCom/opencart30_easy.
- Install modman by running the command
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 Nexi 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 Nexi 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 Nexi 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 Nexi Checkout module:
| Configuration setting | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Secret key (Live) | Your live secret key from Nexi Checkout Portal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Checkout key (Live) | Your live checkout key from Nexi Checkout Portal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Secret key (Test) | Your secret key for test purchases from Nexi Checkout Portal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Checkout key (Test) | Your checkout key for test purchases from Nexi Checkout Portal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Order Status | The status that new orders will be assigned when placed through Nexi Checkout. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Allowed customer types | Configures which customer types should be accepted on the checkout page. B2C means private customers (Business-to-Consumer). B2B means business customers (Business-to-Business). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Congratulations!
You've now installed and configured the Nexi 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 Nexi Checkout can be managed in the Nexi Checkout portal. There you can charge, refund, or cancel payments.
It's also possible to view the status of orders placed using Nexi Checkout directly in OpenCart Admin by navigating to Sales > Orders.
All transactions performed by Nexi Group are accessible in Nexi 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 the Nets plugin is available under Extensions > Payments in the extensions configuration.
- Temporarily switch to the OpenCart 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 Nexi Checkout account for production.
- Ensure your Live Nexi Checkout account is approved for payments with the selected currency.
- Ensure payment method data is correct and supported by your Nexi Checkout agreement.
Go live checklist
For more information, refer to the section Go-live checklist.