How to connect OpenCart to ManteIQ with the module
Upload manteiq.ocmod.zip under Extensions › Installer, install the ManteIQ Connector under Extensions › Extensions › Modules, then copy the shop address and key from its settings page into ManteIQ. It takes about two minutes, works on OpenCart 3.0 and 4, and the module only reads.
Connect in about two minutes
- 4steps: three in the OpenCart admin, one in ManteIQUpload, install, copy, paste
- ~2 minfrom the zip file to a connected shopFirst order read runs after that
- 3.0 and 4OpenCart lines, tested on 3.0.5.1 and 4.1.0.4PHP 7.2 to 8.5
What you need before you start
You need an OpenCart 3.0 or 4 shop that you can log in to as an administrator, a shop address that opens in a browser, and a ManteIQ account. OpenCart has no API for reading orders, so ManteIQ reads through a small module that you install once.
- Admin access to the shop, because you will upload and install an extension.
- The shop's own address, for example https://your-shop.com, not the address of the admin.
- A shop that is not in maintenance mode and does not block visitors with a security check.
We tested the module on OpenCart 3.0.5.1 and 4.1.0.4, and its reading code runs on PHP 7.2 to 8.5. We have not tested OpenCart 4.0.0 or 4.0.1. If you run another release and it does not connect, tell us the version.
Download the file for your OpenCart version
There is one file for OpenCart 4 and one for OpenCart 3, and both are named manteiq.ocmod.zip. Keep that name exactly: OpenCart names the extension after the file, and a renamed copy such as manteiq.ocmod (1).zip is refused with Invalid file type.
Both downloads are on the OpenCart page and on ManteIQ's Sources screen once you have an account.
Open the OpenCart pageUpload the file under Extensions › Installer
Open Extensions, then Installer, and upload the file. On OpenCart 4 the upload button is the blue one at the top right, and you then install the extension from the list. OpenCart 3 installs it as soon as the upload finishes.
Install the module under Extensions › Extensions › Modules
Uploading is only the first half. Open Extensions, then Extensions again, choose Modules in the extension type list, find ManteIQ Connector, click Install (the plus button), then Edit (the pencil button). The module makes its key at the moment you install it.
- Open Extensions › Extensions and choose Modules in the extension type list.
- Find ManteIQ Connector in the list. It sits in alphabetical order.
- Click the green plus button to install it. It turns into a red minus.
- Click the blue pencil button to open its settings page.
Copy the shop address and the key
The module's settings page shows the shop address and a key, each with a Copy button, and a status switch. Copy both. The address has to be the one your shop loads at in a browser, and the key has to be copied whole.
Paste both values into ManteIQ
In ManteIQ, open Sources (or the Your shop card while you set up), choose OpenCart, paste the shop address and the key and press Connect. ManteIQ checks the key against your shop before it saves anything, which takes a few seconds.
The first read pulls sixteen months of orders, so your first briefing has comparisons from day one. After that ManteIQ reads the shop every two hours, in pages, one request at a time. Sync now reads on the spot and shows each step.
What the module reads, and nothing else
The module answers read requests only, and it has no code that writes to your orders, products or customers. It adds one settings page and touches no theme or template.
What the ManteIQ Connector reads from OpenCart and what ManteIQ uses it for.
Orders and catalog
Customers
When OpenCart does not connect: causes and fixes
Most failed connections come down to one of five things, and ManteIQ names the one it found. Match the message you see in the table.
The messages ManteIQ and OpenCart show when the module does not connect, with the fix for each.
In ManteIQ
- Cause
- The key in ManteIQ is not the one the module holds now. Someone pressed Make a new key, or the key was copied only in part
- Cause
- The address answers, but the module does not. The file was uploaded and never installed, or the address is the admin's
- Cause
- The status switch on the module's page is off
- Cause
- Maintenance mode, or a security check in front of the shop, answered in place of the module
In OpenCart
- Cause
- The browser renamed the download, for example to manteiq.ocmod (1).zip
A challenge page from Cloudflare or another firewall reads exactly like a refused key. ManteIQ names the firewall when it can and shows the allow rule to add.
How to pause, replace or remove the module
You can pause the reads, replace the key or remove the module at any time, and each one takes effect at once.
- To pause, switch the module's status off. ManteIQ stops reading, and the module stays installed.
- To replace the key, press Make a new key. The old key stops working immediately, so paste the new one into ManteIQ.
- To remove it, uninstall the module under Extensions › Extensions › Modules. Its key is deleted and the reads stop.
- To disconnect on our side, use Disconnect in ManteIQ, which destroys the key we stored. Deleting your ManteIQ account removes the stored data too.
Questions about the OpenCart module
- Why do I need a module to connect OpenCart?
- OpenCart has no API for reading orders. Its built-in API belongs to the admin's order editor: it creates orders and cannot list them. The module adds a read-only way in, and that is all it does.
- Which OpenCart versions does the module work with?
- OpenCart 3.0 and 4. We tested 3.0.5.1 and 4.1.0.4, and the reading code runs on PHP 7.2 to 8.5. We have not tested OpenCart 4.0.0 or 4.0.1.
- Is the ManteIQ Connector free?
- Yes. ManteIQ itself starts with a 30-day trial with no card, and the plans are on the pricing page.
- Can the module change anything in my shop?
- No. It answers read requests only and has no code that writes to your orders, products or customers. It adds one settings page and touches no theme or template.
- Where do I find the key after I installed the module?
- Open Extensions › Extensions, choose Modules, and click the pencil next to ManteIQ Connector. The page shows the shop address and the key, each with a Copy button.
- How long does the setup take?
- About two minutes: three steps in the OpenCart admin and one in ManteIQ. The first read of your order history runs once, and your first briefing arrives the next morning.
- What if my shop is behind Cloudflare or a firewall?
- ManteIQ reads the shop over the web, so the firewall has to let it through. A challenge page reads exactly like a refused key. ManteIQ names the vendor when it can and shows the allow rule to add.
Sources
The steps and screenshots come from installing the module through OpenCart's own uploader on test shops running OpenCart 4.1.0.4 and 3.0.5.1 on 1 October 2026, and from ManteIQ's own screens. The address and key in the pictures are examples. Other OpenCart releases may look different.
About the author: Mantas Lukošius
Mantas has worked in ecommerce for more than 15 years, almost all of it on PrestaShop: from his own first shop to business stores and large clients. He builds ManteIQ and its PrestaShop module.
How we write and check these guides