Blog9 min read

Clover Mini + WooCommerce
Setup Guide

How to connect a Clover Mini to a WooCommerce store: OAuth, product import, receipt printing on the built-in printer, online order auto-print, and the device-specific quirks that trip new merchants up.

Clover Mini is the most-deployed Clover device in small retail and quick-service food — an 8-inch countertop terminal with a built-in receipt printer, EMV reader, and contactless support. If you're running a WooCommerce store and want it connected to your Mini, this guide walks the full setup: account preparation, plugin install, OAuth, catalog sync, and the device-specific behaviour that's worth knowing before you flip it on for live orders.

What Clover Mini does well for WooCommerce merchants

Clover Mini is the right device when your physical footprint is small and your POS volume is moderate — boutique retail, coffee shops, takeout kitchens, market stalls. The built-in receipt printer means orders auto-print without a separate accessory, which simplifies the integration story when you push WooCommerce orders to the device.

For sync, the Mini is no different from any other Clover device — it talks to the same Clover API as Station and Flex. What's different is the on-device experience: the Mini's smaller screen and simpler Orders app surface online orders in the same list as in-store sales, with a 'WooCommerce' source tag if you want to filter them.

Prerequisites

  • A Clover Mini with an active Clover merchant account (Sandbox works for testing).
  • A WordPress site with WooCommerce installed (HPOS-compatible setup recommended).
  • Admin access to both your Clover developer dashboard and WordPress admin.
  • Optional: a CloverWoo license — sign up at /pricing or you can run the trial.

Step 1: Prepare the Clover Mini

On the Mini itself, confirm two things: the device is registered to your live merchant account (Settings → About → Merchant ID) and the printer is enabled (Settings → Printers). If your Mini was set up by a Clover dealer with a printer disabled by default, online orders will not auto-print until you enable it.

Optional but recommended: open the Orders app on the Mini and verify in-store orders are appearing normally. That confirms the device is online with Clover's API. If in-store orders aren't syncing back to the cloud, online orders pushed from WooCommerce won't either.

Step 2: Install the CloverWoo plugin in WordPress

Upload the CloverWoo plugin zip via WordPress admin → Plugins → Add New → Upload. Activate. You'll see a 'CloverWoo' section appear in your WordPress sidebar.

Tip: Before activating any new plugin on a production WooCommerce site, take a database backup or snapshot. If your hosting provider supports staging environments, run the install there first.

Step 3: Create a Clover developer app (one-time)

CloverWoo connects to Clover via OAuth, which requires a Clover developer app. Go to dev.clover.com → Apps → Create New App. Name it 'CloverWoo' (or whatever you prefer). Under App Settings → REST Configuration, paste the Site URL and Redirect URL that CloverWoo's Setup screen gives you. Save.

Permissions to enable: Read Inventory, Read Orders, Read Customers, Read Merchant, Read Payments, Write Inventory, Write Orders, Write Customers, Write Payments. The plugin needs all of these for full bidirectional sync.

Step 4: Connect WooCommerce to your Mini via OAuth

Back in WordPress → CloverWoo → Setup → click 'Connect to Clover'. You'll be redirected to Clover, sign in, select your Mini's merchant, and approve the permissions. You'll land back on the CloverWoo setup page with a green 'Connected' state.

First-time setup uses Clover Sandbox by default. Switch to Production from the environment toggle once you've verified things work in Sandbox.

Step 5: Run the one-time bulk import

From CloverWoo → Sync → 'Import Now'. The plugin pulls your Clover catalog, categories, modifiers, taxes, and customers into WooCommerce. A typical Mini-sized catalog (50–500 products) imports in 2–5 minutes.

After import, open WooCommerce → Products. You should see every product that was on your Mini's inventory, with SKUs, prices, categories, and any photos that existed in Clover. Modifier groups arrive as WooCommerce product attributes; categories arrive as WooCommerce product categories.

Step 6: Enable real-time sync

In CloverWoo → Webhooks, click 'Register webhooks with Clover'. This subscribes the plugin to the events that matter for live sync: order created, order updated, inventory adjusted, customer created. From here forward, any sale on the Mini decrements WooCommerce stock in real time, and any sale on WooCommerce decrements Clover stock just as fast.

Tip: If you have a firewall, security plugin, or CDN that blocks unknown POST requests, whitelist Clover's webhook IPs (or at least Clover's documented webhook source) before enabling. Otherwise the webhook delivery will fail silently and you'll think sync is broken when it's just dropped at the door.

Step 7: Configure auto-print for online orders

Open CloverWoo → Order Routing → check 'Auto-print online orders'. The plugin's default settings push WooCommerce orders to the Mini's built-in receipt printer with full line items, modifiers, and order notes. If you want online orders to also print on a kitchen printer connected via the Mini's USB or Bluetooth, enable the 'Also print to kitchen printer' option and select the device from the list.

Place a test order on your WooCommerce site (use a $0.01 product or a test payment method). Confirm: (1) the order appears in the WooCommerce orders list, (2) the order appears in the Orders app on the Mini with a WooCommerce source tag, (3) a receipt prints automatically.

Clover Mini-specific quirks worth knowing

The Mini's printer queue is small

The Mini's built-in printer buffers around 5–10 print jobs locally. If a sudden burst of online orders comes in (e.g., a coupon goes viral) and the printer is busy on in-store receipts, some prints may queue and print slightly delayed. Production retail and food workflows rarely hit this, but it's worth knowing during launch promotions.

Offline mode and sync recovery

If the Mini loses internet, in-store sales queue locally and replay to Clover's cloud when connectivity returns. CloverWoo treats that replay as a normal webhook stream — the queue will catch up automatically, and any inventory deltas that happened while offline will reconcile on the next sync cycle.

Modifier groups vs WooCommerce variations

Clover modifier groups (size, milk, add-ons) map to WooCommerce product attributes via CloverWoo. If your Clover catalog uses deeply nested modifier groups (Mini setups often do — coffee shops especially), the WooCommerce product page will reflect those as variation dropdowns. Confirm the mapping by opening one of your imported products and clicking the Variations tab.

Next steps after setup

Frequently asked questions

Does CloverWoo work with all Clover Mini generations?

Yes. CloverWoo communicates with Clover's REST API at the merchant account level, not the device. Any Clover Mini registered to a live merchant account (gen 1 or gen 2) connects identically. The device firmware does not affect the integration.

Can I run two Clover Mini devices at the same location with one WooCommerce store?

Yes. Both Minis share the same merchant account and the same Clover catalog, so CloverWoo treats them as one POS surface. Online orders auto-print on whichever Mini you designate as the receipt destination in Order Routing settings.

What if my Clover Mini doesn't have a kitchen printer attached?

Then online orders print on the Mini's built-in receipt printer instead. CloverWoo's Order Routing settings let you pick the printer destination — built-in, USB-attached, or Bluetooth — based on what you've actually configured on the device.

Does the Mini's smaller screen affect how online orders look?

No. The Orders app on the Mini surfaces online orders the same way it surfaces in-store orders: line items, modifiers, totals, and a source tag. The smaller screen just means slightly more scrolling for long orders.

Run Clover + WooCommerce as one system

CloverWoo — sync, payments, and POS operations in one plugin for $60/month.