@wix/auto_sdk_ecom_order-transactions 1.0.11 → 1.0.13

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/index.d.ts +1 -0
  2. package/build/cjs/index.js +18 -0
  3. package/build/cjs/index.js.map +1 -0
  4. package/build/cjs/index.typings.d.ts +1 -0
  5. package/build/cjs/index.typings.js +18 -0
  6. package/build/cjs/index.typings.js.map +1 -0
  7. package/build/cjs/meta.d.ts +1 -0
  8. package/build/cjs/meta.js +18 -0
  9. package/build/cjs/meta.js.map +1 -0
  10. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.context.d.ts +9 -0
  11. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.context.js +41 -0
  12. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.context.js.map +1 -0
  13. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.http.d.ts +73 -0
  14. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.http.js +466 -0
  15. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.http.js.map +1 -0
  16. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.meta.d.ts +30 -0
  17. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.meta.js +161 -0
  18. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.meta.js.map +1 -0
  19. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.public.d.ts +63 -0
  20. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.public.js +76 -0
  21. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.public.js.map +1 -0
  22. package/build/{ecom-v1-order-transactions-order-transactions.universal-DgIVKgiJ.d.mts → cjs/src/ecom-v1-order-transactions-order-transactions.types.d.ts} +199 -221
  23. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.types.js +303 -0
  24. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.types.js.map +1 -0
  25. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.universal.d.ts +2537 -0
  26. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.universal.js +681 -0
  27. package/build/cjs/src/ecom-v1-order-transactions-order-transactions.universal.js.map +1 -0
  28. package/build/es/index.d.ts +1 -0
  29. package/build/es/index.js +2 -0
  30. package/build/es/index.js.map +1 -0
  31. package/build/es/index.typings.d.ts +1 -0
  32. package/build/es/index.typings.js +2 -0
  33. package/build/es/index.typings.js.map +1 -0
  34. package/build/es/meta.d.ts +1 -0
  35. package/build/es/meta.js +2 -0
  36. package/build/es/meta.js.map +1 -0
  37. package/build/es/package.json +3 -0
  38. package/build/es/src/ecom-v1-order-transactions-order-transactions.context.d.ts +9 -0
  39. package/build/es/src/ecom-v1-order-transactions-order-transactions.context.js +13 -0
  40. package/build/es/src/ecom-v1-order-transactions-order-transactions.context.js.map +1 -0
  41. package/build/es/src/ecom-v1-order-transactions-order-transactions.http.d.ts +73 -0
  42. package/build/es/src/ecom-v1-order-transactions-order-transactions.http.js +456 -0
  43. package/build/es/src/ecom-v1-order-transactions-order-transactions.http.js.map +1 -0
  44. package/build/es/src/ecom-v1-order-transactions-order-transactions.meta.d.ts +30 -0
  45. package/build/es/src/ecom-v1-order-transactions-order-transactions.meta.js +128 -0
  46. package/build/es/src/ecom-v1-order-transactions-order-transactions.meta.js.map +1 -0
  47. package/build/es/src/ecom-v1-order-transactions-order-transactions.public.d.ts +63 -0
  48. package/build/es/src/ecom-v1-order-transactions-order-transactions.public.js +41 -0
  49. package/build/es/src/ecom-v1-order-transactions-order-transactions.public.js.map +1 -0
  50. package/build/{ecom-v1-order-transactions-order-transactions.universal-DgIVKgiJ.d.ts → es/src/ecom-v1-order-transactions-order-transactions.types.d.ts} +199 -221
  51. package/build/es/src/ecom-v1-order-transactions-order-transactions.types.js +300 -0
  52. package/build/es/src/ecom-v1-order-transactions-order-transactions.types.js.map +1 -0
  53. package/build/es/src/ecom-v1-order-transactions-order-transactions.universal.d.ts +2537 -0
  54. package/build/es/src/ecom-v1-order-transactions-order-transactions.universal.js +648 -0
  55. package/build/es/src/ecom-v1-order-transactions-order-transactions.universal.js.map +1 -0
  56. package/build/internal/cjs/index.d.ts +1 -0
  57. package/build/internal/cjs/index.js +18 -0
  58. package/build/internal/cjs/index.js.map +1 -0
  59. package/build/internal/cjs/index.typings.d.ts +1 -0
  60. package/build/internal/cjs/index.typings.js +18 -0
  61. package/build/internal/cjs/index.typings.js.map +1 -0
  62. package/build/internal/cjs/meta.d.ts +1 -0
  63. package/build/internal/cjs/meta.js +18 -0
  64. package/build/internal/cjs/meta.js.map +1 -0
  65. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.context.d.ts +13 -0
  66. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.context.js +41 -0
  67. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.context.js.map +1 -0
  68. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.http.d.ts +73 -0
  69. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.http.js +466 -0
  70. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.http.js.map +1 -0
  71. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.meta.d.ts +30 -0
  72. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.meta.js +161 -0
  73. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.meta.js.map +1 -0
  74. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.public.d.ts +108 -0
  75. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.public.js +76 -0
  76. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.public.js.map +1 -0
  77. package/build/internal/{ecom-v1-order-transactions-order-transactions.universal-CQewkK3E.d.mts → cjs/src/ecom-v1-order-transactions-order-transactions.types.d.ts} +199 -305
  78. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.types.js +303 -0
  79. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.types.js.map +1 -0
  80. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.universal.d.ts +2684 -0
  81. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.universal.js +681 -0
  82. package/build/internal/cjs/src/ecom-v1-order-transactions-order-transactions.universal.js.map +1 -0
  83. package/build/internal/es/index.d.ts +1 -0
  84. package/build/internal/es/index.js +2 -0
  85. package/build/internal/es/index.js.map +1 -0
  86. package/build/internal/es/index.typings.d.ts +1 -0
  87. package/build/internal/es/index.typings.js +2 -0
  88. package/build/internal/es/index.typings.js.map +1 -0
  89. package/build/internal/es/meta.d.ts +1 -0
  90. package/build/internal/es/meta.js +2 -0
  91. package/build/internal/es/meta.js.map +1 -0
  92. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.context.d.ts +13 -0
  93. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.context.js +13 -0
  94. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.context.js.map +1 -0
  95. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.http.d.ts +73 -0
  96. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.http.js +456 -0
  97. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.http.js.map +1 -0
  98. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.meta.d.ts +30 -0
  99. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.meta.js +128 -0
  100. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.meta.js.map +1 -0
  101. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.public.d.ts +108 -0
  102. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.public.js +41 -0
  103. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.public.js.map +1 -0
  104. package/build/internal/{ecom-v1-order-transactions-order-transactions.universal-CQewkK3E.d.ts → es/src/ecom-v1-order-transactions-order-transactions.types.d.ts} +199 -305
  105. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.types.js +300 -0
  106. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.types.js.map +1 -0
  107. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.universal.d.ts +2684 -0
  108. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.universal.js +648 -0
  109. package/build/internal/es/src/ecom-v1-order-transactions-order-transactions.universal.js.map +1 -0
  110. package/package.json +11 -12
  111. package/build/index.d.mts +0 -69
  112. package/build/index.d.ts +0 -69
  113. package/build/index.js +0 -942
  114. package/build/index.js.map +0 -1
  115. package/build/index.mjs +0 -887
  116. package/build/index.mjs.map +0 -1
  117. package/build/internal/index.d.mts +0 -118
  118. package/build/internal/index.d.ts +0 -118
  119. package/build/internal/index.js +0 -942
  120. package/build/internal/index.js.map +0 -1
  121. package/build/internal/index.mjs +0 -887
  122. package/build/internal/index.mjs.map +0 -1
  123. package/build/internal/meta.d.mts +0 -602
  124. package/build/internal/meta.d.ts +0 -602
  125. package/build/internal/meta.js +0 -566
  126. package/build/internal/meta.js.map +0 -1
  127. package/build/internal/meta.mjs +0 -533
  128. package/build/internal/meta.mjs.map +0 -1
  129. package/build/meta.d.mts +0 -602
  130. package/build/meta.d.ts +0 -602
  131. package/build/meta.js +0 -566
  132. package/build/meta.js.map +0 -1
  133. package/build/meta.mjs +0 -533
  134. package/build/meta.mjs.map +0 -1
