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.

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.

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.7.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.