Connect WooCommerce

Connect your WooCommerce webshop from Order channels so its orders arrive in Zippendo. This page explains every field in the connect window and on the webshop’s settings page. For a click-by-click walkthrough, see Connect order channels. To show live shipping rates at your checkout, see Checkout.

Start the connection

Open the catalog

Click Order channels in the sidebar, then the Catalog tab.

Click Connect WooCommerce

On the WooCommerce card (Import orders from your WooCommerce store), click Connect WooCommerce. The Connect WooCommerce store window opens.

Order channels catalog with the WooCommerce card and the Connect WooCommerce button — Click Connect WooCommerce on the WooCommerce card

Connect in one click

The window opens on step 1 of 2, One-click: Connect in one click. You approve the connection in your own store. This is the quickest way. WooCommerce creates the REST API keys for you.

Connect WooCommerce store window on the One-click step with Store URL, Default sender address, Connect and Enter API keys manually — One-click step: enter your Store URL and click Connect

Field	Required	What to enter
Store URL	Yes	Your webshop’s address, for example `https://mystore.dk`. If you leave out `https://`, Zippendo adds it. One-click connect only works for a webshop on HTTPS. Left empty, you see Enter your WooCommerce store URL.
Default sender address	No	The sender address for shipments created from this webshop’s orders. You can change it later. If the list says No addresses yet. Create one first in Settings → Addresses., add a sender address first.

Click Connect

The button changes to Redirecting… and your webshop opens in the same tab.

Approve on your webshop

WooCommerce shows its own approval screen for the app Zippendo with read/write access. Click to approve. Keep the tab open until WooCommerce sends you back to Zippendo.

Check the result

Back on Order channels, you see WooCommerce store connected! and New orders will now be imported in real time. The webshop now appears on the Connected tab.

If you see Couldn’t connect the WooCommerce store, try again or use Enter API keys manually. Approve read/write access: with read-only access, orders come in, but Zippendo cannot send tracking back to WooCommerce. The new channel is named after your webshop, for example “WooCommerce - mystore.dk”. It starts with these settings:

Setting	Starts as
Automatic sync	On, every 15 minutes
Only unfulfilled orders	On
Mark orders as completed in WooCommerce	On
Create shipments automatically	Off

Enter API keys manually

Use this when your webshop is not on HTTPS, when your hosting blocks the one-click approval, or when you already have keys. First create the keys in your WordPress admin. These are WooCommerce’s own names, also listed under How to get API keys in the window:

Open REST API

Go to WooCommerce → Settings → Advanced → REST API.

Add a key

Click Add key.

Choose Read/Write

Set the permissions to Read/Write.

Copy both values

Copy the Consumer key and the Consumer secret. WooCommerce only shows the secret once.

WooCommerce documentation on generating REST API keys, with Consumer Key, Consumer Secret and Read/Write permissions — WooCommerce's guide to creating REST API keys. You create them in your own WordPress admin

Then, in the Zippendo window, click Enter API keys manually. You move to step 2 of 2, API keys: Enter the REST API keys you generated in WooCommerce. The URL and address you already entered are kept.

Connect WooCommerce store window on the API keys step with Store URL, Consumer key, Consumer secret, Default sender address and How to get API keys — API keys step: Store URL, Consumer key, Consumer secret and Default sender address

Field	Required	What to enter
Store URL	Yes	Your webshop’s address, as in one-click.
Consumer key	Yes	The key from WooCommerce. It starts with `ck_`. Left empty: Enter your Consumer key.
Consumer secret	Yes	The secret from WooCommerce. It starts with `cs_`. Left empty: Enter your Consumer secret.
Default sender address	No	The sender address for shipments created from this webshop’s orders.

Click Connect. The button shows Connecting… while Zippendo checks the keys with your webshop. The channel is only saved if the keys work. Back to one-click connect returns to step 1 with your URL and address kept. Cancel closes the window.

Choose Read/Write keys. With read-only keys, orders come in, but Zippendo cannot send tracking back to WooCommerce.

Find your connected webshop

Your webshop is listed on the Connected tab, in the WooCommerce card. Each row shows the channel name, the webshop’s address and the brand, if one is assigned. Click the row to open its settings.

Order channels page with a connected WooCommerce webshop — A connected WooCommerce webshop on the Order channels page

The settings page is headed by the channel name and the webshop’s address. WooCommerce admin opens your WordPress admin in a new tab. Settings are split over two tabs: Orders & checkout and Connection.

Orders & checkout

Orders & checkout: order sync settings, brand and default sender address

What Zippendo is used for

Import orders from this webshop is on by default. Turn it off if another system, such as a warehouse system (WMS) or an ERP, owns your orders and you only use Zippendo for shipping. While it is off, checkout rates and service point selection still work. Orders are not imported, and Zippendo does not mark orders as fulfilled or send tracking back to your webshop. The system that imported the order does that. The order sync settings below are hidden. When you turn it back on, Zippendo asks you to confirm, because if another system already fulfills these orders, both it and Zippendo will start creating shipments for the same order. See Connecting WooCommerce for when to use this.

Order sync

