@wix/auto_sdk_ecom_checkout-templates 1.0.36 → 1.0.37

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.
Files changed (134) hide show
  1. package/build/{cjs/src/ecom-v1-checkout-template-checkout-templates.types.d.ts → ecom-v1-checkout-template-checkout-templates.universal-DZSQyXAS.d.mts} +400 -276
  2. package/build/{internal/cjs/src/ecom-v1-checkout-template-checkout-templates.types.d.ts → ecom-v1-checkout-template-checkout-templates.universal-DZSQyXAS.d.ts} +400 -276
  3. package/build/index.d.mts +136 -0
  4. package/build/index.d.ts +136 -0
  5. package/build/index.js +1209 -0
  6. package/build/index.js.map +1 -0
  7. package/build/index.mjs +1149 -0
  8. package/build/index.mjs.map +1 -0
  9. package/build/internal/{cjs/src/ecom-v1-checkout-template-checkout-templates.universal.d.ts → ecom-v1-checkout-template-checkout-templates.universal-DQx0Jt-F.d.mts} +209 -450
  10. package/build/internal/{es/src/ecom-v1-checkout-template-checkout-templates.universal.d.ts → ecom-v1-checkout-template-checkout-templates.universal-DQx0Jt-F.d.ts} +209 -450
  11. package/build/internal/index.d.mts +136 -0
  12. package/build/internal/index.d.ts +136 -0
  13. package/build/internal/index.js +1209 -0
  14. package/build/internal/index.js.map +1 -0
  15. package/build/internal/index.mjs +1149 -0
  16. package/build/internal/index.mjs.map +1 -0
  17. package/build/internal/meta.d.mts +810 -0
  18. package/build/internal/meta.d.ts +810 -0
  19. package/build/internal/meta.js +491 -0
  20. package/build/internal/meta.js.map +1 -0
  21. package/build/internal/meta.mjs +458 -0
  22. package/build/internal/meta.mjs.map +1 -0
  23. package/build/meta.d.mts +810 -0
  24. package/build/meta.d.ts +810 -0
  25. package/build/meta.js +491 -0
  26. package/build/meta.js.map +1 -0
  27. package/build/meta.mjs +458 -0
  28. package/build/meta.mjs.map +1 -0
  29. package/package.json +12 -11
  30. package/build/cjs/index.d.ts +0 -1
  31. package/build/cjs/index.js +0 -18
  32. package/build/cjs/index.js.map +0 -1
  33. package/build/cjs/index.typings.d.ts +0 -1
  34. package/build/cjs/index.typings.js +0 -18
  35. package/build/cjs/index.typings.js.map +0 -1
  36. package/build/cjs/meta.d.ts +0 -1
  37. package/build/cjs/meta.js +0 -18
  38. package/build/cjs/meta.js.map +0 -1
  39. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.context.d.ts +0 -32
  40. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.context.js +0 -61
  41. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.context.js.map +0 -1
  42. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.http.d.ts +0 -68
  43. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.http.js +0 -390
  44. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.http.js.map +0 -1
  45. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.meta.d.ts +0 -29
  46. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.meta.js +0 -161
  47. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.meta.js.map +0 -1
  48. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.public.d.ts +0 -112
  49. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.public.js +0 -271
  50. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.public.js.map +0 -1
  51. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.types.js +0 -261
  52. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.types.js.map +0 -1
  53. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.universal.d.ts +0 -3161
  54. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.universal.js +0 -730
  55. package/build/cjs/src/ecom-v1-checkout-template-checkout-templates.universal.js.map +0 -1
  56. package/build/es/index.d.ts +0 -1
  57. package/build/es/index.js +0 -2
  58. package/build/es/index.js.map +0 -1
  59. package/build/es/index.typings.d.ts +0 -1
  60. package/build/es/index.typings.js +0 -2
  61. package/build/es/index.typings.js.map +0 -1
  62. package/build/es/meta.d.ts +0 -1
  63. package/build/es/meta.js +0 -2
  64. package/build/es/meta.js.map +0 -1
  65. package/build/es/package.json +0 -3
  66. package/build/es/src/ecom-v1-checkout-template-checkout-templates.context.d.ts +0 -32
  67. package/build/es/src/ecom-v1-checkout-template-checkout-templates.context.js +0 -32
  68. package/build/es/src/ecom-v1-checkout-template-checkout-templates.context.js.map +0 -1
  69. package/build/es/src/ecom-v1-checkout-template-checkout-templates.http.d.ts +0 -68
  70. package/build/es/src/ecom-v1-checkout-template-checkout-templates.http.js +0 -380
  71. package/build/es/src/ecom-v1-checkout-template-checkout-templates.http.js.map +0 -1
  72. package/build/es/src/ecom-v1-checkout-template-checkout-templates.meta.d.ts +0 -29
  73. package/build/es/src/ecom-v1-checkout-template-checkout-templates.meta.js +0 -128
  74. package/build/es/src/ecom-v1-checkout-template-checkout-templates.meta.js.map +0 -1
  75. package/build/es/src/ecom-v1-checkout-template-checkout-templates.public.d.ts +0 -112
  76. package/build/es/src/ecom-v1-checkout-template-checkout-templates.public.js +0 -235
  77. package/build/es/src/ecom-v1-checkout-template-checkout-templates.public.js.map +0 -1
  78. package/build/es/src/ecom-v1-checkout-template-checkout-templates.types.d.ts +0 -2794
  79. package/build/es/src/ecom-v1-checkout-template-checkout-templates.types.js +0 -258
  80. package/build/es/src/ecom-v1-checkout-template-checkout-templates.types.js.map +0 -1
  81. package/build/es/src/ecom-v1-checkout-template-checkout-templates.universal.d.ts +0 -3161
  82. package/build/es/src/ecom-v1-checkout-template-checkout-templates.universal.js +0 -697
  83. package/build/es/src/ecom-v1-checkout-template-checkout-templates.universal.js.map +0 -1
  84. package/build/internal/cjs/index.d.ts +0 -1
  85. package/build/internal/cjs/index.js +0 -18
  86. package/build/internal/cjs/index.js.map +0 -1
  87. package/build/internal/cjs/index.typings.d.ts +0 -1
  88. package/build/internal/cjs/index.typings.js +0 -18
  89. package/build/internal/cjs/index.typings.js.map +0 -1
  90. package/build/internal/cjs/meta.d.ts +0 -1
  91. package/build/internal/cjs/meta.js +0 -18
  92. package/build/internal/cjs/meta.js.map +0 -1
  93. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.context.d.ts +0 -32
  94. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.context.js +0 -61
  95. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.context.js.map +0 -1
  96. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.http.d.ts +0 -68
  97. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.http.js +0 -390
  98. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.http.js.map +0 -1
  99. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.meta.d.ts +0 -29
  100. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.meta.js +0 -161
  101. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.meta.js.map +0 -1
  102. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.public.d.ts +0 -112
  103. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.public.js +0 -271
  104. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.public.js.map +0 -1
  105. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.types.js +0 -261
  106. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.types.js.map +0 -1
  107. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.universal.js +0 -730
  108. package/build/internal/cjs/src/ecom-v1-checkout-template-checkout-templates.universal.js.map +0 -1
  109. package/build/internal/es/index.d.ts +0 -1
  110. package/build/internal/es/index.js +0 -2
  111. package/build/internal/es/index.js.map +0 -1
  112. package/build/internal/es/index.typings.d.ts +0 -1
  113. package/build/internal/es/index.typings.js +0 -2
  114. package/build/internal/es/index.typings.js.map +0 -1
  115. package/build/internal/es/meta.d.ts +0 -1
  116. package/build/internal/es/meta.js +0 -2
  117. package/build/internal/es/meta.js.map +0 -1
  118. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.context.d.ts +0 -32
  119. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.context.js +0 -32
  120. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.context.js.map +0 -1
  121. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.http.d.ts +0 -68
  122. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.http.js +0 -380
  123. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.http.js.map +0 -1
  124. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.meta.d.ts +0 -29
  125. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.meta.js +0 -128
  126. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.meta.js.map +0 -1
  127. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.public.d.ts +0 -112
  128. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.public.js +0 -235
  129. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.public.js.map +0 -1
  130. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.types.d.ts +0 -2794
  131. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.types.js +0 -258
  132. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.types.js.map +0 -1
  133. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.universal.js +0 -697
  134. package/build/internal/es/src/ecom-v1-checkout-template-checkout-templates.universal.js.map +0 -1
