Updates the current site visitor's cart.
Note: This endpoint requires visitor or member authentication.
Cart info.
Coupon code. For more information, see Coupons API.
Merchant discounts to apply to specific line items. If no lineItemIds are passed, the discount will be applied to the whole cart.
Catalog line items.
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.
Updated Cart.
Apply a coupon to the current cart.
curl -X PATCH \
'https://www.wixapis.com/ecom/v1/carts/current' \
-H 'Authorization: <AUTH>' \
-H 'Content-Type: application/json' \
-d '{
"couponCode": "SUMMERSALE10"
}'{
"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"
}
}
}
}This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.