Title: BlackBoxNG Delivery for WooCommerce Author: blackboxng Published: Èbìbí 27, 2026 Last modified: Èbìbí 27, 2026 --- Ṣàwárí àwọn plugin ![](https://ps.w.org/blackboxng/assets/banner-772x250.png?rev=3551283) ![](https://ps.w.org/blackboxng/assets/icon-256x256.png?rev=3551283) # BlackBoxNG Delivery for WooCommerce Láti ọwọ́ [blackboxng](https://profiles.wordpress.org/blackboxng/) [Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/blackboxng.1.0.0.zip) * [Àwọn àlàyé](https://yor.wordpress.org/plugins/blackboxng/#description) * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/blackboxng/#reviews) * [Ìgbéwọlẹ̀](https://yor.wordpress.org/plugins/blackboxng/#installation) * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/blackboxng/#developers) [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/blackboxng/) ## Àpèjúwe **BlackBoxNG Delivery for WooCommerce** is the official WooCommerce connector for** BlackBoxNG**, a Lagos-based last-mile delivery service. The plugin itself doesnÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’t quote rates and order sync wonÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá:’ 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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s Store API. * **GDPR-aware.** Personal data exporter and eraser registered with WordPressÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s status changes** (picked up, in transit, delivered, cancelled): BlackBoxNG POSTs the new status to the pluginÌtumọ̀ Yorùbá: ’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 ## Àwọn àwòrán ìbòjú * [[ * WordPress plugins list with the BlackBoxNG Settings link. * [[ * The connect screen: paste your install token, click Connect. * [[ * The auto-configured “BlackBoxNG Lagos” shipping zone. * [[ * Live rate quoting at the WooCommerce checkout. * [[ * The per-order BlackBoxNG panel with tracking ID and a Refresh button. * [[ * The order list with the BlackBoxNG sync status column. ## Ìgbéwọlẹ̀ 1. Install and activate the plugin (Plugins Add New, or upload the .zip). 2. In WordPress admin, open the **BlackBoxNG** menu. 3. In the BlackBoxNG dashboard at https://app.blackboxng.com, generate an install token (valid for 60 minutes, single use). 4. Paste the token into WordPress and click Connect. The “BlackBoxNG Lagos” shipping zone is created automatically; new orders start syncing within seconds. **Upgrading from a manually-distributed beta?** Deactivate the old plugin, delete it, then install this WordPress.org release. Your WooCommerce orders and zones are untouched; you reconnect once with a fresh install token from the BlackBoxNG dashboard. ## FAQ ### Do I need a BlackBoxNG account first? Yes. Sign up free at https://app.blackboxng.com. The plugin is a connector for the BlackBoxNG dispatch service; without an account, no rates are quoted and no orders are dispatched. ### Where is my data stored? The plugin stores your BlackBoxNG API key encrypted in WordPressÌtumọ̀ Yorùbá: ’ s `wp_options` table (AES-256-GCM, keyed off your siteÌtumọ̀ Yorùbá: ’s `AUTH_KEY`). Order data flows through the BlackBoxNG API; see https://www.blackboxng.com/privacy for retention details on the BlackBoxNG side. The plugin stamps a tracking identifier on each WooCommerce order it dispatches; nothing else customer-identifiable is stored locally. ### What happens at checkout if my customerÌtumọ̀ Yorùbá: ’s address is outside Lagos? The BlackBoxNG shipping option wonÌtumọ̀ Yorùbá: ’t appear: the API returns no rate for out-of-zone addresses, and WooCommerce naturally falls back to your other configured shipping methods. ### How do I disconnect? Open WordPress BlackBoxNG Disconnect. The plugin POSTs a disconnect signal to BlackBoxNG, then wipes the local API key. You can reconnect later by generating a fresh install token. ### Will this work with my existing shipping methods? Yes. The plugin adds a new “BlackBoxNG Lagos” shipping zone; your existing zones and methods are untouched. WooCommerce shows BlackBoxNG delivery to customers shipping into Lagos and your other methods to customers elsewhere. ### Does the plugin send any data on install or activation? No. The activation hook only sets a one-time welcome-notice transient. No remote calls happen until you click Connect; no data is sent to BlackBoxNG, no tracking pixels, no analytics, no “phone home” of any kind. ### How much does this cost? The plugin is free. BlackBoxNG charges per delivery based on distance, weight, and tier; pricing is shown in the BlackBoxNG dashboard and at checkout (the rate the customer sees). See https://www.blackboxng.com for current pricing. ### Where can I get help? Open a thread in the WordPress.org support forum for this plugin, or contact BlackBoxNG support directly from https://app.blackboxng.com for issues that need account-side investigation. ### Does this support High-Performance Order Storage (HPOS) and the block-based checkout? Yes to both. The plugin declares compatibility with `custom_order_tables` (HPOS) and `cart_checkout_blocks`. Order meta is read and written via WooCommerceÌtumọ̀ Yorùbá: ’s order API rather than `wp_postmeta`, and shipping rates are exposed to the Store API consumed by the Cart/Checkout blocks. ### How are personal data export and erasure requests handled? The plugin registers WordPressÌtumọ̀ Yorùbá: ’s built-in privacy exporter and eraser. When an admin uses Tools Export Personal Data or Tools Erase Personal Data with a customer email, the plugin returns / removes any BlackBoxNG tracking identifiers stamped on that customerÌtumọ̀ Yorùbá: ’s orders. Erasing the customerÌtumọ̀ Yorùbá:’ s record on the BlackBoxNG side is a separate request you make directly to BlackBoxNG via https://www.blackboxng.com/privacy. ## Àwọn àgbéyẹ̀wò Kò sí àwọn àgbéyẹ̀wò fún plugin yìí. ## Àwọn Olùkópa & Olùgbéejáde “BlackBoxNG Delivery for WooCommerce” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí. Àwọn Olùkópa * [ blackboxng ](https://profiles.wordpress.org/blackboxng/) * [ shegzico ](https://profiles.wordpress.org/shegzico/) [Túmọ̀ “BlackBoxNG Delivery for WooCommerce” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/blackboxng) ### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè? [Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/blackboxng/), ṣàyẹ̀wò [ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/blackboxng/), tàbí ṣe àgbékalẹ̀ sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/blackboxng/) nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/blackboxng/?limit=100&mode=stop_on_copy&format=rss). ## Àkọsílẹ̀ àwọn àyípadà #### 1.0.0 * Initial WordPress.org release. * Install-token connect flow (no API key copy-pasting). * Auto-configured Lagos shipping zone. * Real-time order push (configurable: on creation or on payment). * Live rate quoting at checkout, classic and block. * Two-way status sync via signed webhooks (no polling required). * HPOS + Cart/Checkout Blocks compatibility declarations. * WordPress Privacy Tools integration (exporter + eraser + policy suggestion). ## Àkójọpọ̀ Meta * Ẹ̀yà **1.0.0** * Ìgbàgbọ́hùn tó kẹ́yìn **ọjọ́ 6 sẹ́yìn** * Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **Tó kéré sí 10** * Ẹ̀yà WordPress ** 6.2 tàbí ju bẹ́ẹ̀ lọ ** * Dánwò dé **6.9.4** * Ẹ̀yà PHP ** 7.4 tàbí ju bẹ́ẹ̀ lọ ** * Èdè * [English (US)](https://wordpress.org/plugins/blackboxng/) * Àwọn àmì * [courier](https://yor.wordpress.org/plugins/tags/courier/)[delivery](https://yor.wordpress.org/plugins/tags/delivery/) [shipping](https://yor.wordpress.org/plugins/tags/shipping/)[woocommerce](https://yor.wordpress.org/plugins/tags/woocommerce/) * [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/blackboxng/advanced/) ## Àwọn ìbò Kò sí ìwádìí tí a tíì fi ránṣẹ́. [Your review](https://wordpress.org/support/plugin/blackboxng/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/blackboxng/reviews/) ## Àwọn Olùkópa * [ blackboxng ](https://profiles.wordpress.org/blackboxng/) * [ shegzico ](https://profiles.wordpress.org/shegzico/) ## Ìrànlọ́wọ́ Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́? [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/blackboxng/)