@wix/ditto-codegen-public 1.0.169 → 1.0.171
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/docs-output/api-docs/ecom-cart-addToCart-doc.txt +255 -345
- package/dist/docs-output/api-docs/ecom-cart-createCart-doc.txt +298 -387
- package/dist/docs-output/api-docs/ecom-cart-createCheckout-doc.txt +24 -30
- package/dist/docs-output/api-docs/ecom-cart-getCart-doc.txt +174 -266
- package/dist/docs-output/api-docs/ecom-cart-removeLineItemsFromCart-doc.txt +175 -204
- package/dist/docs-output/api-docs/ecom-cart-updateCart-doc.txt +301 -398
- package/dist/docs-output/api-docs/ecom-checkout-addToCheckout-doc.txt +433 -816
- package/dist/docs-output/api-docs/ecom-checkout-createCheckout-doc.txt +519 -1282
- package/dist/docs-output/api-docs/ecom-checkout-getCheckout-doc.txt +353 -886
- package/dist/docs-output/api-docs/ecom-checkout-removeLineItemsFromCheckout-doc.txt +354 -734
- package/dist/docs-output/api-docs/ecom-checkout-updateCheckout-doc.txt +513 -794
- package/dist/docs-output/api-docs/ecom-currentCart-getCurrentCart-doc.txt +174 -301
- package/dist/docs-output/api-docs/ecom-currentCart-updateCurrentCart-doc.txt +301 -398
- package/dist/docs-output/api-docs/ecom-orders-bulkUpdateOrders-doc.txt +589 -641
- package/dist/docs-output/api-docs/ecom-orders-getOrder-doc.txt +425 -726
- package/dist/out.js +1 -1
- package/package.json +2 -2
|
@@ -29,7 +29,7 @@ undefined
|
|
|
29
29
|
|
|
30
30
|
# Method Code Examples:
|
|
31
31
|
|
|
32
|
-
## Add a catalog item to a cart
|
|
32
|
+
## Add a catalog item to a cart
|
|
33
33
|
|
|
34
34
|
```javascript
|
|
35
35
|
/**************************************
|
|
@@ -78,96 +78,6 @@ await ecom.refreshCart();
|
|
|
78
78
|
|
|
79
79
|
// Navigate to the cart page.
|
|
80
80
|
await ecom.navigateToCartPage();
|
|
81
|
-
|
|
82
|
-
/* Promise resolves to:
|
|
83
|
-
*
|
|
84
|
-
* {
|
|
85
|
-
* "_id": "ba47a627-7bb8-4918-89b2-6a72af464765",
|
|
86
|
-
* "lineItems": [
|
|
87
|
-
* {
|
|
88
|
-
* "_id": "00000000-0000-0000-0000-000000000001",
|
|
89
|
-
* "quantity": 1,
|
|
90
|
-
* "catalogReference": {
|
|
91
|
-
* "catalogItemId": "c8539b66-7a44-fe18-affc-afec4be8562a",
|
|
92
|
-
* "appId": "215238eb-22a5-4c36-9e7b-e7c08025e04e"
|
|
93
|
-
* },
|
|
94
|
-
* "productName": {
|
|
95
|
-
* "original": "Shirt",
|
|
96
|
-
* "translated": "Shirt"
|
|
97
|
-
* },
|
|
98
|
-
* "url": "https://example.wixsite.com",
|
|
99
|
-
* "price": {
|
|
100
|
-
* "amount": "10",
|
|
101
|
-
* "convertedAmount": "10",
|
|
102
|
-
* "formattedAmount": "€10.00",
|
|
103
|
-
* "formattedConvertedAmount": "€10.00"
|
|
104
|
-
* },
|
|
105
|
-
* "fullPrice": {
|
|
106
|
-
* "amount": "10",
|
|
107
|
-
* "convertedAmount": "10",
|
|
108
|
-
* "formattedAmount": "€10.00",
|
|
109
|
-
* "formattedConvertedAmount": "€10.00"
|
|
110
|
-
* },
|
|
111
|
-
* "priceBeforeDiscounts": {
|
|
112
|
-
* "amount": "10",
|
|
113
|
-
* "convertedAmount": "10",
|
|
114
|
-
* "formattedAmount": "€10.00",
|
|
115
|
-
* "formattedConvertedAmount": "€10.00"
|
|
116
|
-
* },
|
|
117
|
-
* "descriptionLines": [],
|
|
118
|
-
* "image": "wix:image://v1/3c76e2_c5331f937348492a97df87b0a3b34ea4~mv2.jpg#originWidth=1000&originHeight=1000",
|
|
119
|
-
* "availability": {
|
|
120
|
-
* "status": "AVAILABLE"
|
|
121
|
-
* },
|
|
122
|
-
* "physicalProperties": {
|
|
123
|
-
* "sku": "364115376135191",
|
|
124
|
-
* "shippable": true
|
|
125
|
-
* },
|
|
126
|
-
* "couponScopes": [
|
|
127
|
-
* {
|
|
128
|
-
* "namespace": "stores",
|
|
129
|
-
* "group": {
|
|
130
|
-
* "name": "collection",
|
|
131
|
-
* "entityId": "00000000-000000-000000-000000000001"
|
|
132
|
-
* }
|
|
133
|
-
* },
|
|
134
|
-
* {
|
|
135
|
-
* "namespace": "stores",
|
|
136
|
-
* "group": {
|
|
137
|
-
* "name": "product",
|
|
138
|
-
* "entityId": "c8539b66-7a44-fe18-affc-afec4be8562a"
|
|
139
|
-
* }
|
|
140
|
-
* }
|
|
141
|
-
* ],
|
|
142
|
-
* "itemType": {
|
|
143
|
-
* "preset": "PHYSICAL"
|
|
144
|
-
* },
|
|
145
|
-
* "paymentOption": "FULL_PAYMENT_ONLINE"
|
|
146
|
-
* }
|
|
147
|
-
* ],
|
|
148
|
-
* "buyerInfo": {
|
|
149
|
-
* "visitorId": "4c7ce95c-9fb3-417d-9f02-b41e82b841f7"
|
|
150
|
-
* },
|
|
151
|
-
* "currency": "EUR",
|
|
152
|
-
* "conversionCurrency": "EUR",
|
|
153
|
-
* "buyerLanguage": "en",
|
|
154
|
-
* "siteLanguage": "en",
|
|
155
|
-
* "taxIncludedInPrices": false,
|
|
156
|
-
* "weightUnit": "KG",
|
|
157
|
-
* "subtotal": {
|
|
158
|
-
* "amount": "10",
|
|
159
|
-
* "convertedAmount": "10",
|
|
160
|
-
* "formattedAmount": "€10.00",
|
|
161
|
-
* "formattedConvertedAmount": "€10.00"
|
|
162
|
-
* },
|
|
163
|
-
* "appliedDiscounts": [],
|
|
164
|
-
* "inSync": true,
|
|
165
|
-
* "_createdDate": "2022-05-15T11:31:30.484Z",
|
|
166
|
-
* "_updatedDate": "2022-05-23T12:11:55.095Z"
|
|
167
|
-
* }
|
|
168
|
-
*
|
|
169
|
-
*/
|
|
170
|
-
|
|
171
81
|
```
|
|
172
82
|
|
|
173
83
|
|
|
@@ -190,292 +100,292 @@ Method: ecom.cart.addToCart(_id, options)
|
|
|
190
100
|
Description: Adds [catalog](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration) line items to a cart. >**Notes:** > + When adding catalog line items to a cart, the `lineItems.catalogReference.appId` and `lineItems.catalogReference.catalogItemId` fields are required. > + After a cart is updated, call [Refresh Cart](https://dev.wix.com/docs/sdk/frontend-modules/ecom/refresh-cart) to update the cart's UI elements and trigger the Cart Updated event.
|
|
191
101
|
Method parameters:
|
|
192
102
|
param name: _id | type: string | description: Cart GUID. | required: true
|
|
193
|
-
param name: options | type: AddToCartOptions | description: Items to be added to cart.
|
|
194
|
-
- name: businessLocationId | type: string | description: The business location GUID associated with the cart. The `businessLocationId` field cannot be passed if one already exists on the cart. To update a cart's business location GUID, use the Update Cart method. To learn more, see the Locations API.
|
|
195
|
-
- name: customLineItems | type: Array<CustomLineItem> | description: 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](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
|
|
196
|
-
- name: catalogReference | type: CatalogReference | description: Catalog and item reference. Includes GUIDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin.
|
|
197
|
-
- name: appId | type: string | description: GUID of the app providing the catalog. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/). For items from Wix catalogs, the following values always apply: + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
|
|
198
|
-
- name: catalogItemId | type: string | description: GUID of the item within the catalog it belongs to.
|
|
199
|
-
- name: options | type: Record<string, any> | description: Additional item details in key:value pairs. Use this optional field to provide more specificity with item selection. The `options` field values differ depending on which catalog is providing the items. For products and variants from a Wix Stores catalog, learn more about [eCommerce integration](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration).
|
|
200
|
-
- name: deliveryProfileId | type: string | description: Delivery profile GUID.
|
|
201
|
-
- name: depositAmount | type: string | description: Partial payment for the given item to be paid upfront during the checkout. Eligible for catalog items with type `DEPOSIT_ONLINE`. When omitted, the item's price will not be split and is expected to be paid in a single installment.
|
|
202
|
-
- name: descriptionLines | type: Array<DescriptionLine> | description: Custom line item description lines. Used for display purposes for the cart, checkout and order.
|
|
203
|
-
- name: name | type: DescriptionLineName | description: Description line name.
|
|
204
|
-
- name: original | type: string | description: Description line name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
205
|
-
- name: translated | type: string | description: Description line name translated into the buyer's language. Default: Same as `original`.
|
|
206
|
-
- ONE-OF:
|
|
207
|
-
- name: colorInfo | type: Color | description: Description line color value.
|
|
208
|
-
- name: code | type: string | description: HEX or RGB color code for display.
|
|
209
|
-
- name: original | type: string | description: Description line color name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
210
|
-
- name: translated | type: string | description: Description line color name translated into the buyer's language. Default: Same as `original`.
|
|
211
|
-
- name: plainText | type: PlainTextValue | description: Description line plain text value.
|
|
212
|
-
- name: original | type: string | description: Description line plain text value in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
213
|
-
- name: translated | type: string | description: Description line plain text value translated into the buyer's language. Default: Same as `original`.
|
|
214
|
-
- ONE-OF:
|
|
215
|
-
- name: fixedQuantity | type: boolean | description: Whether the line item quantity is fixed and cannot be changed. Default: `false`
|
|
216
|
-
- name: fullPrice | type: string | description: Item price **before** catalog-defined discount. Defaults to `price` when not provided.
|
|
103
|
+
param name: options | type: AddToCartOptions | description: Items to be added to cart.
|
|
104
|
+
- name: businessLocationId | type: string | description: The business location GUID associated with the cart. The `businessLocationId` field cannot be passed if one already exists on the cart. To update a cart's business location GUID, use the Update Cart method. To learn more, see the Locations API.
|
|
105
|
+
- name: customLineItems | type: Array<CustomLineItem> | description: 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](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
|
|
106
|
+
- name: catalogReference | type: CatalogReference | description: Catalog and item reference. Includes GUIDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin.
|
|
107
|
+
- name: appId | type: string | description: GUID of the app providing the catalog. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/). For items from Wix catalogs, the following values always apply: + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
|
|
108
|
+
- name: catalogItemId | type: string | description: GUID of the item within the catalog it belongs to.
|
|
109
|
+
- name: options | type: Record<string, any> | description: Additional item details in key:value pairs. Use this optional field to provide more specificity with item selection. The `options` field values differ depending on which catalog is providing the items. For products and variants from a Wix Stores catalog, learn more about [eCommerce integration](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration).
|
|
110
|
+
- name: deliveryProfileId | type: string | description: Delivery profile GUID.
|
|
111
|
+
- name: depositAmount | type: string | description: Partial payment for the given item to be paid upfront during the checkout. Eligible for catalog items with type `DEPOSIT_ONLINE`. When omitted, the item's price will not be split and is expected to be paid in a single installment.
|
|
112
|
+
- name: descriptionLines | type: Array<DescriptionLine> | description: Custom line item description lines. Used for display purposes for the cart, checkout and order.
|
|
113
|
+
- name: name | type: DescriptionLineName | description: Description line name.
|
|
114
|
+
- name: original | type: string | description: Description line name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
115
|
+
- name: translated | type: string | description: Description line name translated into the buyer's language. Default: Same as `original`.
|
|
116
|
+
- ONE-OF:
|
|
117
|
+
- name: colorInfo | type: Color | description: Description line color value.
|
|
118
|
+
- name: code | type: string | description: HEX or RGB color code for display.
|
|
119
|
+
- name: original | type: string | description: Description line color name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
120
|
+
- name: translated | type: string | description: Description line color name translated into the buyer's language. Default: Same as `original`.
|
|
121
|
+
- name: plainText | type: PlainTextValue | description: Description line plain text value.
|
|
122
|
+
- name: original | type: string | description: Description line plain text value in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
123
|
+
- name: translated | type: string | description: Description line plain text value translated into the buyer's language. Default: Same as `original`.
|
|
124
|
+
- ONE-OF:
|
|
125
|
+
- name: fixedQuantity | type: boolean | description: Whether the line item quantity is fixed and cannot be changed. Default: `false`
|
|
126
|
+
- name: fullPrice | type: string | description: Item price **before** catalog-defined discount. Defaults to `price` when not provided.
|
|
217
127
|
- name: itemType | type: ItemType | description: Item type. Either a preset type or custom. | required: true
|
|
218
|
-
- ONE-OF:
|
|
219
|
-
- name: custom | type: string | description: Custom item type. When none of the preset types are suitable, specifies the custom type.
|
|
220
|
-
- name: preset | type: ItemTypePreset | description: Preset item type.
|
|
128
|
+
- ONE-OF:
|
|
129
|
+
- name: custom | type: string | description: Custom item type. When none of the preset types are suitable, specifies the custom type.
|
|
130
|
+
- name: preset | type: ItemTypePreset | description: Preset item type.
|
|
221
131
|
enum: DIGITAL, GIFT_CARD, PHYSICAL, SERVICE, UNRECOGNISED
|
|
222
|
-
- name: media | type: string | description: Custom line item media. + We only support images coming from Wix media manager, if you want to use an image from another source you must first upload it to [Wix Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager) - `"wix:image://v1/3c76e2_c53...4ea4~mv2.jpg#originWidth=1000&originHeight=1000"`.
|
|
223
|
-
- name: membersOnly | type: boolean | description: Whether the item can only be purchased by site members. Default: `false`
|
|
224
|
-
- name: modifierGroups | type: Array<V1ModifierGroup> | description: Modifier groups that were added to the item.
|
|
225
|
-
- name: _id | type: string | description: Modifier group GUID.
|
|
226
|
-
- name: modifiers | type: Array<V1ItemModifier> | description: List of modifiers in this group.
|
|
227
|
-
- name: _id | type: string | description: Modifier GUID.
|
|
228
|
-
- name: details | type: TranslatableString | description: Additional details.
|
|
229
|
-
- name: original | type: string | description: __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
230
|
-
- name: translated | type: string | description: String translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
231
|
-
- name: label | type: TranslatableString | description: Primary display label for the modifier.
|
|
232
|
-
- name: price | type: string | description: The price of the modifier.
|
|
233
|
-
- name: quantity | type: number | description: The quantity of this modifier.
|
|
234
|
-
- name: name | type: TranslatableString | description: Modifier group name.
|
|
235
|
-
- name: paymentOption | type: PaymentOptionType | description: Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`. + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout. + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods. + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0. + `DEPOSIT_ONLINE` - Partial payment for the given item to be paid upfront during the checkout. Amount to be paid is defined by deposit_amount field.
|
|
236
|
-
enum:
|
|
132
|
+
- name: media | type: string | description: Custom line item media. + We only support images coming from Wix media manager, if you want to use an image from another source you must first upload it to [Wix Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager) - `"wix:image://v1/3c76e2_c53...4ea4~mv2.jpg#originWidth=1000&originHeight=1000"`.
|
|
133
|
+
- name: membersOnly | type: boolean | description: Whether the item can only be purchased by site members. Default: `false`
|
|
134
|
+
- name: modifierGroups | type: Array<V1ModifierGroup> | description: Modifier groups that were added to the item.
|
|
135
|
+
- name: _id | type: string | description: Modifier group GUID.
|
|
136
|
+
- name: modifiers | type: Array<V1ItemModifier> | description: List of modifiers in this group.
|
|
137
|
+
- name: _id | type: string | description: Modifier GUID.
|
|
138
|
+
- name: details | type: TranslatableString | description: Additional details.
|
|
139
|
+
- name: original | type: string | description: __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
140
|
+
- name: translated | type: string | description: String translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
141
|
+
- name: label | type: TranslatableString | description: Primary display label for the modifier.
|
|
142
|
+
- name: price | type: string | description: The price of the modifier.
|
|
143
|
+
- name: quantity | type: number | description: The quantity of this modifier.
|
|
144
|
+
- name: name | type: TranslatableString | description: Modifier group name.
|
|
145
|
+
- name: paymentOption | type: PaymentOptionType | description: Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`. + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout. + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods. + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0. + `DEPOSIT_ONLINE` - Partial payment for the given item to be paid upfront during the checkout. Amount to be paid is defined by deposit_amount field.
|
|
146
|
+
enum:
|
|
237
147
|
DEPOSIT_ONLINE: Partial payment to be paid upfront during checkout. The initial amount to be paid for each line item is specified in `depositAmount`.
|
|
238
148
|
FULL_PAYMENT_OFFLINE: The entire payment for this item happens after checkout. For example, when using cash, check, or other offline payment methods.
|
|
239
149
|
FULL_PAYMENT_ONLINE: The entire payment for this item happens as part of the checkout.
|
|
240
150
|
MEMBERSHIP: Payment for this item is done by charging a membership. Any remaining amount not covered by the membership, such as item modifiers, is paid online.
|
|
241
151
|
MEMBERSHIP_OFFLINE: Payment for this item can only be done by charging a membership and must be manually redeemed in the dashboard by the site admin. When selected, `price` is `0`.
|
|
242
152
|
MEMBERSHIP_ONLINE_WITH_OFFLINE_REMAINDER: Item price is charged to online membership. Any remaining amount not covered by the membership, such as item modifiers, is paid offline.
|
|
243
|
-
- name: physicalProperties | type: PhysicalProperties | description: Physical properties of the item.
|
|
244
|
-
- name: shippable | type: boolean | description: Whether this line item is shippable.
|
|
245
|
-
- name: sku | type: string | description: Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
|
|
246
|
-
- name: weight | type: number | description: Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
|
|
247
|
-
- name: policies | type: Array<Policy> | description: Policies to be displayed to the customer on the checkout page.
|
|
248
|
-
- name: content | type: string | description: Policy content - should be translated
|
|
249
|
-
- name: title | type: string | description: Policy title - should be translated
|
|
153
|
+
- name: physicalProperties | type: PhysicalProperties | description: Physical properties of the item.
|
|
154
|
+
- name: shippable | type: boolean | description: Whether this line item is shippable.
|
|
155
|
+
- name: sku | type: string | description: Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
|
|
156
|
+
- name: weight | type: number | description: Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
|
|
157
|
+
- name: policies | type: Array<Policy> | description: Policies to be displayed to the customer on the checkout page.
|
|
158
|
+
- name: content | type: string | description: Policy content - should be translated
|
|
159
|
+
- name: title | type: string | description: Policy title - should be translated
|
|
250
160
|
- name: price | type: string | description: Custom line item price. Must be a number or a decimal without symbols. | required: true
|
|
251
|
-
- name: priceDescription | type: PriceDescription | description: Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
|
|
252
|
-
- name: original | type: string | description: __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
253
|
-
- name: translated | type: string | description: Price description translated into the buyer's language. Default: Same as `original`.
|
|
254
|
-
- name: priceUndetermined | type: boolean | description: Whether the price is not yet defined, and will be updated after the order is created. Default: `false`
|
|
161
|
+
- name: priceDescription | type: PriceDescription | description: Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
|
|
162
|
+
- name: original | type: string | description: __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
163
|
+
- name: translated | type: string | description: Price description translated into the buyer's language. Default: Same as `original`.
|
|
164
|
+
- name: priceUndetermined | type: boolean | description: Whether the price is not yet defined, and will be updated after the order is created. Default: `false`
|
|
255
165
|
- name: productName | type: ProductName | description: Name of the item or product. | required: true
|
|
256
|
-
- name: original | type: string | description: __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
257
|
-
- name: translated | type: string | description: Item name translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
258
|
-
- name: quantity | type: number | description: Custom line item quantity. Min: `1` Max: `100000`
|
|
259
|
-
- name: quantityAvailable | type: number | description: Item quantity available for purchase. Only return this if inventory is managed. Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
|
|
260
|
-
- name: rootCatalogItemId | type: string | description: In cases where `catalogReference.catalogItemId` is NOT the actual catalog item GUID, this field will return the true item's GUID. + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking GUID. Therefore this value is set to the service GUID. + In most cases, this field is the same as `catalogReference.catalogItemId`. + Used in membership validation.
|
|
261
|
-
- name: serviceProperties | type: ServiceProperties | description: Service properties. When relevant, this contains information such as date and number of participants. Used, among other things, when checking for valid memberships.
|
|
262
|
-
- name: numberOfParticipants | type: number | description: The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
|
|
263
|
-
- name: scheduledDate | type: Date | description: Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. For example, the start time of a class.
|
|
264
|
-
- name: taxGroupId | type: string | description: Tax group GUID for this custom line item.
|
|
265
|
-
- name: taxableAddress | type: TaxableAddress | description: Address to use for tax calculation purposes.
|
|
266
|
-
- ONE-OF:
|
|
267
|
-
- name: addressType | type: TaxableAddressType | description: taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly.
|
|
166
|
+
- name: original | type: string | description: __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
167
|
+
- name: translated | type: string | description: Item name translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
168
|
+
- name: quantity | type: number | description: Custom line item quantity. Min: `1` Max: `100000`
|
|
169
|
+
- name: quantityAvailable | type: number | description: Item quantity available for purchase. Only return this if inventory is managed. Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
|
|
170
|
+
- name: rootCatalogItemId | type: string | description: In cases where `catalogReference.catalogItemId` is NOT the actual catalog item GUID, this field will return the true item's GUID. + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking GUID. Therefore this value is set to the service GUID. + In most cases, this field is the same as `catalogReference.catalogItemId`. + Used in membership validation.
|
|
171
|
+
- name: serviceProperties | type: ServiceProperties | description: Service properties. When relevant, this contains information such as date and number of participants. Used, among other things, when checking for valid memberships.
|
|
172
|
+
- name: numberOfParticipants | type: number | description: The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
|
|
173
|
+
- name: scheduledDate | type: Date | description: Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. For example, the start time of a class.
|
|
174
|
+
- name: taxGroupId | type: string | description: Tax group GUID for this custom line item.
|
|
175
|
+
- name: taxableAddress | type: TaxableAddress | description: Address to use for tax calculation purposes.
|
|
176
|
+
- ONE-OF:
|
|
177
|
+
- name: addressType | type: TaxableAddressType | description: taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly.
|
|
268
178
|
enum: BILLING, BUSINESS, SHIPPING, UNKNOWN_TAXABLE_ADDRESS
|
|
269
|
-
- name: url | type: string | description: URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
|
|
270
|
-
- name: lineItems | type: Array<LineItem> | description: Catalog line items.
|
|
271
|
-
- name: catalogOverrideFields | type: CatalogOverrideFields | description: Overriding values for catalog item properties. To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
|
|
272
|
-
- name: depositAmount | type: string | description: Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
|
|
273
|
-
- name: descriptionLines | type: Array<DescriptionLine> | description: Item description lines. Used when displaying the line item to customers.
|
|
274
|
-
- name: fullPrice | type: string | description: Item price **before** discounts.
|
|
275
|
-
- name: image | type: string | description: Item image.
|
|
276
|
-
- name: paymentOption | type: PaymentOption | description: Payment method selected for the item.
|
|
277
|
-
- name: value | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
|
|
278
|
-
- name: physicalProperties | type: PhysicalProperties | description: Physical properties of the item.
|
|
279
|
-
- name: price | type: string | description: Item price **after** discounts.
|
|
280
|
-
- name: productName | type: ProductName | description: Item name.
|
|
281
|
-
- name: savePaymentMethod | type: boolean | description: Whether to save the payment method on the order. Default: `false`
|
|
179
|
+
- name: url | type: string | description: URL to the item's page on the site. When not provided, the link back from the cart page to the relevant product page will not work.
|
|
180
|
+
- name: lineItems | type: Array<LineItem> | description: Catalog line items.
|
|
181
|
+
- name: catalogOverrideFields | type: CatalogOverrideFields | description: Overriding values for catalog item properties. To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
|
|
182
|
+
- name: depositAmount | type: string | description: Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
|
|
183
|
+
- name: descriptionLines | type: Array<DescriptionLine> | description: Item description lines. Used when displaying the line item to customers.
|
|
184
|
+
- name: fullPrice | type: string | description: Item price **before** discounts.
|
|
185
|
+
- name: image | type: string | description: Item image.
|
|
186
|
+
- name: paymentOption | type: PaymentOption | description: Payment method selected for the item.
|
|
187
|
+
- name: value | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
|
|
188
|
+
- name: physicalProperties | type: PhysicalProperties | description: Physical properties of the item.
|
|
189
|
+
- name: price | type: string | description: Item price **after** discounts.
|
|
190
|
+
- name: productName | type: ProductName | description: Item name.
|
|
191
|
+
- name: savePaymentMethod | type: boolean | description: Whether to save the payment method on the order. Default: `false`
|
|
282
192
|
- name: catalogReference | type: CatalogReference | description: Catalog and item reference. Holds GUIDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. | required: true
|
|
283
|
-
- name: extendedFields | type: ExtendedFields | description: Custom extended fields for the line item object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured using the 'Checkout & Orders - Line Items Schema Plugin' in the app dashboard before they can be accessed with API calls.
|
|
284
|
-
- name: namespaces | type: Record<string, undefined> | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
|
|
285
|
-
- name: quantity | type: number | description: Item quantity.
|
|
286
|
-
- name: selectedMembership | type: SelectedMembership | description: Selected membership to be used as payment for this item. Must be used with `lineItem.paymentOption` set to `MEMBERSHIP` or `MEMBERSHIP_OFFLINE`. This field can be empty when `lineItem.paymentOption` is set to `MEMBERSHIP_OFFLINE`.
|
|
193
|
+
- name: extendedFields | type: ExtendedFields | description: Custom extended fields for the line item object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured using the 'Checkout & Orders - Line Items Schema Plugin' in the app dashboard before they can be accessed with API calls.
|
|
194
|
+
- name: namespaces | type: Record<string, undefined> | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
|
|
195
|
+
- name: quantity | type: number | description: Item quantity.
|
|
196
|
+
- name: selectedMembership | type: SelectedMembership | description: Selected membership to be used as payment for this item. Must be used with `lineItem.paymentOption` set to `MEMBERSHIP` or `MEMBERSHIP_OFFLINE`. This field can be empty when `lineItem.paymentOption` is set to `MEMBERSHIP_OFFLINE`.
|
|
287
197
|
- name: _id | type: string | description: Membership GUID. | required: true
|
|
288
198
|
- name: appId | type: string | description: GUID of the app providing this payment option. | required: true
|
|
289
|
-
- name: taxableAddress | type: TaxableAddress | description: Address to use for tax calculation purposes.
|
|
199
|
+
- name: taxableAddress | type: TaxableAddress | description: Address to use for tax calculation purposes.
|
|
290
200
|
Return type: PROMISE<AddToCartResponse>
|
|
291
|
-
- name: cart | type: Cart | description: Updated cart.
|
|
292
|
-
- name: cart._createdDate | type: Date | description: Date and time the cart was created.
|
|
293
|
-
- name: cart._id | type: string | description: Cart GUID.
|
|
294
|
-
- name: cart._updatedDate | type: Date | description: Date and time the cart was updated.
|
|
295
|
-
- name: cart.appliedDiscounts | type: Array<CartDiscount> | description: Cart discounts.
|
|
296
|
-
- ONE-OF:
|
|
297
|
-
- name: cart.appliedDiscounts[].coupon | type: Coupon | description: Coupon details.
|
|
298
|
-
- name: cart.appliedDiscounts[].coupon._id | type: string | description: Coupon GUID.
|
|
299
|
-
- name: cart.appliedDiscounts[].coupon.code | type: string | description: Coupon code.
|
|
300
|
-
- name: cart.appliedDiscounts[].merchantDiscount | type: MerchantDiscount | description: Merchant discount.
|
|
301
|
-
- name: cart.appliedDiscounts[].merchantDiscount.amount | type: MultiCurrencyPrice | description: Discount value.
|
|
302
|
-
- name: cart.appliedDiscounts[].merchantDiscount.amount.amount | type: string | description: Amount.
|
|
303
|
-
- name: cart.appliedDiscounts[].merchantDiscount.amount.convertedAmount | type: string | description: Converted amount.
|
|
304
|
-
- name: cart.appliedDiscounts[].merchantDiscount.amount.formattedAmount | type: string | description: Amount formatted with currency symbol.
|
|
305
|
-
- name: cart.appliedDiscounts[].merchantDiscount.amount.formattedConvertedAmount | type: string | description: Converted amount formatted with currency symbol.
|
|
306
|
-
- name: cart.businessLocationId | type: string | description: The business location GUID associated with the cart. To learn more, see the Locations API.
|
|
307
|
-
- name: cart.buyerInfo | type: BuyerInfo | description: Buyer information.
|
|
308
|
-
- name: cart.buyerInfo.contactId | type: string | description: Contact GUID. For more information, see the Contacts API.
|
|
309
|
-
- name: cart.buyerInfo.email | type: string | description: Buyer email address.
|
|
310
|
-
- ONE-OF:
|
|
311
|
-
- name: cart.buyerInfo.memberId | type: string | description: Member GUID. If the buyer is a site member.
|
|
312
|
-
- name: cart.buyerInfo.userId | type: string | description: User GUID. If the buyer, or cart owner, is a Wix user.
|
|
313
|
-
- name: cart.buyerInfo.visitorId | type: string | description: Visitor GUID. If the buyer is **not** a site member.
|
|
314
|
-
- name: cart.buyerLanguage | type: string | description: Language for communication with the buyer. Defaults to the site language. For a site that supports multiple languages, this is the language the buyer selected.
|
|
315
|
-
- name: cart.buyerNote | type: string | description: [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
|
|
316
|
-
- name: cart.checkoutId | type: string | description: GUID of the checkout that originated from this cart.
|
|
317
|
-
- name: cart.contactInfo | type: AddressWithContact | description: Contact info.
|
|
318
|
-
- name: cart.contactInfo.address | type: Address | description: Address.
|
|
319
|
-
- name: cart.contactInfo.address.addressLine1 | type: string | description: Main address line (usually street name and number).
|
|
320
|
-
- name: cart.contactInfo.address.addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
|
|
321
|
-
- name: cart.contactInfo.address.city | type: string | description: City name.
|
|
322
|
-
- name: cart.contactInfo.address.country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
|
|
323
|
-
- name: cart.contactInfo.address.countryFullname | type: string | description: Country's full name.
|
|
324
|
-
- name: cart.contactInfo.address.location | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
|
|
325
|
-
- name: cart.contactInfo.address.location.latitude | type: number | description: Address latitude.
|
|
326
|
-
- name: cart.contactInfo.address.location.longitude | type: number | description: Address longitude.
|
|
327
|
-
- name: cart.contactInfo.address.postalCode | type: string | description: Postal or zip code.
|
|
328
|
-
- name: cart.contactInfo.address.streetAddress | type: StreetAddress | description: Street address.
|
|
329
|
-
- name: cart.contactInfo.address.streetAddress.name | type: string | description: Street name.
|
|
330
|
-
- name: cart.contactInfo.address.streetAddress.number | type: string | description: Street number.
|
|
331
|
-
- name: cart.contactInfo.address.subdivision | type: string | description: Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
|
|
332
|
-
- name: cart.contactInfo.address.subdivisionFullname | type: string | description: Subdivision full-name.
|
|
333
|
-
- name: cart.contactInfo.contactDetails | type: FullAddressContactDetails | description: Contact details.
|
|
334
|
-
- name: cart.contactInfo.contactDetails.company | type: string | description: Company name.
|
|
335
|
-
- name: cart.contactInfo.contactDetails.firstName | type: string | description: First name.
|
|
336
|
-
- name: cart.contactInfo.contactDetails.lastName | type: string | description: Last name.
|
|
337
|
-
- name: cart.contactInfo.contactDetails.phone | type: string | description: Phone number.
|
|
338
|
-
- name: cart.contactInfo.contactDetails.vatId | type: VatId | description: Tax information (for Brazil only). If GUID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
|
|
339
|
-
- name: cart.contactInfo.contactDetails.vatId._id | type: string | description: Customer's tax GUID.
|
|
340
|
-
- name: cart.contactInfo.contactDetails.vatId.type | type: VatType | description: Tax type. Supported values: + `CPF`: for individual tax payers + `CNPJ`: for corporations
|
|
341
|
-
enum:
|
|
201
|
+
- name: cart | type: Cart | description: Updated cart.
|
|
202
|
+
- name: cart._createdDate | type: Date | description: Date and time the cart was created.
|
|
203
|
+
- name: cart._id | type: string | description: Cart GUID.
|
|
204
|
+
- name: cart._updatedDate | type: Date | description: Date and time the cart was updated.
|
|
205
|
+
- name: cart.appliedDiscounts | type: Array<CartDiscount> | description: Cart discounts.
|
|
206
|
+
- ONE-OF:
|
|
207
|
+
- name: cart.appliedDiscounts[].coupon | type: Coupon | description: Coupon details.
|
|
208
|
+
- name: cart.appliedDiscounts[].coupon._id | type: string | description: Coupon GUID.
|
|
209
|
+
- name: cart.appliedDiscounts[].coupon.code | type: string | description: Coupon code.
|
|
210
|
+
- name: cart.appliedDiscounts[].merchantDiscount | type: MerchantDiscount | description: Merchant discount.
|
|
211
|
+
- name: cart.appliedDiscounts[].merchantDiscount.amount | type: MultiCurrencyPrice | description: Discount value.
|
|
212
|
+
- name: cart.appliedDiscounts[].merchantDiscount.amount.amount | type: string | description: Amount.
|
|
213
|
+
- name: cart.appliedDiscounts[].merchantDiscount.amount.convertedAmount | type: string | description: Converted amount.
|
|
214
|
+
- name: cart.appliedDiscounts[].merchantDiscount.amount.formattedAmount | type: string | description: Amount formatted with currency symbol.
|
|
215
|
+
- name: cart.appliedDiscounts[].merchantDiscount.amount.formattedConvertedAmount | type: string | description: Converted amount formatted with currency symbol.
|
|
216
|
+
- name: cart.businessLocationId | type: string | description: The business location GUID associated with the cart. To learn more, see the Locations API.
|
|
217
|
+
- name: cart.buyerInfo | type: BuyerInfo | description: Buyer information.
|
|
218
|
+
- name: cart.buyerInfo.contactId | type: string | description: Contact GUID. For more information, see the Contacts API.
|
|
219
|
+
- name: cart.buyerInfo.email | type: string | description: Buyer email address.
|
|
220
|
+
- ONE-OF:
|
|
221
|
+
- name: cart.buyerInfo.memberId | type: string | description: Member GUID. If the buyer is a site member.
|
|
222
|
+
- name: cart.buyerInfo.userId | type: string | description: User GUID. If the buyer, or cart owner, is a Wix user.
|
|
223
|
+
- name: cart.buyerInfo.visitorId | type: string | description: Visitor GUID. If the buyer is **not** a site member.
|
|
224
|
+
- name: cart.buyerLanguage | type: string | description: Language for communication with the buyer. Defaults to the site language. For a site that supports multiple languages, this is the language the buyer selected.
|
|
225
|
+
- name: cart.buyerNote | type: string | description: [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
|
|
226
|
+
- name: cart.checkoutId | type: string | description: GUID of the checkout that originated from this cart.
|
|
227
|
+
- name: cart.contactInfo | type: AddressWithContact | description: Contact info.
|
|
228
|
+
- name: cart.contactInfo.address | type: Address | description: Address.
|
|
229
|
+
- name: cart.contactInfo.address.addressLine1 | type: string | description: Main address line (usually street name and number).
|
|
230
|
+
- name: cart.contactInfo.address.addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
|
|
231
|
+
- name: cart.contactInfo.address.city | type: string | description: City name.
|
|
232
|
+
- name: cart.contactInfo.address.country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
|
|
233
|
+
- name: cart.contactInfo.address.countryFullname | type: string | description: Country's full name.
|
|
234
|
+
- name: cart.contactInfo.address.location | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
|
|
235
|
+
- name: cart.contactInfo.address.location.latitude | type: number | description: Address latitude.
|
|
236
|
+
- name: cart.contactInfo.address.location.longitude | type: number | description: Address longitude.
|
|
237
|
+
- name: cart.contactInfo.address.postalCode | type: string | description: Postal or zip code.
|
|
238
|
+
- name: cart.contactInfo.address.streetAddress | type: StreetAddress | description: Street address.
|
|
239
|
+
- name: cart.contactInfo.address.streetAddress.name | type: string | description: Street name.
|
|
240
|
+
- name: cart.contactInfo.address.streetAddress.number | type: string | description: Street number.
|
|
241
|
+
- name: cart.contactInfo.address.subdivision | type: string | description: Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
|
|
242
|
+
- name: cart.contactInfo.address.subdivisionFullname | type: string | description: Subdivision full-name.
|
|
243
|
+
- name: cart.contactInfo.contactDetails | type: FullAddressContactDetails | description: Contact details.
|
|
244
|
+
- name: cart.contactInfo.contactDetails.company | type: string | description: Company name.
|
|
245
|
+
- name: cart.contactInfo.contactDetails.firstName | type: string | description: First name.
|
|
246
|
+
- name: cart.contactInfo.contactDetails.lastName | type: string | description: Last name.
|
|
247
|
+
- name: cart.contactInfo.contactDetails.phone | type: string | description: Phone number.
|
|
248
|
+
- name: cart.contactInfo.contactDetails.vatId | type: VatId | description: Tax information (for Brazil only). If GUID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
|
|
249
|
+
- name: cart.contactInfo.contactDetails.vatId._id | type: string | description: Customer's tax GUID.
|
|
250
|
+
- name: cart.contactInfo.contactDetails.vatId.type | type: VatType | description: Tax type. Supported values: + `CPF`: for individual tax payers + `CNPJ`: for corporations
|
|
251
|
+
enum:
|
|
342
252
|
CNPJ: CNPJ - for corporations
|
|
343
253
|
CPF: CPF - for individual tax payers.
|
|
344
254
|
UNSPECIFIED
|
|
345
|
-
- name: cart.conversionCurrency | type: string | description: The currency [selected by the customer](https://support.wix.com/en/article/multicurrency-an-overview) during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This reflects the customer’s preferred display currency and may differ from the site’s default currency. When no specific currency is selected by the customer, this matches the `currency` property.
|
|
346
|
-
- name: cart.currency | type: string | description: The site’s default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This represents the base currency configured for the site and remains constant regardless of the customer’s currency selection.
|
|
347
|
-
- name: cart.extendedFields | type: ExtendedFields | description: Fields extended by data extensions
|
|
348
|
-
- name: cart.extendedFields.namespaces | type: Record<string, undefined> | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
|
|
349
|
-
- name: cart.lineItems | type: Array<LineItem> | description: Line items.
|
|
350
|
-
- name: cart.lineItems[]._id | type: string | description: Line item GUID.
|
|
351
|
-
- name: cart.lineItems[].availability | type: ItemAvailabilityInfo | description: Item availability details.
|
|
352
|
-
- name: cart.lineItems[].availability.quantityAvailable | type: number | description: Quantity available.
|
|
353
|
-
- name: cart.lineItems[].availability.status | type: ItemAvailabilityStatus | description: Item availability status.
|
|
255
|
+
- name: cart.conversionCurrency | type: string | description: The currency [selected by the customer](https://support.wix.com/en/article/multicurrency-an-overview) during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This reflects the customer’s preferred display currency and may differ from the site’s default currency. When no specific currency is selected by the customer, this matches the `currency` property.
|
|
256
|
+
- name: cart.currency | type: string | description: The site’s default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This represents the base currency configured for the site and remains constant regardless of the customer’s currency selection.
|
|
257
|
+
- name: cart.extendedFields | type: ExtendedFields | description: Fields extended by data extensions
|
|
258
|
+
- name: cart.extendedFields.namespaces | type: Record<string, undefined> | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
|
|
259
|
+
- name: cart.lineItems | type: Array<LineItem> | description: Line items.
|
|
260
|
+
- name: cart.lineItems[]._id | type: string | description: Line item GUID.
|
|
261
|
+
- name: cart.lineItems[].availability | type: ItemAvailabilityInfo | description: Item availability details.
|
|
262
|
+
- name: cart.lineItems[].availability.quantityAvailable | type: number | description: Quantity available.
|
|
263
|
+
- name: cart.lineItems[].availability.status | type: ItemAvailabilityStatus | description: Item availability status.
|
|
354
264
|
enum: AVAILABLE, NOT_AVAILABLE: Item is not in stock.
|
|
355
265
|
NOT_FOUND: Item does not exist.
|
|
356
266
|
PARTIALLY_AVAILABLE: Available quantity is less than requested.
|
|
357
|
-
- name: cart.lineItems[].catalogOverrideFields | type: CatalogOverrideFields | description: Overriding values for catalog item properties. To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
|
|
358
|
-
- name: cart.lineItems[].catalogOverrideFields.depositAmount | type: string | description: Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
|
|
359
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines | type: Array<DescriptionLine> | description: Item description lines. Used when displaying the line item to customers.
|
|
360
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].name | type: DescriptionLineName | description: Description line name.
|
|
361
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].name.original | type: string | description: Description line name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
362
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].name.translated | type: string | description: Description line name translated into the buyer's language. Default: Same as `original`.
|
|
363
|
-
- ONE-OF:
|
|
364
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo | type: Color | description: Description line color value.
|
|
365
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo.code | type: string | description: HEX or RGB color code for display.
|
|
366
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo.original | type: string | description: Description line color name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
367
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo.translated | type: string | description: Description line color name translated into the buyer's language. Default: Same as `original`.
|
|
368
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].plainText | type: PlainTextValue | description: Description line plain text value.
|
|
369
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].plainText.original | type: string | description: Description line plain text value in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
370
|
-
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].plainText.translated | type: string | description: Description line plain text value translated into the buyer's language. Default: Same as `original`.
|
|
371
|
-
- ONE-OF:
|
|
372
|
-
- name: cart.lineItems[].catalogOverrideFields.fullPrice | type: string | description: Item price **before** discounts.
|
|
373
|
-
- name: cart.lineItems[].catalogOverrideFields.image | type: string | description: Item image.
|
|
374
|
-
- name: cart.lineItems[].catalogOverrideFields.paymentOption | type: PaymentOption | description: Payment method selected for the item.
|
|
375
|
-
- name: cart.lineItems[].catalogOverrideFields.paymentOption.value | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
|
|
376
|
-
enum:
|
|
267
|
+
- name: cart.lineItems[].catalogOverrideFields | type: CatalogOverrideFields | description: Overriding values for catalog item properties. To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
|
|
268
|
+
- name: cart.lineItems[].catalogOverrideFields.depositAmount | type: string | description: Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
|
|
269
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines | type: Array<DescriptionLine> | description: Item description lines. Used when displaying the line item to customers.
|
|
270
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].name | type: DescriptionLineName | description: Description line name.
|
|
271
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].name.original | type: string | description: Description line name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
272
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].name.translated | type: string | description: Description line name translated into the buyer's language. Default: Same as `original`.
|
|
273
|
+
- ONE-OF:
|
|
274
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo | type: Color | description: Description line color value.
|
|
275
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo.code | type: string | description: HEX or RGB color code for display.
|
|
276
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo.original | type: string | description: Description line color name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
277
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].colorInfo.translated | type: string | description: Description line color name translated into the buyer's language. Default: Same as `original`.
|
|
278
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].plainText | type: PlainTextValue | description: Description line plain text value.
|
|
279
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].plainText.original | type: string | description: Description line plain text value in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
280
|
+
- name: cart.lineItems[].catalogOverrideFields.descriptionLines[].plainText.translated | type: string | description: Description line plain text value translated into the buyer's language. Default: Same as `original`.
|
|
281
|
+
- ONE-OF:
|
|
282
|
+
- name: cart.lineItems[].catalogOverrideFields.fullPrice | type: string | description: Item price **before** discounts.
|
|
283
|
+
- name: cart.lineItems[].catalogOverrideFields.image | type: string | description: Item image.
|
|
284
|
+
- name: cart.lineItems[].catalogOverrideFields.paymentOption | type: PaymentOption | description: Payment method selected for the item.
|
|
285
|
+
- name: cart.lineItems[].catalogOverrideFields.paymentOption.value | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
|
|
286
|
+
enum:
|
|
377
287
|
DEPOSIT_ONLINE: Partial payment to be paid upfront during checkout. The initial amount to be paid for each line item is specified in `depositAmount`.
|
|
378
288
|
FULL_PAYMENT_OFFLINE: The entire payment for this item happens after checkout. For example, when using cash, check, or other offline payment methods.
|
|
379
289
|
FULL_PAYMENT_ONLINE: The entire payment for this item happens as part of the checkout.
|
|
380
290
|
MEMBERSHIP: Payment for this item is done by charging a membership. Any remaining amount not covered by the membership, such as item modifiers, is paid online.
|
|
381
291
|
MEMBERSHIP_OFFLINE: Payment for this item can only be done by charging a membership and must be manually redeemed in the dashboard by the site admin. When selected, `price` is `0`.
|
|
382
292
|
MEMBERSHIP_ONLINE_WITH_OFFLINE_REMAINDER: Item price is charged to online membership. Any remaining amount not covered by the membership, such as item modifiers, is paid offline.
|
|
383
|
-
- name: cart.lineItems[].catalogOverrideFields.physicalProperties | type: PhysicalProperties | description: Physical properties of the item.
|
|
384
|
-
- name: cart.lineItems[].catalogOverrideFields.physicalProperties.shippable | type: boolean | description: Whether this line item is shippable.
|
|
385
|
-
- name: cart.lineItems[].catalogOverrideFields.physicalProperties.sku | type: string | description: Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
|
|
386
|
-
- name: cart.lineItems[].catalogOverrideFields.physicalProperties.weight | type: number | description: Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
|
|
387
|
-
- name: cart.lineItems[].catalogOverrideFields.price | type: string | description: Item price **after** discounts.
|
|
388
|
-
- name: cart.lineItems[].catalogOverrideFields.productName | type: ProductName | description: Item name.
|
|
389
|
-
- name: cart.lineItems[].catalogOverrideFields.productName.original | type: string | description: __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
390
|
-
- name: cart.lineItems[].catalogOverrideFields.productName.translated | type: string | description: Item name translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
391
|
-
- name: cart.lineItems[].catalogOverrideFields.savePaymentMethod | type: boolean | description: Whether to save the payment method on the order. Default: `false`
|
|
293
|
+
- name: cart.lineItems[].catalogOverrideFields.physicalProperties | type: PhysicalProperties | description: Physical properties of the item.
|
|
294
|
+
- name: cart.lineItems[].catalogOverrideFields.physicalProperties.shippable | type: boolean | description: Whether this line item is shippable.
|
|
295
|
+
- name: cart.lineItems[].catalogOverrideFields.physicalProperties.sku | type: string | description: Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
|
|
296
|
+
- name: cart.lineItems[].catalogOverrideFields.physicalProperties.weight | type: number | description: Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
|
|
297
|
+
- name: cart.lineItems[].catalogOverrideFields.price | type: string | description: Item price **after** discounts.
|
|
298
|
+
- name: cart.lineItems[].catalogOverrideFields.productName | type: ProductName | description: Item name.
|
|
299
|
+
- name: cart.lineItems[].catalogOverrideFields.productName.original | type: string | description: __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
300
|
+
- name: cart.lineItems[].catalogOverrideFields.productName.translated | type: string | description: Item name translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
301
|
+
- name: cart.lineItems[].catalogOverrideFields.savePaymentMethod | type: boolean | description: Whether to save the payment method on the order. Default: `false`
|
|
392
302
|
- name: cart.lineItems[].catalogReference | type: CatalogReference | description: Catalog and item reference. Holds GUIDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin. | required: true
|
|
393
|
-
- name: cart.lineItems[].catalogReference.appId | type: string | description: GUID of the app providing the catalog. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/). For items from Wix catalogs, the following values always apply: + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
|
|
394
|
-
- name: cart.lineItems[].catalogReference.catalogItemId | type: string | description: GUID of the item within the catalog it belongs to.
|
|
395
|
-
- name: cart.lineItems[].catalogReference.options | type: Record<string, any> | description: Additional item details in key:value pairs. Use this optional field to provide more specificity with item selection. The `options` field values differ depending on which catalog is providing the items. For products and variants from a Wix Stores catalog, learn more about [eCommerce integration](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration).
|
|
396
|
-
- name: cart.lineItems[].consentRequiredPaymentPolicy | type: string | description: Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
|
|
397
|
-
- name: cart.lineItems[].customLineItem | type: boolean | description: Whether the line item is a custom line item. Custom line items don't trigger the Catalog service plugin.
|
|
398
|
-
- name: cart.lineItems[].deliveryProfileId | type: string | description: Delivery profile GUID.
|
|
399
|
-
- name: cart.lineItems[].depositAmount | type: MultiCurrencyPrice | description: Partial payment to be paid upfront during the checkout. Eligible for catalog items with `lineItem.paymentOption` type `DEPOSIT_ONLINE` only.
|
|
400
|
-
- name: cart.lineItems[].descriptionLines | type: Array<DescriptionLine> | description: Line item description lines. Used for displaying the cart, checkout and order.
|
|
401
|
-
- name: cart.lineItems[].extendedFields | type: ExtendedFields | description: Custom extended fields for the line item object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured using the 'Checkout & Orders - Line Items Schema Plugin' in the app dashboard before they can be accessed with API calls.
|
|
402
|
-
- name: cart.lineItems[].fixedQuantity | type: boolean | description: Whether the line item quantity is fixed and cannot be changed.
|
|
403
|
-
- name: cart.lineItems[].fullPrice | type: MultiCurrencyPrice | description: Item price **before** catalog-defined discount. Defaults to `price` when not provided.
|
|
404
|
-
- name: cart.lineItems[].image | type: string | description: Line item image details.
|
|
405
|
-
- name: cart.lineItems[].itemType | type: ItemType | description: Item type. Either a preset type or custom.
|
|
406
|
-
- ONE-OF:
|
|
407
|
-
- name: cart.lineItems[].itemType.custom | type: string | description: Custom item type. When none of the preset types are suitable, specifies the custom type.
|
|
408
|
-
- name: cart.lineItems[].itemType.preset | type: ItemTypePreset | description: Preset item type.
|
|
303
|
+
- name: cart.lineItems[].catalogReference.appId | type: string | description: GUID of the app providing the catalog. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/). For items from Wix catalogs, the following values always apply: + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
|
|
304
|
+
- name: cart.lineItems[].catalogReference.catalogItemId | type: string | description: GUID of the item within the catalog it belongs to.
|
|
305
|
+
- name: cart.lineItems[].catalogReference.options | type: Record<string, any> | description: Additional item details in key:value pairs. Use this optional field to provide more specificity with item selection. The `options` field values differ depending on which catalog is providing the items. For products and variants from a Wix Stores catalog, learn more about [eCommerce integration](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration).
|
|
306
|
+
- name: cart.lineItems[].consentRequiredPaymentPolicy | type: string | description: Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
|
|
307
|
+
- name: cart.lineItems[].customLineItem | type: boolean | description: Whether the line item is a custom line item. Custom line items don't trigger the Catalog service plugin.
|
|
308
|
+
- name: cart.lineItems[].deliveryProfileId | type: string | description: Delivery profile GUID.
|
|
309
|
+
- name: cart.lineItems[].depositAmount | type: MultiCurrencyPrice | description: Partial payment to be paid upfront during the checkout. Eligible for catalog items with `lineItem.paymentOption` type `DEPOSIT_ONLINE` only.
|
|
310
|
+
- name: cart.lineItems[].descriptionLines | type: Array<DescriptionLine> | description: Line item description lines. Used for displaying the cart, checkout and order.
|
|
311
|
+
- name: cart.lineItems[].extendedFields | type: ExtendedFields | description: Custom extended fields for the line item object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured using the 'Checkout & Orders - Line Items Schema Plugin' in the app dashboard before they can be accessed with API calls.
|
|
312
|
+
- name: cart.lineItems[].fixedQuantity | type: boolean | description: Whether the line item quantity is fixed and cannot be changed.
|
|
313
|
+
- name: cart.lineItems[].fullPrice | type: MultiCurrencyPrice | description: Item price **before** catalog-defined discount. Defaults to `price` when not provided.
|
|
314
|
+
- name: cart.lineItems[].image | type: string | description: Line item image details.
|
|
315
|
+
- name: cart.lineItems[].itemType | type: ItemType | description: Item type. Either a preset type or custom.
|
|
316
|
+
- ONE-OF:
|
|
317
|
+
- name: cart.lineItems[].itemType.custom | type: string | description: Custom item type. When none of the preset types are suitable, specifies the custom type.
|
|
318
|
+
- name: cart.lineItems[].itemType.preset | type: ItemTypePreset | description: Preset item type.
|
|
409
319
|
enum: DIGITAL, GIFT_CARD, PHYSICAL, SERVICE, UNRECOGNISED
|
|
410
|
-
- name: cart.lineItems[].lineItemPrice | type: MultiCurrencyPrice | description: Total price **after** catalog-defined discount and line item discounts.
|
|
411
|
-
- name: cart.lineItems[].membersOnly | type: boolean | description: Whether the item can only be purchased by site members. Default: `false`
|
|
412
|
-
- name: cart.lineItems[].modifierGroups | type: Array<ModifierGroup> | description: Modifier groups that were added to the item.
|
|
413
|
-
- name: cart.lineItems[].modifierGroups[]._id | type: string | description: Modifier group GUID.
|
|
414
|
-
- name: cart.lineItems[].modifierGroups[].modifiers | type: Array<ItemModifier> | description: List of modifiers in this group.
|
|
415
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[]._id | type: string | description: Modifier GUID.
|
|
416
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[].details | type: TranslatableString | description: Additional details.
|
|
417
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[].details.original | type: string | description: __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
418
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[].details.translated | type: string | description: String translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
419
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[].label | type: TranslatableString | description: Primary display label for the modifier.
|
|
420
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[].price | type: MultiCurrencyPrice | description: The price of the modifier.
|
|
421
|
-
- name: cart.lineItems[].modifierGroups[].modifiers[].quantity | type: number | description: The quantity of this modifier.
|
|
422
|
-
- name: cart.lineItems[].modifierGroups[].name | type: TranslatableString | description: Modifier group name.
|
|
423
|
-
- name: cart.lineItems[].modifiersTotalPrice | type: MultiCurrencyPrice | description: Total price of all item modifiers. Included in the item price.
|
|
424
|
-
- name: cart.lineItems[].paymentOption | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
|
|
425
|
-
- name: cart.lineItems[].physicalProperties | type: PhysicalProperties | description: Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability.
|
|
426
|
-
- name: cart.lineItems[].policies | type: Array<Policy> | description: Policies to be displayed to the customer on the checkout page.
|
|
427
|
-
- name: cart.lineItems[].policies[].content | type: string | description: Policy content - should be translated
|
|
428
|
-
- name: cart.lineItems[].policies[].title | type: string | description: Policy title - should be translated
|
|
429
|
-
- name: cart.lineItems[].price | type: MultiCurrencyPrice | description: Item price **after** catalog-defined discount and line item discounts.
|
|
430
|
-
- name: cart.lineItems[].priceBeforeDiscounts | type: MultiCurrencyPrice | description: Item price **before** line item discounts and **after** catalog-defined discount. Defaults to `price` when not provided.
|
|
431
|
-
- name: cart.lineItems[].priceDescription | type: PriceDescription | description: Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
|
|
432
|
-
- name: cart.lineItems[].priceDescription.original | type: string | description: __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
433
|
-
- name: cart.lineItems[].priceDescription.translated | type: string | description: Price description translated into the buyer's language. Default: Same as `original`.
|
|
434
|
-
- name: cart.lineItems[].priceUndetermined | type: boolean | description: Whether the price is not yet defined, and will be updated after the order is created.
|
|
435
|
-
- name: cart.lineItems[].productName | type: ProductName | description: Item name. + Stores - `product.name` + Bookings - `service.info.name` + Events - `ticket.name`
|
|
436
|
-
- name: cart.lineItems[].quantity | type: number | description: Item quantity.
|
|
437
|
-
- name: cart.lineItems[].rootCatalogItemId | type: string | description: In cases where `catalogReference.catalogItemId` is NOT the actual catalog item GUID, this field will return the true item's GUID. + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking GUID. Therefore this value is set to the service GUID. + in most cases, this field is the same as `catalogReference.catalogItemId`. + Used in membership validation.
|
|
438
|
-
- name: cart.lineItems[].savePaymentMethod | type: boolean | description: Whether to save the payment method on the order. Default: `false`
|
|
439
|
-
- name: cart.lineItems[].selectedMembership | type: SelectedMembership | description: Selected membership to be used as payment for this item. Must be used with `lineItem.paymentOption` set to `MEMBERSHIP` or `MEMBERSHIP_OFFLINE`. This field can be empty when `lineItem.paymentOption` is set to `MEMBERSHIP_OFFLINE`.
|
|
320
|
+
- name: cart.lineItems[].lineItemPrice | type: MultiCurrencyPrice | description: Total price **after** catalog-defined discount and line item discounts.
|
|
321
|
+
- name: cart.lineItems[].membersOnly | type: boolean | description: Whether the item can only be purchased by site members. Default: `false`
|
|
322
|
+
- name: cart.lineItems[].modifierGroups | type: Array<ModifierGroup> | description: Modifier groups that were added to the item.
|
|
323
|
+
- name: cart.lineItems[].modifierGroups[]._id | type: string | description: Modifier group GUID.
|
|
324
|
+
- name: cart.lineItems[].modifierGroups[].modifiers | type: Array<ItemModifier> | description: List of modifiers in this group.
|
|
325
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[]._id | type: string | description: Modifier GUID.
|
|
326
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[].details | type: TranslatableString | description: Additional details.
|
|
327
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[].details.original | type: string | description: __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
|
|
328
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[].details.translated | type: string | description: String translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
|
|
329
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[].label | type: TranslatableString | description: Primary display label for the modifier.
|
|
330
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[].price | type: MultiCurrencyPrice | description: The price of the modifier.
|
|
331
|
+
- name: cart.lineItems[].modifierGroups[].modifiers[].quantity | type: number | description: The quantity of this modifier.
|
|
332
|
+
- name: cart.lineItems[].modifierGroups[].name | type: TranslatableString | description: Modifier group name.
|
|
333
|
+
- name: cart.lineItems[].modifiersTotalPrice | type: MultiCurrencyPrice | description: Total price of all item modifiers. Included in the item price.
|
|
334
|
+
- name: cart.lineItems[].paymentOption | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
|
|
335
|
+
- name: cart.lineItems[].physicalProperties | type: PhysicalProperties | description: Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability.
|
|
336
|
+
- name: cart.lineItems[].policies | type: Array<Policy> | description: Policies to be displayed to the customer on the checkout page.
|
|
337
|
+
- name: cart.lineItems[].policies[].content | type: string | description: Policy content - should be translated
|
|
338
|
+
- name: cart.lineItems[].policies[].title | type: string | description: Policy title - should be translated
|
|
339
|
+
- name: cart.lineItems[].price | type: MultiCurrencyPrice | description: Item price **after** catalog-defined discount and line item discounts.
|
|
340
|
+
- name: cart.lineItems[].priceBeforeDiscounts | type: MultiCurrencyPrice | description: Item price **before** line item discounts and **after** catalog-defined discount. Defaults to `price` when not provided.
|
|
341
|
+
- name: cart.lineItems[].priceDescription | type: PriceDescription | description: Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
|
|
342
|
+
- name: cart.lineItems[].priceDescription.original | type: string | description: __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
343
|
+
- name: cart.lineItems[].priceDescription.translated | type: string | description: Price description translated into the buyer's language. Default: Same as `original`.
|
|
344
|
+
- name: cart.lineItems[].priceUndetermined | type: boolean | description: Whether the price is not yet defined, and will be updated after the order is created.
|
|
345
|
+
- name: cart.lineItems[].productName | type: ProductName | description: Item name. + Stores - `product.name` + Bookings - `service.info.name` + Events - `ticket.name`
|
|
346
|
+
- name: cart.lineItems[].quantity | type: number | description: Item quantity.
|
|
347
|
+
- name: cart.lineItems[].rootCatalogItemId | type: string | description: In cases where `catalogReference.catalogItemId` is NOT the actual catalog item GUID, this field will return the true item's GUID. + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking GUID. Therefore this value is set to the service GUID. + in most cases, this field is the same as `catalogReference.catalogItemId`. + Used in membership validation.
|
|
348
|
+
- name: cart.lineItems[].savePaymentMethod | type: boolean | description: Whether to save the payment method on the order. Default: `false`
|
|
349
|
+
- name: cart.lineItems[].selectedMembership | type: SelectedMembership | description: Selected membership to be used as payment for this item. Must be used with `lineItem.paymentOption` set to `MEMBERSHIP` or `MEMBERSHIP_OFFLINE`. This field can be empty when `lineItem.paymentOption` is set to `MEMBERSHIP_OFFLINE`.
|
|
440
350
|
- name: cart.lineItems[].selectedMembership._id | type: string | description: Membership GUID. | required: true
|
|
441
351
|
- name: cart.lineItems[].selectedMembership.appId | type: string | description: GUID of the app providing this payment option. | required: true
|
|
442
|
-
- name: cart.lineItems[].serviceProperties | type: ServiceProperties | description: Service properties. When relevant, this contains information such as date and number of participants.
|
|
443
|
-
- name: cart.lineItems[].serviceProperties.numberOfParticipants | type: number | description: The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
|
|
444
|
-
- name: cart.lineItems[].serviceProperties.scheduledDate | type: Date | description: Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. For example, the start time of a class.
|
|
445
|
-
- name: cart.lineItems[].subscriptionOptionInfo | type: SubscriptionOptionInfo | description: Subscription option information.
|
|
446
|
-
- name: cart.lineItems[].subscriptionOptionInfo.description | type: Description | description: Subscription option description.
|
|
447
|
-
- name: cart.lineItems[].subscriptionOptionInfo.description.original | type: string | description: Subscription option description.
|
|
448
|
-
- name: cart.lineItems[].subscriptionOptionInfo.description.translated | type: string | description: Translated subscription option description.
|
|
449
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings | type: SubscriptionSettings | description: Subscription option settings.
|
|
450
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.autoRenewal | type: boolean | description: Whether subscription is renewed automatically at the end of each period.
|
|
451
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.billingCycles | type: number | description: Number of billing cycles before subscription ends. Ignored if `autoRenewal` is `true`.
|
|
452
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.enableCustomerCancellation | type: boolean | description: Whether to allow the customer to cancel the subscription..
|
|
453
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.freeTrialPeriod | type: FreeTrialPeriod | description: Period until first cycle starts. If applied payNow will be 0 If None => no free trial
|
|
454
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.freeTrialPeriod.frequency | type: SubscriptionFrequency | description: Frequency of period. Values: DAY, WEEK, MONTH, YEAR
|
|
352
|
+
- name: cart.lineItems[].serviceProperties | type: ServiceProperties | description: Service properties. When relevant, this contains information such as date and number of participants.
|
|
353
|
+
- name: cart.lineItems[].serviceProperties.numberOfParticipants | type: number | description: The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
|
|
354
|
+
- name: cart.lineItems[].serviceProperties.scheduledDate | type: Date | description: Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. For example, the start time of a class.
|
|
355
|
+
- name: cart.lineItems[].subscriptionOptionInfo | type: SubscriptionOptionInfo | description: Subscription option information.
|
|
356
|
+
- name: cart.lineItems[].subscriptionOptionInfo.description | type: Description | description: Subscription option description.
|
|
357
|
+
- name: cart.lineItems[].subscriptionOptionInfo.description.original | type: string | description: Subscription option description.
|
|
358
|
+
- name: cart.lineItems[].subscriptionOptionInfo.description.translated | type: string | description: Translated subscription option description.
|
|
359
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings | type: SubscriptionSettings | description: Subscription option settings.
|
|
360
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.autoRenewal | type: boolean | description: Whether subscription is renewed automatically at the end of each period.
|
|
361
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.billingCycles | type: number | description: Number of billing cycles before subscription ends. Ignored if `autoRenewal` is `true`.
|
|
362
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.enableCustomerCancellation | type: boolean | description: Whether to allow the customer to cancel the subscription..
|
|
363
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.freeTrialPeriod | type: FreeTrialPeriod | description: Period until first cycle starts. If applied payNow will be 0 If None => no free trial
|
|
364
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.freeTrialPeriod.frequency | type: SubscriptionFrequency | description: Frequency of period. Values: DAY, WEEK, MONTH, YEAR
|
|
455
365
|
enum: DAY, MONTH, UNDEFINED, WEEK, YEAR
|
|
456
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.freeTrialPeriod.interval | type: number | description: interval of period
|
|
457
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.frequency | type: SubscriptionFrequency | description: Frequency of recurring payment.
|
|
458
|
-
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.interval | type: number | description: Interval of recurring payment. Default: `1`. If SubscriptionFrequency is Day the minimum interval is 7
|
|
459
|
-
- name: cart.lineItems[].subscriptionOptionInfo.title | type: Title | description: Subscription option title.
|
|
460
|
-
- name: cart.lineItems[].subscriptionOptionInfo.title.original | type: string | description: Subscription option name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
461
|
-
- name: cart.lineItems[].subscriptionOptionInfo.title.translated | type: string | description: Subscription option name translated into the buyer's language. Default: Same as `original`.
|
|
462
|
-
- name: cart.lineItems[].taxGroupId | type: string | description: Tax group GUID for this line item.
|
|
463
|
-
- name: cart.lineItems[].taxableAddress | type: TaxableAddress | description: Address to use for tax calculation purposes.
|
|
464
|
-
- ONE-OF:
|
|
465
|
-
- name: cart.lineItems[].taxableAddress.addressType | type: TaxableAddressType | description: taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly.
|
|
366
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.freeTrialPeriod.interval | type: number | description: interval of period
|
|
367
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.frequency | type: SubscriptionFrequency | description: Frequency of recurring payment.
|
|
368
|
+
- name: cart.lineItems[].subscriptionOptionInfo.subscriptionSettings.interval | type: number | description: Interval of recurring payment. Default: `1`. If SubscriptionFrequency is Day the minimum interval is 7
|
|
369
|
+
- name: cart.lineItems[].subscriptionOptionInfo.title | type: Title | description: Subscription option title.
|
|
370
|
+
- name: cart.lineItems[].subscriptionOptionInfo.title.original | type: string | description: Subscription option name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
|
|
371
|
+
- name: cart.lineItems[].subscriptionOptionInfo.title.translated | type: string | description: Subscription option name translated into the buyer's language. Default: Same as `original`.
|
|
372
|
+
- name: cart.lineItems[].taxGroupId | type: string | description: Tax group GUID for this line item.
|
|
373
|
+
- name: cart.lineItems[].taxableAddress | type: TaxableAddress | description: Address to use for tax calculation purposes.
|
|
374
|
+
- ONE-OF:
|
|
375
|
+
- name: cart.lineItems[].taxableAddress.addressType | type: TaxableAddressType | description: taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly.
|
|
466
376
|
enum: BILLING, BUSINESS, SHIPPING, UNKNOWN_TAXABLE_ADDRESS
|
|
467
|
-
- name: cart.lineItems[].url | type: string | description: URL to the item's page on the site.
|
|
468
|
-
- name: cart.overrideCheckoutUrl | type: string | description: `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page. This field overrides the `checkoutUrl` in a cart or checkout. `checkoutUrl` is used in the Abandoned Checkout API to send customers back to their checkouts. By default, a `checkoutUrl` generates for a checkout and directs to a standard Wix checkout page. When `overrideCheckoutUrl` has a value, it will replace and set the value of `checkoutUrl`.
|
|
469
|
-
- name: cart.paymentCurrency | type: string | description: The currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This is determined by the [customer's selected currency](https://support.wix.com/en/article/multicurrency-an-overview) and the site’s supported payment currencies. If the customer’s selected currency is supported for payment, this matches the `conversionCurrency` property. If not supported, this falls back to the `currency` property.
|
|
470
|
-
- name: cart.purchaseFlowId | type: string | description: Persistent GUID that correlates between the various eCommerce elements: cart, checkout, and order.
|
|
471
|
-
- name: cart.revision | type: string | description: Revision number, which increments by 1 each time the Cart is updated.
|
|
472
|
-
- name: cart.selectedShippingOption | type: SelectedShippingOption | description: Selected shipping option.
|
|
473
|
-
- name: cart.selectedShippingOption.carrierId | type: string | description: Carrier GUID.
|
|
474
|
-
- name: cart.selectedShippingOption.code | type: string | description: Selected shipping option code. For example, "usps_std_overnight".
|
|
475
|
-
- name: cart.siteLanguage | type: string | description: Site language in which original values are displayed.
|
|
476
|
-
- name: cart.taxIncludedInPrices | type: boolean | description: Whether tax is included in line item prices.
|
|
477
|
-
- name: cart.weightUnit | type: WeightUnit | description: Weight measurement unit - defaults to site's weight unit.
|
|
478
|
-
enum:
|
|
377
|
+
- name: cart.lineItems[].url | type: string | description: URL to the item's page on the site.
|
|
378
|
+
- name: cart.overrideCheckoutUrl | type: string | description: `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page. This field overrides the `checkoutUrl` in a cart or checkout. `checkoutUrl` is used in the Abandoned Checkout API to send customers back to their checkouts. By default, a `checkoutUrl` generates for a checkout and directs to a standard Wix checkout page. When `overrideCheckoutUrl` has a value, it will replace and set the value of `checkoutUrl`.
|
|
379
|
+
- name: cart.paymentCurrency | type: string | description: The currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This is determined by the [customer's selected currency](https://support.wix.com/en/article/multicurrency-an-overview) and the site’s supported payment currencies. If the customer’s selected currency is supported for payment, this matches the `conversionCurrency` property. If not supported, this falls back to the `currency` property.
|
|
380
|
+
- name: cart.purchaseFlowId | type: string | description: Persistent GUID that correlates between the various eCommerce elements: cart, checkout, and order.
|
|
381
|
+
- name: cart.revision | type: string | description: Revision number, which increments by 1 each time the Cart is updated.
|
|
382
|
+
- name: cart.selectedShippingOption | type: SelectedShippingOption | description: Selected shipping option.
|
|
383
|
+
- name: cart.selectedShippingOption.carrierId | type: string | description: Carrier GUID.
|
|
384
|
+
- name: cart.selectedShippingOption.code | type: string | description: Selected shipping option code. For example, "usps_std_overnight".
|
|
385
|
+
- name: cart.siteLanguage | type: string | description: Site language in which original values are displayed.
|
|
386
|
+
- name: cart.taxIncludedInPrices | type: boolean | description: Whether tax is included in line item prices.
|
|
387
|
+
- name: cart.weightUnit | type: WeightUnit | description: Weight measurement unit - defaults to site's weight unit.
|
|
388
|
+
enum:
|
|
479
389
|
KG: Kilograms.
|
|
480
390
|
LB: Pounds.
|
|
481
391
|
UNSPECIFIED_WEIGHT_UNIT: Weight unit can't be classified due to an error.
|
|
@@ -485,4 +395,4 @@ Possible Errors:
|
|
|
485
395
|
|
|
486
396
|
```
|
|
487
397
|
</type_definition>
|
|
488
|
-
</ecom_cart_addToCart>
|
|
398
|
+
</ecom_cart_addToCart>
|