storefront

Create a storefront order

Finalize a storefront cart into a Foundry order. The storefront owns payment processing — Foundry just records the order, server-recomputes totals from current ChannelSku.price values, and reserves inventory.

Returns { orderId, orderNumber, status, lookupToken }. The token is the customer's escape-hatch reference: storefronts give it to the customer (in the confirmation email, account page, wherever) so they can fetch order status via Phase 3's GET /storefront/orders/:lookupToken without a Foundry account.

Pass Idempotency-Key to make retries safe — replays with the same key + body return the cached 2xx; same key + different body returns 409 to surface the misuse.

post/api/v1/storefront/orders

Request

  • Base URL: https://api.foundryims.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.foundryims.com/api/v1/storefront/orders
  • Auth: HTTP bearer

Headers

idempotency-keystring required
Idempotency-Keystring

24-128 char client-supplied key for retry-safe order creation

Request body

externalReferencestring
notesstring

Response

orderIdstring required
orderNumberstring required
statusstring required
lookupTokenstring required

Customer-facing order-status token.

Example response

{
  "orderNumber": "SF-A1B2C3D4",
  "status": "PROCESSING"
}

Changes

No recorded changes to this operation across all 1 revision of this API.