Connect your store

What it does and when to use it

Connecting your shop is the first thing to do in Azimea. It brings in your customers, guest buyers, orders and products, keeps them up to date on their own, and sends Azimea what happens in the shop as it happens: carts, emails typed at checkout, orders, sign-ups. Every flow that runs on its own (abandoned carts, welcome, after the order) starts from this connection.

Platforms

Platform	Status	How it connects
WooCommerce	Available	Two REST API keys + the free Azimea plugin
PrestaShop	Available	A read-only webservice key + the free Azimea module
OpenCart	Available	The free Azimea extension, which does both reading and sending
Magento	Available	An integration access token + the free Azimea module
Shopware	Available	The free Azimea app + a link code
Shopify	Coming soon	—
Gomag	Coming soon	—
MerchantPro	Coming soon	—

For a platform marked “Coming soon”, open it in Integrations and press Notify me when it’s ready: you get one email the day it can be connected.

How it works

A connection has two halves that do different jobs:

Azimea reads your shop through a key you create in the shop’s admin (or, on Shopware, through the app). Right after connecting it brings in your customers, guest buyers and the orders of the last 12 months, then keeps them current: orders every 5 minutes, customers every 15 minutes, products every 6 hours. The keys only read: Azimea never changes products, prices, stock or orders.
Your shop tells Azimea what happens, through the Azimea plugin, module, extension or app installed in it: every change to a cart (anonymous visitors included), the email typed at checkout, orders and their status, new accounts and newsletter sign-ups. These arrive within seconds, signed with your store’s secret.

Without the second half, orders still sync, but abandoned carts cannot be seen: no shop platform lets anyone read carts from the outside, so the abandoned-cart flow does not start.

Kind	Platforms	What you give Azimea	What you install in the shop
Keys + plugin	WooCommerce, PrestaShop, Magento	A key created in the shop’s admin	The plugin or module, with a store key and secret from Azimea
Extension	OpenCart	The extension’s own read key and secret	The extension, with a store key and secret from Azimea
App	Shopware	A link code shown by the app	The app; Azimea writes its keys into it by itself

The “See my cart” link

Every plugin and app sends, with each cart, a link that rebuilds that cart in any browser or device and lands on the checkout. It is what the button in a cart reminder opens. The link is signed with your store’s secret, expires after 30 days, carries products only (never an address or a login), and does nothing for a cart that was already ordered.

How your shop asks for marketing consent is chosen in Azimea, in Settings › Consent: a checkbox at checkout, a notice at checkout, consent you collect elsewhere, or no marketing. The plugin reads that choice and shows the right thing at checkout, with your own words. An email typed at checkout is never consent by itself: it only allows the reminder about that cart. See consent statuses.

What each status means and what to do

The store

Status or reason	What it means	What you do
`Active`	Connected and checked: orders, customers and products are kept in sync.	Nothing.
`Error`	The last check failed: keys revoked, permission removed or the shop not answering. Syncing is paused.	Open the shop in Integrations, read the error, fix the keys or the shop, then press Check.
`Disconnected`	You disconnected it; its keys were deleted and its running imports stopped. Its contacts and orders stay in Azimea; its products are no longer shown in emails.	Connect it again with new keys when you want syncing back.

The plugin

The store’s page in Azimea shows, under Store plugin, whether the plugin is talking to Azimea:

Shown	What it means	What you do
Waiting for the first event	The keys exist, but nothing has arrived yet.	Add a product to the cart on your site.
Connected · last event …	Events arrive.	Nothing.
Nothing new since …	No event for more than a day. Normal for a quiet shop.	If the shop had visitors, check that the plugin is active.
… deliveries refused	The keys in the plugin do not match the ones in Azimea.	Paste the store key and secret again, or generate new ones.

Set it up in the dashboard

Open Integrations and choose your platform.
Press Connect your store and follow the steps on the platform’s page in these docs.
On the platform’s page in Azimea, under Store plugin, press Generate keys and paste the store key and secret into the plugin (not needed on Shopware). The secret is shown only once.
Add a product to the cart on your site: the plugin status turns to Connected.

Each plan includes a number of connected stores; one Azimea account can connect several shops, each with its own keys.

Troubleshooting

These answers apply to every platform; each platform’s page lists its own.

Symptom	Likely cause	Fix
`stores.url_not_https`	The address starts with `http://`.	Use the `https://` address; keys are never sent unencrypted.
`stores.url_redirects` / `stores.url_redirects_to`	The address you typed redirects elsewhere (often `www.` or a language path).	Use the final address the site opens at.
`stores.unreachable` / `stores.timeout`	The site is down, or a firewall blocks Azimea.	Check that the site opens from outside; ask your host to allow Azimea.
`stores.already_connected`	This shop is already connected in your account.	Use Check next to the store, or disconnect it first to use other keys.
`stores.limit_reached`	Your plan’s number of stores is used up.	Disconnect one, or move to a larger plan.

Every code is listed in error codes.