Orders

The sale is the start.Follow every order to the door.

Every order your agent places lands in one list, with the store's own order number. As stores report shipping and delivery, Harbor tells your server the moment anything changes.

Get API keys Read the guide
Orders
Brooklinen · Hand Towelsplaced
Allbirds · Dasher NZshippeddelivered
Target · Tide Pods 42 ctdelivered
Chemex · Golden T-Shirtreturn open

One order object.Whichever way it was placed.

merchant_order_ref

The store's number

The one in the user's confirmation email, so support is one lookup away.

tracking

Carrier and link

Added when the order ships, ready to show in your app.

status

Five states

placed, shipped, delivered, canceled, returned.

checkout_id

The full story

Every order links to its checkout and a step-by-step replay in the dashboard.

Today: order numbers on every route. Shipping and delivery updates work end to end in the sandbox and are rolling out store by store; each merchant's capabilities.orders says where they're live.

GET /v1/orders/ord_…
{
  "id": "ord_0n2k29185t5p1u04644a",
  "merchant_id": "allbirds",
  "merchant_order_ref": "1041",
  "status": "shipped",
  "total": { "amount": 14000, "currency": "USD" },
  "tracking": [{
    "carrier": "UPS",
    "number": "1Z999…"
  }]
}
POST yourapp.com/harbor/webhooks
Harbor-Signature: t=1790227763,v1=5257a869e7…

{
  "type": "order.updated",
  "data": {
    "id": "ord_0n2k29185t5p1u04644a",
    "status": "delivered"
  }
}
webhooks

Know the moment it changes.

Harbor posts an event to your server for every checkout and order change, signed with your endpoint's secret so you can trust it.

  • order.updated for placed, shipped, delivered and returns.
  • checkout.completed and checkout.failed as they happen.
  • HMAC-SHA256 signatures, with Node and Python examples in the docs.

Webhooks guide →

See every step of every order.In the dashboard, for sandbox and live.

replay

Step-by-step history

Every state a checkout went through, with timings and the exact data at each step.

users

Who bought what

Each of your users, the stores they connected, and their orders.

events

Every webhook

The events Harbor sent, per environment, next to your endpoints and secrets.

From "buy it"to "it's here."