Setup Guide

Set Up Clover WooCommerce Integration

Follow these steps to install, license, and connect your Clover POS to WooCommerce. The whole process takes about 5 minutes. See the full feature list or check our FAQ if you have questions.

Step 01

Get Your License Key

After purchasing, you’ll receive a separate email from support@cloverwoo.com (sent by our license server, separate from your Stripe receipt).

Your license key has the format CLV-XXXX-XXXXXXXX-XXXXXXXX-XXXXXXXXXXXX (for example CLV-EE6C-CC2043C8-356D5C8A-F5B604343564).

The same email contains your private plugin download link. Copy the license key — you’ll paste it into the plugin settings in the next steps.

Tip: Can’t find the email? Check your spam folder, or email <code>support@cloverwoo.com</code> and our support team will resend it.
Step 02

Install the Plugin

Download clover-woocommerce-integration.zip using the private download link in your license-delivery email.

In your WordPress admin, go to Plugins → Add New → Upload Plugin.

Choose the zip file and click Install Now, then Activate.

Tip: Your download link is tied to your active subscription — keep the email handy if you need to reinstall later.
Step 03

Enter Your License Key

Go to Clover → Settings in your WordPress admin sidebar.

Paste your license key (CLV-XXXX-XXXXXXXX-XXXXXXXX-XXXXXXXXXXXX) into the License Key field at the top.

Click Save Settings. The plugin will verify your license immediately — you should see a green checkmark.

Step 04

Create a Clover Developer App

Go to developer.clover.com and create a new app (or use an existing one). Set App type to REST Client.

Enable these permissions on the app:

InventoryRead + Write
CustomersRead + Write
OrdersRead + Write
PaymentsRead + Write
MerchantRead
EmployeesRead

Set the Site URL in the Clover app to your CloverWoo OAuth callback. Pretty permalinks: https://YOUR_SITE/wp-json/clover-woo/v1/oauth/callback. Plain permalinks: https://YOUR_SITE/index.php?rest_route=/clover-woo/v1/oauth/callback.

From the app’s overview, copy the App ID, App Secret, and the PAKMS Key (under Ecommerce → API Tokens). Paste them into the matching fields on the CloverWoo settings page.

Tip: For testing, select “Sandbox” as your environment. Switch to your production region (NA, EU, or LATAM) when you’re ready to go live.
Step 05

Connect to Clover via OAuth

Click the Connect to Clover button on the settings page.

You’ll be redirected to Clover’s authorization page. Select your merchant account and approve the connection.

You’ll be redirected back to WordPress. A green “Connected” status confirms it worked.

Step 06

Configure Sync & Payments

Choose your sync direction — bidirectional, Clover → WooCommerce, or WooCommerce → Clover.

Set your conflict resolution strategy (Clover wins, WooCommerce wins, or newest wins).

Enable the Clover payment gateway under WooCommerce → Settings → Payments.

Step 07

Set Up Webhooks (Optional)

For real-time sync, copy the webhook URL displayed on the plugin settings page and paste it into the Clover Developer Dashboard. It includes a security key parameter and looks like this:

https://yoursite.com/wp-json/clover-woo/v1/webhook?key=YOUR_WEBHOOK_SECRET

If your site uses plain permalinks instead of pretty permalinks, the URL takes this form instead: https://yoursite.com/?rest_route=/clover-woo/v1/webhook&key=YOUR_WEBHOOK_SECRET.

The plugin shows the full ready-to-paste URL on the settings page — copy it from there rather than typing it.

Subscribe to the event types you want: items (I), inventory (IC), orders (O), customers (C), and payments (P).

Without webhooks, the plugin still syncs hourly via WP-Cron.

Step 08

Run Your First Sync

Go to Clover → Dashboard (or Clover → Sync) in your WordPress admin sidebar.

Click Sync Products to pull your Clover items into WooCommerce (or push WooCommerce products to Clover).

The dashboard shows sync progress, mapped item counts, and a real-time activity log.

Tip: Start with products, then sync categories, inventory, customers, and orders in that order for best results.

You're all set!

Your Clover POS and WooCommerce store are now connected. Products, orders, inventory, and customers will sync automatically.

Need help?

Email support

Reach us at support@cloverwoo.com

Check the logs

Go to Clover WooCommerce → Logs in your WordPress admin to see sync activity and debug any issues.