PATCH

Update Cart


Updates a cart's properties.

Permissions
Manage eCommerce - all permissions
Manage Stores - all permissions
Manage Restaurants - all permissions
Manage eCommerce - Admin Permissions
Learn more about app permissions.
Endpoint
PATCH
https://www.wixapis.com/ecom/v1/carts/{cartInfo.id}

Path Params
cartInfo.idstringRequired

Cart ID.

Body Params
cartInfoCartInfo

Cart info.


couponCodestring

Coupon code. For more information, see Coupons API.


merchantDiscountsArray <MerchantDiscountInput>betamaxItems 100

Merchant discounts to apply to specific line items. If no lineItemIds are passed, the discount will be applied to the whole cart.


lineItemsArray <LineItem>maxItems 300

Catalog line items.


customLineItemsArray <CustomLineItem>betamaxItems 300

Custom line items. Custom line items don't trigger the Catalog service plugin.

To access and manage custom line items, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about permission scopes.

Response Object
cartCart

Updated Cart.

Request
cURL
curl -X PATCH \ 'https://www.wixapis.com/ecom/v1/carts/f97a2939-b1f3-41f2-9fc5-7ecea2060991' \ -H 'Authorization: <AUTH>' \ -H 'Content-Type: application/json' \ -d '{ "cartInfo": { "id": "f97a2939-b1f3-41f2-9fc5-7ecea2060991" }, "couponCode": "SUMMERSALE10" }'
Response
JSON
{ "cart": { "id": "f97a2939-b1f3-41f2-9fc5-7ecea2060991", "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 3, "catalogReference": { "catalogItemId": "c8539b66-7a44-fe18-affc-afec4be8562a", "appId": "215238eb-22a5-4c36-9e7b-e7c08025e04e" }, "productName": { "original": "Shirt", "translated": "Shirt" }, "url": { "relativePath": "/product-page/shirt", "url": "https://example.wixsite.com/my-site/product-page/shirt" }, "price": { "amount": "10", "convertedAmount": "10", "formattedAmount": "$10.00", "formattedConvertedAmount": "$10.00" }, "fullPrice": { "amount": "10", "convertedAmount": "10", "formattedAmount": "$10.00", "formattedConvertedAmount": "$10.00" }, "priceBeforeDiscounts": { "amount": "10", "convertedAmount": "10", "formattedAmount": "$10.00", "formattedConvertedAmount": "$10.00" }, "descriptionLines": [], "image": { "id": "3c76e2_c5331f937348492a97df87b0a3b34ea4~mv2.jpg", "url": "https://static.wixstatic.com/media/3c76e2_c5331f937348492a97df87b0a3b34ea4~mv2.jpg", "height": 1000, "width": 1000 }, "availability": { "status": "AVAILABLE" }, "physicalProperties": { "sku": "364115376135191", "shippable": true }, "couponScopes": [ { "namespace": "stores", "group": { "name": "collection", "entityId": "00000000-000000-000000-000000000001" } }, { "namespace": "stores", "group": { "name": "product", "entityId": "c8539b66-7a44-fe18-affc-afec4be8562a" } } ], "itemType": { "preset": "PHYSICAL" }, "paymentOption": "FULL_PAYMENT_ONLINE", "customLineItem": false } ], "buyerInfo": { "userId": "8b7eef41-7fbb-440b-928a-a442878112a3" }, "currency": "USD", "conversionCurrency": "USD", "buyerLanguage": "en", "siteLanguage": "en", "taxIncludedInPrices": false, "weightUnit": "LB", "subtotal": { "amount": "30", "convertedAmount": "30", "formattedAmount": "$30.00", "formattedConvertedAmount": "$30.00" }, "appliedDiscounts": [ { "coupon": { "id": "e463550b-220a-428f-82d9-8d11c3c1acd7", "code": "SUMMERSALE10" } } ], "inSync": false, "createdDate": "2023-02-13T10:34:55.727Z", "updatedDate": "2023-02-13T13:37:21.586Z", "contactInfo": { "address": { "country": "US", "subdivision": "US-NY", "city": "New York", "postalCode": "10011", "addressLine": "235 West 23rd Street", "addressLine2": "3rd floor", "countryFullname": "United States", "subdivisionFullname": "New York" }, "contactDetails": { "firstName": "Jane", "lastName": "Doe", "phone": "+1234567890" } } } }
Errors
428Failed Precondition

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?