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

HTML
<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

JavaScript
{
  "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.