We provide a dedicated plugin to simplify integration with WooCommerce. It lets you connect your WooCommerce store to Onro without manual configuration or complex setup steps. Once installed and configured, it enables order syncing between both systems. This guide walks you through the installation and setup process step by step.
Prerequisites
Before starting, make sure you have:
A live WooCommerce store
Administrator access to WordPress
An active Onro account
Optional but recommended: WooCommerce REST API keys with Read/Write permission
What this integration does
After setup, the plugin enables the following capabilities:
🔗Connection
It connects your WooCommerce store to Onro with an API key
➡️Automation
Automatically creates deliveries when orders reach selected WooCommerce statuses.
Automatically cancels deliveries based on selected WooCommerce order statuses.
⚙️Admin actions
Allows store managers to manually send, confirm, cancel, sync, and track deliveries from the WooCommerce admin
📦Order visibility
Display synced Onro deliveries inside WooCommerce
🔎Tracking & customer view
Show tracking links, label links, and receipt links (when available) on customer order pages.
Installation and Setup
Step 1 - Configure the integration in Onro Admin Center
Before installing and configuring the plugin in WordPress, you need to create or review the WooCommerce integration record in the Onro Admin Center. To do so, navigate to the path below:
Admin Center -> Settings -> Integration -> POS
On this page, click on the WooCommerce (Plugin) to open its configuration window.
In the integration settings window, provide the following information:
Title: Enter an Internal name for this integration record, for example, the store name.
Business: Select the Onro business customer account that should receive WooCommerce deliveries.
Consumer Key: Enter the WooCommerce REST API consumer key if you are using WooCommerce REST synchronization.
Consumer Secret: Enter the WooCommerce REST API consumer secret paired with the consumer key.
Order Type: Select the order type used for deliveries created from WooCommerce orders.
Service: Select the service that should be assigned to this WooCommerce store deliveries.
Vehicle Type: Selecting Vehicle Type is optional and restricts deliveries to a specific vehicle type if your operation requires it.
Payment Method: Select the payment method that should be used for deliveries created through this integration.
Pickup Location: Select the default pickup address to be used when pickup is handled from Onro.
If you want the plugin to use the customer’s pickup address set in Onro, make sure the correct pickup location is configured here before enabling pickup from Onro in WooCommerce.
Api Key: The Onro API key used to connect the WooCommerce store.
Finally, click Submit to save the integration settings.
Before saving the integration, make sure the selected Business, Service, Payment Method, and Pickup Location match your actual WooCommerce delivery flow.
You can connect multiple stores by repeating the same steps and creating a separate integration for each store under a different business customer account.
Step 2 - Install and activate the plugin in WordPress
Now it's time to install the plugin. Log in to your WordPress admin dashboard and navigate to Plugins → Add New Plugin. You can either upload the Onro plugin ZIP file or search for Onro in the plugin directory and install it directly.
Once the installation is complete, make sure to activate the plugin.
After activating the plugin, you should see the Onro and Onro Orders menu items under WooCommerce in the WordPress admin sidebar.
Step 3 - Connect WooCommerce to Onro
To connect WooCommerce to Onro, navigate to the following page in your WordPress admin dashboard:
WordPress Admin Sidebar→ WooCommerce → Onro
On the settings page, complete the Connection section by doing the following:
Enter the Onro API Key. This is the API key generated (at step 1) in Onro when you completed the integration setup in the Onro Admin Center.
Then click:
Connect if the store is not connected yet.
Save if the store is already connected and you are updating settings.
After a successful connection, the plugin should show a green Connected badge.
If the API key is invalid or the Onro service is unavailable, the page will show an error message and the new settings will not be committed.
Step 4 (Optional ) - WooCommerce REST API Setup
WooCommerce REST API credentials are optional, but we recommend configuring them to improve synchronization between WooCommerce and Onro.
To generate them, in the WordPress admin dashboard, follow the path below:
WooCommerce -> Settings -> Advanced -> REST API
Enter these recommended values for:
Description: Integration with Onro
User: Administrator or integration user
Permissions: Read/Write
Then click Generate API Key. After the key is generated, you'll need to :
Copy the Consumer Key
Copy the Consumer Secret
Now that you copied the keys, it's time to configure them in the plugin settings.
Go back to the WooCommerce > Onro menu and paste them into the Consumer Key and Consumer Secret inputs.
These keys allow Onro to update order and delivery state in WooCommerce more reliably.
Step 5 - Configure automatic delivery creation
On the WooCommerce → Onro settings page, locate the Automation section and enable Auto Create Delivery When Order Status Changes.
Then select the WooCommerce order statuses that should automatically create a delivery in Onro (A commonly recommended configuration is Processing)
When an order reaches one of the selected statuses, the plugin automatically sends the delivery request to Onro.
Orders should contain valid shipping details. Automatic delivery creation depends on the order requiring shipping and having a usable delivery address.
Automatic creation works best when:
the order requires shipping
the delivery address is complete
the order has not already been sent to Onro
Step 6 - Configure automatic cancellation
On the WooCommerce → Onro settings page, locate the Automation section and enable Auto cancel delivery when order status changes.
Then select the statuses that should trigger automatic cancellation. When an order that already has an Onro delivery reaches one of these statuses, the plugin automatically sends a cancellation request to Onro.
Recommended statuses to choose:
Cancelled
Refunded
Failed
Automatic cancellation only works when:
the order already has an Onro delivery ID
the new WooCommerce status is in the selected cancellation list
Step 7 - Configure pickup location behavior
On the WooCommerce → Onro settings page, the Pickup Location Settings section controls whether the pickup location should come from Onro or the WooCommerce store address by enabling/disabling Use the Onro pickup address as the pickup location.
When enabled, the plugin uses the pickup address configured in Onro. If none is available, it falls back to the WooCommerce store address.
When disabled, the WooCommerce store address will be used as the pickup address.
To make sure the WooCommerce fallback works correctly, complete the store address by going to WooCommerce -> Settings -> General and completing these recommended fields:
Store Address
City
Postcode
Country / State
Step 8 – View Onro Orders in WooCommerce
Now that your store is successfully connected, you can view synced orders from Onro by going to WooCommerce → Onro Orders.
This page is pretty useful for daily operations, giving your team a quick overview of delivery status without leaving WooCommerce.
It also allows store managers to:
View synced orders from Onro
Filter orders by order code, status, and date ranges (created and updated)
Access tracking and label links for each delivery
Perform Confirm and Cancel actions based on the current delivery status
Step 9 - Use order-level delivery actions
On the WooCommerce order page, the Onro plugin can show:
Send to Onro
Confirm
Cancel
Tracking
When the order isn't created in Onro
When the order is created in Onro
The information shown in the plugin depends on the current delivery state returned by Onro.
Examples:
Send to Onro appears when no Onro delivery exists yet
Confirm appears only for statuses that support confirmation
Cancel appears only for statuses that support cancellation
Step 10 - Validate the integration with a real order
To verify that the integration is successful and the orders are syncing properly, you can do the test below.
1. Create a test order that:
requires shipping
contains a valid customer delivery address
reaches one of your configured auto-create statuses
2. Then verify:
the order receives an Onro delivery ID
the order appears in WooCommerce > Onro Orders
the Onro Delivery box appears on the order screen
tracking, label, and other returned links display when available
If automatic cancellation is enabled, test a second order by moving it to one of your configured cancellation statuses.
Troubleshooting
⛔The store does not connect
If you are experiencing issues connecting the store, check the following:
The API key is valid and correctly entered
The server can reach the Onro service
No firewall or security plugin is blocking outbound API requests
⛔Deliveries are not created automatically
If deliveries are not being created automatically, check the following:
Auto Create Delivery When Order Status Changes is enabled
The order has reached one of the selected triggering statuses
The order requires shipping
The customer delivery address is complete
The order has not already been sent to Onro
⛔Deliveries are not cancelled automatically
If deliveries are not getting canceled automatically, check the following:
Auto cancel delivery when order status changes is enabled
The order already has an Onro delivery ID
The new WooCommerce status is one of the selected cancellation statuses
⛔Confirm or Cancel fails from WooCommerce admin
If Confirm or Cancel actions fail in the WooCommerce admin, check the following:
The current delivery status supports the action
The store is still connected
API requests are not blocked by the hosting environment or firewall restrictions
If a manual action fails, the plugin displays an admin notice that includes the response returned by the Onro service.
Still facing an issue?
If your problem is not listed above, reach out to [email protected] for assistance.