WooCommerce Plugin

The IDeliver for WooCommerce plugin connects your WordPress / WooCommerce store to IDeliver. When a customer places an order and it reaches your chosen status (e.g. Processing), the plugin automatically forwards the order to IDeliver and a rider is dispatched — no code, no manual copy-paste.

Download

⬇ Download ideliver-for-woocommerce.zip

This is a standard WordPress .zip file. Install it directly from your WordPress admin panel — no FTP required.

v1.1 adds multi-origin pickup defaults, per-order origin / dispatch-preference overrides, and hold auto-dispatch until origin is set.

Requirements

Installation

Step 1 — Upload the plugin

1. In your WordPress admin, go to Plugins → Add New Plugin
2. Click Upload Plugin at the top of the page
3. Click Choose File, select the ideliver-for-woocommerce.zip file you downloaded
4. Click Install Now, then Activate Plugin

Step 2 — Open the settings

Go to WooCommerce → Settings → Integrations → IDeliver Delivery

You will see sections: IDeliver Account, Dispatch Settings, Pickup Origins, WooCommerce Webhook, and Debug.

Configuration

IDeliver Account

After filling in your Merchant ID and API Key, click Test Connection to verify the credentials are working.

Dispatch Settings

Pickup Origins (multi-warehouse)

Optional. Configure one or more warehouses / hubs so each order can pick a pickup location.

WooCommerce Webhook (recommended)

The plugin can register WooCommerce webhooks automatically, so IDeliver is notified in real time as orders change:

1. Fill in your Merchant ID and Webhook Secret first
2. Click Register WooCommerce Webhooks
3. The plugin creates two active webhooks in WooCommerce → Settings → Advanced → Webhooks:
   • IDeliver — order.created
   • IDeliver — order.updated

You can also copy the Webhook URL shown in the settings and add it manually in WooCommerce.

How auto-dispatch works

Customer places order
        ↓
WooCommerce order reaches trigger status (e.g. "Processing")
        ↓
Plugin signs the order payload with HMAC-SHA256
        ↓
Signed POST → https://api.ideliver.ng/webhooks/woocommerce/{your-merchant-id}
        ↓
IDeliver creates a delivery + dispatches a rider
        ↓
Order meta updated: dispatch ID, status, tracking URL

The plugin prevents double-dispatch: if an order has already been sent to IDeliver, it will not be dispatched again when the status changes again (e.g. from Processing → Completed).

Order metabox

Every WooCommerce order edit page shows an IDeliver Dispatch panel in the right sidebar:

Pickup origin and dispatch preference are orthogonal: origin is where to pick up; preference is which rider pool to use.

Orders list column

A compact IDeliver column appears in WooCommerce → Orders, showing a coloured status icon at a glance:

Dispatch status reference

Manual dispatch

If auto-dispatch is off, or if an order was placed before the plugin was configured:

1. Open the order in WooCommerce → Orders → [Order number]
2. In the IDeliver Dispatch sidebar panel, click Dispatch Now
3. The order is sent to IDeliver immediately

If a previous dispatch attempt failed, click Retry Dispatch to try again.

Wallet & billing

Dispatching an order deducts the delivery fee from your IDeliver wallet. Make sure your wallet has sufficient balance at merchant.ideliver.ng/wallet  before orders are dispatched.

If your balance is too low, the dispatch will fail and a note will be added to the order. Top up and click Retry Dispatch.

Troubleshooting

Uninstalling

Deactivate and delete the plugin from Plugins → Installed Plugins. Order meta data (_ideliver_*) stored on existing orders is not deleted — your order history is preserved.

Related

• Webhooks & Events — Receive IDeliver order status updates in your own system
• Orders & Deliveries — Full order lifecycle documentation
• Quick Start — Set up your IDeliver account from scratch
• SDKs — Programmatic integration via REST API or generated clients