Take payments in a WooCommerce store with the Harbour for WooCommerce plugin.
Harbour for WooCommerce sends shoppers to Harbour's hosted checkout, which hands off to your own Paystack,
Flutterwave or OPay page, and completes the order when Harbour confirms the payment. It works with the block checkout
(the default since WooCommerce 8.3) and the classic checkout, and with High-Performance Order Storage. The store must
sell in Nigerian naira. Harbour never holds money: every naira settles from your provider to your bank.
Install
Download harbour-for-woocommerce.zip from the latest
build of Harbour Connect, or build it
yourself:
Terminal
git clone https://github.com/Nordaxiz-Technology-Limited/nordaxiz-harbour-connect.gitcd nordaxiz-harbour-connectphp woocommerce/build.php # writes woocommerce/dist/harbour-for-woocommerce-0.1.0.zip, SDK included
In WordPress, open Plugins · Add New · Upload Plugin, choose the zip and activate it. It needs
WordPress 6.4, WooCommerce 8.6 and PHP 8.1 or newer.
Connect it to Harbour
In Harbour, open Settings · Developers and create a secret key. Start with a test key
(hb_sk_test_…).
Still there, add a webhook endpoint with your store's address. The plugin's settings page shows it; it looks
like this:
Terminal
https://your-store.ng/?wc-api=harbour_webhook
Copy the endpoint's signing secret (whsec_…). It is shown once.
In WordPress, open WooCommerce · Settings · Payments · Harbour, paste the secret key and the
signing secret, choose a provider or leave it on Auto, and enable the gateway.
How orders complete
The webhook completes the order. When Harbour sends a signed charge.succeeded, the
order moves to Processing with the Harbour reference (HB-…) as its transaction ID, even if the
shopper closed the tab.
The return is verified. When the shopper comes back, the plugin asks Harbour about the charge
before showing the thank-you page. The status in the address is never trusted on its own.
The amount must match. If the paid amount differs from the order total (for example, the basket
changed after the checkout was created), the order goes On hold with a note instead of Processing.
Failed payments mark a pending order Failed, and the shopper can try again from their account.
Each try is a new Harbour checkout; late webhooks for older tries are still matched to the order.
Every event is applied once. Harbour's retries, and replays, change nothing.
Refunds
Refund from the order screen as usual. The plugin asks Harbour for the refund, which goes to the business owner's
approval queue in the Harbour dashboard or app before any money moves. The order gets a note when the refund completes,
and a warning if it is declined or fails, because WooCommerce has already recorded it as refunded.
Test before going live
With a test key, place an order and pay on the provider's test page.
Check the order turns Processing, and that the webhook delivery shows Delivered in Harbour's
Settings · Developers.
Swap in the live key (hb_sk_live_…) and a live webhook endpoint with its own signing secret.
When something is off
Harbour does not appear at checkout: the store currency must be Nigerian naira, the gateway
enabled, and a secret key saved.
Orders stay Pending payment: check the webhook endpoint's deliveries in Harbour. A 500 response
means no signing secret is saved yet (Harbour keeps retrying); a 400 means the signing secret does not belong to
that endpoint.
Turn on the debug log in the plugin settings and read WooCommerce · Status · Logs
(source harbour). Keys are never written to the log.