KeyCRM Sync — CRM for WooCommerce

KeyCRM Sync for WooCommerce is a plugin that automatically sends every WooCommerce order into KeyCRM: with the customer, products, shipping and payment. The send fires right after checkout (classic checkout and Checkout Blocks) or when the order reaches a status you choose. Managers work in the CRM instead of switching between the store’s admin panel and spreadsheets — and there’s no manual transfer of orders at all.

The plugin is published in the official WordPress.org directory — install it right from the admin panel: wordpress.org/plugins/catcode-order-sync-with-keycrm-for-woocommerce.

The plugin is completely free. The code is open on GitHub: github.com/catcodestudio/wp-keycrm-sync. No limit on the number of orders, no monthly charges and no dependence on third-party services — all you need is an API key from your KeyCRM account.

What the admin gets

How it works, step by step

1. The customer places an order in your store — through the classic checkout or Checkout Blocks.
2. The plugin builds the payload: customer, products, shipping, payment. The phone number is normalised into the +380 format, and zero-value line items are skipped.
3. Sent to KeyCRM via POST /order — right after checkout, or when the order reaches a status you’ve chosen (for example, “Processing”).
4. KeyCRM returns the order ID, which is stored in the _catcode_keycrm_order_id meta field, so there won’t be duplicates even if the trigger fires again.
5. If the CRM is unavailable, the plugin retries itself after 5 min / 30 min / 2 hours via WP-Cron, with no cron setup needed on your hosting.
6. The manager sees the result in the order’s metabox and in the event log.

Pricing

Free, open source. Download it from GitHub or the button on this page. No paid tariffs, trials or limits on the number of orders.

Technical requirements

• WordPress 6.2+
• WooCommerce 6.0+
• PHP 7.4+
• A KeyCRM API key — your KeyCRM account → Settings → API

Under the hood

• Two-level deduplication: the plugin passes source_uuid = wc-{id} and stores the KeyCRM ID in the order’s meta — no duplicates are created on either the plugin’s side or the CRM’s.
• The API key is encrypted in the database — libsodium with an HMAC fallback; the key is never stored in plain text.
• HPOS compatibility (High-Performance Order Storage) — orders are handled exclusively through the WC_Order CRUD API.
• Payment status transfer: a paid order is created in the CRM straight away with a “paid” payment record (optional).
• Hooks for developers: the catcode_keycrm_order_payload filter (modify the data before sending) and the catcode_keycrm_order_sent action (third-party integrations).

How to install

1. In the admin panel: Plugins → Add New → find “CatCode Order Sync with KeyCRM” and click “Install”. Or download catcode-order-sync-with-keycrm-for-woocommerce-0.1.6.zip manually.
2. Activate the plugin in the plugin list.
3. Go to WooCommerce → KeyCRM Sync and paste in the API key from your KeyCRM account.
4. Click “Test connection” — make sure the link to the CRM works.
5. Choose the send trigger (right after checkout, or specific statuses) and save the settings.

Version history

0.1.6 — 13 August 2026

Fixed the “Resend” button in the order metabox — it hadn’t worked for a single day: the metabox printed its own form inside WooCommerce’s order form, and the browser discards a nested form, so a click submitted the order form instead and nothing went to the CRM. It’s now a plain link with a nonce. A manual send takes the same database lock as an automatic one — two managers clicking the button at the same time no longer create two orders in KeyCRM. Translations were removed from the WordPress.org build (they now come from translate.wordpress.org); the Ukrainian localisation remains in the zip on this page.

0.1.5 — 12 August 2026

Updating from versions before 0.1.1 no longer “loses” the store: when the plugin was renamed, the settings, API key, log and “order already in KeyCRM” markers stayed under the old names. Because of this every old order looked unsent — the next status change pushed it into the CRM again, KeyCRM rejected the repeated source_uuid, and the order was marked “Send failed” even though it had long been in the CRM. All of this is now carried over automatically, and the false error status is cleared. Protection against a double send is now atomic (a database lock instead of a transient). Orders with no payment method, or with no customer contact details at all, are no longer rejected by the CRM with a 422 error. Removing the plugin now also cleans up the old log table. The minimum WooCommerce version has been lowered to 6.0.

0.1.4 — 6 August 2026

The description and keywords in the WordPress.org directory, in Ukrainian.

0.1.3 — 20 July 2026

Source code strings moved to English (a WordPress.org directory requirement), a full built-in Ukrainian translation added — the Ukrainian-language interface stayed unchanged.

0.1.2 — 20 July 2026

Published in the official WordPress.org directory. The plugin was renamed to “CatCode Order Sync with KeyCRM for WooCommerce”, prefixes were unified, inline styles moved to enqueue, and a section on external services was added to the readme.

0.1.0 — July 2026

First public release: exporting orders to KeyCRM (checkout and trigger statuses), deduplication via source_uuid, retries at 5 min / 30 min / 2 hours, a metabox on the order with a resend option, an event log, a connection test, API key encryption, HPOS and Checkout Blocks compatibility.