Set up the Maxmove WooCommerce plugin

The Maxmove WooCommerce plugin adds Maxmove as a shipping method, requests eligible delivery quotes at checkout, and automatically creates Maxmove deliveries from qualifying WooCommerce orders.

Requirements#

• WordPress 6.7 or later, PHP 7.4 or later, and WooCommerce 8.9 or later.
• Admin access with the manage_woocommerce capability.
• A Maxmove business workspace with a valid company card.
• HTTPS for the public store and reachable WordPress REST endpoints.
• At least one WooCommerce shipping zone for your intended delivery area.

The plugin supports WooCommerce High-Performance Order Storage and block checkout. Classic checkout remains compatible.

Install the plugin#

1. Download the plugin package provided by Maxmove.
2. In WordPress, open Plugins → Add Plugin → Upload Plugin.
3. Select the ZIP file, install it, and activate the plugin.
4. Open WooCommerce → Maxmove.

Only install updates from a source confirmed by Maxmove. Do not change the Maxmove API address; it is fixed during normal operation.

Connect your business workspace#

1. In the Maxmove dashboard, create a new link token under Integrations → WooCommerce.
2. Under WooCommerce → Maxmove → Store connection and pickup, paste it into Link token.
3. Enter the store's complete pickup address.
4. Save your changes.

After a successful connection, the setup checklist shows the linked business workspace and its billing status.

Enable Maxmove in shipping zones#

1. Open WooCommerce → Settings → Shipping → Shipping zones.
2. Select a zone where Maxmove should be available.
3. Add the Maxmove Delivery shipping method.
4. Enable the method and save the zone.
5. Repeat for every eligible zone.

WooCommerce cannot show a Maxmove checkout option unless the shipping method is active in the zone matching the delivery address.

Review delivery rules#

The central Maxmove configuration controls:

• automatic or manual order import,
• whether only paid WooCommerce orders import,
• default vehicle and available delivery modes,
• live price, price adjustment, fixed price, or free delivery,
• optional add-on services and who pays for them.

The WooCommerce page shows a read-only copy of these rules. Use Edit in Maxmove to change the server-owned policy.

Test checkout#

1. Use a delivery address inside an enabled shipping zone.
2. Add a shippable product with a weight to the cart.
3. Confirm that Maxmove Delivery appears with a price and available delivery window.
4. Select optional add-on services if needed and complete a test order.
5. Review the WooCommerce order notes and Maxmove order reference.

The shopper's payment remains entirely in WooCommerce. Maxmove authorizes the delivery cost separately against the company card on the connected business workspace.

What happens after checkout#

1. WooCommerce reaches a configured order status that is ready for delivery.
2. The plugin places an asynchronous import job in the WooCommerce Action Scheduler queue.
3. Maxmove validates the checkout quote and authorizes the delivery cost.
4. After a successful import, WooCommerce stores the Maxmove order ID.
5. Signed webhooks update delivery status and order notes.

Temporary failures can be retried safely. The plugin prevents duplicate deliveries with stable idempotency data.

Common issues#

Maxmove is missing at checkout: Check the shipping zone, pickup address, company card, product weight, and Maxmove service area.

The setup checklist is incomplete: Open WooCommerce → Maxmove and complete connection, billing, pickup address, and shipping zone in order.

An order did not import: Confirm that its WooCommerce status is included in the configured “Ready statuses.” Use the order action to retry the Maxmove delivery.

Status updates are missing: Confirm that WordPress REST endpoints are publicly reachable and that no firewall blocks signed Maxmove webhooks.