@wix/auto_sdk_ecom_order-transactions 1.0.0

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