Commerce Webstore Checkout Place Order Action API

Use for advanced scenarios requiring better control, extensibility, and resilience through a staged workflow. The Commerce Webstore Checkout Place Order Action API is also referred to as Place Order V2 or Streamlined Place Order.

Endpoint: POST /commerce/webstores/{webstoreId}/checkouts/{activeOrCheckoutId}/orders/actions

Prerequisite: Streamlined Place Order enabled for webstore. See Streamlined Place Order

How it works:

  • The request must include an action in the body: prepare or submit.
  • Two-step process:
    • Prepare – Performs validations and readiness checks.
    • Submit – Finalizes and creates order.
  • On success, returns 200 OK (Submit returns ORN).
  • On failure, returns 422 Unprocessable object.

Orchestration:

  • Call Prepare before payments.
  • Process payments.
  • Call Submit after payments.

Validates whether cart is ready for order placement.

Supported cart states:

  • Checkout
  • PendingClosed (returns early if already in this state).

Extension support:

Finalizes and creates order.

Supported cart states:

  • Checkout
  • PendingClosed (returns existing OrderReferenceNumber (ORN) if already in this state)

Execution flow:

  • Validations, inventory, coupon processing in Prepare.
  • Order placement in Submit.
  • Cart-to-order processing runs asynchronously after Submit.

Extension support: