- 2026-05-28
- by LethaldiranMX
- Trends
- 0 Comments
DeveloperConnect WooCommerce to BlackBoxNG for live Lagos delivery rates at checkout, automatic order dispatch, and two-way status sync.
BlackBoxNG Delivery for WooCommerce is the official WooCommerce connector for BlackBoxNG, a Lagos-based last-mile delivery service. The plugin itself doesn’t dispatch riders or move parcels; it links your WooCommerce store to the BlackBoxNG dispatch network so that orders placed in your store automatically become delivery jobs on the BlackBoxNG side, and live shipping status flows back into the WooCommerce order as order notes and synced order statuses.
This plugin requires an active BlackBoxNG account. Sign up free at https://app.blackboxng.com. Without an account the shipping method won’t quote rates and order sync won’t fire. All delivery operations (rider dispatch, tracking, payment to BlackBoxNG for the service) happen on the BlackBoxNG side; the plugin is the connector, not the carrier.
What you get
- One-paste connection. Generate a single install token in the BlackBoxNG dashboard, paste it into WordPress, click Connect. No copy-pasting API keys, no OAuth dance.
- Auto-configured shipping zone. On first connect, the plugin creates a “BlackBoxNG Lagos” shipping zone wired up to our shipping method. No manual zone setup.
- Live rate quoting at checkout. Buyers see accurate Lagos delivery prices in real time, on both classic and block checkout. Rates are cached briefly per address so checkout stays snappy.
- Real-time order sync. Orders push to BlackBoxNG the moment they’re placed (configurable to push on payment instead). Per-order Send / Refresh actions for manual control.
- Two-way status sync. When the rider picks up, departs, or delivers, the status flows back into WooCommerce as an order note plus a synced order status. No polling required; updates arrive via signed webhooks.
- HPOS-ready. Compatible with WooCommerce’s High-Performance Order Storage (the default for new WC installs since 8.2).
- Block-checkout compatible. Live rates work in the Cart and Checkout blocks via WooCommerce’s Store API.
- GDPR-aware. Personal data exporter and eraser registered with WordPress’s built-in Privacy Tools so admin-initiated requests cover order data the plugin stamps locally.
Where this plugin operates
Lagos State, Nigeria. The shipping method only quotes rates for Lagos addresses; customers shipping elsewhere see no BlackBoxNG option at checkout and your other shipping methods handle them.
What this plugin is NOT
- Not a generic logistics framework: it’s a connector for one specific service (BlackBoxNG).
- Not a payment processor: BlackBoxNG service charges are billed separately by BlackBoxNG, not through WooCommerce.
- Not a tracking app for end-customers: order status flows into the WooCommerce order; end-customer tracking experience is handled by your existing WooCommerce email + tracking-page setup.
External services
This plugin connects to BlackBoxNG at https://app.blackboxng.com. Every endpoint is listed below; no data is sent to any other service.
When you click Connect: the plugin POSTs the install token, the WordPress site URL, and the site name to https://app.blackboxng.com/api/woocommerce/connect. BlackBoxNG returns a permanent API key (stored encrypted in wp_options) and a webhook secret for receiving status updates.
When you click Disconnect: the plugin POSTs to https://app.blackboxng.com/api/woocommerce/disconnect with the API key as a Bearer token to mark the credential row inactive on the BlackBoxNG side.
When a customer reaches checkout: the plugin POSTs the recipient address, weight, and total to https://app.blackboxng.com/api/woocommerce/rate to quote a live shipping rate. The address is used only for rate calculation; rates are cached briefly per address.
When a new order is placed (and the BlackBoxNG shipping method was chosen): the plugin POSTs the order details (recipient name, phone, email, shipping address, line items, total) to https://app.blackboxng.com/api/woocommerce/orders. This is what arranges the BlackBoxNG dispatch.
When the rider’s status changes (picked up, in transit, delivered, cancelled): BlackBoxNG POSTs the new status to the plugin’s webhook receiver at /wp-json/blackbox/v1/status on your site. The payload is HMAC-signed with the secret rotated at connect time.
No data is sent until you initiate one of these actions (Connect / customer-driven checkout / new order). The plugin does not phone home on install or activation.
- Terms of service: https://www.blackboxng.com/terms
- Privacy policy: https://www.blackboxng.com/privacy
