Title: Cycloon Author: cycloon Published: September 10, 2026 Last modified: September 10, 2026 --- Search plugins ![](https://ps.w.org/cycloon/assets/banner-772x250.png?rev=3689457) ![](https://ps.w.org/cycloon/assets/icon.svg?rev=3689457) # Cycloon By [cycloon](https://profiles.wordpress.org/cycloon/) [Download](https://downloads.wordpress.org/plugin/cycloon.1.0.2.zip) * [Details](https://wordpress.org/plugins/cycloon/#description) * [Reviews](https://wordpress.org/plugins/cycloon/#reviews) * [Installation](https://wordpress.org/plugins/cycloon/#installation) * [Development](https://wordpress.org/plugins/cycloon/#developers) [Support](https://wordpress.org/support/plugin/cycloon/) ## Description This plugin integrates the Cycloon API into WooCommerce. * **Shipping method at checkout**: add “Delivery by Cycloon” to your shipping zones, with its own rate per zone, an optional free-shipping threshold and a fixed Cycloon product per method. Works in both the classic checkout and the checkout blocks. * **Create a shipment** from the order page, or automatically when an order reaches“ Processing” — for all orders, or only for orders where the customer chose Cycloon at checkout. Choose the product (Pakket, Pakket XL, Brievenbuspakket, Aangetekende brief, Aangetekend pakket), the number of parcels, and the “Handtekening” (signature) and “Niet bij buren” (no delivery to neighbours) options. * **PDF labels** per order, or in bulk from the order list. ZPL for label printers is available as a setting. * **Pickup points**: let customers choose a nearby parcel point at checkout. Enable it per shipping method, either alongside home delivery or on its own. * **Link an existing shipment**: created a shipment in the Cycloon dashboard? Enter its track & trace code on the order and the plugin pulls in the status, the history and the labels. * **Track & trace**: refresh the status per order, an hourly automatic sync through Action Scheduler, and a webhook receiver for push updates, secured with HMAC verification. The link to the public tracking page comes from the API, so there is nothing to configure. * **Customer communication**: the track & trace code in the order emails and on the “My account” order page. * **Customs**: the customs form is shown and required for destinations outside the EU, pre-filled from the order. * **Translation ready**: English source strings and a bundled .pot template; translations are delivered through translate.wordpress.org. Request an API key through klant@cycloon.eu. **Please note:** Cycloon only collects parcels in the Netherlands. The plugin therefore requires the store location (WooCommerce ▸ Settings ▸ General) to be set to the Netherlands. With any other store location, the shipping method and shipment creation are disabled. ### External services This plugin sends data to the Cycloon Parcel API at `dabba.cycloon.eu`. That connection is required to create shipments, retrieve labels and follow the status; without it the plugin does not work. Authentication uses the email address and API key that you request from Cycloon and enter in the plugin settings. Nothing is sent to Cycloon until those credentials are filled in. What is sent, and when: * **When a shipment is created** (manually from the order page, or automatically if you enable that): the recipient’s name, company name, address, postcode, city, country, phone number and email address, the order number as a reference, the number of parcels, the selected product, the delivery options and an optional note for the courier. The email address is included so that Cycloon can send track & trace updates to the recipient. Your store address from the WooCommerce settings is sent as well, both as the collection address and as the sender on the label. For destinations outside the EU, the customs details are included: item descriptions, quantities, weights, values and HS codes. * **When refreshing a status, retrieving a label, cancelling a shipment or linking an existing shipment : the shipment id or the track & trace code. Status refreshing also runs automatically, once an hour, for shipments that are still in transit. * **When testing the connection**: a non-existent shipment id, to verify that the connection and your credentials work. * **When looking up pickup points at checkout**: your customer’s postcode and country code. This only happens if you enable pickup point delivery and the customer selects that shipping method. The customer’s browser only talks to your own site; the plugin performs the lookup server-side and caches the response for six hours per postcode. No other customer data is included, and nothing is sent to Cycloon before the customer selects that shipping method. Cycloon can also push status updates to your site through a webhook, but only if you ask for that yourself by passing the webhook URL and an HMAC secret to Cycloon. Requests without a valid signature for that secret are rejected. Terms of use and privacy policy of the service: * Terms of use: https://www.cycloon.eu/algemene-voorwaarden * Privacy policy: https://www.cycloon.eu/privacy-policy ## Screenshots [⌊The settings page under WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon.⌉⌊The settings page under WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon.⌉[ The settings page under WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon. [⌊The "Delivery by Cycloon" method in a shipping zone.⌉⌊The "Delivery by Cycloon" method in a shipping zone.⌉[ The “Delivery by Cycloon” method in a shipping zone. [⌊The shipping method settings: rate, free shipping threshold, product and pickup points.⌉⌊The shipping method settings: rate, free shipping threshold, product and pickup points.⌉[ The shipping method settings: rate, free shipping threshold, product and pickup points. [⌊Creating a shipment from the order page: product, number of parcels and options.⌉⌊ Creating a shipment from the order page: product, number of parcels and options.⌉[ Creating a shipment from the order page: product, number of parcels and options. [⌊The shipment panel with status, history and the label buttons.⌉⌊The shipment panel with status, history and the label buttons.⌉[ The shipment panel with status, history and the label buttons. [⌊The Cycloon column in the order list, with the bulk action for labels.⌉⌊The Cycloon column in the order list, with the bulk action for labels.⌉[ The Cycloon column in the order list, with the bulk action for labels. [⌊Choosing a pickup point at checkout.⌉⌊Choosing a pickup point at checkout.⌉[ Choosing a pickup point at checkout. ## Installation 1. Upload the plugin folder to `/wp-content/plugins/` and activate the plugin. 2. Go to WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon. 3. Enter your email address and API key, save, and click “Test connection”. 4. Under WooCommerce ▸ Settings ▸ Shipping ▸ Shipping zones, add the “Cycloon” method to the zones you want and set the rate. 5. Open an order and create your first shipment from the “Cycloon shipment” panel. For webhook push updates, enter an HMAC secret under WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon and pass both that secret and the URL `https://yourshop.com/wp-json/cycloon/ v1/webhook` to klant@cycloon.eu. Without a secret the webhook endpoint rejects every request, so no one else can change your shipment data. ## FAQ ### Do I need a Cycloon account? Yes. Request an email address and API key through klant@cycloon.eu, then enter both under WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon. ### Why is the shipping method missing at checkout? Cycloon only collects parcels in the Netherlands, so the plugin requires the store location under WooCommerce ▸ Settings ▸ General to be set to the Netherlands. Check that first; the plugin also shows a notice in the admin explaining this. ### Can customers choose between home delivery and a pickup point? Yes. Enable pickup point delivery in the plugin settings, then open your Cycloon shipping method and set “Pickup point delivery” to “The customer chooses”. That single shipping method then offers both options at checkout, each with its own title and rate. ### Does the plugin fetch shipping rates from Cycloon? No. The API does not offer a rates endpoint, so you set the shipping costs per zone yourself. ### Can I print labels for several orders at once? Yes. Select the orders in the order list and choose the “Cycloon: download labels” bulk action. You get one merged PDF, or one ZPL file if you set the label format to ZPL. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Cycloon” is open source software. The following people have contributed to this plugin. Contributors * [ cycloon ](https://profiles.wordpress.org/cycloon/) [Translate “Cycloon” into your language.](https://translate.wordpress.org/projects/wp-plugins/cycloon) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/cycloon/), check out the [SVN repository](https://plugins.svn.wordpress.org/cycloon/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cycloon/) by [RSS](https://plugins.trac.wordpress.org/log/cycloon/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.2 * First version in the WordPress.org plugin directory. The plugin itself is unchanged; this release adds the screenshots and the images for the directory page. #### 1.0.1 * The webhook endpoint now requires an HMAC secret. Incoming status updates are only accepted when their X-Fietskoeriers-Hash header matches that secret; without a secret every request is rejected. If you use the webhook, enter a secret under WooCommerce ▸ Settings ▸ Shipping ▸ Cycloon and pass it to klant@cycloon.eu. * Translations are delivered through translate.wordpress.org; the plugin only ships the .pot template. * Admin notices are limited to the screens where they belong: the WooCommerce requirement and the Dutch shop location requirement only show up on the plugin list and on the Cycloon settings section, and all notices can be dismissed. On the order page the shop location requirement was already explained in the Cycloon panel itself. #### 1.0.0 * First release: shipping method for the checkout (per zone, with a free-shipping threshold), shipment creation, PDF labels (per order and in bulk), status sync( manual, hourly and webhook), track & trace in customer emails, customs for destinations outside the EU, and pickup point delivery. ## Meta * Version **1.0.2** * Last updated **9 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.1** * PHP version ** 8.1 or higher ** * Tags * [delivery](https://wordpress.org/plugins/tags/delivery/)[labels](https://wordpress.org/plugins/tags/labels/) [parcel](https://wordpress.org/plugins/tags/parcel/)[shipping](https://wordpress.org/plugins/tags/shipping/) * [Advanced View](https://wordpress.org/plugins/cycloon/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/cycloon/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/cycloon/reviews/) ## Contributors * [ cycloon ](https://profiles.wordpress.org/cycloon/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/cycloon/)