Take payments
Harbour StoreFront
Products with stock, a store page, website widgets and orders, all paid through Checkout.
Harbour StoreFront is an app the business switches on in Apps. The business adds its products
with prices and stock, and sells them on its own Harbour store page (pay.harbour.africa/s/your-business)
or on its website with widgets. Every order is paid through Harbour Checkout into the business's own provider
account.
Stock is held while the buyer pays
When a buyer presses Pay, the quantities are held for 15 minutes so nobody else can buy the last one at the same
time. A payment turns the hold into a sale and gives the order its number (ORD-0001 and on, with no gaps,
in live mode). An order not paid in time expires and its stock comes back. A full refund puts the stock back too.
Products can be "not tracked" when stock does not matter.
On your website
<script src="https://pay.harbour.africa/v1/harbour.js" data-key="hb_pk_live_…" async></script>
<!-- the whole store, or one collection -->
<div data-harbour="store"></div>
<div data-harbour="store" data-collection="col_…"></div>
<!-- one product with a Buy button -->
<div data-harbour="buy" data-product="prd_…"></div>
Buy opens the business's store page with the product chosen, in a new tab: payment never happens inside a frame. In live mode widgets only load on the websites listed on the key.
Orders
{
"object": "order",
"id": "ord_01k5…",
"number": "ORD-0042",
"app": "storefront",
"status": "paid", // pending | paid | fulfilled | delivered | refunded | cancelled | expired
"mode": "live",
"currency": "NGN",
"customer": { "name": "Bola", "email": "bola@example.ng", "phone": null },
"delivery": { "method": "delivery", "address": "12 Admiralty Way, Lekki", "fee_minor": 250000, "note": null },
"lines": [{ "name": "Aso-ebi lace", "quantity": 2, "unit_amount_minor": 1500000, "amount_minor": 3000000 }],
"subtotal_minor": 3000000,
"total_minor": 3250000,
"receipt_url": "https://pay.harbour.africa/o/ot_…"
}
Harbour sends order.paid, order.fulfilled and order.refunded webhooks. Mark an
order sent with POST /v1/orders/{id}/fulfil (optionally with a note the buyer gets by email),
or delivered with "status": "delivered". See the API reference.