Skip to content
Azimea Docs

WooCommerce

What it brings

Section titled “What it brings”
  • Registered customers and guest buyers (taken from their orders), as contacts.
  • Orders of the last 12 months, with their products and value, then every new order and status change.
  • Products, with price and stock, for the recommendations in your emails.
  • Carts as they happen, anonymous ones included, with the email typed at checkout: this is where the abandoned-cart flow starts. Carts come only from the plugin.

Requirements

Section titled “Requirements”
What Why
WooCommerce with REST API v3 (WooCommerce 3.5 or later) Azimea reads customers, orders and products through it.
For the plugin: WordPress 6.4+, WooCommerce 8.2+, PHP 8.1+ The plugin sends carts and events.
The site on HTTPS Keys are never sent unencrypted.
Permalinks other than “Plain” (WordPress › Settings › Permalinks) With “Plain”, the REST API has no address.
A WordPress administrator account Only an administrator can create REST API keys.

How it works

Section titled “How it works”
  • Reading: with the REST API keys, Azimea reads customers, orders and products, the same way on every sync.
  • Sending: the Azimea plugin sends the cart whenever it changes, the email typed at checkout (on the classic and the block checkout), orders and their status, accounts, and the consent your checkout collects.
  • Nothing is sent while a shopper’s page loads: events wait in the plugin’s own table and leave with Action Scheduler, in batches of up to 100. If Azimea cannot be reached, the plugin retries after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours, then says so on its settings screen.
  • The plugin supports High-Performance Order Storage, and consent texts per language with WPML or Polylang.

Install and connect

Section titled “Install and connect”

1. Create the REST API keys

Section titled “1. Create the REST API keys”
  1. In WordPress, go to WooCommerce › Settings › Advanced › REST API.
  2. Press Add key, set the description to Azimea.
  3. Under permissions choose Read/Write, as Azimea’s connect screen asks, and generate the key.
  4. Keep the page open: you need the Consumer key (ck_…) and the Consumer secret (cs_…).

2. Connect in Azimea

Section titled “2. Connect in Azimea”
  1. In Azimea, open Integrations › WooCommerce › Connect your store.
  2. Paste your shop’s address (https://…), the consumer key and the consumer secret, then press Check and connect.
  3. Azimea checks the keys on your shop on the spot and starts bringing in customers and orders. You can leave the screen: it continues on the server.

3. Install the plugin

Section titled “3. Install the plugin”
  1. Download the plugin: azimea-for-woocommerce.zip.
  2. In WordPress, go to Plugins › Add New Plugin › Upload Plugin, upload the zip, then Activate.
  3. In Azimea, on the WooCommerce page, under Store plugin, press Generate keys. Copy the store key (str_…) and the secret (whsec_…): the secret is shown only once.
  4. In WordPress, open WooCommerce › Settings › Azimea, paste both and press Test connection.
  5. Add a product to the cart on your site. In Azimea the plugin status turns to Connected.

To keep the secret out of the database, define AZIMEA_STORE_KEY and AZIMEA_SECRET in wp-config.php; the settings screen then shows both as locked.

Statuses

Section titled “Statuses”

The store and plugin statuses are explained in the overview. Orders keep WooCommerce’s own states on the shop’s side; in Azimea they read as the common statuses in carts and orders.

Troubleshooting

Section titled “Troubleshooting”
Symptom Likely cause Fix
stores.consumer_key_format / stores.consumer_secret_format The key was not copied whole. A key starts with ck_, a secret with cs_, both 43 characters. Copy them again from WooCommerce.
stores.credentials_rejected WooCommerce refused the keys: revoked, or for another site. Create a new key pair and connect again.
stores.rest_api_not_found No REST API at this address: WooCommerce inactive, or permalinks set to “Plain”. Check the address, activate WooCommerce, change the permalinks.
stores.not_a_woocommerce_api Something answered, but not WooCommerce: a security plugin or a firewall blocks the API. Allow /wp-json/wc/v3/ in the security plugin or the firewall.
Plugin status “… deliveries refused” (ingestion.signature_invalid) The store key or secret in the plugin is not the current one. Generate new keys in Azimea and paste them again.
Plugin status stays “Waiting for the first event” Nobody has used the cart yet, or the site blocks its own background requests. Add a product to the cart; the plugin then delivers on the next visit.

All codes: error codes.

Disconnect

Section titled “Disconnect”

In Azimea, press Disconnect next to the store: its keys are deleted and syncing stops; contacts and orders stay. In WooCommerce, revoke the Azimea key under REST API and deactivate the plugin. Deleting the plugin removes its table, its settings and the keys it added to orders.

Section titled “Related”