EcommerceOrders

Update Order

This API lets you update the fields, comment, shippingProvider, and/or shippingTracking for a given order. All three fields can be updated simultaneously or independently.

Path parameters

site_idstringRequiredformat: "uuid"
Unique identifier for a Site
order_idstringRequiredformat: "uuid"
Unique identifier for an Order

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Accept-VersionstringOptional
The API version

Request

The order fields to update
fieldsobjectOptional

Response

Request was successful
orderIdstring or null
The order ID. Will usually be 6 hex characters, but can also be 9 hex characters if the site has a very large number of orders. Randomly assigned.
statusenum or null

One of pending, unfulfilled, fulfilled, disputed, dispute-lost, or refunded

commentstring or null

A comment string for this order editable by API user (not used by Webflow).

orderCommentstring or null
A comment that the customer left when making their order
acceptedOnstring or nullformat: "date-time"
The ISO8601 timestamp that an order was placed.
disputedOnstring or nullformat: "date-time"
If an order was disputed by the customer, then this key will be set with the ISO8601 timestamp that Stripe notifies Webflow. Null if not disputed.
disputeUpdatedOnstring or null
If an order was disputed by the customer, then this key will be set with the ISO8601 timestamp of the last time that we got an update. Null if not disputed.
disputeLastStatusstring or null

If an order was disputed by the customer, then this key will be set with the dispute’s status.

fulfilledOnstring or nullformat: "date-time"
If an order was marked as 'fulfilled', then this is the ISO8601 timestamp when that happened.
refundedOnstring or nullformat: "date-time"
If an order was refunded, this is the ISO8601 of when that happened.
customerPaidobject or null
The sum of all line items.
netAmountobject or null
The sum of all line items.
requiresShippingboolean or null
A boolean indicating whether the order contains one or more purchased items that require shipping.
shippingProviderstring or null

A string editable by the API user to note the shipping provider used (not used by Webflow).

shippingTrackingstring or null

A string editable by the API user to note the shipping tracking number for the order (not used by Webflow).

customerInfoobject or null

An object with the keys fullName and email.

allAddresseslist of objects or null
All addresses provided by the customer during the ordering flow.
shippingAddressobject or null
A customer address
billingAddressobject or null
A customer address
purchasedItemslist of objects or null
An array of all things that the customer purchased.
stripeDetailsobject or null
An object with various Stripe IDs, useful for linking into the stripe dashboard.
stripeCardobject or null
Details on the card used to fulfill this order, if this order was finalized with Stripe.
totalsobject or null
An object describing various pricing totals.
customDatalist of objects or null
An array of additional inputs for custom order data gathering. Each object in the array represents an input with a name, and a textInput, textArea, or checkbox value.
downloadFileslist of objects or null
An array of downloadable file objects.

Errors