Take payments

WooCommerce

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.git
cd nordaxiz-harbour-connect
php 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

  1. In Harbour, open Settings · Developers and create a secret key. Start with a test key (hb_sk_test_…).
  2. 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.
  3. 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

  1. With a test key, place an order and pay on the provider's test page.
  2. Check the order turns Processing, and that the webhook delivery shows Delivered in Harbour's Settings · Developers.
  3. 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.