Connect WooCommerce

WooCommerce connects through a small WordPress plugin that runs on your own site. You install the plugin, generate a connector key from its settings, then paste your store URL and that key into the portal.

Requirements

• WordPress 5.9+
• WooCommerce 7.0+
• PHP 8.2+
• Admin access to your WordPress site (to install and configure a plugin)

Step 1 — Install the plugin

The plugin is on the WordPress.org directory, so you can install it without leaving your site.

1. In your WordPress admin, go to Plugins → Add New.
2. Search for Synchronity.
3. On Synchronity for WooCommerce, click Install Now, then Activate.

Step 2 — Generate your connector key

The plugin generates the key for you — no config files to edit.

1. In your WordPress admin, go to WooCommerce → Settings → Synchronity.
2. Next to Connector Key, click Generate new key.
3. Click Copy. Keep it handy — you'll paste it into the portal in the next step.

This is the shared secret the gateway uses to authenticate with your store. You can regenerate it any time; if your store is already linked, a regenerated key is pushed to Synchronity automatically.

Step 3 — Register the store in the portal

1. In the merchant portal, open Storefronts and click Add Storefront.
2. Choose WooCommerce.
3. Fill in the three fields:
   • Store Name — a label for your store (for example Acme Coffee).
   • Store URL — just your WordPress site address, e.g. https://your-store.com. Synchronity adds the connector path automatically — don't append anything yourself.
   • Connector Key — the key you copied in Step 2.
4. Click Connect store.

If the URL and key match, your store appears as connected under Storefronts.

Troubleshooting

• "Connection failed. Check your connector URL and key." — the most common causes: the Connector Key doesn't match the one in your plugin settings (regenerate and re-copy), the plugin isn't activated, or you entered something other than your plain site address in Store URL (enter just https://your-store.com — no /wp-json/... path).
• 404 / "rest_no_route" — WordPress permalinks may be set to "Plain". Set Settings → Permalinks to any non-plain option so the REST route resolves, then retry.

Next

Accepting payments in chat (mobile money / card via Paystack) is configured in the plugin's own settings — see the WooCommerce connector README for WooCommerce → Settings → Synchronity → Inline Payments.