Rivier/ Reference/ shop

Place an order from a cart

post/shop/orders

Place an order from a cart. Prices, tax and shipping are worked out again; the stock is committed; idempotent on the key.

Before you call

Credential
Authorization: Bearer $KEY
Scope
shop:write
Mcp
rivier_shop_order_place
Graphql
Mutation.placeShopOrder
Sdk
shop.order.place
Cli
shop order place
Events
shop.order.placed

Request bodyapplication/json, required

  • cartIdstring (uuid)required
  • contactobjectrequired
    • emailstring (email)required
      At most 254 characters.
    • namestringrequired
      At most 200 characters.
    • phonestring
      At most 40 characters.
  • shippingAddressobject
    • namestringrequired
      At most 200 characters.
    • line1stringrequired
      At most 200 characters.
    • line2string
      At most 200 characters.
    • citystringrequired
      At most 120 characters.
    • regionstring
      Default: . At most 10 characters.
    • postalCodestringrequired
      At most 20 characters.
    • countrystringrequired
      Pattern: ^[A-Z]{2}$.
    • phonestring
      At most 40 characters.
  • billingAddressobject
    • namestringrequired
      At most 200 characters.
    • line1stringrequired
      At most 200 characters.
    • line2string
      At most 200 characters.
    • citystringrequired
      At most 120 characters.
    • regionstring
      Default: . At most 10 characters.
    • postalCodestringrequired
      At most 20 characters.
    • countrystringrequired
      Pattern: ^[A-Z]{2}$.
    • phonestring
      At most 40 characters.
  • shippingRateIdstring (uuid)
  • idempotencyKeystringrequired
    At most 120 characters.
  • returnUrlstring (uri)
    At most 500 characters.
  • agentobject
    • namestringrequired
      At most 100 characters.
    • modelstring
      At most 100 characters.
    • runIdstring
      At most 100 characters.

Responses

  • 201application/json
    Success
    • 400application/json
      The request was malformed
      • errorstringrequired
      • messagestring
    • 401application/json
      No valid credential
      • errorstringrequired
      • messagestring
    • 403application/json
      The credential lacks the scope, origin or address
      • errorstringrequired
      • messagestring
    • 429application/json
      Over the key's rate limit; see Retry-After
      • errorstringrequired
      • messagestring

    This page as Markdown