The Order Confirmation page is shown immediately after a successful checkout and order placement. The page presents a summary of the completed order, including:
The storefront retrieves the order summary using either the order reference number or the order summary ID, both of which are supported by the Order Summary APIs.
This flow demonstrates how a headless storefront can render order confirmation experiences, including order summaries, purchased items, pricing totals, shipping details, and payment information, using B2B Commerce Order Summary APIs.
| Operation | HTTP Method | Endpoint |
|---|---|---|
| Get order summary | POST | /commerce/webstores/{webstoreId}/order-summaries/actions/lookup |
Some storefront implementations retrieve order data through multiple API calls, such as:
/order-summaries/{orderSummaryId}/order-summaries/{orderSummaryId}/items/order-summaries/{orderSummaryId}/delivery-groups/order-summaries/{orderSummaryId}/adjustments-aggregatesA single call to POST /commerce/webstores/{webstoreId}/order-summaries/actions/lookup returns the complete order summary payload required by the Order Confirmation page in a single round trip. Prefer the lookup API approach to reduce network requests and improve page load performance.
Load the order confirmation page.
Call the following endpoint to retrieve the order summary:
POST /commerce/webstores/{webstoreId}/order-summaries/actions/lookup
Example request body:
1{
2 "orderSummaryIdOrRefNumber": "<order-id>"
3}Pass either of the following values in orderSummaryIdOrRefNumber:
Use the POST variant of the lookup endpoint for both authenticated and guest order lookup flows. The endpoint also supports a GET request with the identifier passed as a query parameter, but the POST request provides a consistent implementation path across buyer types.
Use the response to retrieve:
deliveryGroups[].lineItemspayments[].paymentMethod.fieldscurrencyIsoCodetotals field mapRender the order confirmation experience using the response data.
Display the following sections on the page:
This flow allows buyers to recreate a previous order by adding items from the original order to an active cart.
Add a View Order Details action to retrieve richer order item metadata using:
GET /commerce/webstores/{webstoreId}/order-summaries/{orderSummaryId}/items?fields=... This endpoint requires a valid orderSummaryId rather than an order reference number. Resolve the summary ID from the initial order lookup response before calling the order items API.
Add a Reorder action using:
POST /commerce/webstores/{webstoreId}/order-summaries/actions/add-order-to-cart
Example request body:
1{
2 "orderSummaryId": "<orderSummaryId>",
3 "cartId": "<optionalCartId>"
4}
j