Take payments

Harbour Apps

Apps a business switches on from its dashboard, each one tied to a Harbour Checkout payment.

Harbour Apps are features a business switches on from Apps in its Harbour dashboard. A Harbour app puts a Harbour feature on the business's own website or in its dashboard. A connector links Harbour to an account the business already has with another company. Every app leads to a payment through Harbour Checkout, or follows from one. Payments always go to the business's own provider accounts: Harbour never holds money, and no app is a marketplace.

What an app is

Each app has its own page in the dashboard with an Overview (what it does, everything it can do, switching it on and off) and an Activity log of what it did for the business. Harbour Checkout is the first app. It is part of every plan, is always on, and cannot be switched off.

The apps

AppKindWhere it sits in the paymentStatus
Harbour CheckoutHarbour appThe payment itself: harbour.js, hosted checkout, payment linksAvailable
Harbour InvoiceHarbour appInvoices the business sends, each paid through CheckoutAvailable
Harbour StoreFrontHarbour appA catalogue, cart and orders on the business's website, paid through CheckoutAvailable
Harbour TicketsHarbour appEvent booking with attendee approvals, QR tickets and a door scanner, paid through CheckoutAvailable
Harbour TaxManHarbour appAn estimate of tax owed from the business's Harbour income (Nigerian law by default; not tax advice)Available
Zoho BooksConnectorAfter payment: payments, refunds and settlements posted to the business's own booksAvailable
KlaviyoConnectorMarketing for sales: payment events and audiences, with campaigns run from HarbourAvailable
WhatsApp BusinessConnectorBefore and after payment: invoices, payment requests, receipts and tickets from the business's own WhatsApp numberAvailable

An app marked coming soon is listed in the dashboard so businesses can see what is on the way. It can be switched on once it is released. This page and the API reference grow with each app as it ships.

Setting an app up

The owner or an admin opens the app in Apps and chooses Set up. A short guided setup walks through everything the app needs, one step at a time, and shows which steps are done. It can be left and picked up later. The steps depend on the app:

StepWhich appsWhat happens
Switch it onAllAccept the Harbour Apps terms. The app starts in test mode.
Connect how you get paidInvoice, StoreFront, TicketsConnect a payment provider, such as Paystack. Setup returns to the app afterwards.
The app's own settingsStoreFront, TaxManPickup and delivery for StoreFront; the kind of business and VAT for TaxMan.
Connect your accountKlaviyo, Zoho Books, WhatsApp BusinessPaste a Klaviyo private API key, sign in with Zoho, or connect WhatsApp with Meta (or paste a Cloud API token).
Your website (optional)Invoice, StoreFront, TicketsType the website address, for example okafortextiles.ng.
Go liveInvoice, StoreFront, TicketsNeeds the provider's live keys and a two-step code.

Switching an app on works only when Harbour has released it and switched it on for everyone (each app starts off at Harbour), and when the business's plan includes it (every plan includes every app while they are free for now). Acceptance of the terms is recorded for the business, per app and per version of the terms. Staff accounts can open apps but cannot set them up or switch them off.

Apps that are on appear under My apps in the side menu. The full list stays under App directory.

Test and live

An app starts in test mode, so it can be tried with test payments. Going live is the last setup step. It needs the business's payment provider connected with live keys, and a two-step code. A website is not needed to go live: links such as invoice pay links work without one.

To show an app's widget on a website, the business adds the website in the setup step. Harbour adds both the address with and without www., on https. Live widgets then load only on the websites added, and test widgets load anywhere. Developers can still manage the same list on a live public key in Settings, Developers.

Working in a connected app from Harbour

Once a connector is connected, the business does the everyday work for that system from Harbour, as far as the partner's API allows. For example, it can create, schedule and send Klaviyo campaigns, or chase unpaid Zoho Books invoices with a Harbour pay link. The same actions will be available through the Harbour API with a secret key, so the business's own systems can start them too.

Each connector's page opens with a notice listing what can be done in Harbour, what can be done through the API, and what stays in the partner's own app. Closing the notice hides it for that person on every device. It comes back when the app gains something new.

Pricing

Each app is a yearly module on the Harbour price list and is part of the plans that include it. Every app is free for now: the list price is shown with a 100% discount. Harbour gives at least 30 days' notice by email before any app starts to cost money.

Paused and switched off

The business can switch an app off at any time. It stops at once in test and live, and everything set up in it is kept, so switching it on again picks up where it left off. Harbour can pause an app for every business, for example while a partner's service is failing. The app's page then says why, its owners are emailed, nothing is deleted, and it comes back by itself. Payments through Harbour Checkout are never affected.