@@ -1,2794 +0,0 @@
1
- export interface CheckoutTemplate {
2
- /**
3
- * Checkout template ID.
4
- * @format GUID
5
- * @readonly
6
- */
7
- id?: string | null;
8
- /**
9
- * Status of the checkout template.
10
- *
11
- * When `status` is `INACTIVE` checkouts will not be created with this template `id`. Instead, the endpoint will redirect to the domain site.
12
- *
13
- * Default: `ACTIVE`
14
- */
15
- status?: StatusWithLiterals;
16
- /** Custom settings to apply to the checkout page created from this template. */
17
- customization?: CheckoutCustomization;
18
- /**
19
- * Catalog line items.
20
- *
21
- * Max: 300 items
22
- * @maxSize 300
23
- */
24
- lineItems?: V1LineItem[];
25
- /**
26
- * Custom line items. Custom line items don't trigger the Catalog service plugin.
27
- *
28
- * Max: 300 items
29
- * @maxSize 300
30
- */
31
- customLineItems?: CustomLineItem[];
32
- /**
33
- * Coupon code.
34
- *
35
- * Note that a checkout can only hold one `couponCode` at a time. If an additional `couponCode` is added, it will override the existing `couponCode`.
36
- * For additional information, see the Coupons API.
37
- */
38
- couponCode?: string | null;
39
- /**
40
- * Reference IDs for the app and component providing custom checkout page content.
41
- *
42
- * To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
43
- * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
44
- */
45
- customContentReference?: CustomContentReference;
46
- /**
47
- * References to an external app and resource associated with the checkout.
48
- * Used for integration and tracking across different platforms.
49
- * @immutable
50
- */
51
- externalReference?: ExternalReference;
52
- }
53
- export declare enum Status {
54
- UNKNOWN_STATUS = "UNKNOWN_STATUS",
55
- ACTIVE = "ACTIVE",
56
- INACTIVE = "INACTIVE"
57
- }
58
- /** @enumType */
59
- export type StatusWithLiterals = Status | 'UNKNOWN_STATUS' | 'ACTIVE' | 'INACTIVE';
60
- export interface CheckoutCustomization {
61
- /** Web client customizations. These customizations only apply to the standard Wix checkout page. */
62
- webClient?: WebClientCustomization;
63
- /**
64
- * Whether to lock the ability to add or remove a gift card.
65
- *
66
- * Default: `false`
67
- */
68
- lockedGiftCard?: boolean;
69
- /**
70
- * Whether to lock the ability to apply or remove a coupon code.
71
- *
72
- * Default: `false`
73
- */
74
- lockedCoupon?: boolean;
75
- /**
76
- * Whether to disable manual payment option for this checkout.
77
- *
78
- * Default: `false`
79
- */
80
- disabledManualPayment?: boolean;
81
- }
82
- export interface WebClientCustomization {
83
- /**
84
- * Whether to disable the "Continue shopping" button.
85
- *
86
- * Default: `false`
87
- */
88
- disabledContinueShoppingButton?: boolean;
89
- /**
90
- * Whether to disable policy agreement checkout in the checkout page
91
- *
92
- * Default: `false`
93
- */
94
- disabledPolicyAgreementCheckbox?: boolean;
95
- }
96
- export interface V1LineItem {
97
- /**
98
- * Item quantity.
99
- *
100
- * Min: `1` <br />
101
- * Max: `100000`
102
- * @min 1
103
- * @max 100000
104
- */
105
- quantity?: number;
106
- /** Catalog and item reference. Holds IDs 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
- catalogReference?: CatalogReference;
108
- /** Overriding values for catalog item properties. */
109
- catalogOverrideFields?: CatalogOverrideFields;
110
- }
111
- /** Used for grouping line items. Sent when an item is added to a cart, checkout, or order. */
112
- export interface CatalogReference {
113
- /**
114
- * ID of the item within the catalog it belongs to.
115
- * @minLength 1
116
- * @maxLength 36
117
- */
118
- catalogItemId?: string;
119
- /**
120
- * ID of the app providing the catalog.
121
- *
122
- * You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
123
- *
124
- * For items from Wix catalogs, the following values always apply:
125
- * + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
126
- * + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
127
- * + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
128
- * @minLength 1
129
- */
130
- appId?: string;
131
- /**
132
- * 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.
133
- *
134
- * For products and variants from a Wix Stores catalog, learn more about eCommerce integration ([SDK](https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/e-commerce-integration) | [REST](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration)).
135
- */
136
- options?: Record<string, any> | null;
137
- }
138
- export interface CatalogOverrideFields {
139
- /** Item name. */
140
- productName?: ProductName;
141
- /**
142
- * Item price **after** discounts.
143
- * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
144
- */
145
- price?: string | null;
146
- /**
147
- * Item price **before** discounts.
148
- * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
149
- */
150
- fullPrice?: string | null;
151
- /**
152
- * Item description lines. Used when displaying the line item to customers.
153
- * @maxSize 20
154
- */
155
- descriptionLines?: DescriptionLine[];
156
- /** Physical properties of the item. */
157
- physicalProperties?: PhysicalProperties;
158
- /** Item image. */
159
- image?: Image;
160
- /** Payment method selected for the item. */
161
- paymentOption?: PaymentOption;
162
- /**
163
- * Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
164
- * @format DECIMAL_VALUE
165
- * @decimalValue options { gt:0, lte:999999999, maxScale:3 }
166
- */
167
- depositAmount?: string | null;
168
- /**
169
- * Whether to save the payment method on the order.
170
- *
171
- * Default: `false`
172
- */
173
- savePaymentMethod?: boolean | null;
174
- }
175
- export interface ProductName {
176
- /**
177
- * __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).
178
- *
179
- * Min: 1 character.
180
- * Max: 200 characters.
181
- * @minLength 1
182
- * @maxLength 200
183
- */
184
- original?: string;
185
- /**
186
- * Item name translated into the buyer's language.
187
- *
188
- * Min: 1 character.
189
- * Max: 400 characters.
190
- * Default: Same as `original`.
191
- * @minLength 1
192
- * @maxLength 400
193
- */
194
- translated?: string | null;
195
- }
196
- export interface DescriptionLine extends DescriptionLineValueOneOf, DescriptionLineDescriptionLineValueOneOf {
197
- /** Description line plain text value. */
198
- plainText?: PlainTextValue;
199
- /** Description line color value. */
200
- colorInfo?: Color;
201
- /** Description line name. */
202
- name?: DescriptionLineName;
203
- }
204
- /** @oneof */
205
- export interface DescriptionLineValueOneOf {
206
- /** Description line plain text value. */
207
- plainText?: PlainTextValue;
208
- /** Description line color value. */
209
- colorInfo?: Color;
210
- }
211
- /** @oneof */
212
- export interface DescriptionLineDescriptionLineValueOneOf {
213
- }
214
- export interface DescriptionLineName {
215
- /**
216
- * 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).
217
- * @maxLength 100
218
- */
219
- original?: string;
220
- /**
221
- * Description line name translated into the buyer's language.
222
- *
223
- * Default: Same as `original`.
224
- * @maxLength 200
225
- */
226
- translated?: string | null;
227
- }
228
- export interface PlainTextValue {
229
- /**
230
- * 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).
231
- * @maxLength 600
232
- */
233
- original?: string;
234
- /**
235
- * Description line plain text value translated into the buyer's language.
236
- *
237
- * Default: Same as `original`.
238
- * @maxLength 600
239
- */
240
- translated?: string | null;
241
- }
242
- export interface Color {
243
- /**
244
- * 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).
245
- * @maxLength 500
246
- */
247
- original?: string;
248
- /**
249
- * Description line color name translated into the buyer's language.
250
- *
251
- * Default: Same as `original`.
252
- * @maxLength 500
253
- */
254
- translated?: string | null;
255
- /** HEX or RGB color code for display. */
256
- code?: string | null;
257
- }
258
- export declare enum DescriptionLineType {
259
- /** Unrecognized type. */
260
- UNRECOGNISED = "UNRECOGNISED",
261
- /** Plain text type. */
262
- PLAIN_TEXT = "PLAIN_TEXT",
263
- /** Color type. */
264
- COLOR = "COLOR"
265
- }
266
- /** @enumType */
267
- export type DescriptionLineTypeWithLiterals = DescriptionLineType | 'UNRECOGNISED' | 'PLAIN_TEXT' | 'COLOR';
268
- export interface PhysicalProperties {
269
- /** Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request. */
270
- weight?: number | null;
271
- /**
272
- * Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
273
- * @maxLength 40
274
- */
275
- sku?: string | null;
276
- /** Whether this line item is shippable. */
277
- shippable?: boolean;
278
- }
279
- export interface Image {
280
- /** WixMedia image ID. */
281
- id?: string;
282
- /** Original image height. */
283
- height?: number;
284
- /** Original image width. */
285
- width?: number;
286
- /** Image alt text. Optional. */
287
- altText?: string | null;
288
- /** Image filename. Optional. */
289
- filename?: string | null;
290
- }
291
- export interface PaymentOption {
292
- /**
293
- * Type of selected payment option for current item.
294
- *
295
- * Default: `FULL_PAYMENT_ONLINE`
296
- */
297
- value?: PaymentOptionTypeWithLiterals;
298
- }
299
- /** Type of selected payment option for catalog item */
300
- export declare enum PaymentOptionType {
301
- /** The entire payment for this item happens as part of the checkout. */
302
- FULL_PAYMENT_ONLINE = "FULL_PAYMENT_ONLINE",
303
- /** The entire payment for this item happens after checkout. For example, when using cash, check, or other offline payment methods. */
304
- FULL_PAYMENT_OFFLINE = "FULL_PAYMENT_OFFLINE",
305
- /** Payment for this item is done by charging a membership. When selected, `price` is `0`. */
306
- MEMBERSHIP = "MEMBERSHIP",
307
- /** Partial payment to be paid upfront during checkout. The initial amount to be paid for each line item is specified in `depositAmount`. */
308
- DEPOSIT_ONLINE = "DEPOSIT_ONLINE",
309
- /** 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`. */
310
- MEMBERSHIP_OFFLINE = "MEMBERSHIP_OFFLINE"
311
- }
312
- /** @enumType */
313
- export type PaymentOptionTypeWithLiterals = PaymentOptionType | 'FULL_PAYMENT_ONLINE' | 'FULL_PAYMENT_OFFLINE' | 'MEMBERSHIP' | 'DEPOSIT_ONLINE' | 'MEMBERSHIP_OFFLINE';
314
- export interface CustomLineItem {
315
- /**
316
- * Custom line item quantity.
317
- *
318
- * Min: `1`
319
- * Max: `100000`
320
- * @min 1
321
- * @max 100000
322
- */
323
- quantity?: number;
324
- /**
325
- * Custom line item price.
326
- *
327
- * Must be a number or a decimal without symbols.
328
- * @format DECIMAL_VALUE
329
- * @decimalValue options { gte:0, lte:1000000000000000 }
330
- */
331
- price?: string;
332
- /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */
333
- priceDescription?: PriceDescription;
334
- /**
335
- * Custom line item description lines. Used for display purposes for the cart, checkout and order.
336
- * @maxSize 10
337
- */
338
- descriptionLines?: DescriptionLine[];
339
- /** Custom line item's media. */
340
- media?: Image;
341
- /**
342
- * Custom line item ID. If passed, `id` must be unique.
343
- *
344
- * Default: auto-generated ID
345
- * @format GUID
346
- */
347
- id?: string | null;
348
- /**
349
- * Tax group ID for this custom line item.
350
- * @format GUID
351
- */
352
- taxGroupId?: string | null;
353
- /** Name of the item or product. */
354
- productName?: ProductName;
355
- /** 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. */
356
- url?: PageUrlV2;
357
- /** Item type. Either a preset type or custom. */
358
- itemType?: ItemType;
359
- /**
360
- * Item price **before** catalog-defined discount. Defaults to `price` when not provided.
361
- * @format DECIMAL_VALUE
362
- */
363
- fullPrice?: string | null;
364
- /**
365
- * Item quantity available for purchase. Only return this if inventory is managed.
366
- * Not returning this field means that the buyer can "infinitely" tick up the number of items in the cart.
367
- * @max 100000
368
- */
369
- quantityAvailable?: number | null;
370
- /** Physical properties of the item. */
371
- physicalProperties?: PhysicalProperties;
372
- /**
373
- * Type of selected payment option for current item. Defaults to `FULL_PAYMENT_ONLINE`.
374
- *
375
- * + `FULL_PAYMENT_ONLINE` - Entire payment for this item happens as part of the checkout.
376
- * + `FULL_PAYMENT_OFFLINE` - Entire payment for this item happens after the checkout. For example, when using cash, check, or other offline payment methods.
377
- * + `MEMBERSHIP` - Payment for this item is done by charging a membership. When this option is used, `lineItem.price.amount` is 0.
378
- * + `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.
379
- */
380
- paymentOption?: PaymentOptionTypeWithLiterals;
381
- /**
382
- * Service properties. When relevant, this contains information such as date and number of participants.
383
- * Used, among other things, when checking for valid memberships.
384
- */
385
- serviceProperties?: ServiceProperties;
386
- /**
387
- * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
388
- *
389
- * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
390
- * + In most cases, this field is the same as `catalogReference.catalogItemId`.
391
- * + Used in membership validation.
392
- * @minLength 1
393
- * @maxLength 36
394
- */
395
- rootCatalogItemId?: string | null;
396
- /**
397
- * Partial payment for the given item to be paid upfront during the checkout.
398
- *
399
- * Eligible for catalog items with type `DEPOSIT_ONLINE`.
400
- * When omitted, the item's price will not be split and is expected to be paid in a single installment.
401
- * @format DECIMAL_VALUE
402
- */
403
- depositAmount?: string | null;
404
- /**
405
- * Delivery profile ID.
406
- * @format GUID
407
- */
408
- deliveryProfileId?: string | null;
409
- /** Catalog and item reference. Includes IDs 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. */
410
- catalogReference?: CatalogReference;
411
- /**
412
- * Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
413
- * @minLength 1
414
- * @maxLength 1000
415
- * @readonly
416
- */
417
- consentRequiredPaymentPolicy?: string | null;
418
- /**
419
- * Whether to save the payment method on the order.
420
- *
421
- * Default: `false`
422
- * @readonly
423
- */
424
- savePaymentMethod?: boolean;
425
- /**
426
- * Policies to be displayed to the customer on the checkout page.
427
- * @maxSize 5
428
- */
429
- policies?: Policy[];
430
- /**
431
- * Whether the item can only be purchased by site members.
432
- *
433
- * Default: `false`
434
- */
435
- membersOnly?: boolean;
436
- /** Address to use for tax calculation purposes. */
437
- taxableAddress?: TaxableAddress;
438
- /**
439
- * Modifier groups that were added to the item.
440
- * @maxSize 25
441
- */
442
- modifierGroups?: V1ModifierGroup[];
443
- }
444
- export interface PriceDescription {
445
- /**
446
- * __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).
447
- * @minLength 1
448
- * @maxLength 100
449
- */
450
- original?: string;
451
- /**
452
- * Price description translated into the buyer's language.
453
- *
454
- * Default: Same as `original`.
455
- * @minLength 1
456
- * @maxLength 100
457
- */
458
- translated?: string | null;
459
- }
460
- export interface PageUrlV2 {
461
- /** The relative path for the page within the site. For example, `/product-page/a-product`. */
462
- relativePath?: string;
463
- /** The page's full URL. For example, `https://mysite.com/product-page/a-product`. */
464
- url?: string | null;
465
- }
466
- export interface ItemType extends ItemTypeItemTypeDataOneOf {
467
- /** Preset item type. */
468
- preset?: ItemTypeItemTypeWithLiterals;
469
- /** Custom item type. When none of the preset types are suitable, specifies the custom type. */
470
- custom?: string;
471
- }
472
- /** @oneof */
473
- export interface ItemTypeItemTypeDataOneOf {
474
- /** Preset item type. */
475
- preset?: ItemTypeItemTypeWithLiterals;
476
- /** Custom item type. When none of the preset types are suitable, specifies the custom type. */
477
- custom?: string;
478
- }
479
- export declare enum ItemTypeItemType {
480
- UNRECOGNISED = "UNRECOGNISED",
481
- PHYSICAL = "PHYSICAL",
482
- DIGITAL = "DIGITAL",
483
- GIFT_CARD = "GIFT_CARD",
484
- SERVICE = "SERVICE"
485
- }
486
- /** @enumType */
487
- export type ItemTypeItemTypeWithLiterals = ItemTypeItemType | 'UNRECOGNISED' | 'PHYSICAL' | 'DIGITAL' | 'GIFT_CARD' | 'SERVICE';
488
- export interface SubscriptionOptionInfo {
489
- /** Subscription option settings. */
490
- subscriptionSettings?: SubscriptionSettings;
491
- /** Subscription option title. */
492
- title?: Title;
493
- /** Subscription option description. */
494
- description?: Description;
495
- }
496
- export interface SubscriptionSettings {
497
- /** Frequency of recurring payment. */
498
- frequency?: SubscriptionFrequencyWithLiterals;
499
- /**
500
- * Interval of recurring payment.
501
- *
502
- * Default: `1`.
503
- * If SubscriptionFrequency is Day the minimum interval is 7
504
- * @min 1
505
- * @max 50
506
- */
507
- interval?: number | null;
508
- /** Whether subscription is renewed automatically at the end of each period. */
509
- autoRenewal?: boolean;
510
- /**
511
- * Number of billing cycles before subscription ends. Ignored if `autoRenewal` is `true`.
512
- * @min 1
513
- */
514
- billingCycles?: number | null;
515
- /** Whether to allow the customer to cancel the subscription.. */
516
- enableCustomerCancellation?: boolean;
517
- /**
518
- * Period until first cycle starts. If applied payNow will be 0
519
- * If None => no free trial
520
- */
521
- freeTrialPeriod?: FreeTrialPeriod;
522
- }
523
- /** Frequency unit of recurring payment */
524
- export declare enum SubscriptionFrequency {
525
- UNDEFINED = "UNDEFINED",
526
- DAY = "DAY",
527
- WEEK = "WEEK",
528
- MONTH = "MONTH",
529
- YEAR = "YEAR"
530
- }
531
- /** @enumType */
532
- export type SubscriptionFrequencyWithLiterals = SubscriptionFrequency | 'UNDEFINED' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';
533
- export interface FreeTrialPeriod {
534
- /** Frequency of period. Values: DAY, WEEK, MONTH, YEAR */
535
- frequency?: SubscriptionFrequencyWithLiterals;
536
- /**
537
- * interval of period
538
- * @min 1
539
- * @max 999
540
- */
541
- interval?: number;
542
- }
543
- export interface Title {
544
- /**
545
- * 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).
546
- * @minLength 1
547
- * @maxLength 150
548
- */
549
- original?: string;
550
- /**
551
- * Subscription option name translated into the buyer's language.
552
- *
553
- * Default: Same as `original`.
554
- * @minLength 1
555
- * @maxLength 150
556
- */
557
- translated?: string | null;
558
- }
559
- export interface Description {
560
- /**
561
- * Subscription option description.
562
- * @maxLength 500
563
- */
564
- original?: string;
565
- /**
566
- * Translated subscription option description.
567
- * @maxLength 500
568
- */
569
- translated?: string | null;
570
- }
571
- export interface SecuredMedia {
572
- /**
573
- * Media ID in Wix Media Manager.
574
- * @minLength 1
575
- * @maxLength 100
576
- */
577
- id?: string;
578
- /**
579
- * Original filename.
580
- * @minLength 1
581
- * @maxLength 1000
582
- */
583
- fileName?: string;
584
- /** File type. */
585
- fileType?: FileTypeWithLiterals;
586
- }
587
- export declare enum FileType {
588
- UNSPECIFIED = "UNSPECIFIED",
589
- SECURE_PICTURE = "SECURE_PICTURE",
590
- SECURE_VIDEO = "SECURE_VIDEO",
591
- SECURE_DOCUMENT = "SECURE_DOCUMENT",
592
- SECURE_MUSIC = "SECURE_MUSIC",
593
- SECURE_ARCHIVE = "SECURE_ARCHIVE"
594
- }
595
- /** @enumType */
596
- export type FileTypeWithLiterals = FileType | 'UNSPECIFIED' | 'SECURE_PICTURE' | 'SECURE_VIDEO' | 'SECURE_DOCUMENT' | 'SECURE_MUSIC' | 'SECURE_ARCHIVE';
597
- export interface ServiceProperties {
598
- /**
599
- * 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.
600
- * For example, the start time of a class.
601
- */
602
- scheduledDate?: Date | null;
603
- /**
604
- * 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.
605
- * @min 1
606
- * @max 10000
607
- */
608
- numberOfParticipants?: number | null;
609
- }
610
- export interface Policy {
611
- /**
612
- * Policy title - should be translated
613
- * @minLength 1
614
- * @maxLength 29
615
- */
616
- title?: string | null;
617
- /**
618
- * Policy content - should be translated
619
- * @minLength 1
620
- * @maxLength 3000
621
- */
622
- content?: string;
623
- }
624
- export interface TaxableAddress extends TaxableAddressTaxableAddressDataOneOf {
625
- /** taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly. */
626
- addressType?: TaxableAddressTypeWithLiterals;
627
- }
628
- /** @oneof */
629
- export interface TaxableAddressTaxableAddressDataOneOf {
630
- /** taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly. */
631
- addressType?: TaxableAddressTypeWithLiterals;
632
- }
633
- export declare enum TaxableAddressType {
634
- UNKNOWN_TAXABLE_ADDRESS = "UNKNOWN_TAXABLE_ADDRESS",
635
- BUSINESS = "BUSINESS",
636
- BILLING = "BILLING",
637
- SHIPPING = "SHIPPING"
638
- }
639
- /** @enumType */
640
- export type TaxableAddressTypeWithLiterals = TaxableAddressType | 'UNKNOWN_TAXABLE_ADDRESS' | 'BUSINESS' | 'BILLING' | 'SHIPPING';
641
- export interface V1ModifierGroup {
642
- /**
643
- * Modifier group id.
644
- * @minLength 1
645
- * @maxLength 36
646
- */
647
- id?: string;
648
- /** Modifier group name. */
649
- name?: TranslatableString;
650
- /**
651
- * List of modifiers in this group.
652
- * @minSize 1
653
- * @maxSize 25
654
- */
655
- modifiers?: V1ItemModifier[];
656
- }
657
- export interface TranslatableString {
658
- /**
659
- * __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).
660
- *
661
- * Min: 1 character.
662
- * Max: 200 characters.
663
- * @minLength 1
664
- * @maxLength 200
665
- */
666
- original?: string;
667
- /**
668
- * String translated into the buyer's language.
669
- *
670
- * Min: 1 character.
671
- * Max: 400 characters.
672
- * Default: Same as `original`.
673
- * @minLength 1
674
- * @maxLength 400
675
- */
676
- translated?: string | null;
677
- }
678
- export interface V1ItemModifier {
679
- /**
680
- * Modifier ID.
681
- * @minLength 1
682
- * @maxLength 36
683
- */
684
- id?: string;
685
- /**
686
- * The quantity of this modifier.
687
- * @min 1
688
- * @max 100000
689
- */
690
- quantity?: number | null;
691
- /** Primary display label for the modifier. */
692
- label?: TranslatableString;
693
- /** Optional additional details or clarification for the modifier. */
694
- details?: TranslatableString;
695
- /**
696
- * The price of the modifier.
697
- * @decimalValue options { gte:0, lte:1000000000000000, maxScale:3 }
698
- */
699
- price?: string | null;
700
- }
701
- export interface ExtendedFields {
702
- /**
703
- * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
704
- * The value of each key is structured according to the schema defined when the extended fields were configured.
705
- *
706
- * You can only access fields for which you have the appropriate permissions.
707
- *
708
- * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
709
- */
710
- namespaces?: Record<string, Record<string, any>>;
711
- }
712
- export interface CustomContentReference {
713
- /**
714
- * ID of the app providing the content.
715
- *
716
- * You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
717
- * @format GUID
718
- */
719
- appId?: string;
720
- /**
721
- * ID of the component within the app it belongs to.
722
- *
723
- * You can get your component's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
724
- * @format GUID
725
- */
726
- componentId?: string;
727
- }
728
- export interface ExternalReference {
729
- /**
730
- * ID of the app associated with the purchase flow.
731
- * For example, the Wix Pay Links app ID.
732
- * @format GUID
733
- * @immutable
734
- */
735
- appId?: string;
736
- /**
737
- * Reference to an external resource ID. Used to link the purchase flow to a specific entity in an external system.
738
- * For example, a Wix Pay Link ID.
739
- * @minLength 1
740
- * @maxLength 100
741
- * @immutable
742
- */
743
- resourceId?: string | null;
744
- }
745
- /** Triggered when newly checkout created successfully from checkout template */
746
- export interface CheckoutTemplateUsed {
747
- /** checkout template */
748
- checkoutTemplate?: CheckoutTemplate;
749
- /** newly created checkout */
750
- checkout?: Checkout;
751
- }
752
- export interface Checkout {
753
- /**
754
- * Checkout ID.
755
- * @format GUID
756
- * @readonly
757
- */
758
- id?: string | null;
759
- /**
760
- * Line items.
761
- *
762
- * Max: 300 items
763
- * @minSize 1
764
- * @maxSize 300
765
- * @readonly
766
- */
767
- lineItems?: LineItem[];
768
- /** Billing information. */
769
- billingInfo?: AddressWithContact;
770
- /** Shipping information. */
771
- shippingInfo?: ShippingInfo;
772
- /**
773
- * [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
774
- * @maxLength 1000
775
- */
776
- buyerNote?: string | null;
777
- /** Buyer information. */
778
- buyerInfo?: BuyerInfo;
779
- /**
780
- * The currency selected by the buyer during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
781
- * @readonly
782
- * @format CURRENCY
783
- */
784
- conversionCurrency?: string;
785
- /**
786
- * Calculated price summary for the checkout.
787
- * @readonly
788
- */
789
- priceSummary?: PriceSummary;
790
- /**
791
- * Errors when calculating totals.
792
- * @readonly
793
- */
794
- calculationErrors?: CalculationErrors;
795
- /**
796
- * Applied gift card details.
797
- *
798
- * >**Note:** Gift cards are supported through the Wix UI, though the service plugin is not currently available. Learn more about [Wix Gift Cards](https://support.wix.com/en/article/setting-up-wix-gift-cards-9451439).
799
- * @readonly
800
- */
801
- giftCard?: GiftCard;
802
- /**
803
- * Applied discounts.
804
- * @readonly
805
- */
806
- appliedDiscounts?: AppliedDiscount[];
807
- /** Custom fields. */
808
- customFields?: CustomField[];
809
- /**
810
- * Weight measurement unit. Defaults to a site's weight unit.
811
- * @readonly
812
- */
813
- weightUnit?: WeightUnitWithLiterals;
814
- /**
815
- * Tax summary.
816
- * @readonly
817
- */
818
- taxSummary?: TaxSummary;
819
- /**
820
- * The site's default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
821
- * @format CURRENCY
822
- * @readonly
823
- */
824
- currency?: string;
825
- /**
826
- * Sales channel that submitted the order.
827
- * @readonly
828
- */
829
- channelType?: ChannelTypeWithLiterals;
830
- /**
831
- * Site language in which original values are shown.
832
- * @readonly
833
- */
834
- siteLanguage?: string;
835
- /**
836
- * Language for communication with the buyer. Defaults to the site language.
837
- *
838
- * For a site that supports multiple languages, this is the language the buyer selected.
839
- * @readonly
840
- */
841
- buyerLanguage?: string;
842
- /**
843
- * Whether an order was successfully created from this checkout.
844
- *
845
- * For an order to be successful, it must be successfully paid for (unless the total is 0).
846
- * @readonly
847
- */
848
- completed?: boolean;
849
- /**
850
- * Whether tax is included in line item prices.
851
- * @readonly
852
- */
853
- taxIncludedInPrice?: boolean;
854
- /**
855
- * ID of the checkout's initiator.
856
- * @readonly
857
- */
858
- createdBy?: CreatedBy;
859
- /**
860
- * Date and time the checkout was created.
861
- * @readonly
862
- */
863
- createdDate?: Date | null;
864
- /**
865
- * Date and time the checkout was updated.
866
- * @readonly
867
- */
868
- updatedDate?: Date | null;
869
- /**
870
- * Minimal amount to pay in order to place the order.
871
- * @readonly
872
- */
873
- payNow?: PriceSummary;
874
- /**
875
- * Remaining amount for the order to be fully paid.
876
- * @readonly
877
- */
878
- payLater?: PriceSummary;
879
- /** Memberships to apply when creating the order. */
880
- membershipOptions?: MembershipOptions;
881
- /**
882
- * Additional Fees.
883
- * @maxSize 100
884
- */
885
- additionalFees?: AdditionalFee[];
886
- /**
887
- * Cart ID that this checkout was created from. Empty if this checkout wasn't created from a cart.
888
- * @format GUID
889
- */
890
- cartId?: string | null;
891
- /**
892
- * List of validation violations raised by the Validations service plugin ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/service-plugins/validations/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/service-plugins/validations-integration-service-plugin/introduction)).
893
- * @readonly
894
- */
895
- violations?: Violation[];
896
- /**
897
- * Custom field data for the checkout object.
898
- *
899
- * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
900
- */
901
- extendedFields?: ExtendedFields;
902
- /**
903
- * Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
904
- * @format GUID
905
- * @readonly
906
- */
907
- purchaseFlowId?: string | null;
908
- /**
909
- * Additional settings for customization of the checkout process.
910
- *
911
- * > **Notes:**
912
- * > * Custom settings can only be set when creating a checkout.
913
- * > * To access and manage custom checkout page content, 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).
914
- * @immutable
915
- */
916
- customSettings?: CustomSettings;
917
- /**
918
- * Reference IDs for the app and component providing custom checkout page content.
919
- *
920
- * To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
921
- * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
922
- */
923
- customContentReference?: CustomContentReference;
924
- /**
925
- * References to an external app and resource associated with this checkout.
926
- * Used for integration and tracking across different platforms.
927
- * @immutable
928
- */
929
- externalReference?: ExternalReference;
930
- /**
931
- * Payment for subscriptions after free trial period.
932
- * @readonly
933
- */
934
- payAfterFreeTrial?: PriceSummary;
935
- /**
936
- * The business location ID associated with the checkout.
937
- *
938
- * To learn more, see the Locations API.
939
- * @format GUID
940
- */
941
- businessLocationId?: string | null;
942
- /**
943
- * Currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.
944
- * @readonly
945
- * @format CURRENCY
946
- */
947
- paymentCurrency?: string;
948
- }
949
- export interface LineItem {
950
- /**
951
- * Line item ID.
952
- * @format GUID
953
- * @readonly
954
- */
955
- id?: string | null;
956
- /**
957
- * Item quantity.
958
- *
959
- * Min: `"1"`
960
- * Max: `"100000"`
961
- * @min 1
962
- * @max 100000
963
- */
964
- quantity?: number;
965
- /** Catalog and item reference. Includes IDs 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. */
966
- catalogReference?: CatalogReference;
967
- /**
968
- * Item name.
969
- * + Stores - `product.name`
970
- * + Bookings - `service.info.name`
971
- * + Events - `ticket.name`
972
- * @readonly
973
- */
974
- productName?: ProductName;
975
- /**
976
- * URL to the item's page on the site.
977
- * @readonly
978
- */
979
- url?: PageUrlV2;
980
- /**
981
- * Item price **after** catalog-defined discount and line item discounts.
982
- * @readonly
983
- */
984
- price?: MultiCurrencyPrice;
985
- /**
986
- * Total line item price **after** catalog-defined discount and line item discounts.
987
- * @readonly
988
- */
989
- lineItemPrice?: MultiCurrencyPrice;
990
- /**
991
- * Item price **before** catalog-defined discount. Defaults to `price` when not provided.
992
- * @readonly
993
- */
994
- fullPrice?: MultiCurrencyPrice;
995
- /**
996
- * Item price **before** line item discounts and **after** catalog-defined discount. Defaults to `price` when not provided.
997
- * @readonly
998
- */
999
- priceBeforeDiscounts?: MultiCurrencyPrice;
1000
- /**
1001
- * Total price after all discounts and tax.
1002
- * @readonly
1003
- */
1004
- totalPriceAfterTax?: MultiCurrencyPrice;
1005
- /**
1006
- * Total price after discounts, and before tax.
1007
- * @readonly
1008
- */
1009
- totalPriceBeforeTax?: MultiCurrencyPrice;
1010
- /**
1011
- * Tax details for this line item.
1012
- * @readonly
1013
- */
1014
- taxDetails?: ItemTaxFullDetails;
1015
- /**
1016
- * Discount for this line item's entire quantity.
1017
- * @readonly
1018
- */
1019
- discount?: MultiCurrencyPrice;
1020
- /**
1021
- * Line item description lines. Used for display purposes for the cart, checkout and order.
1022
- * @readonly
1023
- */
1024
- descriptionLines?: DescriptionLine[];
1025
- /**
1026
- * Line item image details.
1027
- * @readonly
1028
- */
1029
- media?: CommonImage;
1030
- /**
1031
- * Item availability details.
1032
- * @readonly
1033
- */
1034
- availability?: ItemAvailabilityInfo;
1035
- /**
1036
- * Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability.
1037
- * @readonly
1038
- */
1039
- physicalProperties?: PhysicalProperties;
1040
- /**
1041
- * Item type. Either a preset type or custom.
1042
- * @readonly
1043
- */
1044
- itemType?: ItemType;
1045
- /**
1046
- * Subscription option information.
1047
- * @readonly
1048
- */
1049
- subscriptionOptionInfo?: SubscriptionOptionInfo;
1050
- /**
1051
- * Type of selected payment option for current item.
1052
- *
1053
- * Default: `FULL_PAYMENT_ONLINE`
1054
- * @readonly
1055
- */
1056
- paymentOption?: PaymentOptionTypeWithLiterals;
1057
- /**
1058
- * Service properties. When relevant, this contains information such as date and number of participants.
1059
- * @readonly
1060
- */
1061
- serviceProperties?: ServiceProperties;
1062
- /**
1063
- * In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID.
1064
- * + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID.
1065
- * + In most cases, this field has the same value as `catalogReference.catalogItemId`.
1066
- * + Used in membership validation.
1067
- * @minLength 1
1068
- * @maxLength 36
1069
- * @readonly
1070
- */
1071
- rootCatalogItemId?: string | null;
1072
- /**
1073
- * Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
1074
- * @readonly
1075
- */
1076
- priceDescription?: PriceDescription;
1077
- /**
1078
- * Partial payment to be paid upfront during the checkout. Eligible for catalog items with `lineItem.paymentOption` type `DEPOSIT_ONLINE` only.
1079
- * @readonly
1080
- */
1081
- depositAmount?: MultiCurrencyPrice;
1082
- /**
1083
- * Delivery profile ID.
1084
- * @format GUID
1085
- * @readonly
1086
- */
1087
- deliveryProfileId?: string | null;
1088
- /**
1089
- * Whether the line item is a custom line item. Custom line items don't trigger the Catalog service plugin.
1090
- * @readonly
1091
- */
1092
- customLineItem?: boolean;
1093
- /**
1094
- * Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
1095
- * @minLength 1
1096
- * @maxLength 2500
1097
- * @readonly
1098
- */
1099
- consentRequiredPaymentPolicy?: string | null;
1100
- /**
1101
- * Overriding values for catalog item properties.
1102
- *
1103
- * To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions".
1104
- * Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
1105
- */
1106
- catalogOverrideFields?: CatalogOverrideFields;
1107
- /**
1108
- * Whether the price is not yet defined, and will be updated after the order is created.
1109
- * @readonly
1110
- */
1111
- priceUndetermined?: boolean;
1112
- /**
1113
- * Whether the line item quantity is fixed and cannot be changed.
1114
- * @readonly
1115
- */
1116
- fixedQuantity?: boolean;
1117
- /**
1118
- * Whether to save the payment method on the order.
1119
- *
1120
- * Default: `false`
1121
- * @readonly
1122
- */
1123
- savePaymentMethod?: boolean;
1124
- /** Address to use for tax calculation purposes. */
1125
- taxableAddress?: TaxableAddress;
1126
- /**
1127
- * Policies to be displayed to the customer on the checkout page.
1128
- * @readonly
1129
- * @maxSize 5
1130
- */
1131
- policies?: Policy[];
1132
- /**
1133
- * Whether the item can only be purchased by site members.
1134
- *
1135
- * Default: `false`
1136
- * @readonly
1137
- */
1138
- membersOnly?: boolean;
1139
- /**
1140
- * Modifier groups that were added to the item.
1141
- * @readonly
1142
- * @maxSize 25
1143
- */
1144
- modifierGroups?: ModifierGroup[];
1145
- /**
1146
- * Total price of all item modifiers. Included in the item price.
1147
- * @readonly
1148
- */
1149
- modifiersTotalPrice?: MultiCurrencyPrice;
1150
- }
1151
- export interface MultiCurrencyPrice {
1152
- /**
1153
- * Amount.
1154
- * @decimalValue options { gte:0, lte:1000000000000000 }
1155
- */
1156
- amount?: string;
1157
- /**
1158
- * Converted amount.
1159
- * @readonly
1160
- * @decimalValue options { gte:0, lte:1000000000000000 }
1161
- */
1162
- convertedAmount?: string;
1163
- /**
1164
- * Amount formatted with currency symbol.
1165
- * @readonly
1166
- */
1167
- formattedAmount?: string;
1168
- /**
1169
- * Converted amount formatted with currency symbol.
1170
- * @readonly
1171
- */
1172
- formattedConvertedAmount?: string;
1173
- }
1174
- export interface ItemTaxFullDetails {
1175
- /** Amount for which tax is calculated. */
1176
- taxableAmount?: MultiCurrencyPrice;
1177
- /**
1178
- * Tax rate %, as a decimal point between 0 and 1.
1179
- * @decimalValue options { gte:0, lte:1, maxScale:6 }
1180
- */
1181
- taxRate?: string;
1182
- /** Calculated tax, based on `taxable_amount` and `tax_rate`. */
1183
- totalTax?: MultiCurrencyPrice;
1184
- /**
1185
- * If breakdown exists, the sum of rates in the breakdown must equal `tax_rate`. Deprecated - use 'tax_breakdown' instead.
1186
- * @readonly
1187
- * @deprecated
1188
- */
1189
- rateBreakdown?: TaxRateBreakdown[];
1190
- }
1191
- export interface TaxRateBreakdown {
1192
- /**
1193
- * Name of tax against which the calculation was performed.
1194
- * @maxLength 100
1195
- */
1196
- name?: string;
1197
- /**
1198
- * Rate at which this tax detail was calculated.
1199
- * @decimalValue options { gte:0, lte:1, maxScale:6 }
1200
- */
1201
- rate?: string;
1202
- /** Amount of tax for this tax detail. */
1203
- tax?: MultiCurrencyPrice;
1204
- }
1205
- /**
1206
- * TaxBreakdown represents tax information for a line item.
1207
- * It holds the tax amount and the tax rate for each tax authority that apply on the line item.
1208
- */
1209
- export interface TaxBreakdown {
1210
- /**
1211
- * The name of the jurisdiction to which this tax detail applies. For example, "New York" or "Quebec".
1212
- * @maxLength 200
1213
- */
1214
- jurisdiction?: string | null;
1215
- /** The amount of this line item price that was considered nontaxable. (Decimal value) */
1216
- nonTaxableAmount?: MultiCurrencyPrice;
1217
- /**
1218
- * The rate at which this tax detail was calculated, e.g 0.1000 signifies 10% tax and 2.0000 signifies 200% tax. (Decimal value)
1219
- * @decimalValue options { gte:0, maxScale:6 }
1220
- */
1221
- rate?: string | null;
1222
- /** The amount of tax estimated for this line item. (Decimal value) */
1223
- taxAmount?: MultiCurrencyPrice;
1224
- /** The taxable amount of this line item. */
1225
- taxableAmount?: MultiCurrencyPrice;
1226
- /**
1227
- * The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc.
1228
- * @maxLength 200
1229
- */
1230
- taxType?: string | null;
1231
- /**
1232
- * The name of the tax against which this tax amount was calculated. For example, "NY State Sales Tax", "Quebec GST", etc.
1233
- * This name should be explicit enough to allow the merchant to understand what tax was calculated.
1234
- * @maxLength 200
1235
- */
1236
- taxName?: string | null;
1237
- /** The type of the jurisdiction in which this tax detail applies. */
1238
- jurisdictionType?: JurisdictionTypeWithLiterals;
1239
- }
1240
- /** JurisdictionType represents the type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */
1241
- export declare enum JurisdictionType {
1242
- UNDEFINED = "UNDEFINED",
1243
- COUNTRY = "COUNTRY",
1244
- STATE = "STATE",
1245
- COUNTY = "COUNTY",
1246
- CITY = "CITY",
1247
- SPECIAL = "SPECIAL"
1248
- }
1249
- /** @enumType */
1250
- export type JurisdictionTypeWithLiterals = JurisdictionType | 'UNDEFINED' | 'COUNTRY' | 'STATE' | 'COUNTY' | 'CITY' | 'SPECIAL';
1251
- export interface CommonImage {
1252
- /** WixMedia image ID. */
1253
- id?: string;
1254
- /** Image URL. */
1255
- url?: string;
1256
- /**
1257
- * Original image height.
1258
- * @readonly
1259
- */
1260
- height?: number;
1261
- /**
1262
- * Original image width.
1263
- * @readonly
1264
- */
1265
- width?: number;
1266
- /** Image alt text. */
1267
- altText?: string | null;
1268
- /**
1269
- * Image filename.
1270
- * @readonly
1271
- */
1272
- filename?: string | null;
1273
- }
1274
- export interface FocalPoint {
1275
- /** X-coordinate of the focal point. */
1276
- x?: number;
1277
- /** Y-coordinate of the focal point. */
1278
- y?: number;
1279
- /** crop by height */
1280
- height?: number | null;
1281
- /** crop by width */
1282
- width?: number | null;
1283
- }
1284
- export interface ItemAvailabilityInfo {
1285
- /** Item availability status. */
1286
- status?: ItemAvailabilityStatusWithLiterals;
1287
- /** Quantity available. */
1288
- quantityAvailable?: number | null;
1289
- }
1290
- export declare enum ItemAvailabilityStatus {
1291
- AVAILABLE = "AVAILABLE",
1292
- /** Item does not exist. */
1293
- NOT_FOUND = "NOT_FOUND",
1294
- /** Item is not in stock. */
1295
- NOT_AVAILABLE = "NOT_AVAILABLE",
1296
- /** Available quantity is less than requested. */
1297
- PARTIALLY_AVAILABLE = "PARTIALLY_AVAILABLE"
1298
- }
1299
- /** @enumType */
1300
- export type ItemAvailabilityStatusWithLiterals = ItemAvailabilityStatus | 'AVAILABLE' | 'NOT_FOUND' | 'NOT_AVAILABLE' | 'PARTIALLY_AVAILABLE';
1301
- export interface Scope {
1302
- /** Scope namespace (Wix Stores, Wix Bookings, Wix Events, Wix Pricing Plans) */
1303
- namespace?: string;
1304
- /** Coupon scope's applied group (e.g., event or ticket in Wix Events) */
1305
- group?: Group;
1306
- }
1307
- export interface Group {
1308
- /** Coupon scope's group (e.g., product or collection in Wix Stores). See [valid scope values](https://dev.wix.com/api/rest/coupons/coupons/valid-scope-values). */
1309
- name?: string;
1310
- /** Item ID (when the coupon scope is limited to just one item). */
1311
- entityId?: string | null;
1312
- }
1313
- export interface ModifierGroup {
1314
- /**
1315
- * Modifier group id.
1316
- * @minLength 1
1317
- * @maxLength 36
1318
- */
1319
- id?: string;
1320
- /** Modifier group name. */
1321
- name?: TranslatableString;
1322
- /**
1323
- * List of modifiers in this group.
1324
- * @minSize 1
1325
- * @maxSize 25
1326
- */
1327
- modifiers?: ItemModifier[];
1328
- }
1329
- export interface ItemModifier {
1330
- /**
1331
- * Modifier ID.
1332
- * @minLength 1
1333
- * @maxLength 36
1334
- */
1335
- id?: string;
1336
- /**
1337
- * The quantity of this modifier.
1338
- * @min 1
1339
- * @max 100000
1340
- */
1341
- quantity?: number | null;
1342
- /** Primary display label for the modifier. */
1343
- label?: TranslatableString;
1344
- /** Optional additional details or clarification for the modifier. */
1345
- details?: TranslatableString;
1346
- /** The price of the modifier. */
1347
- price?: MultiCurrencyPrice;
1348
- }
1349
- /** Billing Info and shipping details */
1350
- export interface AddressWithContact {
1351
- /** Address. */
1352
- address?: Address;
1353
- /** Contact details. */
1354
- contactDetails?: FullAddressContactDetails;
1355
- }
1356
- /** Physical address */
1357
- export interface Address {
1358
- /**
1359
- * Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
1360
- * @format COUNTRY
1361
- */
1362
- country?: string | null;
1363
- /**
1364
- * Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
1365
- * @maxLength 50
1366
- */
1367
- subdivision?: string | null;
1368
- /**
1369
- * City name.
1370
- * @maxLength 50
1371
- */
1372
- city?: string | null;
1373
- /**
1374
- * Postal or zip code.
1375
- * @maxLength 50
1376
- */
1377
- postalCode?: string | null;
1378
- /** Street address. */
1379
- streetAddress?: StreetAddress;
1380
- /**
1381
- * Main address line (usually street name and number).
1382
- * @maxLength 150
1383
- */
1384
- addressLine?: string | null;
1385
- /**
1386
- * Free text providing more detailed address info. Usually contains apt, suite, floor.
1387
- * @maxLength 100
1388
- */
1389
- addressLine2?: string | null;
1390
- /**
1391
- * Country's full name.
1392
- * @readonly
1393
- */
1394
- countryFullname?: string | null;
1395
- /**
1396
- * Subdivision full-name.
1397
- * @readonly
1398
- */
1399
- subdivisionFullname?: string | null;
1400
- }
1401
- export interface StreetAddress {
1402
- /** Street number. */
1403
- number?: string;
1404
- /** Street name. */
1405
- name?: string;
1406
- }
1407
- export interface AddressLocation {
1408
- /** Address latitude. */
1409
- latitude?: number | null;
1410
- /** Address longitude. */
1411
- longitude?: number | null;
1412
- }
1413
- /** Full contact details for an address */
1414
- export interface FullAddressContactDetails {
1415
- /**
1416
- * First name.
1417
- * @maxLength 100
1418
- */
1419
- firstName?: string | null;
1420
- /**
1421
- * Last name.
1422
- * @maxLength 100
1423
- */
1424
- lastName?: string | null;
1425
- /**
1426
- * Phone number.
1427
- * @format PHONE
1428
- */
1429
- phone?: string | null;
1430
- /**
1431
- * Company name.
1432
- * @maxLength 1000
1433
- */
1434
- company?: string | null;
1435
- /** Tax information (for Brazil only). If ID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed. */
1436
- vatId?: VatId;
1437
- }
1438
- export interface VatId {
1439
- /** Customer's tax ID. */
1440
- id?: string;
1441
- /**
1442
- * Tax type.
1443
- *
1444
- * Supported values:
1445
- * + `CPF`: for individual tax payers
1446
- * + `CNPJ`: for corporations
1447
- */
1448
- type?: VatTypeWithLiterals;
1449
- }
1450
- /** tax info types */
1451
- export declare enum VatType {
1452
- UNSPECIFIED = "UNSPECIFIED",
1453
- /** CPF - for individual tax payers. */
1454
- CPF = "CPF",
1455
- /** CNPJ - for corporations */
1456
- CNPJ = "CNPJ"
1457
- }
1458
- /** @enumType */
1459
- export type VatTypeWithLiterals = VatType | 'UNSPECIFIED' | 'CPF' | 'CNPJ';
1460
- export interface ShippingInfo {
1461
- /** Shipping address and contact details. */
1462
- shippingDestination?: AddressWithContact;
1463
- /** Selected option out of the options allowed for the `region`. */
1464
- selectedCarrierServiceOption?: SelectedCarrierServiceOption;
1465
- /**
1466
- * Shipping region. Based on the address provided.
1467
- * @readonly
1468
- */
1469
- region?: ShippingRegion;
1470
- /**
1471
- * All carrier options for this shipping rule.
1472
- * @readonly
1473
- */
1474
- carrierServiceOptions?: CarrierServiceOption[];
1475
- }
1476
- export interface SelectedCarrierServiceOption {
1477
- /**
1478
- * Unique identifier of selected option. For example, "usps_std_overnight".
1479
- * @maxLength 100
1480
- */
1481
- code?: string;
1482
- /**
1483
- * Title of the option, such as USPS Standard Overnight Delivery (in the requested locale).
1484
- * For example, "Standard" or "First-Class Package International".
1485
- * @maxLength 250
1486
- * @readonly
1487
- */
1488
- title?: string;
1489
- /**
1490
- * Delivery logistics.
1491
- * @readonly
1492
- */
1493
- logistics?: DeliveryLogistics;
1494
- /**
1495
- * Shipping costs.
1496
- * @readonly
1497
- */
1498
- cost?: SelectedCarrierServiceOptionPrices;
1499
- /**
1500
- * Were we able to find the requested shipping option, or otherwise we fallback to the default one (the first)
1501
- * @readonly
1502
- */
1503
- requestedShippingOption?: boolean;
1504
- /**
1505
- * Other charges
1506
- * @deprecated Other charges
1507
- * @replacedBy additional_fees
1508
- * @targetRemovalDate 2025-10-01
1509
- */
1510
- otherCharges?: SelectedCarrierServiceOptionOtherCharge[];
1511
- /**
1512
- * This carrier's unique ID
1513
- * @format GUID
1514
- */
1515
- carrierId?: string | null;
1516
- /**
1517
- * Delivery solution allocations to different delivery carriers and delivery regions
1518
- * @maxSize 300
1519
- */
1520
- deliveryAllocations?: DeliveryAllocation[];
1521
- /** If the delivery solution is a partial and doesn't apply to all items. */
1522
- partial?: boolean | null;
1523
- }
1524
- export interface DeliveryLogistics {
1525
- /**
1526
- * Expected delivery time, in free text. For example, "3-5 business days".
1527
- * @maxLength 500
1528
- */
1529
- deliveryTime?: string | null;
1530
- /**
1531
- * Instructions for caller, e.g for pickup: "Please deliver during opening hours, and please don't park in disabled parking spot".
1532
- * @maxLength 1000
1533
- */
1534
- instructions?: string | null;
1535
- /** Pickup details. */
1536
- pickupDetails?: PickupDetails;
1537
- }
1538
- export interface PickupDetails {
1539
- /** Pickup address. */
1540
- address?: Address;
1541
- /**
1542
- * Whether the pickup address is that of a business - this may effect tax calculation.
1543
- * @deprecated
1544
- */
1545
- businessLocation?: boolean;
1546
- /** Pickup method */
1547
- pickupMethod?: PickupMethodWithLiterals;
1548
- }
1549
- export declare enum PickupMethod {
1550
- UNKNOWN_METHOD = "UNKNOWN_METHOD",
1551
- STORE_PICKUP = "STORE_PICKUP",
1552
- PICKUP_POINT = "PICKUP_POINT"
1553
- }
1554
- /** @enumType */
1555
- export type PickupMethodWithLiterals = PickupMethod | 'UNKNOWN_METHOD' | 'STORE_PICKUP' | 'PICKUP_POINT';
1556
- export interface DeliveryTimeSlot {
1557
- /** starting time of the delivery time slot */
1558
- from?: Date | null;
1559
- /** ending time of the delivery time slot */
1560
- to?: Date | null;
1561
- }
1562
- export interface SelectedCarrierServiceOptionPrices {
1563
- /** Total shipping price, after discount and after tax. */
1564
- totalPriceAfterTax?: MultiCurrencyPrice;
1565
- /** Total price of shipping after discounts (when relevant), and before tax. */
1566
- totalPriceBeforeTax?: MultiCurrencyPrice;
1567
- /** Tax details. */
1568
- taxDetails?: ItemTaxFullDetails;
1569
- /** Shipping discount before tax. */
1570
- totalDiscount?: MultiCurrencyPrice;
1571
- /** Shipping price before discount and before tax. */
1572
- price?: MultiCurrencyPrice;
1573
- }
1574
- export interface SelectedCarrierServiceOptionOtherCharge {
1575
- /** Type of additional cost. */
1576
- type?: ChargeTypeWithLiterals;
1577
- /**
1578
- * Details of the charge, such as 'Full Coverage Insurance of up to 80% of value of shipment'.
1579
- * @maxLength 200
1580
- */
1581
- details?: string | null;
1582
- /** Price of added charge. */
1583
- cost?: SelectedCarrierServiceOptionPrices;
1584
- }
1585
- export declare enum ChargeType {
1586
- HANDLING_FEE = "HANDLING_FEE",
1587
- INSURANCE = "INSURANCE"
1588
- }
1589
- /** @enumType */
1590
- export type ChargeTypeWithLiterals = ChargeType | 'HANDLING_FEE' | 'INSURANCE';
1591
- export interface DeliveryAllocation {
1592
- /** The delivery option's carrier details, could be multiple if the delivery option is a combination of multiple carriers */
1593
- deliveryCarrier?: Carrier;
1594
- /** The delivery region that are relevant for this delivery solution. */
1595
- deliveryRegion?: Region;
1596
- /** Populated if the delivery solution is a partially supplied by this carrier. */
1597
- applicableLineItems?: ApplicableLineItems;
1598
- }
1599
- export interface Carrier {
1600
- /**
1601
- * The carrier app id
1602
- * @format GUID
1603
- */
1604
- appId?: string | null;
1605
- /**
1606
- * Unique code that acts as an ID for a shipping rate. For example, `"usps_std_overnight"`.
1607
- * @maxLength 250
1608
- */
1609
- code?: string;
1610
- }
1611
- export interface Region {
1612
- /**
1613
- * The delivery region id.
1614
- * @format GUID
1615
- */
1616
- id?: string | null;
1617
- /**
1618
- * The delivery region name.
1619
- * @maxLength 100
1620
- */
1621
- name?: string | null;
1622
- }
1623
- export interface ApplicableLineItems {
1624
- /**
1625
- * Line items that the delivery solution is for.
1626
- * @maxSize 300
1627
- * @minLength 1
1628
- * @maxLength 100
1629
- */
1630
- lineItemIds?: string[];
1631
- }
1632
- export interface ShippingRegion {
1633
- /**
1634
- * Shipping region ID.
1635
- * @format GUID
1636
- * @readonly
1637
- */
1638
- id?: string;
1639
- /**
1640
- * Shipping region name.
1641
- * @maxLength 100
1642
- */
1643
- name?: string;
1644
- }
1645
- export interface CarrierServiceOption {
1646
- /**
1647
- * Carrier ID.
1648
- * @format GUID
1649
- */
1650
- carrierId?: string;
1651
- /** Shipping options offered by this carrier for this request. */
1652
- shippingOptions?: ShippingOption[];
1653
- }
1654
- export interface ShippingOption {
1655
- /**
1656
- * Unique code of provided shipping option like "usps_std_overnight".
1657
- * For legacy calculators this would be the UUID of the option.
1658
- * @maxLength 100
1659
- */
1660
- code?: string;
1661
- /**
1662
- * Title of the option, such as USPS Standard Overnight Delivery (in the requested locale).
1663
- * For example, "Standard" or "First-Class Package International".
1664
- * @maxLength 250
1665
- */
1666
- title?: string;
1667
- /** Delivery logistics. */
1668
- logistics?: DeliveryLogistics;
1669
- /** Sipping price information. */
1670
- cost?: ShippingPrice;
1671
- /**
1672
- * Delivery solution allocations to different delivery carriers and delivery regions
1673
- * @maxSize 300
1674
- */
1675
- deliveryAllocations?: DeliveryAllocation[];
1676
- /** If the delivery solution is a partial and doesn't apply to all items. */
1677
- partial?: boolean | null;
1678
- }
1679
- export interface ShippingPrice {
1680
- /** Shipping price. */
1681
- price?: MultiCurrencyPrice;
1682
- /** Other costs such as insurance, handling & packaging for fragile items, etc. */
1683
- otherCharges?: OtherCharge[];
1684
- }
1685
- export interface OtherCharge {
1686
- /** Type of additional cost. */
1687
- type?: ChargeTypeWithLiterals;
1688
- /** Price of added cost. */
1689
- price?: MultiCurrencyPrice;
1690
- /**
1691
- * Description of the additional charge. For example, `"Handling fee of $5 applied for gift wrapping"`.
1692
- * @maxLength 250
1693
- */
1694
- details?: string | null;
1695
- }
1696
- export interface BuyerInfo extends BuyerInfoIdOneOf {
1697
- /**
1698
- * Visitor ID (if site visitor is **not** a member).
1699
- * @format GUID
1700
- * @readonly
1701
- */
1702
- visitorId?: string;
1703
- /**
1704
- * Member ID (if site visitor is a site member).
1705
- * @format GUID
1706
- * @readonly
1707
- */
1708
- memberId?: string;
1709
- /**
1710
- * Contact ID. Auto-created if one does not yet exist. For more information, see the Contacts API.
1711
- * @format GUID
1712
- * @readonly
1713
- */
1714
- contactId?: string | null;
1715
- /**
1716
- * Buyer email address.
1717
- * @format EMAIL
1718
- */
1719
- email?: string | null;
1720
- }
1721
- /** @oneof */
1722
- export interface BuyerInfoIdOneOf {
1723
- /**
1724
- * Visitor ID (if site visitor is **not** a member).
1725
- * @format GUID
1726
- * @readonly
1727
- */
1728
- visitorId?: string;
1729
- /**
1730
- * Member ID (if site visitor is a site member).
1731
- * @format GUID
1732
- * @readonly
1733
- */
1734
- memberId?: string;
1735
- }
1736
- export interface PriceSummary {
1737
- /** Subtotal of all line items, before discounts and before tax. */
1738
- subtotal?: MultiCurrencyPrice;
1739
- /** Total shipping price, before discounts and before tax. */
1740
- shipping?: MultiCurrencyPrice;
1741
- /** Total tax. */
1742
- tax?: MultiCurrencyPrice;
1743
- /** Total calculated discount value. */
1744
- discount?: MultiCurrencyPrice;
1745
- /** Total price after discounts, gift cards, and tax. */
1746
- total?: MultiCurrencyPrice;
1747
- /** Total additional fees price before tax. */
1748
- additionalFees?: MultiCurrencyPrice;
1749
- }
1750
- export interface CalculationErrors extends CalculationErrorsShippingCalculationErrorOneOf {
1751
- /** General shipping calculation error. */
1752
- generalShippingCalculationError?: Details;
1753
- /** Carrier errors. */
1754
- carrierErrors?: CarrierErrors;
1755
- /** Tax calculation error. */
1756
- taxCalculationError?: Details;
1757
- /** Coupon calculation error. */
1758
- couponCalculationError?: Details;
1759
- /** Gift card calculation error. */
1760
- giftCardCalculationError?: Details;
1761
- /** Order validation errors. */
1762
- orderValidationErrors?: ApplicationError[];
1763
- /**
1764
- * Membership payment methods calculation errors
1765
- * For example, will indicate that a line item that must be paid with membership payment doesn't have one or selected memberships are invalid
1766
- */
1767
- membershipError?: Details;
1768
- /** Discount Rule calculation error. */
1769
- discountsCalculationError?: Details;
1770
- }
1771
- /** @oneof */
1772
- export interface CalculationErrorsShippingCalculationErrorOneOf {
1773
- /** General shipping calculation error. */
1774
- generalShippingCalculationError?: Details;
1775
- /** Carrier errors. */
1776
- carrierErrors?: CarrierErrors;
1777
- }
1778
- export interface Details extends DetailsKindOneOf {
1779
- applicationError?: ApplicationError;
1780
- validationError?: ValidationError;
1781
- systemError?: SystemError;
1782
- /**
1783
- * deprecated in API's - to enable migration from rendering arbitrary tracing to rest response
1784
- * @deprecated
1785
- */
1786
- tracing?: Record<string, string>;
1787
- }
1788
- /** @oneof */
1789
- export interface DetailsKindOneOf {
1790
- applicationError?: ApplicationError;
1791
- validationError?: ValidationError;
1792
- systemError?: SystemError;
1793
- }
1794
- export interface ApplicationError {
1795
- /** Error code. */
1796
- code?: string;
1797
- /** Description of the error. */
1798
- description?: string;
1799
- /** Data related to the error. */
1800
- data?: Record<string, any> | null;
1801
- }
1802
- /**
1803
- * example result:
1804
- * {
1805
- * "fieldViolations": [
1806
- * {
1807
- * "field": "fieldA",
1808
- * "description": "invalid music note. supported notes: [do,re,mi,fa,sol,la,ti]",
1809
- * "violatedRule": "OTHER",
1810
- * "ruleName": "INVALID_NOTE",
1811
- * "data": {
1812
- * "value": "FI"
1813
- * }
1814
- * },
1815
- * {
1816
- * "field": "fieldB",
1817
- * "description": "field value out of range. supported range: [0-20]",
1818
- * "violatedRule": "MAX",
1819
- * "data": {
1820
- * "threshold": 20
1821
- * }
1822
- * },
1823
- * {
1824
- * "field": "fieldC",
1825
- * "description": "invalid phone number. provide a valid phone number of size: [7-12], supported characters: [0-9, +, -, (, )]",
1826
- * "violatedRule": "FORMAT",
1827
- * "data": {
1828
- * "type": "PHONE"
1829
- * }
1830
- * }
1831
- * ]
1832
- * }
1833
- */
1834
- export interface ValidationError {
1835
- fieldViolations?: FieldViolation[];
1836
- }
1837
- export declare enum RuleType {
1838
- VALIDATION = "VALIDATION",
1839
- OTHER = "OTHER",
1840
- MAX = "MAX",
1841
- MIN = "MIN",
1842
- MAX_LENGTH = "MAX_LENGTH",
1843
- MIN_LENGTH = "MIN_LENGTH",
1844
- MAX_SIZE = "MAX_SIZE",
1845
- MIN_SIZE = "MIN_SIZE",
1846
- FORMAT = "FORMAT",
1847
- DECIMAL_LTE = "DECIMAL_LTE",
1848
- DECIMAL_GTE = "DECIMAL_GTE",
1849
- DECIMAL_LT = "DECIMAL_LT",
1850
- DECIMAL_GT = "DECIMAL_GT",
1851
- DECIMAL_MAX_SCALE = "DECIMAL_MAX_SCALE",
1852
- INVALID_ENUM_VALUE = "INVALID_ENUM_VALUE",
1853
- REQUIRED_FIELD = "REQUIRED_FIELD",
1854
- FIELD_NOT_ALLOWED = "FIELD_NOT_ALLOWED",
1855
- ONE_OF_ALIGNMENT = "ONE_OF_ALIGNMENT",
1856
- EXACT_LENGTH = "EXACT_LENGTH",
1857
- EXACT_SIZE = "EXACT_SIZE",
1858
- REQUIRED_ONE_OF_FIELD = "REQUIRED_ONE_OF_FIELD"
1859
- }
1860
- /** @enumType */
1861
- export type RuleTypeWithLiterals = RuleType | 'VALIDATION' | 'OTHER' | 'MAX' | 'MIN' | 'MAX_LENGTH' | 'MIN_LENGTH' | 'MAX_SIZE' | 'MIN_SIZE' | 'FORMAT' | 'DECIMAL_LTE' | 'DECIMAL_GTE' | 'DECIMAL_LT' | 'DECIMAL_GT' | 'DECIMAL_MAX_SCALE' | 'INVALID_ENUM_VALUE' | 'REQUIRED_FIELD' | 'FIELD_NOT_ALLOWED' | 'ONE_OF_ALIGNMENT' | 'EXACT_LENGTH' | 'EXACT_SIZE' | 'REQUIRED_ONE_OF_FIELD';
1862
- export interface FieldViolation {
1863
- field?: string;
1864
- description?: string;
1865
- violatedRule?: RuleTypeWithLiterals;
1866
- /** applicable when violated_rule=OTHER */
1867
- ruleName?: string | null;
1868
- data?: Record<string, any> | null;
1869
- }
1870
- export interface SystemError {
1871
- /** Error code. */
1872
- errorCode?: string | null;
1873
- }
1874
- export interface CarrierErrors {
1875
- /** Carrier errors. */
1876
- errors?: CarrierError[];
1877
- }
1878
- export interface CarrierError {
1879
- /** Carrier ID. */
1880
- carrierId?: string;
1881
- /** Error details. */
1882
- error?: Details;
1883
- }
1884
- export interface GiftCard {
1885
- /**
1886
- * Gift Card ID.
1887
- * @deprecated
1888
- */
1889
- id?: string;
1890
- /** Gift card obfuscated code. */
1891
- obfuscatedCode?: string;
1892
- /** Gift card value. */
1893
- amount?: MultiCurrencyPrice;
1894
- /**
1895
- * App ID of the gift card provider.
1896
- * @format GUID
1897
- */
1898
- appId?: string;
1899
- /**
1900
- * External ID in the gift card provider's system.
1901
- * Used for integration and tracking across different platforms.
1902
- * @minLength 1
1903
- * @maxLength 50
1904
- */
1905
- externalId?: string | null;
1906
- }
1907
- export interface AppliedDiscount extends AppliedDiscountDiscountSourceOneOf {
1908
- /** Coupon details. */
1909
- coupon?: Coupon;
1910
- /** Merchant discount. */
1911
- merchantDiscount?: MerchantDiscount;
1912
- /** Discount rule */
1913
- discountRule?: DiscountRule;
1914
- /** Discount type. */
1915
- discountType?: DiscountTypeWithLiterals;
1916
- /**
1917
- * IDs of line items the discount applies to.
1918
- * @format GUID
1919
- * @deprecated IDs of line items the discount applies to.
1920
- * @replacedBy line_items_discounts
1921
- * @targetRemovalDate 2024-06-01
1922
- */
1923
- lineItemIds?: string[];
1924
- }
1925
- /** @oneof */
1926
- export interface AppliedDiscountDiscountSourceOneOf {
1927
- /** Coupon details. */
1928
- coupon?: Coupon;
1929
- /** Merchant discount. */
1930
- merchantDiscount?: MerchantDiscount;
1931
- /** Discount rule */
1932
- discountRule?: DiscountRule;
1933
- }
1934
- export declare enum DiscountType {
1935
- GLOBAL = "GLOBAL",
1936
- SPECIFIC_ITEMS = "SPECIFIC_ITEMS",
1937
- SHIPPING = "SHIPPING"
1938
- }
1939
- /** @enumType */
1940
- export type DiscountTypeWithLiterals = DiscountType | 'GLOBAL' | 'SPECIFIC_ITEMS' | 'SHIPPING';
1941
- /** Coupon */
1942
- export interface Coupon {
1943
- /** Coupon ID. */
1944
- id?: string;
1945
- /** Coupon code. */
1946
- code?: string;
1947
- /** Coupon value. */
1948
- amount?: MultiCurrencyPrice;
1949
- /** Coupon name. */
1950
- name?: string;
1951
- }
1952
- export interface MerchantDiscount {
1953
- /** Discount value. */
1954
- amount?: MultiCurrencyPrice;
1955
- /**
1956
- * Discount Percentage. Will be calculated from items price before other discounts.
1957
- * @min 1
1958
- * @max 100
1959
- */
1960
- percentage?: number | null;
1961
- }
1962
- export interface DiscountRule {
1963
- /**
1964
- * Discount rule ID
1965
- * @format GUID
1966
- */
1967
- id?: string;
1968
- /** Discount rule name */
1969
- name?: DiscountRuleName;
1970
- /** Discount value. */
1971
- amount?: MultiCurrencyPrice;
1972
- }
1973
- export interface DiscountRuleName {
1974
- /**
1975
- * Original discount rule name (in site's default language).
1976
- * @minLength 1
1977
- * @maxLength 256
1978
- */
1979
- original?: string;
1980
- /**
1981
- * Translated discount rule name according to buyer language. Defaults to `original` when not provided.
1982
- * @minLength 1
1983
- * @maxLength 500
1984
- */
1985
- translated?: string | null;
1986
- }
1987
- export interface LineItemDiscount {
1988
- /**
1989
- * ID of line item the discount applies to.
1990
- * @format GUID
1991
- */
1992
- id?: string;
1993
- /** Discount value. */
1994
- totalDiscountAmount?: MultiCurrencyPrice;
1995
- }
1996
- export interface CustomField {
1997
- /** Custom field value. */
1998
- value?: any;
1999
- /**
2000
- * Custom field title.
2001
- * @minLength 1
2002
- * @maxLength 500
2003
- */
2004
- title?: string;
2005
- /**
2006
- * Translated custom field title.
2007
- * @minLength 1
2008
- * @maxLength 500
2009
- */
2010
- translatedTitle?: string | null;
2011
- }
2012
- export declare enum WeightUnit {
2013
- /** Weight unit can't be classified due to an error. */
2014
- UNSPECIFIED_WEIGHT_UNIT = "UNSPECIFIED_WEIGHT_UNIT",
2015
- /** Kilograms. */
2016
- KG = "KG",
2017
- /** Pounds. */
2018
- LB = "LB"
2019
- }
2020
- /** @enumType */
2021
- export type WeightUnitWithLiterals = WeightUnit | 'UNSPECIFIED_WEIGHT_UNIT' | 'KG' | 'LB';
2022
- export interface TaxSummary {
2023
- /**
2024
- * Amount for which tax is calculated, added from line items.
2025
- * @readonly
2026
- */
2027
- taxableAmount?: MultiCurrencyPrice;
2028
- /**
2029
- * Calculated tax, added from line items.
2030
- * @readonly
2031
- */
2032
- totalTax?: MultiCurrencyPrice;
2033
- /**
2034
- * Tax calculator that was active when the order was created.
2035
- * @deprecated
2036
- */
2037
- calculationDetails?: TaxCalculationDetails;
2038
- }
2039
- export interface TaxCalculationDetails extends TaxCalculationDetailsCalculationDetailsOneOf {
2040
- /** Reason the manual calculation was used. */
2041
- manualRateReason?: ManualCalculationReasonWithLiterals;
2042
- /** Details of the fallback rate calculation. */
2043
- autoTaxFallbackDetails?: AutoTaxFallbackCalculationDetails;
2044
- /** Rate calculation type. */
2045
- rateType?: RateTypeWithLiterals;
2046
- }
2047
- /** @oneof */
2048
- export interface TaxCalculationDetailsCalculationDetailsOneOf {
2049
- /** Reason the manual calculation was used. */
2050
- manualRateReason?: ManualCalculationReasonWithLiterals;
2051
- /** Details of the fallback rate calculation. */
2052
- autoTaxFallbackDetails?: AutoTaxFallbackCalculationDetails;
2053
- }
2054
- export declare enum RateType {
2055
- /** no tax being collected for this request due to location of purchase */
2056
- NO_TAX_COLLECTED = "NO_TAX_COLLECTED",
2057
- /** manual rate used for calculation */
2058
- MANUAL_RATE = "MANUAL_RATE",
2059
- /** autotax rate used for calculation */
2060
- AUTO_RATE = "AUTO_RATE",
2061
- /** fallback rate used for calculation */
2062
- FALLBACK_RATE = "FALLBACK_RATE"
2063
- }
2064
- /** @enumType */
2065
- export type RateTypeWithLiterals = RateType | 'NO_TAX_COLLECTED' | 'MANUAL_RATE' | 'AUTO_RATE' | 'FALLBACK_RATE';
2066
- export declare enum ManualCalculationReason {
2067
- /** user set calculator in Business Manager to be Manual */
2068
- GLOBAL_SETTING_TO_MANUAL = "GLOBAL_SETTING_TO_MANUAL",
2069
- /** specific region is on manual even though Global setting is Auto-tax */
2070
- REGION_SETTING_TO_MANUAL = "REGION_SETTING_TO_MANUAL"
2071
- }
2072
- /** @enumType */
2073
- export type ManualCalculationReasonWithLiterals = ManualCalculationReason | 'GLOBAL_SETTING_TO_MANUAL' | 'REGION_SETTING_TO_MANUAL';
2074
- export interface AutoTaxFallbackCalculationDetails {
2075
- /** reason for fallback */
2076
- fallbackReason?: FallbackReasonWithLiterals;
2077
- /** invalid request (i.e. address), timeout, internal error, license error, and others will be encoded here */
2078
- error?: ApplicationError;
2079
- }
2080
- export declare enum FallbackReason {
2081
- /** auto-tax failed to be calculated */
2082
- AUTO_TAX_FAILED = "AUTO_TAX_FAILED",
2083
- /** auto-tax was temporarily deactivated on a system-level */
2084
- AUTO_TAX_DEACTIVATED = "AUTO_TAX_DEACTIVATED"
2085
- }
2086
- /** @enumType */
2087
- export type FallbackReasonWithLiterals = FallbackReason | 'AUTO_TAX_FAILED' | 'AUTO_TAX_DEACTIVATED';
2088
- /**
2089
- * The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate.
2090
- * Tax breakdown is the tax amount split to the tax authorities that applied on the line item.
2091
- */
2092
- export interface AggregatedTaxBreakdown {
2093
- /**
2094
- * The name of the tax against which this tax amount was calculated.
2095
- * @maxLength 200
2096
- */
2097
- taxName?: string;
2098
- /**
2099
- * The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws.
2100
- * @maxLength 200
2101
- */
2102
- taxType?: string;
2103
- /**
2104
- * The name of the jurisdiction in which this tax detail applies.
2105
- * @maxLength 200
2106
- */
2107
- jurisdiction?: string;
2108
- /** The type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */
2109
- jurisdictionTypeEnum?: JurisdictionTypeWithLiterals;
2110
- /**
2111
- * The rate at which this tax detail was calculated, e.g 0.1000 signifies 10% tax and 2.000 signifies 200% tax. (Decimal value)
2112
- * @decimalValue options { gte:0, maxScale:6 }
2113
- */
2114
- rate?: string;
2115
- /** The sum of all the tax from line items that calculated by the tax identifiers. */
2116
- aggregatedTaxAmount?: MultiCurrencyPrice;
2117
- }
2118
- export declare enum ChannelType {
2119
- /** Unspecified sales channel. This value is not supported. */
2120
- UNSPECIFIED = "UNSPECIFIED",
2121
- /** A web client. */
2122
- WEB = "WEB",
2123
- /** [Point of sale solutions](https://support.wix.com/en/wix-mobile-pos-2196395). */
2124
- POS = "POS",
2125
- /** [eBay shop](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-ebay-shop). */
2126
- EBAY = "EBAY",
2127
- /** [Amazon shop](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-amazon-shop). */
2128
- AMAZON = "AMAZON",
2129
- /** Other sales platform. */
2130
- OTHER_PLATFORM = "OTHER_PLATFORM",
2131
- /** [Wix Owner app](https://support.wix.com/article/wix-owner-app-an-overview). */
2132
- WIX_APP_STORE = "WIX_APP_STORE",
2133
- /** Wix Invoices app in [your dashboard](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Finvoices/settings/general-settings) */
2134
- WIX_INVOICES = "WIX_INVOICES",
2135
- /** Wix merchant backoffice. */
2136
- BACKOFFICE_MERCHANT = "BACKOFFICE_MERCHANT",
2137
- /** Wish sales channel. */
2138
- WISH = "WISH",
2139
- /** [ClassPass sales channel](https://support.wix.com/en/article/wix-bookings-letting-clients-book-your-services-with-classpass). */
2140
- CLASS_PASS = "CLASS_PASS",
2141
- /** Global-E sales channel. */
2142
- GLOBAL_E = "GLOBAL_E",
2143
- /** [Facebook shop](https://support.wix.com/en/article/wix-stores-changes-to-facebook-shops). */
2144
- FACEBOOK = "FACEBOOK",
2145
- /** [Etsy sales channel](https://support.wix.com/en/article/wix-stores-request-adding-etsy-as-a-sales-channel). */
2146
- ETSY = "ETSY",
2147
- /** [TikTok sales channel](https://support.wix.com/en/article/wix-stores-request-adding-tiktok-as-a-sales-channel). */
2148
- TIKTOK = "TIKTOK",
2149
- /** [Faire marketplace integration](https://support.wix.com/en/article/wix-stores-creating-a-faire-store-using-the-faire-integration-app). */
2150
- FAIRE_COM = "FAIRE_COM"
2151
- }
2152
- /** @enumType */
2153
- export type ChannelTypeWithLiterals = ChannelType | 'UNSPECIFIED' | 'WEB' | 'POS' | 'EBAY' | 'AMAZON' | 'OTHER_PLATFORM' | 'WIX_APP_STORE' | 'WIX_INVOICES' | 'BACKOFFICE_MERCHANT' | 'WISH' | 'CLASS_PASS' | 'GLOBAL_E' | 'FACEBOOK' | 'ETSY' | 'TIKTOK' | 'FAIRE_COM';
2154
- export interface CreatedBy extends CreatedByIdOneOf {
2155
- /**
2156
- * User ID. When the order was created by a Wix user on behalf of a buyer.
2157
- * For example, via POS (point of service).
2158
- * @format GUID
2159
- */
2160
- userId?: string;
2161
- /**
2162
- * Member ID. When the order was created by a **logged in** site visitor.
2163
- * @format GUID
2164
- */
2165
- memberId?: string;
2166
- /**
2167
- * Visitor ID. When the order was created by a site visitor that was **not** logged in.
2168
- * @format GUID
2169
- */
2170
- visitorId?: string;
2171
- /**
2172
- * App ID. When the order was created by an external application or Wix service.
2173
- * @format GUID
2174
- */
2175
- appId?: string;
2176
- }
2177
- /** @oneof */
2178
- export interface CreatedByIdOneOf {
2179
- /**
2180
- * User ID. When the order was created by a Wix user on behalf of a buyer.
2181
- * For example, via POS (point of service).
2182
- * @format GUID
2183
- */
2184
- userId?: string;
2185
- /**
2186
- * Member ID. When the order was created by a **logged in** site visitor.
2187
- * @format GUID
2188
- */
2189
- memberId?: string;
2190
- /**
2191
- * Visitor ID. When the order was created by a site visitor that was **not** logged in.
2192
- * @format GUID
2193
- */
2194
- visitorId?: string;
2195
- /**
2196
- * App ID. When the order was created by an external application or Wix service.
2197
- * @format GUID
2198
- */
2199
- appId?: string;
2200
- }
2201
- /** Reserved for internal use. */
2202
- export interface MembershipOptions {
2203
- /**
2204
- * Reserved for internal use.
2205
- * @readonly
2206
- * @maxSize 300
2207
- */
2208
- eligibleMemberships?: Membership[];
2209
- /**
2210
- * Reserved for internal use.
2211
- * @readonly
2212
- * @maxSize 300
2213
- */
2214
- invalidMemberships?: InvalidMembership[];
2215
- /** Selected membership to apply to this checkout. */
2216
- selectedMemberships?: SelectedMemberships;
2217
- }
2218
- export interface Membership {
2219
- /**
2220
- * Membership ID.
2221
- * @minLength 1
2222
- * @maxLength 100
2223
- */
2224
- id?: string;
2225
- /**
2226
- * ID of the application providing this payment option.
2227
- * @format GUID
2228
- */
2229
- appId?: string;
2230
- /** The name of this membership. */
2231
- name?: MembershipName;
2232
- /**
2233
- * Line item IDs which are "paid" for by this membership.
2234
- * @minSize 1
2235
- * @maxSize 300
2236
- * @minLength 1
2237
- * @maxLength 100
2238
- */
2239
- lineItemIds?: string[];
2240
- /** Optional - For a membership that has limited credits, information about credit usage. */
2241
- credits?: MembershipPaymentCredits;
2242
- /** Optional - TMembership expiry date. */
2243
- expirationDate?: Date | null;
2244
- /** Additional data about this membership. */
2245
- additionalData?: Record<string, any> | null;
2246
- }
2247
- export interface MembershipName {
2248
- /**
2249
- * Membership name.
2250
- * @maxLength 100
2251
- */
2252
- original?: string;
2253
- /**
2254
- * Translated membership name. Defaults to `original` when not provided.
2255
- * @maxLength 100
2256
- */
2257
- translated?: string | null;
2258
- }
2259
- export interface MembershipPaymentCredits {
2260
- /**
2261
- * Membership's total amount of credits.
2262
- * @min 1
2263
- */
2264
- total?: number;
2265
- /** Membership's remaining amount of credits. */
2266
- remaining?: number;
2267
- }
2268
- export interface InvalidMembership {
2269
- /** Membership details. */
2270
- membership?: Membership;
2271
- /**
2272
- * Reason why this membership is invalid and cannot be used.
2273
- * @minLength 1
2274
- * @maxLength 100
2275
- */
2276
- reason?: string;
2277
- }
2278
- export interface SelectedMemberships {
2279
- /**
2280
- * Selected memberships.
2281
- * @maxSize 300
2282
- */
2283
- memberships?: SelectedMembership[];
2284
- }
2285
- export interface SelectedMembership {
2286
- /**
2287
- * Membership ID.
2288
- * @minLength 1
2289
- * @maxLength 100
2290
- */
2291
- id?: string;
2292
- /**
2293
- * ID of the app providing this payment option.
2294
- * @format GUID
2295
- */
2296
- appId?: string;
2297
- /**
2298
- * IDs of the line items this membership applies to.
2299
- * @minSize 1
2300
- * @maxSize 300
2301
- * @minLength 1
2302
- * @maxLength 100
2303
- */
2304
- lineItemIds?: string[];
2305
- }
2306
- export interface AdditionalFee {
2307
- /**
2308
- * Additional fee's unique code (or ID) for future processing.
2309
- * @minLength 1
2310
- * @maxLength 100
2311
- */
2312
- code?: string | null;
2313
- /**
2314
- * Translated additional fee's name.
2315
- * @minLength 1
2316
- * @maxLength 50
2317
- */
2318
- name?: string;
2319
- /** Additional fee's price. */
2320
- price?: MultiCurrencyPrice;
2321
- /** Tax details. */
2322
- taxDetails?: ItemTaxFullDetails;
2323
- /**
2324
- * Provider's app id.
2325
- * @minLength 1
2326
- * @maxLength 100
2327
- */
2328
- providerAppId?: string | null;
2329
- /** Additional fee's price before tax. */
2330
- priceBeforeTax?: MultiCurrencyPrice;
2331
- /** Additional fee's price after tax. */
2332
- priceAfterTax?: MultiCurrencyPrice;
2333
- /**
2334
- * Optional - Line items associated with this additional fee.
2335
- * If no `lineItemIds` are provided, the fee will be associated with the whole cart/checkout/order.
2336
- * @format GUID
2337
- */
2338
- lineItemIds?: string[];
2339
- /** the source the additional fee was added from */
2340
- source?: AdditionalFeeSourceWithLiterals;
2341
- }
2342
- export declare enum AdditionalFeeSource {
2343
- UNKNOWN_ADDITIONAL_FEE_SOURCE = "UNKNOWN_ADDITIONAL_FEE_SOURCE",
2344
- /** The additional fee was added by an additional fee service plugin */
2345
- SERVICE_PLUGIN = "SERVICE_PLUGIN",
2346
- /** The additional fee was added on the item either via the catalog or on custom line item */
2347
- ITEM = "ITEM",
2348
- /** The additional fee was added manually on the request */
2349
- MANUAL = "MANUAL",
2350
- /** The additional fee was added by the shipping provider */
2351
- SHIPPING = "SHIPPING"
2352
- }
2353
- /** @enumType */
2354
- export type AdditionalFeeSourceWithLiterals = AdditionalFeeSource | 'UNKNOWN_ADDITIONAL_FEE_SOURCE' | 'SERVICE_PLUGIN' | 'ITEM' | 'MANUAL' | 'SHIPPING';
2355
- export interface ConversionInfo {
2356
- /**
2357
- * The site currency.
2358
- * @readonly
2359
- * @format CURRENCY
2360
- */
2361
- siteCurrency?: string;
2362
- /**
2363
- * The rate used when converting from the site currency to the checkout currency.
2364
- * @readonly
2365
- * @decimalValue options { gt:0, lte:1000000000000000 }
2366
- */
2367
- conversionRate?: string;
2368
- }
2369
- export interface Violation {
2370
- /** Severity of the violation. The violations are shown on the cart and checkout pages. A warning is displayed as yellow, and allows a site visitor to proceed with caution. An error is displayed as red, and doesn't allow a site visitor to proceed with the eCommerce flow. */
2371
- severity?: SeverityWithLiterals;
2372
- /** Target location on a checkout or cart page where the violation will be displayed. */
2373
- target?: Target;
2374
- /**
2375
- * Violation description. Can include rich text. Only HTTP or HTTPS links in the following format are allowed: `<a href="https://www.wix.com">Click me</a>`.
2376
- * @minLength 1
2377
- * @maxLength 1000
2378
- */
2379
- description?: string | null;
2380
- }
2381
- export declare enum Severity {
2382
- /** The user is allowed to move forward in the flow. */
2383
- WARNING = "WARNING",
2384
- /**
2385
- * The user is blocked from moving forward in the flow.
2386
- * For example, if callerContext is CART - moving to checkout is blocked. if callerContext is CHECKOUT, placing an order is blocked.
2387
- */
2388
- ERROR = "ERROR"
2389
- }
2390
- /** @enumType */
2391
- export type SeverityWithLiterals = Severity | 'WARNING' | 'ERROR';
2392
- export interface Target extends TargetTargetTypeOneOf {
2393
- /** General (other) violation. */
2394
- other?: Other;
2395
- /** Specific line item violation. */
2396
- lineItem?: TargetLineItem;
2397
- }
2398
- /** @oneof */
2399
- export interface TargetTargetTypeOneOf {
2400
- /** General (other) violation. */
2401
- other?: Other;
2402
- /** Specific line item violation. */
2403
- lineItem?: TargetLineItem;
2404
- }
2405
- /** Available locations on the webpage */
2406
- export declare enum NameInOther {
2407
- /** Default location, in case no specific location is specified. */
2408
- OTHER_DEFAULT = "OTHER_DEFAULT"
2409
- }
2410
- /** @enumType */
2411
- export type NameInOtherWithLiterals = NameInOther | 'OTHER_DEFAULT';
2412
- /** Available locations on the line item */
2413
- export declare enum NameInLineItem {
2414
- /** Default location, in case no specific location is specified. */
2415
- LINE_ITEM_DEFAULT = "LINE_ITEM_DEFAULT"
2416
- }
2417
- /** @enumType */
2418
- export type NameInLineItemWithLiterals = NameInLineItem | 'LINE_ITEM_DEFAULT';
2419
- export declare enum SuggestedFix {
2420
- /** No suggested fix is specified. The user should refer to the violation description to resolve the issue. */
2421
- UNKNOWN_SUGGESTED_FIX = "UNKNOWN_SUGGESTED_FIX",
2422
- /** The line item should be removed from the cart or checkout to resolve the violation. */
2423
- REMOVE_LINE_ITEM = "REMOVE_LINE_ITEM"
2424
- }
2425
- /** @enumType */
2426
- export type SuggestedFixWithLiterals = SuggestedFix | 'UNKNOWN_SUGGESTED_FIX' | 'REMOVE_LINE_ITEM';
2427
- /** General (other) violation. */
2428
- export interface Other {
2429
- /** Location on a checkout or a cart page where a general (other) violation will be displayed. */
2430
- name?: NameInOtherWithLiterals;
2431
- }
2432
- /** Specific line item violation. */
2433
- export interface TargetLineItem {
2434
- /** Location on a checkout or a cart page where the specific line item violation will be displayed. */
2435
- name?: NameInLineItemWithLiterals;
2436
- /** ID of the line item containing the violation. */
2437
- id?: string | null;
2438
- }
2439
- export interface CustomSettings {
2440
- /**
2441
- * Whether to restrict the option to add or remove a gift card on the checkout page.
2442
- *
2443
- * Default: `false`
2444
- */
2445
- lockGiftCard?: boolean;
2446
- /**
2447
- * Whether to restrict the option to add or remove a coupon code on the checkout page.
2448
- *
2449
- * Default: `false`
2450
- */
2451
- lockCouponCode?: boolean;
2452
- /**
2453
- * Whether to disable policy agreement checkout in the checkout page
2454
- *
2455
- * Default: `false`
2456
- */
2457
- disabledPolicyAgreementCheckbox?: boolean;
2458
- /**
2459
- * Whether to disable manual payment option for this checkout.
2460
- *
2461
- * Default: `false`
2462
- */
2463
- disabledManualPayment?: boolean;
2464
- }
2465
- export interface SubscriptionCharges {
2466
- /**
2467
- * ids of the items the subscription is defined on
2468
- * @format GUID
2469
- * @minSize 1
2470
- * @maxSize 300
2471
- */
2472
- lineItemIds?: string[];
2473
- /**
2474
- * Generated description explaining future charges amount and schedule.
2475
- * Translated to subscription order buyer language, or to site language if was not provided.
2476
- * @maxLength 1000
2477
- */
2478
- description?: string | null;
2479
- /**
2480
- * Charges for subscription.
2481
- * @maxSize 50
2482
- */
2483
- charges?: Charge[];
2484
- }
2485
- export interface Charge {
2486
- /** The cycle number from which the charge starts. */
2487
- cycleFrom?: number;
2488
- /** The number of cycles for which the charge is applicable. */
2489
- cycleCount?: number | null;
2490
- /** Charge summary. */
2491
- priceSummary?: PriceSummary;
2492
- /** The billing date from which the charge starts. */
2493
- cycleBillingDate?: Date | null;
2494
- }
2495
- export interface CreateCheckoutTemplateRequest {
2496
- /** Checkout template to create. */
2497
- checkoutTemplate: CheckoutTemplate;
2498
- }
2499
- export interface CreateCheckoutTemplateResponse {
2500
- /** Created checkout template. */
2501
- checkoutTemplate?: CheckoutTemplate;
2502
- }
2503
- export interface GetCheckoutTemplateRequest {
2504
- /**
2505
- * ID of the checkout template to retrieve.
2506
- * @format GUID
2507
- */
2508
- checkoutTemplateId: string;
2509
- }
2510
- export interface GetCheckoutTemplateResponse {
2511
- /** Retrieved checkout template. */
2512
- checkoutTemplate?: CheckoutTemplate;
2513
- }
2514
- export interface UpdateCheckoutTemplateRequest {
2515
- /** Checkout template info to update. */
2516
- checkoutTemplate: CheckoutTemplate;
2517
- }
2518
- export interface UpdateCheckoutTemplateResponse {
2519
- /** Updated checkout template. */
2520
- checkoutTemplate?: CheckoutTemplate;
2521
- }
2522
- export interface DeleteCheckoutTemplateRequest {
2523
- /**
2524
- * ID of the checkout template to delete.
2525
- * @format GUID
2526
- */
2527
- checkoutTemplateId: string;
2528
- }
2529
- export interface DeleteCheckoutTemplateResponse {
2530
- }
2531
- export interface QueryCheckoutTemplatesRequest {
2532
- /** Query options. */
2533
- query?: CursorQuery;
2534
- }
2535
- export interface CursorQuery extends CursorQueryPagingMethodOneOf {
2536
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2537
- cursorPaging?: CursorPaging;
2538
- /**
2539
- * Filter object in the following format:
2540
- * `"filter" : {
2541
- * "fieldName1": "value1",
2542
- * "fieldName2":{"$operator":"value2"}
2543
- * }`
2544
- *
2545
- * Example of operators: `$eq`, `$ne`, `$in`, `$startsWith`, `$exists`, `$hasSome`
2546
- */
2547
- filter?: Record<string, any> | null;
2548
- /**
2549
- * Sort object in the following format:
2550
- * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
2551
- */
2552
- sort?: Sorting[];
2553
- }
2554
- /** @oneof */
2555
- export interface CursorQueryPagingMethodOneOf {
2556
- /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
2557
- cursorPaging?: CursorPaging;
2558
- }
2559
- export interface Sorting {
2560
- /** Name of the field to sort by. */
2561
- fieldName?: string;
2562
- /** Sort order. */
2563
- order?: SortOrderWithLiterals;
2564
- }
2565
- export declare enum SortOrder {
2566
- /** Ascending order. */
2567
- ASC = "ASC",
2568
- /** Descending order. */
2569
- DESC = "DESC"
2570
- }
2571
- /** @enumType */
2572
- export type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
2573
- export interface CursorPaging {
2574
- /**
2575
- * Number of items to load.
2576
- * @max 100
2577
- */
2578
- limit?: number | null;
2579
- /**
2580
- * Pointer to the next or previous page in the list of results. </ br>
2581
- *
2582
- * You can get the relevant cursor token
2583
- * from the `pagingMetadata` object in the previous call's response.
2584
- * Not relevant for the first request.
2585
- */
2586
- cursor?: string | null;
2587
- }
2588
- export interface QueryCheckoutTemplatesResponse {
2589
- /** Retrieved checkout templates. */
2590
- checkoutTemplates?: CheckoutTemplate[];
2591
- /** Paging metadata. */
2592
- pagingMetadata?: CursorPagingMetadata;
2593
- }
2594
- export interface CursorPagingMetadata {
2595
- /** Number of items returned in the response. */
2596
- count?: number | null;
2597
- /** Offset that was requested. */
2598
- cursors?: Cursors;
2599
- /**
2600
- * Indicates if there are more results after the current page.
2601
- * If `true`, another page of results can be retrieved.
2602
- * If `false`, this is the last page.
2603
- */
2604
- hasNext?: boolean | null;
2605
- }
2606
- export interface Cursors {
2607
- /** Cursor pointing to next page in the list of results. */
2608
- next?: string | null;
2609
- /** Cursor pointing to previous page in the list of results. */
2610
- prev?: string | null;
2611
- }
2612
- export interface CreateCheckoutFromTemplateRequest {
2613
- /**
2614
- * ID of the checkout template to use to create a checkout from.
2615
- * @format GUID
2616
- */
2617
- checkoutTemplateId: string;
2618
- /**
2619
- * ID of the site associated with the checkout template.
2620
- * @format GUID
2621
- */
2622
- siteId: string;
2623
- }
2624
- export interface CreateCheckoutFromTemplateResponse {
2625
- /**
2626
- * ID of the created checkout.
2627
- * @format GUID
2628
- */
2629
- checkoutId?: string;
2630
- /** URL of the created checkout page. */
2631
- checkoutUrl?: string;
2632
- /**
2633
- * Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
2634
- * @format GUID
2635
- */
2636
- purchaseFlowId?: string | null;
2637
- }
2638
- export interface CreateAndRedirectToCheckoutRequest {
2639
- /**
2640
- * ID of the checkout template to use to create a checkout.
2641
- * @format GUID
2642
- */
2643
- checkoutTemplateId: string;
2644
- /**
2645
- * ID of the site associated with the checkout template.
2646
- * @format GUID
2647
- */
2648
- siteId: string;
2649
- }
2650
- export interface RawHttpResponse {
2651
- body?: Uint8Array;
2652
- statusCode?: number | null;
2653
- headers?: HeadersEntry[];
2654
- }
2655
- export interface HeadersEntry {
2656
- key?: string;
2657
- value?: string;
2658
- }
2659
- export interface DomainEvent extends DomainEventBodyOneOf {
2660
- createdEvent?: EntityCreatedEvent;
2661
- updatedEvent?: EntityUpdatedEvent;
2662
- deletedEvent?: EntityDeletedEvent;
2663
- actionEvent?: ActionEvent;
2664
- /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
2665
- id?: string;
2666
- /**
2667
- * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
2668
- * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
2669
- */
2670
- entityFqdn?: string;
2671
- /**
2672
- * Event action name, placed at the top level to make it easier for users to dispatch messages.
2673
- * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
2674
- */
2675
- slug?: string;
2676
- /** ID of the entity associated with the event. */
2677
- entityId?: string;
2678
- /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
2679
- eventTime?: Date | null;
2680
- /**
2681
- * Whether the event was triggered as a result of a privacy regulation application
2682
- * (for example, GDPR).
2683
- */
2684
- triggeredByAnonymizeRequest?: boolean | null;
2685
- /** If present, indicates the action that triggered the event. */
2686
- originatedFrom?: string | null;
2687
- /**
2688
- * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
2689
- * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
2690
- */
2691
- entityEventSequence?: string | null;
2692
- }
2693
- /** @oneof */
2694
- export interface DomainEventBodyOneOf {
2695
- createdEvent?: EntityCreatedEvent;
2696
- updatedEvent?: EntityUpdatedEvent;
2697
- deletedEvent?: EntityDeletedEvent;
2698
- actionEvent?: ActionEvent;
2699
- }
2700
- export interface EntityCreatedEvent {
2701
- entityAsJson?: string;
2702
- /** Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity */
2703
- restoreInfo?: RestoreInfo;
2704
- }
2705
- export interface RestoreInfo {
2706
- deletedDate?: Date | null;
2707
- }
2708
- export interface EntityUpdatedEvent {
2709
- /**
2710
- * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
2711
- * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
2712
- * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
2713
- */
2714
- currentEntityAsJson?: string;
2715
- }
2716
- export interface EntityDeletedEvent {
2717
- /** Entity that was deleted. */
2718
- deletedEntityAsJson?: string | null;
2719
- }
2720
- export interface ActionEvent {
2721
- bodyAsJson?: string;
2722
- }
2723
- export interface MessageEnvelope {
2724
- /**
2725
- * App instance ID.
2726
- * @format GUID
2727
- */
2728
- instanceId?: string | null;
2729
- /**
2730
- * Event type.
2731
- * @maxLength 150
2732
- */
2733
- eventType?: string;
2734
- /** The identification type and identity data. */
2735
- identity?: IdentificationData;
2736
- /** Stringify payload. */
2737
- data?: string;
2738
- }
2739
- export interface IdentificationData extends IdentificationDataIdOneOf {
2740
- /**
2741
- * ID of a site visitor that has not logged in to the site.
2742
- * @format GUID
2743
- */
2744
- anonymousVisitorId?: string;
2745
- /**
2746
- * ID of a site visitor that has logged in to the site.
2747
- * @format GUID
2748
- */
2749
- memberId?: string;
2750
- /**
2751
- * ID of a Wix user (site owner, contributor, etc.).
2752
- * @format GUID
2753
- */
2754
- wixUserId?: string;
2755
- /**
2756
- * ID of an app.
2757
- * @format GUID
2758
- */
2759
- appId?: string;
2760
- /** @readonly */
2761
- identityType?: WebhookIdentityTypeWithLiterals;
2762
- }
2763
- /** @oneof */
2764
- export interface IdentificationDataIdOneOf {
2765
- /**
2766
- * ID of a site visitor that has not logged in to the site.
2767
- * @format GUID
2768
- */
2769
- anonymousVisitorId?: string;
2770
- /**
2771
- * ID of a site visitor that has logged in to the site.
2772
- * @format GUID
2773
- */
2774
- memberId?: string;
2775
- /**
2776
- * ID of a Wix user (site owner, contributor, etc.).
2777
- * @format GUID
2778
- */
2779
- wixUserId?: string;
2780
- /**
2781
- * ID of an app.
2782
- * @format GUID
2783
- */
2784
- appId?: string;
2785
- }
2786
- export declare enum WebhookIdentityType {
2787
- UNKNOWN = "UNKNOWN",
2788
- ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
2789
- MEMBER = "MEMBER",
2790
- WIX_USER = "WIX_USER",
2791
- APP = "APP"
2792
- }
2793
- /** @enumType */
2794
- export type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';