Storefront API quickstart

1. Choose the request context

Storefront results depend on the market and shopper. Resolve the store, price channel, currency, country, and locale once, then reuse them across product queries and cart creation.

Not every operation requires every value. Pass the dimensions your storefront supports instead of relying on implicit defaults.

Read Storefront request context before adding market switching or public caching.

2. Query products

Query only the fields needed by the current surface. Product lists use cursor pagination; keep endCursor with the filters, sort, and request context that produced it.

Prices use integer minor units. Format centAmount with currencyCode and fractionDigits, and treat the returned contextual price as authoritative.

See the complete products reference for filtering, facets, and backward pagination.

3. Create a cart

Create the cart with the same store, price channel, currency, and country used for discovery. The cart recalculates price, discounts, availability, tax, and totals; do not copy a product price into checkout state.

Inspect both cart and the typed payload errors. A successful HTTP response does not guarantee that the business operation succeeded.

Persist the returned cart ID and use the latest cart returned by every subsequent mutation.

Continue the integration

Use the dedicated guides when you move beyond the first request:

• Keep catalog and cart context aligned
• Build hosted or custom checkout
• Add customer authentication
• Handle transport, GraphQL, and business errors