@@ -0,0 +1,2537 @@
1
+ import { NonNullablePaths } from '@wix/sdk-types';
2
+ export interface OrderTransactions {
3
+ /**
4
+ * Order ID.
5
+ * @format GUID
6
+ */
7
+ orderId?: string;
8
+ /**
9
+ * Record of payments made to the merchant.
10
+ * @maxSize 100
11
+ */
12
+ payments?: Payment[];
13
+ /**
14
+ * Record of refunds made to the buyer.
15
+ * @maxSize 300
16
+ */
17
+ refunds?: Refund[];
18
+ }
19
+ export interface Payment extends PaymentPaymentDetailsOneOf, PaymentReceiptInfoOneOf {
20
+ /** Regular payment details. */
21
+ regularPaymentDetails?: RegularPaymentDetails;
22
+ /** Gift card payment details. */
23
+ giftcardPaymentDetails?: GiftCardPaymentDetails;
24
+ /**
25
+ * Payment ID.
26
+ * @format GUID
27
+ * @readonly
28
+ */
29
+ _id?: string | null;
30
+ /** Date and time the payment was created in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. Defaults to current time when not provided. */
31
+ _createdDate?: Date | null;
32
+ /**
33
+ * Date and time the payment was last updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
34
+ * @readonly
35
+ */
36
+ _updatedDate?: Date | null;
37
+ /** Payment amount. */
38
+ amount?: Price;
39
+ /**
40
+ * Whether refunds for this payment are disabled.
41
+ * + `true`: This payment is not refundable.
42
+ * + `false`: This payment may be refunded. However, this ultimately depends on the payment provider.
43
+ */
44
+ refundDisabled?: boolean;
45
+ }
46
+ /** @oneof */
47
+ export interface PaymentPaymentDetailsOneOf {
48
+ /** Regular payment details. */
49
+ regularPaymentDetails?: RegularPaymentDetails;
50
+ /** Gift card payment details. */
51
+ giftcardPaymentDetails?: GiftCardPaymentDetails;
52
+ }
53
+ /** @oneof */
54
+ export interface PaymentReceiptInfoOneOf {
55
+ }
56
+ export interface RegularPaymentDetails extends RegularPaymentDetailsPaymentMethodDetailsOneOf {
57
+ /** Whether regular card used */
58
+ creditCardDetails?: CreditCardPaymentMethodDetails;
59
+ /**
60
+ * Wix Payments order ID.
61
+ * @maxLength 100
62
+ */
63
+ paymentOrderId?: string | null;
64
+ /**
65
+ * Payment gateway's transaction ID.
66
+ * This field is only returned when the value of `offline_payment` is `false`.
67
+ * @maxLength 100
68
+ */
69
+ gatewayTransactionId?: string | null;
70
+ /**
71
+ * Payment method. Non-exhaustive list of supported values:
72
+ * + `CreditCard`, `Alipay`, `AstropayCash`, `AstropayDBT`, `AstropayMBT`, `Bitcoin`, `BitPay`, `Cash`, `ConvenienceStore`, `EPay`, `Fake`, `Giropay`, `IDeal`, `InPerson`, `Klarna`, `MercadoPago`, `Netpay`, `NordeaSolo`, `Offline`, `PagSeguro`, `PayEasy`, `PayPal`, `Paysafecard`, `Paysafecash`, `PointOfSale`, `Poli`, `Privat24`, `Przelewy24`, `RapidTransfer`, `Sepa`, `Skrill`, `Sofort`, `Trustly`, `Neteller`, `Unionpay`, `UniPay`, `Yandex`
73
+ * @maxLength 100
74
+ */
75
+ paymentMethod?: string | null;
76
+ /**
77
+ * Transaction ID in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for offline payments.
78
+ * @maxLength 100
79
+ */
80
+ providerTransactionId?: string | null;
81
+ /** Whether the payment was made offline. For example, when using cash or when marked as paid in the Business Manager. */
82
+ offlinePayment?: boolean;
83
+ /** Payment status. */
84
+ status?: TransactionStatus;
85
+ /**
86
+ * Whether there is a payment agreement that allows for future charges.
87
+ * @immutable
88
+ */
89
+ savedPaymentMethod?: boolean;
90
+ /** Authorization details. */
91
+ authorizationDetails?: AuthorizationDetails;
92
+ }
93
+ /** @oneof */
94
+ export interface RegularPaymentDetailsPaymentMethodDetailsOneOf {
95
+ /** Whether regular card used */
96
+ creditCardDetails?: CreditCardPaymentMethodDetails;
97
+ }
98
+ export declare enum TransactionStatus {
99
+ UNDEFINED = "UNDEFINED",
100
+ APPROVED = "APPROVED",
101
+ PENDING = "PENDING",
102
+ PENDING_MERCHANT = "PENDING_MERCHANT",
103
+ CANCELED = "CANCELED",
104
+ DECLINED = "DECLINED",
105
+ REFUNDED = "REFUNDED",
106
+ PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED",
107
+ AUTHORIZED = "AUTHORIZED",
108
+ VOIDED = "VOIDED"
109
+ }
110
+ export interface CreditCardPaymentMethodDetails {
111
+ /**
112
+ * The last 4 digits of the card number.
113
+ * @maxLength 4
114
+ */
115
+ lastFourDigits?: string | null;
116
+ /**
117
+ * Card issuer's brand.
118
+ * @maxLength 100
119
+ */
120
+ brand?: string | null;
121
+ }
122
+ export interface AuthorizationDetails {
123
+ /**
124
+ * Whether the authorized payment is of a delayed capture.
125
+ * @readonly
126
+ */
127
+ delayedCapture?: boolean;
128
+ /** Date and time the payment was authorized in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
129
+ authorizedDate?: Date | null;
130
+ /**
131
+ * List of captures associated with payment
132
+ * In case of failed it can be replaced with new one with PENDING or SUCCESS statuses
133
+ * @maxSize 1
134
+ */
135
+ captures?: AuthorizationCapture[];
136
+ /** Void associated with payment */
137
+ void?: AuthorizationVoid;
138
+ /** Scheduled action for this transaction */
139
+ scheduledAction?: ScheduledAction;
140
+ }
141
+ export interface AuthorizationCapture {
142
+ /**
143
+ * Capture ID.
144
+ * @format GUID
145
+ * @readonly
146
+ */
147
+ _id?: string | null;
148
+ /** Status of this capture action */
149
+ status?: AuthorizationCaptureStatus;
150
+ /**
151
+ * Amount of this capture
152
+ * @immutable
153
+ */
154
+ amount?: Price;
155
+ /** Date and time the capture was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
156
+ _createdDate?: Date | null;
157
+ /** In case of status is FAILED may contain failure details */
158
+ failureDetails?: AuthorizationActionFailureDetails;
159
+ }
160
+ export declare enum AuthorizationCaptureStatus {
161
+ UNKNOWN_STATUS = "UNKNOWN_STATUS",
162
+ /** Capture operation still in progress. */
163
+ PENDING = "PENDING",
164
+ /** Capture operation succeeded. */
165
+ SUCCEEDED = "SUCCEEDED",
166
+ /** Capture operation failed. */
167
+ FAILED = "FAILED"
168
+ }
169
+ export interface Price {
170
+ /**
171
+ * Amount.
172
+ * @decimalValue options { gte:0, lte:1000000000000000 }
173
+ */
174
+ amount?: string;
175
+ /**
176
+ * Amount formatted with currency symbol.
177
+ * @readonly
178
+ */
179
+ formattedAmount?: string;
180
+ }
181
+ export interface AuthorizationActionFailureDetails {
182
+ /** @maxLength 100 */
183
+ failureCode?: string;
184
+ }
185
+ export interface AuthorizationVoid {
186
+ /** Status of this void action */
187
+ status?: AuthorizationVoidStatus;
188
+ /** Date and time the void was initiated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. */
189
+ voidedDate?: Date | null;
190
+ /** In case of status is FAILED may contain failure details */
191
+ failureDetails?: AuthorizationActionFailureDetails;
192
+ /** Reason of void action */
193
+ reason?: Reason;
194
+ }
195
+ export declare enum AuthorizationVoidStatus {
196
+ UNKNOWN_STATUS = "UNKNOWN_STATUS",
197
+ /** Void operation still in progress. */
198
+ PENDING = "PENDING",
199
+ /** Void operation succeeded. */
200
+ SUCCEEDED = "SUCCEEDED",
201
+ /** Void operation failed. */
202
+ FAILED = "FAILED"
203
+ }
204
+ /** Reason the authorization was voided. */
205
+ export declare enum Reason {
206
+ UNKNOWN_REASON = "UNKNOWN_REASON",
207
+ /** Authorization was voided by user. */
208
+ MANUAL = "MANUAL",
209
+ /** Authorization passed execution date. */
210
+ SCHEDULED = "SCHEDULED"
211
+ }
212
+ export interface ScheduledAction {
213
+ /** Type of the action. */
214
+ actionType?: ActionType;
215
+ /** The date and time of the action. */
216
+ executionDate?: Date | null;
217
+ }
218
+ export declare enum ActionType {
219
+ UNKNOWN_ACTION_TYPE = "UNKNOWN_ACTION_TYPE",
220
+ VOID = "VOID",
221
+ CAPTURE = "CAPTURE"
222
+ }
223
+ export interface GiftCardPaymentDetails {
224
+ /**
225
+ * Gift card payment ID.
226
+ * @minLength 1
227
+ * @maxLength 100
228
+ */
229
+ giftCardPaymentId?: string;
230
+ /**
231
+ * ID of the app that created the gift card.
232
+ * @format GUID
233
+ */
234
+ appId?: string;
235
+ /**
236
+ * Whether the gift card is voided.
237
+ * @readonly
238
+ */
239
+ voided?: boolean;
240
+ }
241
+ export interface MembershipPaymentDetails {
242
+ /**
243
+ * Membership ID.
244
+ * @minLength 1
245
+ * @maxLength 100
246
+ */
247
+ membershipId?: string;
248
+ /**
249
+ * ID of the line item this membership applies to.
250
+ * @minLength 1
251
+ * @maxLength 100
252
+ */
253
+ lineItemId?: string;
254
+ /** Payment status. */
255
+ status?: MembershipPaymentStatus;
256
+ /** Membership name. */
257
+ name?: MembershipName;
258
+ /**
259
+ * The transaction ID in the membership system. Can be used to void the transaction.
260
+ * @minLength 1
261
+ * @maxLength 100
262
+ */
263
+ externalTransactionId?: string | null;
264
+ /**
265
+ * Whether the membership is voided.
266
+ * @readonly
267
+ */
268
+ voided?: boolean;
269
+ /**
270
+ * ID of the application providing this payment option.
271
+ * @format GUID
272
+ */
273
+ providerAppId?: string;
274
+ }
275
+ export declare enum MembershipPaymentStatus {
276
+ /** Payment was charged. */
277
+ CHARGED = "CHARGED",
278
+ /** The attempt to charge the payment failed, for example, due to lack of credits. */
279
+ CHARGE_FAILED = "CHARGE_FAILED"
280
+ }
281
+ export interface MembershipName {
282
+ /**
283
+ * Membership name.
284
+ * @maxLength 100
285
+ */
286
+ original?: string;
287
+ /**
288
+ * Translated membership name. Defaults to `original` when not provided.
289
+ * @maxLength 100
290
+ */
291
+ translated?: string | null;
292
+ }
293
+ export interface WixReceiptInfo {
294
+ /**
295
+ * Receipt ID
296
+ * @format GUID
297
+ */
298
+ receiptId?: string;
299
+ /**
300
+ * Display number of receipt
301
+ * @minLength 1
302
+ * @maxLength 40
303
+ */
304
+ displayNumber?: string | null;
305
+ }
306
+ export interface ExternalReceiptInfo {
307
+ /**
308
+ * External receipt ID
309
+ * @maxLength 100
310
+ */
311
+ receiptId?: string | null;
312
+ /**
313
+ * ID of the app providing the receipt
314
+ * @format GUID
315
+ */
316
+ appId?: string | null;
317
+ /**
318
+ * Display number of receipt
319
+ * @minLength 1
320
+ * @maxLength 40
321
+ */
322
+ displayNumber?: string | null;
323
+ }
324
+ export interface Refund {
325
+ /**
326
+ * Refund ID.
327
+ * @format GUID
328
+ * @readonly
329
+ */
330
+ _id?: string;
331
+ /**
332
+ * List of transactions.
333
+ * @maxSize 50
334
+ */
335
+ transactions?: RefundTransaction[];
336
+ /** Refund business details. */
337
+ details?: RefundDetails;
338
+ /**
339
+ * Date and time the refund was created in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. Defaults to current time when not provided.
340
+ * @readonly
341
+ * @immutable
342
+ */
343
+ _createdDate?: Date | null;
344
+ /**
345
+ * Aggregated refund summary.
346
+ * @readonly
347
+ */
348
+ summary?: AggregatedRefundSummary;
349
+ /**
350
+ * ID of the app that initiated this refund.
351
+ * @format GUID
352
+ * @readonly
353
+ * @immutable
354
+ */
355
+ requestingServiceAppId?: string | null;
356
+ }
357
+ export interface RefundTransaction {
358
+ /**
359
+ * ID of the payment associated with this refund.
360
+ * @format GUID
361
+ * @immutable
362
+ */
363
+ paymentId?: string;
364
+ /**
365
+ * Refund amount.
366
+ * @immutable
367
+ */
368
+ amount?: Price;
369
+ /** Refund status. */
370
+ refundStatus?: RefundStatus;
371
+ /** Optional details of current refund status. */
372
+ refundStatusInfo?: RefundStatusInfo;
373
+ /**
374
+ * Payment gateway's refund ID.
375
+ * This field is only returned when the value of `external_refund` is `false`.
376
+ * @format GUID
377
+ */
378
+ gatewayRefundId?: string | null;
379
+ /** ID of the refund in the payment provider's system. For example, at PayPal, Square, Stripe, etc. Not returned for external refunds. */
380
+ providerRefundId?: string | null;
381
+ /**
382
+ * Whether refund was made externally and manually on the payment provider's side.
383
+ * @immutable
384
+ */
385
+ externalRefund?: boolean;
386
+ }
387
+ /** Refund transaction status. */
388
+ export declare enum RefundStatus {
389
+ /** Refund was initiated on payment provider side. PENDING status was assigned by provider. */
390
+ PENDING = "PENDING",
391
+ /** Refund transaction succeeded. */
392
+ SUCCEEDED = "SUCCEEDED",
393
+ /** Refund transaction failed. */
394
+ FAILED = "FAILED",
395
+ /** Refund request acknowledged, and will be executed soon. */
396
+ SCHEDULED = "SCHEDULED",
397
+ /** Refund was initiated on payment provider side. */
398
+ STARTED = "STARTED"
399
+ }
400
+ export interface RefundStatusInfo {
401
+ /**
402
+ * Reason code for the refund's current status.
403
+ *
404
+ * Learn more about [reason codes](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/reason-codes).
405
+ * @minLength 1
406
+ * @maxLength 10
407
+ */
408
+ paymentGatewayReasonCode?: string | null;
409
+ /**
410
+ * Free text explanation of current refund status.
411
+ * @minLength 1
412
+ * @maxLength 1000
413
+ */
414
+ description?: string | null;
415
+ }
416
+ /** Business model of a refund request */
417
+ export interface RefundDetails {
418
+ /**
419
+ * Order line item IDs and quantities that were refunded.
420
+ * @maxSize 300
421
+ */
422
+ items?: RefundItem[];
423
+ /** Whether the shipping fee was also refunded. */
424
+ shippingIncluded?: boolean;
425
+ /**
426
+ * Reason for the refund, provided by customer (optional).
427
+ * @maxLength 200
428
+ */
429
+ reason?: string | null;
430
+ /**
431
+ * Line items that were refunded.
432
+ * @maxSize 300
433
+ */
434
+ lineItems?: LineItemRefund[];
435
+ /**
436
+ * Additional fees that were refunded.
437
+ * @maxSize 100
438
+ */
439
+ additionalFees?: AdditionalFeeRefund[];
440
+ /** Shipping amount that was refunded. */
441
+ shipping?: ShippingRefund;
442
+ }
443
+ export interface RefundItem {
444
+ /**
445
+ * Line item ID the refunded line item.
446
+ * @format GUID
447
+ */
448
+ lineItemId?: string;
449
+ /**
450
+ * Line item quantity refunded.
451
+ * @min 1
452
+ * @max 100000
453
+ */
454
+ quantity?: number;
455
+ }
456
+ export interface LineItemRefund {
457
+ /**
458
+ * Line item ID.
459
+ * @format GUID
460
+ * @immutable
461
+ */
462
+ lineItemId?: string;
463
+ /**
464
+ * Refund quantity.
465
+ * @min 1
466
+ * @max 100000
467
+ * @immutable
468
+ */
469
+ quantity?: number;
470
+ }
471
+ export interface AdditionalFeeRefund {
472
+ /**
473
+ * Additional fee ID.
474
+ * @format GUID
475
+ * @immutable
476
+ */
477
+ additionalFeeId?: string;
478
+ /**
479
+ * Refund amount.
480
+ * @immutable
481
+ */
482
+ amount?: Price;
483
+ }
484
+ export interface ShippingRefund {
485
+ /**
486
+ * Refund amount.
487
+ * @immutable
488
+ */
489
+ amount?: Price;
490
+ }
491
+ export interface AggregatedRefundSummary {
492
+ /** Total amount requested for refund. */
493
+ requestedRefund?: Price;
494
+ /** Pending refund amount - the portion of `requestedRefund` that is still pending. */
495
+ pendingRefund?: Price;
496
+ /** Refunded amount - the portion of `requestedRefund` that refunded successfully. */
497
+ refunded?: Price;
498
+ /** Failed refund amount - the portion of `requestedRefund` that failed. */
499
+ failedRefundAmount?: Price;
500
+ /** Whether at least one refund transaction is still in `"PENDING"` status. */
501
+ pending?: boolean;
502
+ /** Breakdown of refunded items. Available only after refund is complete. */
503
+ breakdown?: RefundItemsBreakdown;
504
+ }
505
+ export interface RefundItemsBreakdown {
506
+ /**
507
+ * Refunded line items and the amount refunded for each.
508
+ * @maxSize 300
509
+ */
510
+ lineItems?: LineItemRefundSummary[];
511
+ }
512
+ export interface LineItemRefundSummary {
513
+ /**
514
+ * ID of the refunded line item.
515
+ * @format GUID
516
+ */
517
+ lineItemId?: string;
518
+ /** Total refunded amount for the line item. */
519
+ totalRefundedAmount?: Price;
520
+ }
521
+ export interface SnapshotMessage {
522
+ _id?: string;
523
+ opType?: number;
524
+ }
525
+ export interface IndexingMessage {
526
+ _id?: string;
527
+ opType?: number;
528
+ requiredVersions?: string[];
529
+ }
530
+ export interface DiffmatokyPayload {
531
+ left?: string;
532
+ right?: string;
533
+ compareChannel?: string;
534
+ entityId?: string;
535
+ errorInformation?: ErrorInformation;
536
+ tags?: string[];
537
+ }
538
+ export interface ErrorInformation {
539
+ stackTrace?: string;
540
+ }
541
+ export interface OrderRefunded {
542
+ /**
543
+ * Refund ID.
544
+ * @readonly
545
+ */
546
+ refundId?: string;
547
+ /**
548
+ * Refunded order data.
549
+ * @readonly
550
+ */
551
+ order?: Order;
552
+ }
553
+ export interface Order {
554
+ /**
555
+ * Order ID (auto-generated upon order creation).
556
+ * @format GUID
557
+ * @readonly
558
+ */
559
+ _id?: string | null;
560
+ /**
561
+ * Order number displayed in the owner's store (auto-generated).
562
+ * @readonly
563
+ */
564
+ number?: number;
565
+ /**
566
+ * Order creation date and time.
567
+ * @readonly
568
+ */
569
+ dateCreated?: Date | null;
570
+ /** Buyer information. */
571
+ buyerInfo?: BuyerInfo;
572
+ /**
573
+ * Currency used for the pricing of this order in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format.
574
+ * @format CURRENCY
575
+ */
576
+ currency?: string | null;
577
+ /** Weight unit used in this store. */
578
+ weightUnit?: WeightUnit;
579
+ /** Totals for order's line items. */
580
+ totals?: Totals;
581
+ /** Billing information. */
582
+ billingInfo?: BillingInfo;
583
+ /** Shipping information. */
584
+ shippingInfo?: ShippingInfo;
585
+ /**
586
+ * A note added by the buyer.
587
+ * @maxLength 1000
588
+ */
589
+ buyerNote?: string | null;
590
+ /**
591
+ * Deprecated.
592
+ * @readonly
593
+ * @deprecated
594
+ */
595
+ read?: boolean;
596
+ /**
597
+ * Whether or not the order was archived.
598
+ * @readonly
599
+ */
600
+ archived?: boolean;
601
+ /** Current status of the payment. */
602
+ paymentStatus?: PaymentStatus;
603
+ /**
604
+ * Order's current fulfillment status (whether the order received a tracking number or was delivered/picked up).
605
+ * @readonly
606
+ */
607
+ fulfillmentStatus?: FulfillmentStatus;
608
+ /**
609
+ * Line items ordered.
610
+ * @minSize 1
611
+ * @maxSize 300
612
+ */
613
+ lineItems?: LineItem[];
614
+ /**
615
+ * Log of updates related to the order.
616
+ * @readonly
617
+ */
618
+ activities?: Activity[];
619
+ /** Invoice information. */
620
+ invoiceInfo?: V2InvoiceInfo;
621
+ /**
622
+ * Order fulfillment information.
623
+ * @readonly
624
+ */
625
+ fulfillments?: Fulfillment[];
626
+ /** Discount information. */
627
+ discount?: Discount;
628
+ /** Custom field information. */
629
+ customField?: CustomField;
630
+ /**
631
+ * Shopping cart ID.
632
+ * @format GUID
633
+ */
634
+ cartId?: string | null;
635
+ /**
636
+ * Language for communication with the buyer. Defaults to the site language.
637
+ * For a site that supports multiple languages, this is the language the buyer selected.
638
+ * @maxLength 10
639
+ */
640
+ buyerLanguage?: string | null;
641
+ /** Information about the sales channel that submitted this order. */
642
+ channelInfo?: ChannelInfo;
643
+ /**
644
+ * Identity of the order's initiator.
645
+ * @readonly
646
+ */
647
+ enteredBy?: EnteredBy;
648
+ /**
649
+ * Date and time of latest update.
650
+ * @readonly
651
+ */
652
+ lastUpdated?: Date | null;
653
+ /** Subscription information. */
654
+ subscriptionInfo?: SubscriptionInfo;
655
+ /**
656
+ * Order’s unique numeric ID.
657
+ * Primarily used for sorting and filtering when crawling all orders.
658
+ * @readonly
659
+ */
660
+ numericId?: string;
661
+ /**
662
+ * Refund information.
663
+ * @readonly
664
+ */
665
+ refunds?: V2Refund[];
666
+ }
667
+ /** Buyer Info */
668
+ export interface BuyerInfo {
669
+ /**
670
+ * Wix customer ID
671
+ * @format GUID
672
+ */
673
+ _id?: string | null;
674
+ /**
675
+ * Deprecated (use identityType instead)
676
+ * @readonly
677
+ * @deprecated
678
+ */
679
+ type?: IdentityType;
680
+ /** Customer type */
681
+ identityType?: IdentityType;
682
+ /**
683
+ * Customer's first name
684
+ * @readonly
685
+ */
686
+ firstName?: string;
687
+ /**
688
+ * Customer's last name
689
+ * @readonly
690
+ */
691
+ lastName?: string;
692
+ /**
693
+ * Customer's phone number
694
+ * @readonly
695
+ */
696
+ phone?: string | null;
697
+ /**
698
+ * Customer's email address
699
+ * @readonly
700
+ */
701
+ email?: string;
702
+ }
703
+ export declare enum IdentityType {
704
+ UNSPECIFIED_IDENTITY_TYPE = "UNSPECIFIED_IDENTITY_TYPE",
705
+ /** Site member */
706
+ MEMBER = "MEMBER",
707
+ /** Contact */
708
+ CONTACT = "CONTACT"
709
+ }
710
+ export declare enum WeightUnit {
711
+ /** Weight unit can't be classified due to an error. */
712
+ UNSPECIFIED_WEIGHT_UNIT = "UNSPECIFIED_WEIGHT_UNIT",
713
+ /** Kilograms. */
714
+ KG = "KG",
715
+ /** Pounds. */
716
+ LB = "LB"
717
+ }
718
+ export interface Totals {
719
+ /**
720
+ * Subtotal of all the line items, before tax.
721
+ * @format DECIMAL_VALUE
722
+ */
723
+ subtotal?: string;
724
+ /**
725
+ * Total shipping price, before tax.
726
+ * @format DECIMAL_VALUE
727
+ */
728
+ shipping?: string | null;
729
+ /**
730
+ * Total tax.
731
+ * @format DECIMAL_VALUE
732
+ */
733
+ tax?: string | null;
734
+ /**
735
+ * Total calculated discount value.
736
+ * @format DECIMAL_VALUE
737
+ */
738
+ discount?: string | null;
739
+ /**
740
+ * Total price charged.
741
+ * @format DECIMAL_VALUE
742
+ */
743
+ total?: string;
744
+ /**
745
+ * Total items weight.
746
+ * @readonly
747
+ */
748
+ weight?: string;
749
+ /**
750
+ * Total number of line items.
751
+ * @readonly
752
+ */
753
+ quantity?: number;
754
+ /**
755
+ * Total refund.
756
+ * @format DECIMAL_VALUE
757
+ * @readonly
758
+ */
759
+ refund?: string | null;
760
+ /**
761
+ * Total calculated gift card value.
762
+ * @format DECIMAL_VALUE
763
+ */
764
+ giftCard?: string | null;
765
+ }
766
+ export interface BillingInfo {
767
+ /**
768
+ * Payment method used for this order
769
+ * @maxLength 50
770
+ */
771
+ paymentMethod?: string | null;
772
+ /**
773
+ * Deprecated (use paymentProviderTransactionId instead)
774
+ * @readonly
775
+ * @deprecated
776
+ */
777
+ externalTransactionId?: string | null;
778
+ /**
779
+ * Transaction ID from payment provider (e.g., PayPal, Square, Stripe) transaction ID
780
+ * @maxLength 100
781
+ */
782
+ paymentProviderTransactionId?: string | null;
783
+ /**
784
+ * Transaction ID from payment gateway (e.g., Wix Payments)
785
+ * @maxLength 100
786
+ */
787
+ paymentGatewayTransactionId?: string | null;
788
+ /** Full billing address */
789
+ address?: Address;
790
+ /**
791
+ * Payment date
792
+ * @readonly
793
+ */
794
+ paidDate?: Date | null;
795
+ /** Whether order can be refunded by payment provider (manually or automatic) */
796
+ refundableByPaymentProvider?: boolean | null;
797
+ }
798
+ export interface Address extends AddressAddressLine1OptionsOneOf {
799
+ /**
800
+ * Address line 1 (free text)
801
+ * @maxLength 1000
802
+ */
803
+ addressLine1?: string;
804
+ /** Address line 1 (street) */
805
+ street?: Street;
806
+ /** Addressee name */
807
+ fullName?: FullName;
808
+ /**
809
+ * Country code (2 letters)
810
+ * @format COUNTRY
811
+ */
812
+ country?: string | null;
813
+ /**
814
+ * State or district
815
+ * @maxLength 50
816
+ */
817
+ subdivision?: string | null;
818
+ /**
819
+ * City name
820
+ * @maxLength 150
821
+ */
822
+ city?: string | null;
823
+ /**
824
+ * ZIP/postal code
825
+ * @maxLength 200
826
+ */
827
+ zipCode?: string | null;
828
+ /**
829
+ * Phone number
830
+ * @maxLength 200
831
+ */
832
+ phone?: string | null;
833
+ /**
834
+ * Company name
835
+ * @maxLength 500
836
+ */
837
+ company?: string | null;
838
+ /**
839
+ * Email address
840
+ * @maxLength 500
841
+ */
842
+ email?: string | null;
843
+ /**
844
+ * address line
845
+ * @maxLength 250
846
+ */
847
+ addressLine2?: string | null;
848
+ /** Tax information (for Brazil only) */
849
+ vatId?: VatId;
850
+ }
851
+ /** @oneof */
852
+ export interface AddressAddressLine1OptionsOneOf {
853
+ /**
854
+ * Address line 1 (free text)
855
+ * @maxLength 1000
856
+ */
857
+ addressLine1?: string;
858
+ /** Address line 1 (street) */
859
+ street?: Street;
860
+ }
861
+ export interface FullName {
862
+ /**
863
+ * Customer's first name
864
+ * @maxLength 1000
865
+ */
866
+ firstName?: string;
867
+ /**
868
+ * Customer's last name
869
+ * @maxLength 1000
870
+ */
871
+ lastName?: string;
872
+ }
873
+ export interface Street {
874
+ /**
875
+ * Street number
876
+ * @maxLength 500
877
+ */
878
+ number?: string;
879
+ /**
880
+ * Street name
881
+ * @maxLength 1000
882
+ */
883
+ name?: string;
884
+ }
885
+ export interface VatId {
886
+ /**
887
+ * Customer's tax ID.
888
+ * @maxLength 50
889
+ */
890
+ number?: string;
891
+ /**
892
+ * Tax type.
893
+ * + `CPF`: For individual tax payers.
894
+ * + `CNPJ`: For corporations.
895
+ */
896
+ type?: VatType;
897
+ }
898
+ /** Brazilian tax info types */
899
+ export declare enum VatType {
900
+ /** When the tax info type can't be classified, due to an error */
901
+ UNSPECIFIED_TAX_TYPE = "UNSPECIFIED_TAX_TYPE",
902
+ /** CPF - for individual tax payers */
903
+ CPF = "CPF",
904
+ /** CNPJ - for corporations */
905
+ CNPJ = "CNPJ"
906
+ }
907
+ export interface ShippingInfo extends ShippingInfoDetailsOneOf {
908
+ /** Shipment details (when this object describes shipment). */
909
+ shipmentDetails?: ShipmentDetails;
910
+ /** Pickup details (when this object describes pickup). */
911
+ pickupDetails?: PickupDetails;
912
+ /**
913
+ * Shipping option name.
914
+ * @maxLength 1000
915
+ */
916
+ deliveryOption?: string;
917
+ /**
918
+ * Shipping option delivery time.
919
+ * @maxLength 500
920
+ */
921
+ estimatedDeliveryTime?: string | null;
922
+ /**
923
+ * Deprecated - Latest expected delivery date.
924
+ * @deprecated
925
+ */
926
+ deliverByDate?: Date | null;
927
+ /**
928
+ * Shipping region.
929
+ * @maxLength 100
930
+ */
931
+ shippingRegion?: string | null;
932
+ /**
933
+ * Unique code of provided shipping option. For example, `"usps_std_overnight"`.
934
+ * @maxLength 100
935
+ * @readonly
936
+ */
937
+ code?: string | null;
938
+ }
939
+ /** @oneof */
940
+ export interface ShippingInfoDetailsOneOf {
941
+ /** Shipment details (when this object describes shipment). */
942
+ shipmentDetails?: ShipmentDetails;
943
+ /** Pickup details (when this object describes pickup). */
944
+ pickupDetails?: PickupDetails;
945
+ }
946
+ export interface ShipmentDetails {
947
+ /** Shipping destination address. */
948
+ address?: Address;
949
+ /**
950
+ * Deprecated (use fulfillments instead).
951
+ * @readonly
952
+ * @deprecated
953
+ */
954
+ trackingInfo?: TrackingInfo;
955
+ /**
956
+ * Discount applied for shipping.
957
+ * @format DECIMAL_VALUE
958
+ */
959
+ discount?: string | null;
960
+ /**
961
+ * Tax applied for shipping.
962
+ * @format DECIMAL_VALUE
963
+ */
964
+ tax?: string | null;
965
+ /** Price data. */
966
+ priceData?: ShippingPriceData;
967
+ }
968
+ export interface TrackingInfo {
969
+ /**
970
+ * Tracking number
971
+ * @maxLength 100
972
+ * @readonly
973
+ */
974
+ trackingNumber?: string | null;
975
+ /**
976
+ * Shipping provider
977
+ * @maxLength 100
978
+ * @readonly
979
+ */
980
+ shippingProvider?: string | null;
981
+ /**
982
+ * Tracking link
983
+ * @format WEB_URL
984
+ * @readonly
985
+ */
986
+ trackingLink?: string | null;
987
+ }
988
+ export interface ShippingPriceData {
989
+ /** Whether tax is included in the price. */
990
+ taxIncludedInPrice?: boolean;
991
+ /**
992
+ * Shipping price.
993
+ * @format DECIMAL_VALUE
994
+ */
995
+ price?: string | null;
996
+ }
997
+ export interface PickupDetails {
998
+ /** Pickup address. */
999
+ pickupAddress?: PickupAddress;
1000
+ /**
1001
+ * Deprecated (use billingInfo instead).
1002
+ * @readonly
1003
+ * @deprecated
1004
+ */
1005
+ buyerDetails?: BuyerDetails;
1006
+ /**
1007
+ * Store owner's pickup instructions.
1008
+ * @maxLength 1000
1009
+ */
1010
+ pickupInstructions?: string | null;
1011
+ }
1012
+ export interface PickupAddress {
1013
+ /** Country code (3 letters) */
1014
+ country?: string;
1015
+ /**
1016
+ * State/District
1017
+ * @maxLength 50
1018
+ */
1019
+ subdivision?: string | null;
1020
+ /**
1021
+ * Address
1022
+ * @maxLength 250
1023
+ */
1024
+ addressLine1?: string;
1025
+ /**
1026
+ * City
1027
+ * @maxLength 100
1028
+ */
1029
+ city?: string;
1030
+ /**
1031
+ * ZIP/postal code
1032
+ * @maxLength 50
1033
+ */
1034
+ zipCode?: string;
1035
+ }
1036
+ export interface BuyerDetails {
1037
+ /** Addressee name */
1038
+ fullName?: FullName;
1039
+ /**
1040
+ * Email address
1041
+ * @maxLength 100
1042
+ * @format EMAIL
1043
+ */
1044
+ email?: string;
1045
+ /**
1046
+ * Phone number
1047
+ * @maxLength 30
1048
+ * @format PHONE
1049
+ */
1050
+ phone?: string;
1051
+ }
1052
+ /** This might be extended in the future with pending orders statuses */
1053
+ export declare enum PaymentStatus {
1054
+ /** Payment status can't be classified, due to an error */
1055
+ UNSPECIFIED_PAYMENT_STATUS = "UNSPECIFIED_PAYMENT_STATUS",
1056
+ /** Order is pending response from the payment provider */
1057
+ PENDING = "PENDING",
1058
+ /** Order is marked as not paid, and can be marked as paid later on. This is relevant for POS and offline orders */
1059
+ NOT_PAID = "NOT_PAID",
1060
+ /** The order is marked as paid */
1061
+ PAID = "PAID",
1062
+ /** Order was refunded, refund amount less than order total price */
1063
+ PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED",
1064
+ /** Full order total price was refunded */
1065
+ FULLY_REFUNDED = "FULLY_REFUNDED",
1066
+ /** At least one payment was received and approved, covering less than total price amount */
1067
+ PARTIALLY_PAID = "PARTIALLY_PAID"
1068
+ }
1069
+ export declare enum FulfillmentStatus {
1070
+ /** None of the order items are fulfilled */
1071
+ NOT_FULFILLED = "NOT_FULFILLED",
1072
+ /**
1073
+ * All of the order items are fulfilled
1074
+ * Orders without shipping info are fulfilled automatically
1075
+ */
1076
+ FULFILLED = "FULFILLED",
1077
+ /** Order is canceled */
1078
+ CANCELED = "CANCELED",
1079
+ /** Some, but not all of the order items are fulfilled */
1080
+ PARTIALLY_FULFILLED = "PARTIALLY_FULFILLED"
1081
+ }
1082
+ export interface LineItem {
1083
+ /**
1084
+ * Line item ID (auto-generated, stable within this order only)
1085
+ * @readonly
1086
+ */
1087
+ index?: number | null;
1088
+ /**
1089
+ * Line item quantity
1090
+ * @min 1
1091
+ * @max 100000
1092
+ */
1093
+ quantity?: number;
1094
+ /**
1095
+ * Deprecated (use priceData instead)
1096
+ * @format DECIMAL_VALUE
1097
+ * @readonly
1098
+ * @deprecated
1099
+ */
1100
+ price?: string | null;
1101
+ /**
1102
+ * Line item name
1103
+ * @minLength 1
1104
+ * @maxLength 200
1105
+ */
1106
+ name?: string | null;
1107
+ /** Product name, translated into the customer's language */
1108
+ translatedName?: string | null;
1109
+ /**
1110
+ * Line item product ID (optional for POS orders)
1111
+ * @minLength 1
1112
+ */
1113
+ productId?: string | null;
1114
+ /**
1115
+ * Deprecated (use priceData instead)
1116
+ * @format DECIMAL_VALUE
1117
+ * @readonly
1118
+ * @deprecated
1119
+ */
1120
+ totalPrice?: string | null;
1121
+ /** Line item type (may be extended) */
1122
+ lineItemType?: LineItemType;
1123
+ /**
1124
+ * Line item options ordered
1125
+ * @maxSize 500
1126
+ */
1127
+ options?: OptionSelection[];
1128
+ /**
1129
+ * Line item custom text field entry
1130
+ * @maxSize 500
1131
+ */
1132
+ customTextFields?: CustomTextFieldSelection[];
1133
+ /**
1134
+ * Line item weight
1135
+ * @format DECIMAL_VALUE
1136
+ */
1137
+ weight?: string | null;
1138
+ /** Primary media for preview of the line item */
1139
+ mediaItem?: MediaItem;
1140
+ /**
1141
+ * Line item SKU
1142
+ * @maxLength 40
1143
+ */
1144
+ sku?: string | null;
1145
+ /**
1146
+ * Line item notes
1147
+ * @maxLength 1000
1148
+ */
1149
+ notes?: string | null;
1150
+ /** Line item variantId (from Stores Catalog) */
1151
+ variantId?: string | null;
1152
+ /**
1153
+ * Line item fulfillerId from stores fulfillers. No value equals self fulfilled
1154
+ * @format GUID
1155
+ */
1156
+ fulfillerId?: string | null;
1157
+ /**
1158
+ * Discount applied for this line item
1159
+ * @format DECIMAL_VALUE
1160
+ */
1161
+ discount?: string | null;
1162
+ /**
1163
+ * Tax applied for this line item
1164
+ * @format DECIMAL_VALUE
1165
+ */
1166
+ tax?: string | null;
1167
+ /**
1168
+ * Deprecated (use priceData instead)
1169
+ * @readonly
1170
+ * @deprecated
1171
+ */
1172
+ taxIncludedInPrice?: boolean;
1173
+ /**
1174
+ * Tax group ID
1175
+ * @format GUID
1176
+ */
1177
+ taxGroupId?: string | null;
1178
+ /** Price data */
1179
+ priceData?: LineItemPriceData;
1180
+ }
1181
+ export declare enum LineItemType {
1182
+ /** Line item type can't be classified, due to an error */
1183
+ UNSPECIFIED_LINE_ITEM_TYPE = "UNSPECIFIED_LINE_ITEM_TYPE",
1184
+ /** Physical item type */
1185
+ PHYSICAL = "PHYSICAL",
1186
+ /** Digital item type */
1187
+ DIGITAL = "DIGITAL",
1188
+ /** Custom item price */
1189
+ CUSTOM_AMOUNT_ITEM = "CUSTOM_AMOUNT_ITEM"
1190
+ }
1191
+ export interface OptionSelection {
1192
+ /**
1193
+ * Option name
1194
+ * @maxLength 1000
1195
+ */
1196
+ option?: string;
1197
+ /**
1198
+ * Selected choice for this option
1199
+ * @maxLength 16000
1200
+ */
1201
+ selection?: string;
1202
+ }
1203
+ export interface CustomTextFieldSelection {
1204
+ /**
1205
+ * Custom text field name
1206
+ * @maxLength 1000
1207
+ */
1208
+ title?: string;
1209
+ /**
1210
+ * Custom text field value
1211
+ * @maxLength 16000
1212
+ */
1213
+ value?: string;
1214
+ }
1215
+ export interface MediaItem {
1216
+ /**
1217
+ * Media type
1218
+ * @readonly
1219
+ */
1220
+ mediaType?: MediaItemType;
1221
+ /**
1222
+ * Media URL
1223
+ * @format WEB_URL
1224
+ * @readonly
1225
+ */
1226
+ url?: string;
1227
+ /**
1228
+ * Media item width
1229
+ * @readonly
1230
+ */
1231
+ width?: number;
1232
+ /**
1233
+ * Media item height
1234
+ * @readonly
1235
+ */
1236
+ height?: number;
1237
+ /**
1238
+ * Deprecated
1239
+ * @deprecated
1240
+ */
1241
+ mediaId?: string | null;
1242
+ /** Media ID (for media items previously saved in Wix Media) */
1243
+ _id?: string | null;
1244
+ /** Media external URL */
1245
+ externalImageUrl?: string | null;
1246
+ /**
1247
+ * Alternative text for presentation when media cannot be displayed
1248
+ * @maxLength 256
1249
+ */
1250
+ altText?: string | null;
1251
+ }
1252
+ export declare enum MediaItemType {
1253
+ /** Media item type can't be classified, due to an error */
1254
+ UNSPECIFIED_MEDIA_TYPE_ITEM = "UNSPECIFIED_MEDIA_TYPE_ITEM",
1255
+ /** Image item type */
1256
+ IMAGE = "IMAGE"
1257
+ }
1258
+ export interface LineItemPriceData {
1259
+ /** Whether tax is included in the price set for this line item */
1260
+ taxIncludedInPrice?: boolean;
1261
+ /**
1262
+ * Line item price
1263
+ * @format DECIMAL_VALUE
1264
+ */
1265
+ price?: string;
1266
+ /**
1267
+ * Total price charged to the customer (per line item) after computation of quantity and discount
1268
+ * @format DECIMAL_VALUE
1269
+ * @readonly
1270
+ */
1271
+ totalPrice?: string | null;
1272
+ }
1273
+ export interface DigitalFile {
1274
+ /**
1275
+ * id of the secure file in media
1276
+ * @minLength 1
1277
+ * @maxLength 100
1278
+ */
1279
+ fileId?: string;
1280
+ }
1281
+ export interface Activity {
1282
+ /**
1283
+ * Activity item type
1284
+ * @readonly
1285
+ */
1286
+ type?: ActivityType;
1287
+ /**
1288
+ * Activity item author
1289
+ * @maxLength 50
1290
+ * @readonly
1291
+ */
1292
+ author?: string | null;
1293
+ /**
1294
+ * Comment added to activity item
1295
+ * @maxLength 1000
1296
+ * @readonly
1297
+ */
1298
+ message?: string | null;
1299
+ /**
1300
+ * Activity item timestamp
1301
+ * @readonly
1302
+ */
1303
+ timestamp?: Date | null;
1304
+ }
1305
+ export declare enum ActivityType {
1306
+ /** Activity item type can't be classified, due to an error */
1307
+ UNSPECIFIED_ORDER_HISTORY_ITEM_TYPE = "UNSPECIFIED_ORDER_HISTORY_ITEM_TYPE",
1308
+ /** Store owner added a comment */
1309
+ MERCHANT_COMMENT = "MERCHANT_COMMENT",
1310
+ /** Order placed */
1311
+ ORDER_PLACED = "ORDER_PLACED",
1312
+ /** Order marked as paid, either by the store owner (for offline orders), or when an online transaction was confirmed */
1313
+ ORDER_PAID = "ORDER_PAID",
1314
+ /** Order shipping status set as fulfilled */
1315
+ ORDER_FULFILLED = "ORDER_FULFILLED",
1316
+ /** Order shipping status set as not fulfilled */
1317
+ ORDER_NOT_FULFILLED = "ORDER_NOT_FULFILLED",
1318
+ /** A download link was sent (relevant for orders with digital line items) */
1319
+ DOWNLOAD_LINK_SENT = "DOWNLOAD_LINK_SENT",
1320
+ /** An email notification for pickup was sent */
1321
+ PICKUP_READY_EMAIL_SENT = "PICKUP_READY_EMAIL_SENT",
1322
+ /** Shipping tracking number was set */
1323
+ TRACKING_NUMBER_ADDED = "TRACKING_NUMBER_ADDED",
1324
+ /** Shipping tracking number was edited */
1325
+ TRACKING_NUMBER_EDITED = "TRACKING_NUMBER_EDITED",
1326
+ /** Shipping tracking link was set */
1327
+ TRACKING_LINK_WAS_SET = "TRACKING_LINK_WAS_SET",
1328
+ /** An email confirmation of order shipment was sent */
1329
+ SHIPPING_CONFIRMATION_EMAIL_SENT = "SHIPPING_CONFIRMATION_EMAIL_SENT",
1330
+ /** Invoice was set in the order */
1331
+ INVOICE_WAS_SET = "INVOICE_WAS_SET",
1332
+ /** Invoice was removed from the order */
1333
+ INVOICE_WAS_REMOVED = "INVOICE_WAS_REMOVED",
1334
+ /** Invoice was sent to customer via email */
1335
+ INVOICE_WAS_SENT = "INVOICE_WAS_SENT",
1336
+ /** Email was sent to fulfiller */
1337
+ FULFILLER_EMAIL_SENT = "FULFILLER_EMAIL_SENT",
1338
+ /** Shipping address was updated */
1339
+ SHIPPING_ADDRESS_EDITED = "SHIPPING_ADDRESS_EDITED",
1340
+ /** Order email was updated */
1341
+ EMAIL_EDITED = "EMAIL_EDITED",
1342
+ /** Order partially paid. During the checkout for orders with deposit items. */
1343
+ ORDER_PARTIALLY_PAID = "ORDER_PARTIALLY_PAID"
1344
+ }
1345
+ export interface V2InvoiceInfo {
1346
+ /**
1347
+ * Invoice ID
1348
+ * @maxLength 100
1349
+ */
1350
+ _id?: string;
1351
+ /** Invoice source */
1352
+ source?: InvoiceSource;
1353
+ }
1354
+ export declare enum InvoiceSource {
1355
+ /** Invoice source can't be classified, due to an error */
1356
+ UNSPECIFIED_INVOICE_SOURCE = "UNSPECIFIED_INVOICE_SOURCE",
1357
+ /** Invoice created using the Invoices API */
1358
+ WIX = "WIX"
1359
+ }
1360
+ export interface Fulfillment {
1361
+ /**
1362
+ * Fulfillment ID (auto generated upon fulfillment creation).
1363
+ * @format GUID
1364
+ * @readonly
1365
+ */
1366
+ _id?: string | null;
1367
+ /**
1368
+ * Fulfillment creation date and time.
1369
+ * @readonly
1370
+ */
1371
+ dateCreated?: Date | null;
1372
+ /**
1373
+ * Information about the line items in the fulfilled order.
1374
+ * @minSize 1
1375
+ * @maxSize 300
1376
+ */
1377
+ lineItems?: FulfillmentLineItem[];
1378
+ /** Tracking information. */
1379
+ trackingInfo?: FulfillmentTrackingInfo;
1380
+ }
1381
+ export interface FulfillmentLineItem {
1382
+ /**
1383
+ * Line item ID (mirrors the line item index of the order).
1384
+ * @min 1
1385
+ * @max 200
1386
+ */
1387
+ index?: number;
1388
+ /**
1389
+ * Line item quantity.
1390
+ * On creation, if this parameter isn't passed, the new fulfillment will automatically include all items of this line item that have not already been linked to a fulfillment.
1391
+ * If the order does not have the requested quantity of line items available to add to this fulfillment, the fulfillment will not be created and an error will be returned.
1392
+ * This property will always have a value when returned.
1393
+ * @min 1
1394
+ * @max 100000
1395
+ */
1396
+ quantity?: number | null;
1397
+ }
1398
+ export interface FulfillmentTrackingInfo {
1399
+ /**
1400
+ * Tracking number.
1401
+ * @minLength 1
1402
+ * @maxLength 100
1403
+ */
1404
+ trackingNumber?: string;
1405
+ /**
1406
+ * Shipping provider. Using the following shipping providers will allow for autofilling the tracking link:
1407
+ * * `fedex`
1408
+ * * `ups`
1409
+ * * `usps`
1410
+ * * `dhl`
1411
+ * * `canadaPost`
1412
+ * @minLength 1
1413
+ * @maxLength 100
1414
+ */
1415
+ shippingProvider?: string;
1416
+ /**
1417
+ * Tracking link - autofilled if using a predefined shipping provider, otherwise provided on creation.
1418
+ * @minLength 1
1419
+ * @maxLength 2048
1420
+ * @format WEB_URL
1421
+ */
1422
+ trackingLink?: string | null;
1423
+ }
1424
+ export interface Discount {
1425
+ /**
1426
+ * Deprecated (use Totals.discount instead)
1427
+ * @readonly
1428
+ * @deprecated
1429
+ */
1430
+ value?: string;
1431
+ /** Applied coupon */
1432
+ appliedCoupon?: AppliedCoupon;
1433
+ }
1434
+ export interface AppliedCoupon {
1435
+ /**
1436
+ * Coupon ID
1437
+ * @minLength 1
1438
+ * @maxLength 100
1439
+ */
1440
+ couponId?: string;
1441
+ /**
1442
+ * Coupon name
1443
+ * @maxLength 100
1444
+ */
1445
+ name?: string;
1446
+ /**
1447
+ * Coupon code
1448
+ * @maxLength 100
1449
+ */
1450
+ code?: string;
1451
+ }
1452
+ /** Custom field */
1453
+ export interface CustomField {
1454
+ /**
1455
+ * Free text that the customer entered in the custom field during the checkout process
1456
+ * @maxLength 2000
1457
+ */
1458
+ value?: string;
1459
+ /**
1460
+ * Title for the custom field
1461
+ * @maxLength 1000
1462
+ */
1463
+ title?: string;
1464
+ /**
1465
+ * The title translated according to the buyer language
1466
+ * @maxLength 1000
1467
+ */
1468
+ translatedTitle?: string;
1469
+ }
1470
+ export interface ChannelInfo {
1471
+ /** Sales channel that submitted the order */
1472
+ type?: ChannelType;
1473
+ /**
1474
+ * Reference to an order ID from an external system, as defined in channelInfo (e.g., eBay or Amazon)
1475
+ * @maxLength 100
1476
+ */
1477
+ externalOrderId?: string | null;
1478
+ /**
1479
+ * URL to the order in the external system, as defined in channelInfo (e.g., eBay or Amazon)
1480
+ * @maxLength 300
1481
+ */
1482
+ externalOrderUrl?: string | null;
1483
+ }
1484
+ export declare enum ChannelType {
1485
+ UNSPECIFIED = "UNSPECIFIED",
1486
+ WEB = "WEB",
1487
+ POS = "POS",
1488
+ EBAY = "EBAY",
1489
+ AMAZON = "AMAZON",
1490
+ OTHER_PLATFORM = "OTHER_PLATFORM",
1491
+ WIX_APP_STORE = "WIX_APP_STORE",
1492
+ WIX_INVOICES = "WIX_INVOICES",
1493
+ BACKOFFICE_MERCHANT = "BACKOFFICE_MERCHANT",
1494
+ WISH = "WISH",
1495
+ CLASS_PASS = "CLASS_PASS",
1496
+ GLOBAL_E = "GLOBAL_E",
1497
+ FACEBOOK = "FACEBOOK",
1498
+ ETSY = "ETSY",
1499
+ TIKTOK = "TIKTOK",
1500
+ FAIRE_COM = "FAIRE_COM"
1501
+ }
1502
+ export interface EnteredBy {
1503
+ /** @format GUID */
1504
+ _id?: string;
1505
+ identityType?: EnteredByIdentityType;
1506
+ }
1507
+ export declare enum EnteredByIdentityType {
1508
+ USER = "USER",
1509
+ MEMBER = "MEMBER",
1510
+ CONTACT = "CONTACT",
1511
+ APP = "APP"
1512
+ }
1513
+ export interface SubscriptionInfo {
1514
+ /**
1515
+ * Subscription ID.
1516
+ * @format GUID
1517
+ */
1518
+ _id?: string | null;
1519
+ /**
1520
+ * Current cycle number. For example, if the subscription is in the 3rd month of a 4-month subscription, the value will be `3`.
1521
+ * @min 1
1522
+ */
1523
+ cycleNumber?: number;
1524
+ /** Subscription settings. */
1525
+ subscriptionSettings?: SubscriptionSettings;
1526
+ /** Subscription options info. */
1527
+ subscriptionOptionInfo?: SubscriptionOptionInfo;
1528
+ }
1529
+ export interface SubscriptionSettings {
1530
+ /** Frequency of recurring payment. */
1531
+ frequency?: SubscriptionFrequency;
1532
+ /** Whether subscription is renewed automatically at the end of each period. */
1533
+ autoRenewal?: boolean;
1534
+ /**
1535
+ * Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`.
1536
+ * @min 2
1537
+ * @max 999
1538
+ */
1539
+ billingCycles?: number | null;
1540
+ }
1541
+ /** Frequency unit of recurring payment */
1542
+ export declare enum SubscriptionFrequency {
1543
+ UNDEFINED = "UNDEFINED",
1544
+ DAY = "DAY",
1545
+ WEEK = "WEEK",
1546
+ MONTH = "MONTH",
1547
+ YEAR = "YEAR"
1548
+ }
1549
+ export interface SubscriptionOptionInfo {
1550
+ /**
1551
+ * Subscription option title.
1552
+ * @minLength 1
1553
+ * @maxLength 150
1554
+ */
1555
+ title?: string;
1556
+ /**
1557
+ * Subscription option description.
1558
+ * @maxLength 500
1559
+ */
1560
+ description?: string | null;
1561
+ }
1562
+ export interface V2Refund {
1563
+ /** Refund created timestamp. */
1564
+ dateCreated?: Date | null;
1565
+ /**
1566
+ * Refund amount.
1567
+ * @format DECIMAL_VALUE
1568
+ */
1569
+ amount?: string;
1570
+ /** Reason for refund, given by user (optional). */
1571
+ reason?: string | null;
1572
+ /** Payment provider transaction ID. Used to find refund transaction info on the payment provider's side. */
1573
+ paymentProviderTransactionId?: string | null;
1574
+ /**
1575
+ * Refund ID.
1576
+ * @format GUID
1577
+ */
1578
+ _id?: string;
1579
+ /** Whether refund was made externally (on the payment provider's side). */
1580
+ externalRefund?: boolean;
1581
+ }
1582
+ export interface GiftCard {
1583
+ /**
1584
+ * @minLength 1
1585
+ * @maxLength 100
1586
+ */
1587
+ transactionId?: string;
1588
+ /**
1589
+ * giftcard internal ID
1590
+ * @maxLength 36
1591
+ * @deprecated giftcard internal ID
1592
+ * @targetRemovalDate 2024-12-31
1593
+ */
1594
+ _id?: string;
1595
+ /**
1596
+ * giftcard provider appid
1597
+ * @format GUID
1598
+ */
1599
+ providerId?: string;
1600
+ /**
1601
+ * giftcard amount
1602
+ * @format DECIMAL_VALUE
1603
+ */
1604
+ amount?: string;
1605
+ }
1606
+ /** Triggered when a payment is updated. */
1607
+ export interface PaymentsUpdated {
1608
+ /** Updated order transactions. */
1609
+ orderTransactions?: OrderTransactions;
1610
+ /**
1611
+ * List of IDs of the updated payments.
1612
+ * @maxSize 100
1613
+ */
1614
+ paymentIds?: string[];
1615
+ /**
1616
+ * List of IDs of the updated refunds.
1617
+ * @maxSize 300
1618
+ */
1619
+ refundIds?: string[];
1620
+ }
1621
+ /** Triggered when a payment is updated. */
1622
+ export interface PaymentDetailsUpdated {
1623
+ /** Updated order transactions. */
1624
+ orderTransactions?: OrderTransactions;
1625
+ /**
1626
+ * List of IDs of the updated payments.
1627
+ * @format GUID
1628
+ * @maxSize 100
1629
+ */
1630
+ paymentIds?: string[];
1631
+ /**
1632
+ * List of IDs of the updated refunds.
1633
+ * @format GUID
1634
+ * @maxSize 300
1635
+ */
1636
+ refundIds?: string[];
1637
+ }
1638
+ /** Triggered when a refund is created. */
1639
+ export interface RefundCreated {
1640
+ /** Updated order transactions. */
1641
+ orderTransactions?: OrderTransactions;
1642
+ /** ID of the created refund. */
1643
+ refundId?: string;
1644
+ /** Inventory restock details as part of this refund.. */
1645
+ restockInfo?: RestockInfo;
1646
+ /** Whether to send a refund confirmation email to the customer. */
1647
+ sendOrderRefundedEmail?: boolean;
1648
+ /** Custom message added to the refund confirmation email. */
1649
+ customMessage?: string | null;
1650
+ /** Refunded line items and quantities that are part of the created refund. */
1651
+ refundItems?: RefundItem[];
1652
+ }
1653
+ export interface RestockInfo {
1654
+ /** Restock type. */
1655
+ type?: RestockType;
1656
+ /**
1657
+ * Restocked line items and quantities. Only relevant for `{"type": "SOME_ITEMS"}`.
1658
+ * @maxSize 300
1659
+ */
1660
+ items?: RestockItem[];
1661
+ }
1662
+ export declare enum RestockType {
1663
+ NO_ITEMS = "NO_ITEMS",
1664
+ ALL_ITEMS = "ALL_ITEMS",
1665
+ SOME_ITEMS = "SOME_ITEMS"
1666
+ }
1667
+ export interface RestockItem {
1668
+ /**
1669
+ * ID of the line item being restocked.
1670
+ * @format GUID
1671
+ */
1672
+ lineItemId?: string;
1673
+ /**
1674
+ * Line item quantity being restocked.
1675
+ * @min 1
1676
+ * @max 100000
1677
+ */
1678
+ quantity?: number;
1679
+ }
1680
+ export interface RefundCompleted {
1681
+ /**
1682
+ * Order ID.
1683
+ * @format GUID
1684
+ */
1685
+ orderId?: string;
1686
+ /** Completed refund. */
1687
+ refund?: Refund;
1688
+ /** Refund side effects. */
1689
+ sideEffects?: RefundSideEffects;
1690
+ /** Order transactions after refund is completed. */
1691
+ orderTransactions?: OrderTransactions;
1692
+ }
1693
+ export interface RefundSideEffects {
1694
+ /** Inventory restock details as part of this refund. */
1695
+ restockInfo?: RestockInfo;
1696
+ /** Whether to send a refund confirmation email to the customer. */
1697
+ sendOrderRefundedEmail?: boolean;
1698
+ /**
1699
+ * Custom message added to the refund confirmation email.
1700
+ * @minLength 1
1701
+ * @maxLength 1000
1702
+ */
1703
+ customMessage?: string | null;
1704
+ }
1705
+ export interface ListTransactionsForSingleOrderRequest {
1706
+ /**
1707
+ * Order ID.
1708
+ * @minLength 1
1709
+ * @maxLength 100
1710
+ */
1711
+ orderId: string;
1712
+ }
1713
+ export interface ListTransactionsForSingleOrderResponse {
1714
+ /** Order ID and its associated transactions. */
1715
+ orderTransactions?: OrderTransactions;
1716
+ }
1717
+ export interface ListTransactionsForMultipleOrdersRequest {
1718
+ /**
1719
+ * Order IDs for which to retrieve transactions.
1720
+ * @minSize 1
1721
+ * @maxSize 100
1722
+ * @minLength 1
1723
+ * @maxLength 100
1724
+ */
1725
+ orderIds: string[];
1726
+ }
1727
+ export interface ListTransactionsForMultipleOrdersResponse {
1728
+ /** List of order IDs and their associated transactions. */
1729
+ orderTransactions?: OrderTransactions[];
1730
+ }
1731
+ export interface AddPaymentsRequest {
1732
+ /**
1733
+ * Order ID.
1734
+ * @format GUID
1735
+ */
1736
+ orderId: string;
1737
+ /**
1738
+ * Payments to be added to order.
1739
+ * @minSize 1
1740
+ * @maxSize 50
1741
+ */
1742
+ payments: Payment[];
1743
+ }
1744
+ export interface AddPaymentsResponse {
1745
+ /** Order ID and its associated transactions. */
1746
+ orderTransactions?: OrderTransactions;
1747
+ /** IDs of added order payments. */
1748
+ paymentsIds?: string[];
1749
+ }
1750
+ export interface AddRefundRequest {
1751
+ /**
1752
+ * Order ID this refunds related to
1753
+ * @minLength 1
1754
+ * @maxLength 100
1755
+ */
1756
+ orderId?: string;
1757
+ /** Refund with refund transactions to be added to order. */
1758
+ refund?: Refund;
1759
+ /** Side effect details related to refund */
1760
+ sideEffects?: RefundSideEffects;
1761
+ }
1762
+ export interface AddRefundResponse {
1763
+ /** Order ID and its associated transactions. */
1764
+ orderTransactions?: OrderTransactions;
1765
+ /** Created refund ID */
1766
+ refundId?: string;
1767
+ }
1768
+ export interface UpdatePaymentStatusRequest {
1769
+ /**
1770
+ * Order ID.
1771
+ * @format GUID
1772
+ */
1773
+ orderId: string;
1774
+ /**
1775
+ * Payment ID.
1776
+ * @format GUID
1777
+ */
1778
+ paymentId: string;
1779
+ /** Payment status. */
1780
+ status?: TransactionStatus;
1781
+ }
1782
+ export interface UpdatePaymentStatusResponse {
1783
+ /** Order ID and its associated transactions after update. */
1784
+ orderTransactions?: OrderTransactions;
1785
+ }
1786
+ export interface BulkUpdatePaymentStatusesRequest {
1787
+ /**
1788
+ * Order and payment IDs for which to update payment status.
1789
+ * @minSize 1
1790
+ * @maxSize 300
1791
+ */
1792
+ paymentAndOrderIds: PaymentAndOrderId[];
1793
+ /** Whether to return the full payment entity (`results.item`) in the response. */
1794
+ returnFullEntity?: boolean;
1795
+ /** Payment status. */
1796
+ status?: TransactionStatus;
1797
+ }
1798
+ export interface PaymentAndOrderId {
1799
+ /**
1800
+ * Order ID.
1801
+ * @format GUID
1802
+ */
1803
+ orderId?: string;
1804
+ /**
1805
+ * Payment ID.
1806
+ * todo: remove comment once UI will use BulkMarkOrderAsPaid
1807
+ */
1808
+ paymentId?: string;
1809
+ }
1810
+ export interface BulkUpdatePaymentStatusesResponse {
1811
+ /** Bulk operation results. */
1812
+ results?: BulkPaymentResult[];
1813
+ /** Bulk operation metadata. */
1814
+ bulkActionMetadata?: BulkActionMetadata;
1815
+ }
1816
+ export interface BulkPaymentResult {
1817
+ /** Item metadata. */
1818
+ itemMetadata?: ItemMetadata;
1819
+ /** Updated payment. Returned if `return_full_entity` set to `true`. */
1820
+ item?: Payment;
1821
+ }
1822
+ export interface ItemMetadata {
1823
+ /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
1824
+ _id?: string | null;
1825
+ /** Index of the item within the request array. Allows for correlation between request and response items. */
1826
+ originalIndex?: number;
1827
+ /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
1828
+ success?: boolean;
1829
+ /** Details about the error in case of failure. */
1830
+ error?: ApplicationError;
1831
+ }
1832
+ export interface ApplicationError {
1833
+ /** Error code. */
1834
+ code?: string;
1835
+ /** Description of the error. */
1836
+ description?: string;
1837
+ /** Data related to the error. */
1838
+ data?: Record<string, any> | null;
1839
+ }
1840
+ export interface BulkActionMetadata {
1841
+ /** Number of items that were successfully processed. */
1842
+ totalSuccesses?: number;
1843
+ /** Number of items that couldn't be processed. */
1844
+ totalFailures?: number;
1845
+ /** Number of failures without details because detailed failure threshold was exceeded. */
1846
+ undetailedFailures?: number;
1847
+ }
1848
+ export interface UpdateRefundRequest {
1849
+ /**
1850
+ * Order ID.
1851
+ * @format GUID
1852
+ */
1853
+ orderId?: string;
1854
+ /** Refund with updated field values. */
1855
+ refund?: Refund;
1856
+ }
1857
+ export interface UpdateRefundResponse {
1858
+ /** Refund after update. */
1859
+ refund?: Refund;
1860
+ /** Order transactions after update. */
1861
+ orderTransactions?: OrderTransactions;
1862
+ }
1863
+ export interface UpdateRefundTransactionRequest {
1864
+ }
1865
+ export interface UpdateRefundTransactionResponse {
1866
+ }
1867
+ export interface UpdatePaymentsRequest {
1868
+ }
1869
+ export interface MaskedPayment {
1870
+ }
1871
+ export interface UpdatePaymentsResponse {
1872
+ }
1873
+ export interface QueryOrderTransactionsRequest {
1874
+ }
1875
+ export interface CursorQuery extends CursorQueryPagingMethodOneOf {
1876
+ /** 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`. */
1877
+ cursorPaging?: CursorPaging;
1878
+ /** A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf) */
1879
+ filter?: Record<string, any> | null;
1880
+ /**
1881
+ * Sort object in the following format:
1882
+ * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
1883
+ * @maxSize 5
1884
+ */
1885
+ sort?: Sorting[];
1886
+ }
1887
+ /** @oneof */
1888
+ export interface CursorQueryPagingMethodOneOf {
1889
+ /** 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`. */
1890
+ cursorPaging?: CursorPaging;
1891
+ }
1892
+ export interface Sorting {
1893
+ /**
1894
+ * Name of the field to sort by.
1895
+ * @maxLength 512
1896
+ */
1897
+ fieldName?: string;
1898
+ /** Sort order. */
1899
+ order?: SortOrder;
1900
+ }
1901
+ export declare enum SortOrder {
1902
+ /** Ascending order. */
1903
+ ASC = "ASC",
1904
+ /** Descending order. */
1905
+ DESC = "DESC"
1906
+ }
1907
+ export interface CursorPaging {
1908
+ /**
1909
+ * Maximum number of items to return in the results.
1910
+ * @max 100
1911
+ */
1912
+ limit?: number | null;
1913
+ /**
1914
+ * Pointer to the next or previous page in the list of results.
1915
+ *
1916
+ * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
1917
+ * Not relevant for the first request.
1918
+ * @maxLength 16000
1919
+ */
1920
+ cursor?: string | null;
1921
+ }
1922
+ export interface QueryOrderTransactionsResponse {
1923
+ }
1924
+ export interface CursorPagingMetadata {
1925
+ /** Number of items returned in the response. */
1926
+ count?: number | null;
1927
+ /** Cursor strings that point to the next page, previous page, or both. */
1928
+ cursors?: Cursors;
1929
+ /**
1930
+ * Whether there are more pages to retrieve following the current page.
1931
+ *
1932
+ * + `true`: Another page of results can be retrieved.
1933
+ * + `false`: This is the last page.
1934
+ */
1935
+ hasNext?: boolean | null;
1936
+ }
1937
+ export interface Cursors {
1938
+ /**
1939
+ * Cursor string pointing to the next page in the list of results.
1940
+ * @maxLength 16000
1941
+ */
1942
+ next?: string | null;
1943
+ /**
1944
+ * Cursor pointing to the previous page in the list of results.
1945
+ * @maxLength 16000
1946
+ */
1947
+ prev?: string | null;
1948
+ }
1949
+ export interface TriggerRefundRequest {
1950
+ /**
1951
+ * The order this refund related to
1952
+ * @minLength 1
1953
+ * @maxLength 100
1954
+ */
1955
+ orderId?: string;
1956
+ /**
1957
+ * Refund operations information
1958
+ * Currently, only *one* payment refund is supported per request
1959
+ * @minSize 1
1960
+ * @maxSize 1
1961
+ */
1962
+ payments?: PaymentRefund[];
1963
+ /** Business model of a refund */
1964
+ details?: RefundDetails;
1965
+ /** How to restock items as part of this refund */
1966
+ restockInfo?: RestockInfo;
1967
+ /** Should send a confirmation mail to the customer */
1968
+ sendOrderRefundedEmail?: boolean;
1969
+ /**
1970
+ * Personal note added to the email
1971
+ * @minLength 1
1972
+ * @maxLength 1000
1973
+ */
1974
+ customMessage?: string | null;
1975
+ }
1976
+ export interface PaymentRefund {
1977
+ /**
1978
+ * Specific payment within the order to refund
1979
+ * @format GUID
1980
+ */
1981
+ paymentId?: string;
1982
+ /** Refund amount. Not relevant for membership and gift card refunds. */
1983
+ amount?: Price;
1984
+ /**
1985
+ * Whether refund is made externally and manually (on the payment provider's side)
1986
+ * When false (default), the payment gateway will be called in order to make an actual refund, and then the payment will be marked as refunded.
1987
+ * When true, the payment will only be *marked* as refunded, and no actual refund will be performed.
1988
+ */
1989
+ externalRefund?: boolean;
1990
+ }
1991
+ export interface TriggerRefundResponse {
1992
+ /** All order's transactions after the refunds were added */
1993
+ orderTransactions?: OrderTransactions;
1994
+ /** Created refund ID */
1995
+ refundId?: string;
1996
+ }
1997
+ export interface CalculateRefundRequest {
1998
+ /**
1999
+ * Order ID
2000
+ * @minLength 1
2001
+ * @maxLength 100
2002
+ */
2003
+ orderId?: string;
2004
+ /**
2005
+ * Refunded line items and quantity
2006
+ * @maxSize 300
2007
+ */
2008
+ refundItems?: CalculateRefundItemRequest[];
2009
+ /** Should include shipping in refund calculation */
2010
+ refundShipping?: boolean;
2011
+ }
2012
+ export interface CalculateRefundItemRequest {
2013
+ /**
2014
+ * ID of the line item being refunded
2015
+ * @format GUID
2016
+ */
2017
+ lineItemId?: string;
2018
+ /**
2019
+ * How much of that line item is being refunded
2020
+ * @min 1
2021
+ * @max 100000
2022
+ */
2023
+ quantity?: number;
2024
+ /** Should this item be restocked (used for validation purposes) */
2025
+ restock?: boolean;
2026
+ }
2027
+ export interface CalculateRefundResponse {
2028
+ /**
2029
+ * Total refundable amount
2030
+ * @format DECIMAL_VALUE
2031
+ */
2032
+ total?: string;
2033
+ /**
2034
+ * Tax cost of the order
2035
+ * @format DECIMAL_VALUE
2036
+ */
2037
+ tax?: string;
2038
+ /**
2039
+ * Discount given for this order
2040
+ * @format DECIMAL_VALUE
2041
+ */
2042
+ discount?: string;
2043
+ /**
2044
+ * Total cost of the order (without tax)
2045
+ * @format DECIMAL_VALUE
2046
+ */
2047
+ subtotal?: string;
2048
+ /**
2049
+ * Previous refund given on that order
2050
+ * @format DECIMAL_VALUE
2051
+ */
2052
+ previouslyRefundedAmount?: string | null;
2053
+ /** The refundable items of that order */
2054
+ items?: CalculateRefundItemResponse[];
2055
+ }
2056
+ export interface CalculateRefundItemResponse {
2057
+ /** Line item ID */
2058
+ lineItemId?: string;
2059
+ /** The line item's price */
2060
+ lineItemPrice?: number;
2061
+ }
2062
+ export interface GetRefundabilityStatusRequest {
2063
+ /**
2064
+ * Order ID.
2065
+ * @minLength 1
2066
+ * @maxLength 100
2067
+ */
2068
+ orderId?: string;
2069
+ }
2070
+ export interface GetRefundabilityStatusResponse {
2071
+ /**
2072
+ * Refundability details.
2073
+ * @maxSize 1
2074
+ */
2075
+ refundabilities?: Refundability[];
2076
+ /** Whether the order supports refunding per item. */
2077
+ refundablePerItem?: boolean;
2078
+ }
2079
+ export interface Refundability extends RefundabilityAdditionalRefundabilityInfoOneOf {
2080
+ /** Reason why payment is not refundable. */
2081
+ nonRefundableReason?: NonRefundableReason;
2082
+ /** Reason why payment is only refundable manually. */
2083
+ manuallyRefundableReason?: ManuallyRefundableReason;
2084
+ /** Payment ID. */
2085
+ paymentId?: string;
2086
+ /** Payment refundability status. */
2087
+ refundabilityStatus?: RefundableStatus;
2088
+ /** Link to payment provider dashboard. */
2089
+ providerLink?: string | null;
2090
+ }
2091
+ /** @oneof */
2092
+ export interface RefundabilityAdditionalRefundabilityInfoOneOf {
2093
+ /** Reason why payment is not refundable. */
2094
+ nonRefundableReason?: NonRefundableReason;
2095
+ /** Reason why payment is only refundable manually. */
2096
+ manuallyRefundableReason?: ManuallyRefundableReason;
2097
+ }
2098
+ export declare enum RefundableStatus {
2099
+ /** Not refundable. */
2100
+ NOT_REFUNDABLE = "NOT_REFUNDABLE",
2101
+ /** Refundable manually. */
2102
+ MANUAL = "MANUAL",
2103
+ /** Refundable. */
2104
+ REFUNDABLE = "REFUNDABLE"
2105
+ }
2106
+ export declare enum NonRefundableReason {
2107
+ /** No reason. */
2108
+ NONE = "NONE",
2109
+ /** Payment already refunded. */
2110
+ ALREADY_REFUNDED = "ALREADY_REFUNDED",
2111
+ /** Payment provider is down. */
2112
+ PROVIDER_IS_DOWN = "PROVIDER_IS_DOWN",
2113
+ /** Internal error occurred. */
2114
+ INTERNAL_ERROR = "INTERNAL_ERROR",
2115
+ /** Payment not made. */
2116
+ NOT_PAID = "NOT_PAID",
2117
+ /** Access denied. */
2118
+ ACCESS_DENIED = "ACCESS_DENIED",
2119
+ /** Payment amount is zero. */
2120
+ ZERO_PRICE = "ZERO_PRICE",
2121
+ /** Disabled by provider. */
2122
+ DISABLED_BY_PROVIDER = "DISABLED_BY_PROVIDER",
2123
+ /** Payment partially paid. */
2124
+ PARTIALLY_PAID = "PARTIALLY_PAID",
2125
+ /** Deposit for online item. */
2126
+ DEPOSIT_ONLINE_ITEM = "DEPOSIT_ONLINE_ITEM",
2127
+ /** Refund is pending. */
2128
+ PENDING_REFUND = "PENDING_REFUND",
2129
+ /** Action forbidden. */
2130
+ FORBIDDEN = "FORBIDDEN"
2131
+ }
2132
+ export declare enum ManuallyRefundableReason {
2133
+ /** Payment expired. */
2134
+ EXPIRED = "EXPIRED",
2135
+ /** Payment method not supported. */
2136
+ NOT_SUPPORTED = "NOT_SUPPORTED",
2137
+ /** Payment not found. */
2138
+ NOT_FOUND = "NOT_FOUND",
2139
+ /** Payment made offline. */
2140
+ OFFLINE = "OFFLINE",
2141
+ /** Refund requires interaction with card reader. */
2142
+ REQUIRES_CARD_READER = "REQUIRES_CARD_READER"
2143
+ }
2144
+ export interface ListInvoicesForSingleOrderRequest {
2145
+ /**
2146
+ * Order ID.
2147
+ * @minLength 1
2148
+ * @maxLength 100
2149
+ */
2150
+ orderId?: string;
2151
+ }
2152
+ export interface ListInvoicesForSingleOrderResponse {
2153
+ /** List of invoices. */
2154
+ invoices?: InvoiceInfo[];
2155
+ }
2156
+ export interface InvoiceInfo {
2157
+ /** Invoice ID. */
2158
+ _id?: string;
2159
+ /** ID of the app that set the invoice. */
2160
+ appId?: string;
2161
+ /**
2162
+ * Invoice URL.
2163
+ * @deprecated
2164
+ */
2165
+ url?: string | null;
2166
+ /**
2167
+ * Invoice creation date and time.
2168
+ * @deprecated
2169
+ */
2170
+ _createdDate?: Date | null;
2171
+ }
2172
+ export interface ListInvoicesForMultipleOrdersRequest {
2173
+ /**
2174
+ * Order IDs for which to retrieve invoices.
2175
+ * @maxSize 300
2176
+ * @minLength 1
2177
+ * @maxLength 100
2178
+ */
2179
+ orderIds?: string[];
2180
+ }
2181
+ export interface ListInvoicesForMultipleOrdersResponse {
2182
+ /** List of order IDs and their associated invoices. */
2183
+ invoicesForOrder?: InvoicesForOrder[];
2184
+ }
2185
+ export interface InvoicesForOrder {
2186
+ /** Order ID. */
2187
+ orderId?: string;
2188
+ /** Invoices info. */
2189
+ invoicesInfo?: InvoiceInfo[];
2190
+ }
2191
+ export interface GenerateInvoiceRequest {
2192
+ /**
2193
+ * Order ID.
2194
+ * @minLength 1
2195
+ * @maxLength 100
2196
+ */
2197
+ orderId?: string;
2198
+ }
2199
+ export interface GenerateInvoiceResponse {
2200
+ /** Invoice ID. */
2201
+ invoiceId?: string;
2202
+ }
2203
+ export interface BulkGenerateInvoicesRequest {
2204
+ /**
2205
+ * Order IDs.
2206
+ * @minSize 1
2207
+ * @maxSize 100
2208
+ * @minLength 1
2209
+ * @maxLength 100
2210
+ */
2211
+ orderIds?: string[];
2212
+ }
2213
+ export interface BulkGenerateInvoicesResponse {
2214
+ results?: BulkInvoiceResult[];
2215
+ bulkActionMetadata?: BulkActionMetadata;
2216
+ }
2217
+ export interface BulkInvoiceResult {
2218
+ itemMetadata?: ItemMetadata;
2219
+ item?: InvoiceForOrder;
2220
+ }
2221
+ export interface InvoiceForOrder {
2222
+ /** Order ID. */
2223
+ orderId?: string;
2224
+ /** Invoice ID. */
2225
+ invoiceId?: string;
2226
+ }
2227
+ export interface AddInvoiceToOrderRequest {
2228
+ /**
2229
+ * Order ID.
2230
+ * @minLength 1
2231
+ * @maxLength 100
2232
+ */
2233
+ orderId?: string;
2234
+ /** Invoice info. */
2235
+ invoiceInfo?: InvoiceInfo;
2236
+ }
2237
+ export interface AddInvoiceToOrderResponse {
2238
+ /** List of order invoices. */
2239
+ orderInvoices?: InvoiceInfo[];
2240
+ }
2241
+ export interface DomainEvent extends DomainEventBodyOneOf {
2242
+ createdEvent?: EntityCreatedEvent;
2243
+ updatedEvent?: EntityUpdatedEvent;
2244
+ deletedEvent?: EntityDeletedEvent;
2245
+ actionEvent?: ActionEvent;
2246
+ /**
2247
+ * Unique event ID.
2248
+ * Allows clients to ignore duplicate webhooks.
2249
+ */
2250
+ _id?: string;
2251
+ /**
2252
+ * Assumes actions are also always typed to an entity_type
2253
+ * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
2254
+ */
2255
+ entityFqdn?: string;
2256
+ /**
2257
+ * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
2258
+ * This is although the created/updated/deleted notion is duplication of the oneof types
2259
+ * Example: created/updated/deleted/started/completed/email_opened
2260
+ */
2261
+ slug?: string;
2262
+ /** ID of the entity associated with the event. */
2263
+ entityId?: string;
2264
+ /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
2265
+ eventTime?: Date | null;
2266
+ /**
2267
+ * Whether the event was triggered as a result of a privacy regulation application
2268
+ * (for example, GDPR).
2269
+ */
2270
+ triggeredByAnonymizeRequest?: boolean | null;
2271
+ /** If present, indicates the action that triggered the event. */
2272
+ originatedFrom?: string | null;
2273
+ /**
2274
+ * A sequence number defining the order of updates to the underlying entity.
2275
+ * For example, given that some entity was updated at 16:00 and than again at 16:01,
2276
+ * it is guaranteed that the sequence number of the second update is strictly higher than the first.
2277
+ * As the consumer, you can use this value to ensure that you handle messages in the correct order.
2278
+ * To do so, you will need to persist this number on your end, and compare the sequence number from the
2279
+ * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
2280
+ */
2281
+ entityEventSequence?: string | null;
2282
+ }
2283
+ /** @oneof */
2284
+ export interface DomainEventBodyOneOf {
2285
+ createdEvent?: EntityCreatedEvent;
2286
+ updatedEvent?: EntityUpdatedEvent;
2287
+ deletedEvent?: EntityDeletedEvent;
2288
+ actionEvent?: ActionEvent;
2289
+ }
2290
+ export interface EntityCreatedEvent {
2291
+ entity?: string;
2292
+ }
2293
+ export interface RestoreInfo {
2294
+ deletedDate?: Date | null;
2295
+ }
2296
+ export interface EntityUpdatedEvent {
2297
+ /**
2298
+ * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
2299
+ * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
2300
+ * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
2301
+ */
2302
+ currentEntity?: string;
2303
+ }
2304
+ export interface EntityDeletedEvent {
2305
+ /** Entity that was deleted */
2306
+ deletedEntity?: string | null;
2307
+ }
2308
+ export interface ActionEvent {
2309
+ body?: string;
2310
+ }
2311
+ export interface MessageEnvelope {
2312
+ /**
2313
+ * App instance ID.
2314
+ * @format GUID
2315
+ */
2316
+ instanceId?: string | null;
2317
+ /**
2318
+ * Event type.
2319
+ * @maxLength 150
2320
+ */
2321
+ eventType?: string;
2322
+ /** The identification type and identity data. */
2323
+ identity?: IdentificationData;
2324
+ /** Stringify payload. */
2325
+ data?: string;
2326
+ }
2327
+ export interface IdentificationData extends IdentificationDataIdOneOf {
2328
+ /**
2329
+ * ID of a site visitor that has not logged in to the site.
2330
+ * @format GUID
2331
+ */
2332
+ anonymousVisitorId?: string;
2333
+ /**
2334
+ * ID of a site visitor that has logged in to the site.
2335
+ * @format GUID
2336
+ */
2337
+ memberId?: string;
2338
+ /**
2339
+ * ID of a Wix user (site owner, contributor, etc.).
2340
+ * @format GUID
2341
+ */
2342
+ wixUserId?: string;
2343
+ /**
2344
+ * ID of an app.
2345
+ * @format GUID
2346
+ */
2347
+ appId?: string;
2348
+ /** @readonly */
2349
+ identityType?: WebhookIdentityType;
2350
+ }
2351
+ /** @oneof */
2352
+ export interface IdentificationDataIdOneOf {
2353
+ /**
2354
+ * ID of a site visitor that has not logged in to the site.
2355
+ * @format GUID
2356
+ */
2357
+ anonymousVisitorId?: string;
2358
+ /**
2359
+ * ID of a site visitor that has logged in to the site.
2360
+ * @format GUID
2361
+ */
2362
+ memberId?: string;
2363
+ /**
2364
+ * ID of a Wix user (site owner, contributor, etc.).
2365
+ * @format GUID
2366
+ */
2367
+ wixUserId?: string;
2368
+ /**
2369
+ * ID of an app.
2370
+ * @format GUID
2371
+ */
2372
+ appId?: string;
2373
+ }
2374
+ export declare enum WebhookIdentityType {
2375
+ UNKNOWN = "UNKNOWN",
2376
+ ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
2377
+ MEMBER = "MEMBER",
2378
+ WIX_USER = "WIX_USER",
2379
+ APP = "APP"
2380
+ }
2381
+ type OrderTransactionsNonNullablePaths = `orderId` | `payments` | `payments.${number}.regularPaymentDetails.offlinePayment` | `payments.${number}.regularPaymentDetails.status` | `payments.${number}.regularPaymentDetails.savedPaymentMethod` | `payments.${number}.regularPaymentDetails.authorizationDetails.delayedCapture` | `payments.${number}.regularPaymentDetails.authorizationDetails.captures` | `payments.${number}.regularPaymentDetails.authorizationDetails.captures.${number}.status` | `payments.${number}.regularPaymentDetails.authorizationDetails.captures.${number}.amount.amount` | `payments.${number}.regularPaymentDetails.authorizationDetails.captures.${number}.amount.formattedAmount` | `payments.${number}.regularPaymentDetails.authorizationDetails.captures.${number}.failureDetails.failureCode` | `payments.${number}.regularPaymentDetails.authorizationDetails.void.status` | `payments.${number}.regularPaymentDetails.authorizationDetails.void.reason` | `payments.${number}.regularPaymentDetails.authorizationDetails.scheduledAction.actionType` | `payments.${number}.giftcardPaymentDetails.giftCardPaymentId` | `payments.${number}.giftcardPaymentDetails.appId` | `payments.${number}.giftcardPaymentDetails.voided` | `payments.${number}.refundDisabled` | `refunds` | `refunds.${number}._id` | `refunds.${number}.transactions` | `refunds.${number}.transactions.${number}.paymentId` | `refunds.${number}.transactions.${number}.amount.amount` | `refunds.${number}.transactions.${number}.amount.formattedAmount` | `refunds.${number}.transactions.${number}.refundStatus` | `refunds.${number}.transactions.${number}.externalRefund` | `refunds.${number}.details.items` | `refunds.${number}.details.items.${number}.lineItemId` | `refunds.${number}.details.items.${number}.quantity` | `refunds.${number}.details.shippingIncluded` | `refunds.${number}.details.lineItems` | `refunds.${number}.details.lineItems.${number}.lineItemId` | `refunds.${number}.details.lineItems.${number}.quantity` | `refunds.${number}.details.additionalFees` | `refunds.${number}.details.additionalFees.${number}.additionalFeeId` | `refunds.${number}.summary.pending` | `refunds.${number}.summary.breakdown.lineItems` | `refunds.${number}.summary.breakdown.lineItems.${number}.lineItemId`;
2382
+ /**
2383
+ * Retrieves information about payments and refunds associated with a specified order.
2384
+ *
2385
+ *
2386
+ * The `listTransactionsForSingleOrder()` function returns a Promise that resolves when the specified order's transaction records are retrieved.
2387
+ * @param orderId - Order ID.
2388
+ * @public
2389
+ * @requiredField orderId
2390
+ * @permissionId ECOM.READ_TRANSACTIONS
2391
+ * @permissionScope Manage Stores - all permissions
2392
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
2393
+ * @permissionScope Read eCommerce - all read permissions
2394
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.READ-ECOM
2395
+ * @permissionScope Read Orders
2396
+ * @permissionScopeId SCOPE.DC-STORES.READ-ORDERS
2397
+ * @permissionScope Read Stores - all read permissions
2398
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
2399
+ * @permissionScope Manage Restaurants - all permissions
2400
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
2401
+ * @permissionScope Manage eCommerce - all permissions
2402
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
2403
+ * @permissionScope Manage Orders
2404
+ * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
2405
+ * @applicableIdentity APP
2406
+ * @fqn com.wix.ecom.orders.payments.v1.Payments.ListTransactionsForSingleOrder
2407
+ */
2408
+ export declare function listTransactionsForSingleOrder(orderId: string): Promise<NonNullablePaths<ListTransactionsForSingleOrderResponse, {
2409
+ [P in OrderTransactionsNonNullablePaths]: `orderTransactions.${P}`;
2410
+ }[OrderTransactionsNonNullablePaths]>>;
2411
+ /**
2412
+ * Retrieves information about payments and refunds associated with all specified orders.
2413
+ *
2414
+ *
2415
+ * The `listTransactionsForMultipleOrders()` function returns a Promise that resolves when the specified orders' transaction records are retrieved.
2416
+ * @param orderIds - Order IDs for which to retrieve transactions.
2417
+ * @public
2418
+ * @requiredField orderIds
2419
+ * @permissionId ECOM.READ_TRANSACTIONS
2420
+ * @permissionScope Manage Stores - all permissions
2421
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
2422
+ * @permissionScope Read eCommerce - all read permissions
2423
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.READ-ECOM
2424
+ * @permissionScope Read Orders
2425
+ * @permissionScopeId SCOPE.DC-STORES.READ-ORDERS
2426
+ * @permissionScope Read Stores - all read permissions
2427
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
2428
+ * @permissionScope Manage Restaurants - all permissions
2429
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
2430
+ * @permissionScope Manage eCommerce - all permissions
2431
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
2432
+ * @permissionScope Manage Orders
2433
+ * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
2434
+ * @applicableIdentity APP
2435
+ * @fqn com.wix.ecom.orders.payments.v1.Payments.ListTransactionsForMultipleOrders
2436
+ */
2437
+ export declare function listTransactionsForMultipleOrders(orderIds: string[]): Promise<NonNullablePaths<ListTransactionsForMultipleOrdersResponse, {
2438
+ [P in OrderTransactionsNonNullablePaths]: `orderTransactions.${number}.${P}`;
2439
+ }[OrderTransactionsNonNullablePaths]>>;
2440
+ /**
2441
+ * Adds up to 50 payment records to an order.
2442
+ *
2443
+ *
2444
+ * The `addPayments()` function returns a Promise that resolves when the payment records are added to an order.
2445
+ *
2446
+ * > **Note:** This does **NOT** perform the actual charging - the order is only updated with records of the payments.
2447
+ * @param orderId - Order ID.
2448
+ * @param payments - Payments to be added to order.
2449
+ * @public
2450
+ * @requiredField orderId
2451
+ * @requiredField payments
2452
+ * @requiredField payments.amount
2453
+ * @requiredField payments.paymentDetails
2454
+ * @requiredField payments.paymentDetails.giftcardPaymentDetails.giftCardPaymentId
2455
+ * @permissionId ECOM.MODIFY_TRANSACTIONS
2456
+ * @permissionScope Manage Stores - all permissions
2457
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
2458
+ * @permissionScope Manage Restaurants - all permissions
2459
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
2460
+ * @permissionScope Manage eCommerce - all permissions
2461
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
2462
+ * @permissionScope Manage Orders
2463
+ * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
2464
+ * @applicableIdentity APP
2465
+ * @fqn com.wix.ecom.orders.payments.v1.Payments.AddPayments
2466
+ */
2467
+ export declare function addPayments(orderId: string, payments: NonNullablePaths<Payment, `amount` | `giftcardPaymentDetails.giftCardPaymentId`>[]): Promise<NonNullablePaths<AddPaymentsResponse, {
2468
+ [P in OrderTransactionsNonNullablePaths]: `orderTransactions.${P}`;
2469
+ }[OrderTransactionsNonNullablePaths] | `paymentsIds`>>;
2470
+ /**
2471
+ * Updates the status of an order's payment.
2472
+ *
2473
+ *
2474
+ * The `updatePaymentStatus()` function returns a Promise that resolves when the payment status is updated.
2475
+ * @public
2476
+ * @requiredField identifiers
2477
+ * @requiredField identifiers.orderId
2478
+ * @requiredField identifiers.paymentId
2479
+ * @permissionId ECOM.MODIFY_TRANSACTIONS
2480
+ * @permissionScope Manage Stores - all permissions
2481
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
2482
+ * @permissionScope Manage Restaurants - all permissions
2483
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
2484
+ * @permissionScope Manage eCommerce - all permissions
2485
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
2486
+ * @permissionScope Manage Orders
2487
+ * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
2488
+ * @applicableIdentity APP
2489
+ * @fqn com.wix.ecom.orders.payments.v1.Payments.UpdatePaymentStatus
2490
+ */
2491
+ export declare function updatePaymentStatus(identifiers: NonNullablePaths<UpdatePaymentStatusIdentifiers, `orderId` | `paymentId`>, options?: UpdatePaymentStatusOptions): Promise<NonNullablePaths<UpdatePaymentStatusResponse, {
2492
+ [P in OrderTransactionsNonNullablePaths]: `orderTransactions.${P}`;
2493
+ }[OrderTransactionsNonNullablePaths]>>;
2494
+ export interface UpdatePaymentStatusIdentifiers {
2495
+ /**
2496
+ * Payment ID.
2497
+ * @format GUID
2498
+ */
2499
+ paymentId: string;
2500
+ /**
2501
+ * Order ID.
2502
+ * @format GUID
2503
+ */
2504
+ orderId: string;
2505
+ }
2506
+ export interface UpdatePaymentStatusOptions {
2507
+ /** Payment status. */
2508
+ status?: TransactionStatus;
2509
+ }
2510
+ /**
2511
+ * Updates multiple order payments with a specified status.
2512
+ *
2513
+ *
2514
+ * The `bulkUpdatePaymentStatus()` function returns a Promise that resolves when the payment statuses are updated.
2515
+ * @param paymentAndOrderIds - Order and payment IDs for which to update payment status.
2516
+ * @public
2517
+ * @requiredField paymentAndOrderIds
2518
+ * @permissionId ECOM.MODIFY_TRANSACTIONS
2519
+ * @permissionScope Manage Stores - all permissions
2520
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
2521
+ * @permissionScope Manage Restaurants - all permissions
2522
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
2523
+ * @permissionScope Manage eCommerce - all permissions
2524
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
2525
+ * @permissionScope Manage Orders
2526
+ * @permissionScopeId SCOPE.DC-STORES.MANAGE-ORDERS
2527
+ * @applicableIdentity APP
2528
+ * @fqn com.wix.ecom.orders.payments.v1.Payments.BulkUpdatePaymentStatuses
2529
+ */
2530
+ export declare function bulkUpdatePaymentStatuses(paymentAndOrderIds: PaymentAndOrderId[], options?: BulkUpdatePaymentStatusesOptions): Promise<NonNullablePaths<BulkUpdatePaymentStatusesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.regularPaymentDetails.offlinePayment` | `results.${number}.item.regularPaymentDetails.status` | `results.${number}.item.regularPaymentDetails.savedPaymentMethod` | `results.${number}.item.regularPaymentDetails.authorizationDetails.delayedCapture` | `results.${number}.item.regularPaymentDetails.authorizationDetails.captures` | `results.${number}.item.regularPaymentDetails.authorizationDetails.captures.${number}.status` | `results.${number}.item.regularPaymentDetails.authorizationDetails.captures.${number}.amount.amount` | `results.${number}.item.regularPaymentDetails.authorizationDetails.captures.${number}.amount.formattedAmount` | `results.${number}.item.regularPaymentDetails.authorizationDetails.captures.${number}.failureDetails.failureCode` | `results.${number}.item.regularPaymentDetails.authorizationDetails.void.status` | `results.${number}.item.regularPaymentDetails.authorizationDetails.void.reason` | `results.${number}.item.regularPaymentDetails.authorizationDetails.scheduledAction.actionType` | `results.${number}.item.giftcardPaymentDetails.giftCardPaymentId` | `results.${number}.item.giftcardPaymentDetails.appId` | `results.${number}.item.giftcardPaymentDetails.voided` | `results.${number}.item.refundDisabled` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`>>;
2531
+ export interface BulkUpdatePaymentStatusesOptions {
2532
+ /** Whether to return the full payment entity (`results.item`) in the response. */
2533
+ returnFullEntity?: boolean;
2534
+ /** Payment status. */
2535
+ status?: TransactionStatus;
2536
+ }
2537
+ export {};