KeyCRM Sync — CRM for OpenCart 2.3, 3.x & 4.x

KeyCRM Sync for OpenCart 2.3, 3.x and 4.x is a module that keeps your store in two-way sync with KeyCRM. In the forward direction, every OpenCart order is automatically created in the CRM — with the customer, products, shipping and payment method. In the reverse direction (optional), the module pulls order statuses, waybill numbers and even stock levels from KeyCRM back into OpenCart. Managers run sales from a single CRM window, and the store stays up to date with no manual work.

The module is completely free. The code is open on GitHub: github.com/catcodestudio/opencart-keycrm-sync. All you need is an API key from your KeyCRM account — no subscriptions and no extra services.

What it looks like in the admin panel

How it works, step by step

1. The customer places an order in the OpenCart store.
2. The module builds the data for the CRM: contacts, products, shipping and payment. The phone number is normalised into the +380 format, and zero-price line items are skipped.
3. The order is sent to KeyCRM — right at checkout or when it reaches the configured status. The order source is created in the CRM automatically on the first send.
4. Duplicate protection: a unique key, UNIQUE(order_id, target), in the log guarantees the order won’t be duplicated even if the event fires again.
5. Failed sends go into a retry queue — a separate cron task keeps retrying them, up to a limited number of attempts.
6. Reverse sync (if enabled): a second cron task periodically pulls updated statuses from KeyCRM (according to your “KeyCRM status → OpenCart status” mapping), adds a comment with the waybill to the order history, and, with a separate checkbox, updates product stock by SKU.

Pricing

Free, open source. Download it from GitHub or the button on this page — no tariffs, no order limits and no hidden charges.

Technical requirements

• OpenCart 4 4.0.2 – 4.1.x, PHP 7.4+
• OpenCart 3 3.0.0 – 3.0.5, PHP 5.6 – 8.2 — a separate cc_crm-oc3.ocmod.zip build
• OpenCart 2.3 2.3.0.0 – 2.3.0.2, PHP 5.6+ — a separate cc_crm-oc2.ocmod.zip build
• A KeyCRM API key — your KeyCRM account → Settings → General → API key
• Cron on your hosting — for the retry queue and reverse sync (direct order sending works without cron too)

Under the hood

• Database-level idempotency — UNIQUE(order_id, target) in the log table: a duplicate is impossible even if an OpenCart event fires twice.
• The API key is encrypted in the database — sodium with an HMAC fallback, never stored in plain text.
• A sync log with a per-status record for every order and fragments of the API request/response — handy for figuring out why a particular order didn’t go through.
• Reverse sync with no loops: it reads from KeyCRM only to fetch data, and while writing the order history it suppresses the forward-sync event — nothing is sent back to the CRM. Every run rescans a 10-minute overlap so no borderline update is missed; times are in UTC.
• Adapter architecture — the order mapper and the dispatcher are decoupled from any specific CRM, with KeyCRM implemented as an adapter.

How to install

1. Download cc_crm.ocmod.zip via Extensions → Installer in the OpenCart admin panel.
   For OpenCart 2.3, take the cc_crm-oc2.ocmod.zip build. The 2.3 built-in installer only copies files over FTP, so if FTP isn’t set up, unpack the archive and upload the contents of the upload/ folder to the store’s root.
2. Go to Extensions → Modules, find KeyCRM Sync and click “Install”.
3. Open the module’s settings and paste in the API key from your KeyCRM account.
4. Enable sending and choose the trigger: right at checkout, or on a status change.
5. If needed, enable reverse sync on the “Reverse sync” tab: set up the status mapping (the list of KeyCRM statuses loads right in the admin panel) and add the cron tasks.
6. OpenCart 2.3 and 3.x: these versions have no scheduler at all, so both cron URLs (retry queue and reverse sync) are simply shown in the module settings — add them to the system crontab. There’s also a “Cron token” field next to them: fill it in so no one else can trigger these URLs.

Version history

1.0.1 (OpenCart 2.3)

A cron token with a special character (&, quotes) is no longer rejected: in 2.3, Request::clean() runs htmlspecialchars over $_GET too, so such a token arrived at the gate HTML-encoded and never matched — the crontab line got a 403 forever. The value is now decoded once, the same as when it’s saved in the admin panel.

1.1.4 — August 2026

A currency fix release: amounts are now sent to KeyCRM in the order’s currency (at the order’s exchange rate) instead of the store’s base currency.

1.1.3 (OpenCart 3) — 11 August 2026

The 3.x build has been brought up to the level of 2.3 and 4.x. The CRM now receives the amount in the currency the customer actually paid in, not the store’s base currency. A cron token has been added for both URLs — without it, anyone could trigger them (the field is empty by default, so existing crontab lines keep working). The sync log has been moved to its own paginated screen. The API key and the UUID prefix with an & character are no longer stored as an HTML entity. Updating is just re-uploading the archive: settings, the event and the log stay in place.

1.0.0 (OpenCart 2.3) — 9 August 2026

A separate build for OpenCart 2.3: the same order sync, log, retry queue and reverse sync, but with PHP 5.6-compatible code and Bootstrap 3 templates. Instead of a scheduler (which 2.3 doesn’t have), there are two cron URLs with their own token. Along the way, amounts were fixed: the CRM now receives the currency the customer actually paid in, not the store’s base currency.

1.1.3 — 5 August 2026

Fixed PHP 7.4 compatibility: the event handler was declared with a mixed type hint (which only exists from PHP 8.0), so on 7.4 sync didn’t work at all. Removed a dependency on mbstring in the log and reverse sync. Added a store UUID prefix — if several stores send orders into one KeyCRM account, their orders with the same number no longer conflict (the CRM used to return HTTP 500 for this). Along the way, a polyfill file the module wouldn’t install without was restored to the build.

1.1.1–1.1.2 — July 2026

Fixed the order event on OpenCart 4.0.2.x (the method separator) and the waybill-duplicate check on the PDO database driver.

1.1.0 — July 2026

Reverse sync KeyCRM → OpenCart: order statuses via a configurable mapping, waybill numbers added to the order history, an optional stock update by SKU (accounting for KeyCRM reservations). Fixed the transfer of shipping cost (shipping_price), the OC4 model event trigger, and the admin-AJAX links.

1.0.0 — July 2026

First release: sending orders to KeyCRM at checkout or on a status change, duplicate-free idempotency, a retry queue via cron, a field and payment mapper, API key encryption, a sync log, automatic source creation in the CRM.