> This page is for Data API, version v1.
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developers.webflow.com/data/v2.0.0/llms.txt
> - v2 Beta: https://developers.webflow.com/data/v2.0.0-beta/llms.txt
> - v1: https://developers.webflow.com/data/v1.0.0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.webflow.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server.

# Updated eComm Order

POST 

Reference: https://developers.webflow.com/data/v1.0.0/reference/ecommerce/orders/ecomm-order-changed

## Request

### Payload

- `orderId` (string, optional) — 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.
- `status` (enum, optional) — One of `pending`, `unfulfilled`, `fulfilled`, `disputed`, `dispute-lost`, or `refunded`
  - Allowed values: `pending`, `unfulfilled`, `fulfilled`, `disputed`, `dispute-lost`, `refunded`
- `comment` (string, optional) — A comment string for this order editable by API user (not used by Webflow).
- `orderComment` (string, optional) — A comment that the customer left when making their order
- `acceptedOn` (string, optional) — The ISO8601 timestamp that an order was placed.
- `disputedOn` (string, optional) — 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.
- `disputeUpdatedOn` (string, optional) — 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.
- `disputeLastStatus` (string, optional) — If an order was disputed by the customer, then this key will be set with the [dispute's status](https://stripe.com/docs/api#dispute_object-status).
- `fulfilledOn` (string, optional) — If an order was marked as 'fulfilled', then this is the ISO8601 timestamp when that happened.
- `refundedOn` (string, optional) — If an order was refunded, this is the ISO8601 of when that happened.
- `customerPaid` (OrderAmount, optional) — The sum of all line items.
- `netAmount` (OrderAmount, optional) — The sum of all line items.
- `requiresShipping` (boolean, optional) — A boolean indicating whether the order contains one or more purchased items that require shipping.
- `shippingProvider` (string, optional) — A string editable by the API user to note the shipping provider used (not used by Webflow).
- `shippingTracking` (string, optional) — A string editable by the API user to note the shipping tracking number for the order (not used by Webflow).
- `customerInfo` (OrderCustomerInfo, optional) — An object with the keys `fullName` and `email`.
- `allAddresses` (list of OrderAddress, optional) — All addresses provided by the customer during the ordering flow.
- `shippingAddress` (OrderAddress, optional) — A customer address
- `billingAddress` (OrderAddress, optional) — A customer address
- `purchasedItems` (list of OrderPurchasedItem, optional) — An array of all things that the customer purchased.
- `stripeDetails` (StripeDetails, optional) — An object with various Stripe IDs, useful for linking into the stripe dashboard.
- `stripeCard` (StripeCard, optional) — Details on the card used to fulfill this order, if this order was finalized with Stripe.
- `totals` (OrderTotals, optional) — An object describing various pricing totals.
- `customData` (list of OrderCustomDataItems, optional) — 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.
- `downloadFiles` (list of OrderDownloadedFile, optional) — An array of downloadable file objects.

## Types

### OrderAmount

The sum of all line items.

- `unit` (string, optional)
- `value` (string, optional)
- `string` (string, optional)

### OrderCustomerInfo

An object with the keys `fullName` and `email`.

- `fullName` (string, optional)
- `email` (string, optional)

### OrderAddress

A customer address

- `type` (enum, optional)
  - Allowed values: `shipping`, `billing`
- `addressee` (string, optional)
- `line1` (string, optional)
- `line2` (string, optional)
- `city` (string, optional)
- `state` (string, optional)
- `country` (string, optional)
- `postalCode` (string, optional)

### OrderPurchasedItem

An item that was purchased

- `count` (double, optional) — Number of item purchased.
- `rowTotal` (OrderAmount, optional) — The sum of all line items.
- `productId` (string, optional) — String Product Id.
- `productName` (string, optional) — Name of the product.
- `productSlug` (string, optional) — Slug of the product.
- `variantId` (string, optional) — String Variant Id. (SKU)
- `variantName` (string, optional) — Name of the variant. (SKU)
- `variantSlug` (string, optional) — Slug of the variant. (SKU)
- `variantImage` (OrderItemImage, optional)
- `variantPrice` (OrderAmount, optional) — The sum of all line items.
- `height` (double, optional) — The height of the variant if provided, 0 otherwise.
- `length` (double, optional) — The length of the variant if provided, 0 otherwise.
- `width` (double, optional) — The width of the variant if provided, 0 otherwise
- `weight` (double, optional) — The weight of the variant if provided, 0 otherwise.
- `purchasedItemsCount` (double, optional) — The sum of all 'count' fields in 'purchasedItems'.

### StripeDetails

An object with various Stripe IDs, useful for linking into the stripe dashboard.

- `refundReason` (string, optional) — Stripe customer ID, or null.
- `refundId` (string, optional) — Stripe charge ID, or null.
- `disputeId` (string, optional) — Stripe dispute ID, or null.
- `chargeId` (string, optional) — Stripe refund ID, or null.
- `customerId` (string, optional)

### StripeCard

Details on the card used to fulfill this order, if this order was finalized with Stripe.

- `last4` (string, optional) — The last 4 digits on the card.
- `brand` (enum, optional) — The card’s brand.
  - Allowed values: `Visa`, `American Express`, `MasterCard`, `Discover`, `JCB`, `Diners Club`, `Unknown`
- `ownerName` (string, optional) — The name on the card.
- `expires` (StripeCardExpires, optional) — The card’s expiration date.

### OrderTotals

An object describing various pricing totals.

- `subtotal` (OrderAmount, optional) — The sum of all line items.
- `extras` (list of OrderExtra, optional) — An array of extra items, includes discounts, shipping, and taxes.
- `total` (OrderAmount, optional) — The sum of all line items.

### OrderCustomDataItems

### OrderDownloadedFile

- `id` (string, optional)
- `name` (string, optional)
- `url` (string, optional)

### OrderItemImage

- `fileId` (string, optional)
- `url` (string, optional)

### StripeCardExpires

The card’s expiration date.

- `year` (double, optional)
- `month` (double, optional)

### OrderExtra

Extra order items, includes discounts, shipping, and taxes.

- `type` (enum, optional) — The type of extra item this is.
  - Allowed values: `discount`, `discount-shipping`, `shipping`, `tax`
- `name` (string, optional) — A human-readable (but English) name for this extra charge.
- `description` (string, optional) — A human-readable (but English) description of this extra charge.
- `price` (OrderAmount, optional) — The sum of all line items.