Setting	Starts as	What it does
Automatic sync	On	Regularly checks the webshop for new orders as a backup, in case one is missed.
Sync interval (minutes)	`15`	How often to check for new orders, from 5 to 1440 minutes. A number outside that range is changed to the nearest allowed value.
Only unfulfilled orders	On	Imports only orders that have not been fulfilled yet.
Create shipments automatically	Off	Creates a shipment as soon as a new order arrives.
Mark orders as completed in WooCommerce	On	Sends tracking back to WooCommerce when you send the shipment. Turn it off if Zippendo should not update the order in WooCommerce.
Brand	No brand	Orders from this channel belong to this brand. The list only appears when your organization has brands. Your choice is saved straight away.
Default sender address	Empty	The sender for shipments created from WooCommerce orders. If the list says No addresses available. Create one first in Settings → Addresses., add one first.

Click Save changes to save the order sync settings and the default sender address. The button only becomes active after you change something. You see Settings saved, or Couldn’t save the settings if it did not work.

Checkout token

You only need the checkout token if you install the Zippendo for WooCommerce plugin, which shows live shipping rates and service points at your checkout. Order import works without it. Full steps: WooCommerce checkout plugin.

Download plugin downloads the latest version of the plugin as a zip file. The plugin comes from Zippendo, not from the WordPress plugin directory.
Generate token creates a token that starts with zck_. Click Copy and paste it into the plugin settings.

Checkout token card with the one-time warning, the token, Copy, Revoke and Replace token — The checkout token is shown once, right after you generate or replace it

Copy the token straight away. Zippendo does not keep a readable copy, so you can’t see it again. If you lose it, click Replace token and paste the new one into the plugin.

Control	What it does
Copy	Copies the token. You see Token copied to clipboard, or Couldn’t copy the token. Then select and copy it by hand.
Active token created	Followed by the date and time the current token was created.
Replace token	Replaces the token. The old token stops working immediately, so paste the new one into the plugin right away.
Revoke	Turns the token off. The plugin stops showing Zippendo rates until you generate a new token. You see Checkout token revoked.

If generating or revoking fails, you see Couldn’t generate the checkout token or Couldn’t revoke the checkout token. Try again.

Connection

Row	What it shows
Store URL	The WooCommerce webshop this channel is connected to.
Status	Active or Disabled. You can’t change it here.
Last sync	When orders were last imported, or Never.
Last sync error	Only shown when the last check for orders failed, with the reason.
Test connection	Checks that the saved API keys can still reach your webshop. You see The connection works. or Connection failed.

Test connection only checks the keys used for importing orders. It does not test the rates at your checkout. If the test fails, see the troubleshooting tips in Connecting WooCommerce.

Webhooks

WooCommerce sends order events to Zippendo in real time through webhooks. WooCommerce turns a webhook off after repeated failed deliveries.

On a working connection you see three webhooks (order created, updated and deleted), each marked Active.
Disabled by WooCommerce means WooCommerce turned that webhook off. Click Re-register to set it up again. You see Webhooks registered, for example with “3 webhooks registered”, or Couldn’t register the webhooks.
No webhooks are registered for this channel. means none are set up. Click Re-register.
Couldn’t load webhook status from the store. means Zippendo could not reach your webshop. Check that it is online, then try Test connection.
Callback URL: is the address WooCommerce sends order events to.

Disconnect

On the Connection tab, under Danger zone, find Disconnect store: Remove this WooCommerce channel and stop importing its orders.

Click Disconnect and confirm. Zippendo removes its webhooks from your webshop and stops importing orders. You see WooCommerce store disconnected, or Couldn’t disconnect the store. Orders already in Zippendo stay. To clean up a leftover channel later, see Order channel settings.

Plugin settings in WordPress

These settings belong to the Zippendo for WooCommerce plugin. You find them in WordPress under WooCommerce → Settings → Shipping → Zippendo, not in Zippendo.

Field	What it does
Checkout API key	Paste the checkout token (`zck_…`) from Zippendo here. It is never sent to your shoppers’ browsers.
Connection	Test connection checks the token. You see Connected to followed by your organization name, or Connection failed: with the reason. Save the token before you test.
Fallback rate	Offer a flat fallback shipping rate when Zippendo cannot be reached. Off by default.
Fallback rate label	The name shoppers see for the fallback rate. Starts as Shipping.
Fallback rate cost	The fixed price of the fallback rate, in your webshop’s currency. Starts as `0`.
Debug logging	Writes extra detail to the WooCommerce status log, for troubleshooting. The token is never written to the log.

Then add the Zippendo shipping method to each WooCommerce shipping zone that should show Zippendo rates. In each zone you can set an optional Label prefix, a text shown before each Zippendo rate name at checkout. Install and token steps: WooCommerce checkout plugin.

Connect order channels

Connect WooCommerce or a custom channel, then see your orders arrive.

Checkout

Live rates and service points at your WooCommerce checkout.

Order channel settings

The Order channels page, brands and leftover channels.

Order sync delays

What to do when orders don’t arrive.

Overview

Shipments

Orders & channels

Carriers

Connect a carrier

Connect an integration

Printing

Automation

Account

Search & dashboard

API & events

Connect WooCommerce

Start the connection

Connect in one click

Enter API keys manually

Find your connected webshop