@wix/auto_sdk_ecom_order-payment-requests 1.0.60 → 1.0.62
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/cjs/index.d.ts +33 -16
- package/build/cjs/index.js +100 -0
- package/build/cjs/index.js.map +1 -1
- package/build/cjs/index.typings.d.ts +171 -61
- package/build/cjs/index.typings.js +91 -0
- package/build/cjs/index.typings.js.map +1 -1
- package/build/cjs/meta.d.ts +116 -35
- package/build/cjs/meta.js +65 -0
- package/build/cjs/meta.js.map +1 -1
- package/build/cjs/schemas.d.ts +5 -1
- package/build/cjs/schemas.js +116 -117
- package/build/cjs/schemas.js.map +1 -1
- package/build/es/index.d.mts +33 -16
- package/build/es/index.mjs +99 -0
- package/build/es/index.mjs.map +1 -1
- package/build/es/index.typings.d.mts +171 -61
- package/build/es/index.typings.mjs +90 -0
- package/build/es/index.typings.mjs.map +1 -1
- package/build/es/meta.d.mts +116 -35
- package/build/es/meta.mjs +64 -0
- package/build/es/meta.mjs.map +1 -1
- package/build/es/schemas.d.mts +5 -1
- package/build/es/schemas.mjs +113 -116
- package/build/es/schemas.mjs.map +1 -1
- package/build/internal/cjs/index.d.ts +40 -18
- package/build/internal/cjs/index.js +100 -0
- package/build/internal/cjs/index.js.map +1 -1
- package/build/internal/cjs/index.typings.d.ts +187 -71
- package/build/internal/cjs/index.typings.js +91 -0
- package/build/internal/cjs/index.typings.js.map +1 -1
- package/build/internal/cjs/meta.d.ts +116 -35
- package/build/internal/cjs/meta.js +65 -0
- package/build/internal/cjs/meta.js.map +1 -1
- package/build/internal/cjs/schemas.d.ts +5 -1
- package/build/internal/cjs/schemas.js +116 -117
- package/build/internal/cjs/schemas.js.map +1 -1
- package/build/internal/es/index.d.mts +40 -18
- package/build/internal/es/index.mjs +99 -0
- package/build/internal/es/index.mjs.map +1 -1
- package/build/internal/es/index.typings.d.mts +187 -71
- package/build/internal/es/index.typings.mjs +90 -0
- package/build/internal/es/index.typings.mjs.map +1 -1
- package/build/internal/es/meta.d.mts +116 -35
- package/build/internal/es/meta.mjs +64 -0
- package/build/internal/es/meta.mjs.map +1 -1
- package/build/internal/es/schemas.d.mts +5 -1
- package/build/internal/es/schemas.mjs +113 -116
- package/build/internal/es/schemas.mjs.map +1 -1
- package/package.json +2 -2
|
@@ -9,7 +9,7 @@ interface OrderPaymentRequest {
|
|
|
9
9
|
*/
|
|
10
10
|
_id?: string | null;
|
|
11
11
|
/**
|
|
12
|
-
*
|
|
12
|
+
* Details about the source that created the order payment request.
|
|
13
13
|
* @immutable
|
|
14
14
|
*/
|
|
15
15
|
source?: Source;
|
|
@@ -36,43 +36,47 @@ interface OrderPaymentRequest {
|
|
|
36
36
|
*/
|
|
37
37
|
amount?: Price;
|
|
38
38
|
/**
|
|
39
|
-
*
|
|
39
|
+
* Three-letter currency code in [ISO-4217 alphabetic format](http://en.wikipedia.org/wiki/ISO_4217). Always matches the order's currency.
|
|
40
40
|
* @format CURRENCY
|
|
41
41
|
* @readonly
|
|
42
42
|
*/
|
|
43
43
|
currency?: string;
|
|
44
44
|
/**
|
|
45
|
-
* Payment gateway order
|
|
45
|
+
* Payment gateway order ID associated with this payment request.
|
|
46
46
|
* @readonly
|
|
47
47
|
* @minLength 1
|
|
48
48
|
* @maxLength 100
|
|
49
49
|
*/
|
|
50
50
|
paymentGatewayOrderId?: string | null;
|
|
51
51
|
/**
|
|
52
|
-
* Title
|
|
52
|
+
* Title displayed to the customer on the payment page.
|
|
53
53
|
* @minLength 1
|
|
54
54
|
* @maxLength 200
|
|
55
55
|
*/
|
|
56
56
|
title?: string;
|
|
57
57
|
/**
|
|
58
|
-
* Description
|
|
58
|
+
* Description displayed to the customer on the payment page.
|
|
59
59
|
* @maxLength 300
|
|
60
60
|
*/
|
|
61
61
|
description?: string | null;
|
|
62
62
|
/**
|
|
63
|
-
*
|
|
63
|
+
* Date and time the order payment request expires. If not provided, the order payment request doesn't expire.
|
|
64
64
|
* @immutable
|
|
65
65
|
*/
|
|
66
66
|
expirationDate?: Date | null;
|
|
67
|
-
/**
|
|
67
|
+
/**
|
|
68
|
+
* Custom field data for this order payment request.
|
|
69
|
+
*
|
|
70
|
+
* [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions) must be configured in the app dashboard before they can be accessed with API calls.
|
|
71
|
+
*/
|
|
68
72
|
extendedFields?: ExtendedFields;
|
|
69
73
|
/**
|
|
70
|
-
* Date and time the
|
|
74
|
+
* Date and time the order payment request was created.
|
|
71
75
|
* @readonly
|
|
72
76
|
*/
|
|
73
77
|
_createdDate?: Date | null;
|
|
74
78
|
/**
|
|
75
|
-
* Date and time the
|
|
79
|
+
* Date and time the order payment request was last updated.
|
|
76
80
|
* @readonly
|
|
77
81
|
*/
|
|
78
82
|
_updatedDate?: Date | null;
|
|
@@ -84,14 +88,12 @@ interface OrderPaymentRequest {
|
|
|
84
88
|
*/
|
|
85
89
|
blockedPaymentMethods?: PaymentMethodWithLiterals[];
|
|
86
90
|
/**
|
|
87
|
-
*
|
|
88
|
-
*
|
|
89
|
-
* These actions are optional and may be conditionally rendered based on the client context.
|
|
91
|
+
* Action links rendered by the payment page, such as navigation links or error resolution URLs.
|
|
90
92
|
* @internal
|
|
91
93
|
*/
|
|
92
94
|
actionLinks?: ActionLinks;
|
|
93
95
|
/**
|
|
94
|
-
*
|
|
96
|
+
* Subscription charges for the order. Displayed to the customer on the payment page so they're aware that paying activates a subscription.
|
|
95
97
|
* @internal
|
|
96
98
|
* @maxSize 100
|
|
97
99
|
* @readonly
|
|
@@ -100,7 +102,7 @@ interface OrderPaymentRequest {
|
|
|
100
102
|
}
|
|
101
103
|
interface Source {
|
|
102
104
|
/**
|
|
103
|
-
*
|
|
105
|
+
* ID of the app that created the order payment request.
|
|
104
106
|
* @format GUID
|
|
105
107
|
* @minLength 1
|
|
106
108
|
* @maxLength 100
|
|
@@ -108,7 +110,7 @@ interface Source {
|
|
|
108
110
|
*/
|
|
109
111
|
appId?: string | null;
|
|
110
112
|
/**
|
|
111
|
-
* Reference to
|
|
113
|
+
* Reference to a record in the source system. For example, if the payment request was created from a paylink or invoice, use this field to store the paylink ID or invoice ID.
|
|
112
114
|
* @minLength 1
|
|
113
115
|
* @maxLength 100
|
|
114
116
|
* @immutable
|
|
@@ -116,10 +118,15 @@ interface Source {
|
|
|
116
118
|
externalId?: string;
|
|
117
119
|
}
|
|
118
120
|
declare enum Status {
|
|
121
|
+
/** Payment is owed but hasn't been collected yet. */
|
|
119
122
|
UNPAID = "UNPAID",
|
|
123
|
+
/** Payment has been collected. */
|
|
120
124
|
PAID = "PAID",
|
|
125
|
+
/** The order payment request has passed its `expirationDate` without being paid. */
|
|
121
126
|
EXPIRED = "EXPIRED",
|
|
122
|
-
/**
|
|
127
|
+
/**
|
|
128
|
+
* The order payment request was voided and can no longer be paid.
|
|
129
|
+
* @documentationMaturity preview
|
|
123
130
|
* @internal
|
|
124
131
|
*/
|
|
125
132
|
VOIDED = "VOIDED"
|
|
@@ -157,11 +164,13 @@ declare enum PaymentMethod {
|
|
|
157
164
|
type PaymentMethodWithLiterals = PaymentMethod | 'MANUAL';
|
|
158
165
|
interface ActionLinks {
|
|
159
166
|
/**
|
|
160
|
-
*
|
|
167
|
+
* Navigation action links rendered as anchors on the payment page.
|
|
168
|
+
*
|
|
169
|
+
* Currently supports a single action link.
|
|
161
170
|
* @maxSize 1
|
|
162
171
|
*/
|
|
163
172
|
general?: ActionLink[];
|
|
164
|
-
/**
|
|
173
|
+
/** Action link rendered as a button in error messages on the payment page. */
|
|
165
174
|
error?: ActionLink;
|
|
166
175
|
}
|
|
167
176
|
interface ActionLink {
|
|
@@ -185,7 +194,7 @@ interface SubscriptionInfo {
|
|
|
185
194
|
*/
|
|
186
195
|
title?: string;
|
|
187
196
|
/**
|
|
188
|
-
* Description of the charges
|
|
197
|
+
* Description of the charges applied for the subscription.
|
|
189
198
|
* @maxLength 1000
|
|
190
199
|
*/
|
|
191
200
|
chargeDescription?: string | null;
|
|
@@ -197,57 +206,124 @@ interface SubscriptionInfo {
|
|
|
197
206
|
/** Whether the subscription renews automatically. */
|
|
198
207
|
autoRenewal?: boolean;
|
|
199
208
|
}
|
|
200
|
-
/** Triggered when
|
|
209
|
+
/** Triggered when an order payment request's `status` changes to `PAID`. */
|
|
201
210
|
interface OrderPaymentRequestPaid {
|
|
202
|
-
/** Order payment request */
|
|
211
|
+
/** Order payment request that was paid. */
|
|
203
212
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
204
213
|
}
|
|
205
|
-
/** Triggered when
|
|
214
|
+
/** Triggered when an order payment request's `status` changes to `EXPIRED`. */
|
|
206
215
|
interface OrderPaymentRequestExpired {
|
|
207
|
-
/** Order payment request */
|
|
216
|
+
/** Order payment request that expired. */
|
|
208
217
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
209
218
|
}
|
|
210
|
-
/** Triggered when
|
|
219
|
+
/** Triggered when an order payment request's `status` changes to `VOIDED`. */
|
|
211
220
|
interface OrderPaymentRequestVoided {
|
|
212
|
-
/** Order payment request */
|
|
221
|
+
/** Order payment request that was voided. */
|
|
213
222
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
214
223
|
}
|
|
215
224
|
interface CreateOrderPaymentRequestRequest {
|
|
216
|
-
/**
|
|
225
|
+
/** Order payment request to create. */
|
|
217
226
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
218
227
|
}
|
|
219
228
|
interface CreateOrderPaymentRequestResponse {
|
|
220
|
-
/**
|
|
229
|
+
/** Created order payment request. */
|
|
221
230
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
222
231
|
/**
|
|
223
|
-
*
|
|
232
|
+
* Payment page URL for the order payment request. Share this URL with the customer so they can complete the payment.
|
|
224
233
|
* @minLength 1
|
|
225
234
|
* @maxLength 100
|
|
226
235
|
*/
|
|
227
236
|
orderPaymentRequestUrl?: string;
|
|
228
237
|
}
|
|
238
|
+
interface BulkCreateOrderPaymentRequestsRequest {
|
|
239
|
+
/**
|
|
240
|
+
* Order payment requests to create.
|
|
241
|
+
* @minSize 1
|
|
242
|
+
* @maxSize 100
|
|
243
|
+
*/
|
|
244
|
+
orderPaymentRequests: OrderPaymentRequest[];
|
|
245
|
+
/**
|
|
246
|
+
* Whether to return the created order payment requests and their payment page URLs in the response.
|
|
247
|
+
* Default: `false`.
|
|
248
|
+
*/
|
|
249
|
+
returnEntity?: boolean;
|
|
250
|
+
}
|
|
251
|
+
interface BulkCreateOrderPaymentRequestsResponse {
|
|
252
|
+
/**
|
|
253
|
+
* Results of the bulk create operation in the same order as the request items.
|
|
254
|
+
* @minSize 1
|
|
255
|
+
* @maxSize 100
|
|
256
|
+
*/
|
|
257
|
+
results?: BulkOrderPaymentRequestResult[];
|
|
258
|
+
/** Metadata about the bulk create operation. */
|
|
259
|
+
bulkActionMetadata?: BulkActionMetadata;
|
|
260
|
+
}
|
|
261
|
+
interface ItemMetadata {
|
|
262
|
+
/**
|
|
263
|
+
* Item ID. Provided only whenever possible. For example, `itemId` can't be provided when item creation has failed.
|
|
264
|
+
* @format GUID
|
|
265
|
+
*/
|
|
266
|
+
_id?: string | null;
|
|
267
|
+
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
268
|
+
originalIndex?: number;
|
|
269
|
+
/** Whether the requested action for this item was successful. When `false`, the `error` field is returned. */
|
|
270
|
+
success?: boolean;
|
|
271
|
+
/** Details about the error in case of failure. */
|
|
272
|
+
error?: ApplicationError;
|
|
273
|
+
}
|
|
274
|
+
interface ApplicationError {
|
|
275
|
+
/** Error code. */
|
|
276
|
+
code?: string;
|
|
277
|
+
/** Description of the error. */
|
|
278
|
+
description?: string;
|
|
279
|
+
/** Data related to the error. */
|
|
280
|
+
data?: Record<string, any> | null;
|
|
281
|
+
}
|
|
282
|
+
interface BulkOrderPaymentRequestItem {
|
|
283
|
+
/** Created order payment request. */
|
|
284
|
+
orderPaymentRequest?: OrderPaymentRequest;
|
|
285
|
+
/**
|
|
286
|
+
* Payment page URL for the created order payment request.
|
|
287
|
+
* @format WEB_URL
|
|
288
|
+
*/
|
|
289
|
+
orderPaymentRequestUrl?: string;
|
|
290
|
+
}
|
|
291
|
+
interface BulkOrderPaymentRequestResult {
|
|
292
|
+
/** Metadata about this item, including its original request index and any error. */
|
|
293
|
+
itemMetadata?: ItemMetadata;
|
|
294
|
+
/** Created order payment request and its payment page URL. Returned when `returnEntity` is `true`. */
|
|
295
|
+
item?: BulkOrderPaymentRequestItem;
|
|
296
|
+
}
|
|
297
|
+
interface BulkActionMetadata {
|
|
298
|
+
/** Number of items that were successfully processed. */
|
|
299
|
+
totalSuccesses?: number;
|
|
300
|
+
/** Number of items that couldn't be processed. */
|
|
301
|
+
totalFailures?: number;
|
|
302
|
+
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
303
|
+
undetailedFailures?: number;
|
|
304
|
+
}
|
|
229
305
|
interface GetOrderPaymentRequestRequest {
|
|
230
306
|
/**
|
|
231
|
-
* ID of the
|
|
307
|
+
* ID of the order payment request to retrieve.
|
|
232
308
|
* @format GUID
|
|
233
309
|
*/
|
|
234
310
|
orderPaymentRequestId: string;
|
|
235
311
|
}
|
|
236
312
|
interface GetOrderPaymentRequestResponse {
|
|
237
|
-
/**
|
|
313
|
+
/** Retrieved order payment request. */
|
|
238
314
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
239
315
|
}
|
|
240
316
|
interface UpdateOrderPaymentRequestRequest {
|
|
241
|
-
/**
|
|
317
|
+
/** Order payment request to update. */
|
|
242
318
|
orderPaymentRequest: OrderPaymentRequest;
|
|
243
319
|
}
|
|
244
320
|
interface UpdateOrderPaymentRequestResponse {
|
|
245
|
-
/** Updated
|
|
321
|
+
/** Updated order payment request. */
|
|
246
322
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
247
323
|
}
|
|
248
324
|
interface DeleteOrderPaymentRequestRequest {
|
|
249
325
|
/**
|
|
250
|
-
*
|
|
326
|
+
* ID of the order payment request to delete.
|
|
251
327
|
* @format GUID
|
|
252
328
|
*/
|
|
253
329
|
orderPaymentRequestId: string;
|
|
@@ -314,11 +390,11 @@ interface CursorPaging {
|
|
|
314
390
|
}
|
|
315
391
|
interface QueryOrderPaymentRequestsResponse {
|
|
316
392
|
/**
|
|
317
|
-
* List of payment requests.
|
|
393
|
+
* List of order payment requests.
|
|
318
394
|
* @maxSize 1000
|
|
319
395
|
*/
|
|
320
396
|
orderPaymentRequests?: OrderPaymentRequest[];
|
|
321
|
-
/** Paging metadata */
|
|
397
|
+
/** Paging metadata. */
|
|
322
398
|
pagingMetadata?: CursorPagingMetadata;
|
|
323
399
|
}
|
|
324
400
|
interface CursorPagingMetadata {
|
|
@@ -348,14 +424,14 @@ interface Cursors {
|
|
|
348
424
|
}
|
|
349
425
|
interface GetOrderPaymentRequestURLRequest {
|
|
350
426
|
/**
|
|
351
|
-
*
|
|
427
|
+
* ID of the order payment request.
|
|
352
428
|
* @format GUID
|
|
353
429
|
*/
|
|
354
430
|
orderPaymentRequestId: string;
|
|
355
431
|
}
|
|
356
432
|
interface GetOrderPaymentRequestURLResponse {
|
|
357
433
|
/**
|
|
358
|
-
*
|
|
434
|
+
* Payment page URL for the order payment request.
|
|
359
435
|
* @minLength 1
|
|
360
436
|
* @maxLength 100
|
|
361
437
|
*/
|
|
@@ -370,7 +446,7 @@ interface UpdateExtendedFieldsRequest {
|
|
|
370
446
|
namespaceData: Record<string, any> | null;
|
|
371
447
|
}
|
|
372
448
|
interface UpdateExtendedFieldsResponse {
|
|
373
|
-
/** Updated
|
|
449
|
+
/** Updated order payment request. */
|
|
374
450
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
375
451
|
}
|
|
376
452
|
interface VoidOrderPaymentRequestRequest {
|
|
@@ -550,6 +626,10 @@ type CreateOrderPaymentRequestApplicationErrors = {
|
|
|
550
626
|
code?: 'INVALID_ORDER_STATUS_FOR_SUBSCRIPTION';
|
|
551
627
|
description?: string;
|
|
552
628
|
data?: Record<string, any>;
|
|
629
|
+
} | {
|
|
630
|
+
code?: 'ORDER_PAYMENT_REQUEST_PAGE_NOT_FOUND';
|
|
631
|
+
description?: string;
|
|
632
|
+
data?: Record<string, any>;
|
|
553
633
|
};
|
|
554
634
|
/** @docsIgnore */
|
|
555
635
|
type GetOrderPaymentRequestApplicationErrors = {
|
|
@@ -707,7 +787,7 @@ interface OrderPaymentRequestExpiredEnvelope {
|
|
|
707
787
|
metadata: EventMetadata;
|
|
708
788
|
}
|
|
709
789
|
/**
|
|
710
|
-
* Triggered when an order payment request status
|
|
790
|
+
* Triggered when an order payment request's `status` changes to `EXPIRED`.
|
|
711
791
|
* @permissionScope Manage Stores - all permissions
|
|
712
792
|
* @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
|
|
713
793
|
* @permissionScope Manage Stores
|
|
@@ -728,7 +808,7 @@ interface OrderPaymentRequestPaidEnvelope {
|
|
|
728
808
|
metadata: EventMetadata;
|
|
729
809
|
}
|
|
730
810
|
/**
|
|
731
|
-
* Triggered when an order payment request status
|
|
811
|
+
* Triggered when an order payment request's `status` changes to `PAID`.
|
|
732
812
|
* @permissionScope Manage Stores - all permissions
|
|
733
813
|
* @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
|
|
734
814
|
* @permissionScope Manage Stores
|
|
@@ -770,7 +850,7 @@ interface OrderPaymentRequestVoidedEnvelope {
|
|
|
770
850
|
metadata: EventMetadata;
|
|
771
851
|
}
|
|
772
852
|
/**
|
|
773
|
-
* Triggered when an order payment request status
|
|
853
|
+
* Triggered when an order payment request's `status` changes to `VOIDED`.
|
|
774
854
|
* @permissionScope Manage Stores - all permissions
|
|
775
855
|
* @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
|
|
776
856
|
* @permissionScope Manage Stores
|
|
@@ -787,7 +867,11 @@ interface OrderPaymentRequestVoidedEnvelope {
|
|
|
787
867
|
*/
|
|
788
868
|
declare function onOrderPaymentRequestVoided(handler: (event: OrderPaymentRequestVoidedEnvelope) => void | Promise<void>): void;
|
|
789
869
|
/**
|
|
790
|
-
* Creates
|
|
870
|
+
* Creates an order payment request.
|
|
871
|
+
*
|
|
872
|
+
* The response includes the payment page URL, which you can share with the customer. To retrieve the URL later, call [Get Order Payment Request URL](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-payment-requests/get-order-payment-request-url).
|
|
873
|
+
*
|
|
874
|
+
* Creation fails with `ORDER_PAYMENT_REQUEST_PAGE_NOT_FOUND` if the site doesn't have a Payment Request Page added and published.
|
|
791
875
|
* @public
|
|
792
876
|
* @documentationMaturity preview
|
|
793
877
|
* @requiredField options.orderPaymentRequest.amount
|
|
@@ -795,25 +879,55 @@ declare function onOrderPaymentRequestVoided(handler: (event: OrderPaymentReques
|
|
|
795
879
|
* @requiredField options.orderPaymentRequest.title
|
|
796
880
|
* @permissionId ECOM.ORDER_PAYMENT_REQUEST_CREATE
|
|
797
881
|
* @applicableIdentity APP
|
|
798
|
-
* @returns
|
|
882
|
+
* @returns Created order payment request.
|
|
799
883
|
* @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.CreateOrderPaymentRequest
|
|
800
884
|
*/
|
|
801
885
|
declare function createOrderPaymentRequest(options?: NonNullablePaths<CreateOrderPaymentRequestOptions, `orderPaymentRequest.amount` | `orderPaymentRequest.orderId` | `orderPaymentRequest.title`, 3>): Promise<NonNullablePaths<OrderPaymentRequest, `source.externalId` | `status` | `orderId` | `amount.amount` | `amount.formattedAmount` | `currency` | `title` | `blockedPaymentMethods`, 3> & {
|
|
802
886
|
__applicationErrorsType?: CreateOrderPaymentRequestApplicationErrors;
|
|
803
887
|
}>;
|
|
804
888
|
interface CreateOrderPaymentRequestOptions {
|
|
805
|
-
/**
|
|
889
|
+
/** Order payment request to create. */
|
|
806
890
|
orderPaymentRequest?: OrderPaymentRequest;
|
|
807
891
|
}
|
|
808
892
|
/**
|
|
809
|
-
*
|
|
810
|
-
*
|
|
893
|
+
* Creates multiple order payment requests in a single request. Works synchronously.
|
|
894
|
+
*
|
|
895
|
+
* The response contains an item-level result for every requested order payment request. Items are processed independently, so some may succeed while others fail.
|
|
896
|
+
*
|
|
897
|
+
* Per-item failures are returned in `results[].itemMetadata.error`. Possible application error codes are:
|
|
898
|
+
* - `ORDER_NOT_FOUND`: The referenced order wasn't found.
|
|
899
|
+
* - `PARTIAL_PAYMENT_NOT_SUPPORTED_FOR_SUBSCRIPTION`: The requested amount doesn't equal the subscription order total.
|
|
900
|
+
* - `INVALID_ORDER_STATUS_FOR_SUBSCRIPTION`: The subscription order isn't in `INITIALIZED` status.
|
|
901
|
+
* - `SITE_NOT_PUBLISHED`: The site isn't published.
|
|
902
|
+
* - `ORDER_PAYMENT_REQUEST_PAGE_NOT_FOUND`: The Payment Request Page isn't available on the site.
|
|
903
|
+
* @param orderPaymentRequests - Order payment requests to create.
|
|
904
|
+
* @internal
|
|
905
|
+
* @documentationMaturity preview
|
|
906
|
+
* @requiredField orderPaymentRequests
|
|
907
|
+
* @requiredField orderPaymentRequests.amount
|
|
908
|
+
* @requiredField orderPaymentRequests.orderId
|
|
909
|
+
* @requiredField orderPaymentRequests.source.externalId
|
|
910
|
+
* @requiredField orderPaymentRequests.title
|
|
911
|
+
* @permissionId ecom:v1:order_payment_request:bulk_create_order_payment_requests
|
|
912
|
+
* @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.BulkCreateOrderPaymentRequests
|
|
913
|
+
*/
|
|
914
|
+
declare function bulkCreateOrderPaymentRequests(orderPaymentRequests: NonNullablePaths<OrderPaymentRequest, `amount` | `orderId` | `source.externalId` | `title`, 3>[], options?: BulkCreateOrderPaymentRequestsOptions): Promise<NonNullablePaths<BulkCreateOrderPaymentRequestsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.orderPaymentRequest.status` | `results.${number}.item.orderPaymentRequest.orderId` | `results.${number}.item.orderPaymentRequest.currency` | `results.${number}.item.orderPaymentRequest.title` | `results.${number}.item.orderPaymentRequestUrl` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
|
|
915
|
+
interface BulkCreateOrderPaymentRequestsOptions {
|
|
916
|
+
/**
|
|
917
|
+
* Whether to return the created order payment requests and their payment page URLs in the response.
|
|
918
|
+
* Default: `false`.
|
|
919
|
+
*/
|
|
920
|
+
returnEntity?: boolean;
|
|
921
|
+
}
|
|
922
|
+
/**
|
|
923
|
+
* Retrieves an order payment request.
|
|
924
|
+
* @param orderPaymentRequestId - ID of the order payment request to retrieve.
|
|
811
925
|
* @public
|
|
812
926
|
* @documentationMaturity preview
|
|
813
927
|
* @requiredField orderPaymentRequestId
|
|
814
928
|
* @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
|
|
815
929
|
* @applicableIdentity APP
|
|
816
|
-
* @returns
|
|
930
|
+
* @returns Retrieved order payment request.
|
|
817
931
|
* @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.GetOrderPaymentRequest
|
|
818
932
|
*/
|
|
819
933
|
declare function getOrderPaymentRequest(orderPaymentRequestId: string): Promise<NonNullablePaths<OrderPaymentRequest, `source.externalId` | `status` | `orderId` | `amount.amount` | `amount.formattedAmount` | `currency` | `title` | `blockedPaymentMethods`, 3> & {
|
|
@@ -830,7 +944,7 @@ declare function getOrderPaymentRequest(orderPaymentRequestId: string): Promise<
|
|
|
830
944
|
* @requiredField orderPaymentRequest
|
|
831
945
|
* @permissionId ECOM.ORDER_PAYMENT_REQUEST_UPDATE
|
|
832
946
|
* @applicableIdentity APP
|
|
833
|
-
* @returns Updated
|
|
947
|
+
* @returns Updated order payment request.
|
|
834
948
|
* @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.UpdateOrderPaymentRequest
|
|
835
949
|
*/
|
|
836
950
|
declare function updateOrderPaymentRequest(_id: string, orderPaymentRequest: UpdateOrderPaymentRequest): Promise<NonNullablePaths<OrderPaymentRequest, `source.externalId` | `status` | `orderId` | `amount.amount` | `amount.formattedAmount` | `currency` | `title` | `blockedPaymentMethods`, 3> & {
|
|
@@ -844,7 +958,7 @@ interface UpdateOrderPaymentRequest {
|
|
|
844
958
|
*/
|
|
845
959
|
_id?: string | null;
|
|
846
960
|
/**
|
|
847
|
-
*
|
|
961
|
+
* Details about the source that created the order payment request.
|
|
848
962
|
* @immutable
|
|
849
963
|
*/
|
|
850
964
|
source?: Source;
|
|
@@ -871,43 +985,47 @@ interface UpdateOrderPaymentRequest {
|
|
|
871
985
|
*/
|
|
872
986
|
amount?: Price;
|
|
873
987
|
/**
|
|
874
|
-
*
|
|
988
|
+
* Three-letter currency code in [ISO-4217 alphabetic format](http://en.wikipedia.org/wiki/ISO_4217). Always matches the order's currency.
|
|
875
989
|
* @format CURRENCY
|
|
876
990
|
* @readonly
|
|
877
991
|
*/
|
|
878
992
|
currency?: string;
|
|
879
993
|
/**
|
|
880
|
-
* Payment gateway order
|
|
994
|
+
* Payment gateway order ID associated with this payment request.
|
|
881
995
|
* @readonly
|
|
882
996
|
* @minLength 1
|
|
883
997
|
* @maxLength 100
|
|
884
998
|
*/
|
|
885
999
|
paymentGatewayOrderId?: string | null;
|
|
886
1000
|
/**
|
|
887
|
-
* Title
|
|
1001
|
+
* Title displayed to the customer on the payment page.
|
|
888
1002
|
* @minLength 1
|
|
889
1003
|
* @maxLength 200
|
|
890
1004
|
*/
|
|
891
1005
|
title?: string;
|
|
892
1006
|
/**
|
|
893
|
-
* Description
|
|
1007
|
+
* Description displayed to the customer on the payment page.
|
|
894
1008
|
* @maxLength 300
|
|
895
1009
|
*/
|
|
896
1010
|
description?: string | null;
|
|
897
1011
|
/**
|
|
898
|
-
*
|
|
1012
|
+
* Date and time the order payment request expires. If not provided, the order payment request doesn't expire.
|
|
899
1013
|
* @immutable
|
|
900
1014
|
*/
|
|
901
1015
|
expirationDate?: Date | null;
|
|
902
|
-
/**
|
|
1016
|
+
/**
|
|
1017
|
+
* Custom field data for this order payment request.
|
|
1018
|
+
*
|
|
1019
|
+
* [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions) must be configured in the app dashboard before they can be accessed with API calls.
|
|
1020
|
+
*/
|
|
903
1021
|
extendedFields?: ExtendedFields;
|
|
904
1022
|
/**
|
|
905
|
-
* Date and time the
|
|
1023
|
+
* Date and time the order payment request was created.
|
|
906
1024
|
* @readonly
|
|
907
1025
|
*/
|
|
908
1026
|
_createdDate?: Date | null;
|
|
909
1027
|
/**
|
|
910
|
-
* Date and time the
|
|
1028
|
+
* Date and time the order payment request was last updated.
|
|
911
1029
|
* @readonly
|
|
912
1030
|
*/
|
|
913
1031
|
_updatedDate?: Date | null;
|
|
@@ -919,14 +1037,12 @@ interface UpdateOrderPaymentRequest {
|
|
|
919
1037
|
*/
|
|
920
1038
|
blockedPaymentMethods?: PaymentMethodWithLiterals[];
|
|
921
1039
|
/**
|
|
922
|
-
*
|
|
923
|
-
*
|
|
924
|
-
* These actions are optional and may be conditionally rendered based on the client context.
|
|
1040
|
+
* Action links rendered by the payment page, such as navigation links or error resolution URLs.
|
|
925
1041
|
* @internal
|
|
926
1042
|
*/
|
|
927
1043
|
actionLinks?: ActionLinks;
|
|
928
1044
|
/**
|
|
929
|
-
*
|
|
1045
|
+
* Subscription charges for the order. Displayed to the customer on the payment page so they're aware that paying activates a subscription.
|
|
930
1046
|
* @internal
|
|
931
1047
|
* @maxSize 100
|
|
932
1048
|
* @readonly
|
|
@@ -937,7 +1053,7 @@ interface UpdateOrderPaymentRequest {
|
|
|
937
1053
|
* Deletes an order payment request.
|
|
938
1054
|
*
|
|
939
1055
|
* You can delete an order payment request in any status except `PAID`. Attempting to delete a `PAID` order payment request fails with `CANNOT_DELETE_PAID_ORDER_PAYMENT_REQUEST`.
|
|
940
|
-
* @param orderPaymentRequestId -
|
|
1056
|
+
* @param orderPaymentRequestId - ID of the order payment request to delete.
|
|
941
1057
|
* @public
|
|
942
1058
|
* @documentationMaturity preview
|
|
943
1059
|
* @requiredField orderPaymentRequestId
|
|
@@ -949,11 +1065,11 @@ declare function deleteOrderPaymentRequest(orderPaymentRequestId: string): Promi
|
|
|
949
1065
|
__applicationErrorsType?: DeleteOrderPaymentRequestApplicationErrors;
|
|
950
1066
|
}>;
|
|
951
1067
|
/**
|
|
952
|
-
* Retrieves a list of
|
|
1068
|
+
* Retrieves a list of up to 1,000 order payment requests, given the provided [paging, filtering, and sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language).
|
|
953
1069
|
*
|
|
954
|
-
* Query Payment Requests runs with these defaults, which you can override:
|
|
955
|
-
* - `
|
|
956
|
-
* - `cursorPaging.limit` is 100
|
|
1070
|
+
* Query Order Payment Requests runs with these defaults, which you can override:
|
|
1071
|
+
* - `_createdDate` is sorted in `DESC` order
|
|
1072
|
+
* - `cursorPaging.limit` is `100`
|
|
957
1073
|
*
|
|
958
1074
|
* To learn about working with _Query_ endpoints, see
|
|
959
1075
|
* [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language), and
|
|
@@ -1136,8 +1252,8 @@ declare const utils: {
|
|
|
1136
1252
|
};
|
|
1137
1253
|
};
|
|
1138
1254
|
/**
|
|
1139
|
-
* Retrieves the
|
|
1140
|
-
* @param orderPaymentRequestId -
|
|
1255
|
+
* Retrieves the payment page URL for an order payment request.
|
|
1256
|
+
* @param orderPaymentRequestId - ID of the order payment request.
|
|
1141
1257
|
* @public
|
|
1142
1258
|
* @documentationMaturity preview
|
|
1143
1259
|
* @requiredField orderPaymentRequestId
|
|
@@ -1149,7 +1265,7 @@ declare function getOrderPaymentRequestUrl(orderPaymentRequestId: string): Promi
|
|
|
1149
1265
|
__applicationErrorsType?: GetOrderPaymentRequestUrlApplicationErrors;
|
|
1150
1266
|
}>;
|
|
1151
1267
|
/**
|
|
1152
|
-
* Updates extended fields of
|
|
1268
|
+
* Updates the extended fields of an order payment request.
|
|
1153
1269
|
* @param _id - ID of the entity to update.
|
|
1154
1270
|
* @param namespace - Identifier for the app whose extended fields are being updated.
|
|
1155
1271
|
* @public
|
|
@@ -1172,7 +1288,7 @@ interface UpdateExtendedFieldsOptions {
|
|
|
1172
1288
|
*
|
|
1173
1289
|
* Only `UNPAID` order payment requests can be voided. Voiding an order payment request that is already `VOIDED` succeeds without making any changes. Voiding a `PAID` or `EXPIRED` order payment request fails.
|
|
1174
1290
|
* @param orderPaymentRequestId - ID of the order payment request to void.
|
|
1175
|
-
* @
|
|
1291
|
+
* @public
|
|
1176
1292
|
* @documentationMaturity preview
|
|
1177
1293
|
* @requiredField orderPaymentRequestId
|
|
1178
1294
|
* @permissionId ECOM.ORDER_PAYMENT_REQUEST_UPDATE
|
|
@@ -1183,4 +1299,4 @@ declare function voidOrderPaymentRequest(orderPaymentRequestId: string): Promise
|
|
|
1183
1299
|
__applicationErrorsType?: VoidOrderPaymentRequestApplicationErrors;
|
|
1184
1300
|
}>;
|
|
1185
1301
|
|
|
1186
|
-
export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type ActionLink, type ActionLinks, type BaseEventMetadata, type CommonQueryWithEntityContext, type CreateOrderPaymentRequestApplicationErrors, type CreateOrderPaymentRequestOptions, type CreateOrderPaymentRequestRequest, type CreateOrderPaymentRequestResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DeleteOrderPaymentRequestApplicationErrors, type DeleteOrderPaymentRequestRequest, type DeleteOrderPaymentRequestResponse, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type ExtendedFields, type GetOrderPaymentRequestApplicationErrors, type GetOrderPaymentRequestRequest, type GetOrderPaymentRequestResponse, type GetOrderPaymentRequestURLRequest, type GetOrderPaymentRequestURLResponse, type GetOrderPaymentRequestUrlApplicationErrors, type IdentificationData, type IdentificationDataIdOneOf, type MessageEnvelope, type OrderPaymentRequest, type OrderPaymentRequestCreatedEnvelope, type OrderPaymentRequestDeletedEnvelope, type OrderPaymentRequestExpired, type OrderPaymentRequestExpiredEnvelope, type OrderPaymentRequestPaid, type OrderPaymentRequestPaidEnvelope, type OrderPaymentRequestQuery, type OrderPaymentRequestQuerySpec, type OrderPaymentRequestUpdatedEnvelope, type OrderPaymentRequestVoided, type OrderPaymentRequestVoidedEnvelope, type OrderPaymentRequestsQueryBuilder, type OrderPaymentRequestsQueryResult, PaymentMethod, type PaymentMethodWithLiterals, type Price, type QueryOrderPaymentRequestsRequest, type QueryOrderPaymentRequestsResponse, type RestoreInfo, SortOrder, type SortOrderWithLiterals, type Sorting, type Source, Status, type StatusWithLiterals, type SubscriptionInfo, type UpdateExtendedFieldsOptions, type UpdateExtendedFieldsRequest, type UpdateExtendedFieldsResponse, type UpdateOrderPaymentRequest, type UpdateOrderPaymentRequestApplicationErrors, type UpdateOrderPaymentRequestRequest, type UpdateOrderPaymentRequestResponse, type VoidOrderPaymentRequestApplicationErrors, type VoidOrderPaymentRequestRequest, type VoidOrderPaymentRequestResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, createOrderPaymentRequest, deleteOrderPaymentRequest, getOrderPaymentRequest, getOrderPaymentRequestUrl, onOrderPaymentRequestCreated, onOrderPaymentRequestDeleted, onOrderPaymentRequestExpired, onOrderPaymentRequestPaid, onOrderPaymentRequestUpdated, onOrderPaymentRequestVoided, queryOrderPaymentRequests, typedQueryOrderPaymentRequests, updateExtendedFields, updateOrderPaymentRequest, utils, voidOrderPaymentRequest };
|
|
1302
|
+
export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type ActionLink, type ActionLinks, type ApplicationError, type BaseEventMetadata, type BulkActionMetadata, type BulkCreateOrderPaymentRequestsOptions, type BulkCreateOrderPaymentRequestsRequest, type BulkCreateOrderPaymentRequestsResponse, type BulkOrderPaymentRequestItem, type BulkOrderPaymentRequestResult, type CommonQueryWithEntityContext, type CreateOrderPaymentRequestApplicationErrors, type CreateOrderPaymentRequestOptions, type CreateOrderPaymentRequestRequest, type CreateOrderPaymentRequestResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DeleteOrderPaymentRequestApplicationErrors, type DeleteOrderPaymentRequestRequest, type DeleteOrderPaymentRequestResponse, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type ExtendedFields, type GetOrderPaymentRequestApplicationErrors, type GetOrderPaymentRequestRequest, type GetOrderPaymentRequestResponse, type GetOrderPaymentRequestURLRequest, type GetOrderPaymentRequestURLResponse, type GetOrderPaymentRequestUrlApplicationErrors, type IdentificationData, type IdentificationDataIdOneOf, type ItemMetadata, type MessageEnvelope, type OrderPaymentRequest, type OrderPaymentRequestCreatedEnvelope, type OrderPaymentRequestDeletedEnvelope, type OrderPaymentRequestExpired, type OrderPaymentRequestExpiredEnvelope, type OrderPaymentRequestPaid, type OrderPaymentRequestPaidEnvelope, type OrderPaymentRequestQuery, type OrderPaymentRequestQuerySpec, type OrderPaymentRequestUpdatedEnvelope, type OrderPaymentRequestVoided, type OrderPaymentRequestVoidedEnvelope, type OrderPaymentRequestsQueryBuilder, type OrderPaymentRequestsQueryResult, PaymentMethod, type PaymentMethodWithLiterals, type Price, type QueryOrderPaymentRequestsRequest, type QueryOrderPaymentRequestsResponse, type RestoreInfo, SortOrder, type SortOrderWithLiterals, type Sorting, type Source, Status, type StatusWithLiterals, type SubscriptionInfo, type UpdateExtendedFieldsOptions, type UpdateExtendedFieldsRequest, type UpdateExtendedFieldsResponse, type UpdateOrderPaymentRequest, type UpdateOrderPaymentRequestApplicationErrors, type UpdateOrderPaymentRequestRequest, type UpdateOrderPaymentRequestResponse, type VoidOrderPaymentRequestApplicationErrors, type VoidOrderPaymentRequestRequest, type VoidOrderPaymentRequestResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkCreateOrderPaymentRequests, createOrderPaymentRequest, deleteOrderPaymentRequest, getOrderPaymentRequest, getOrderPaymentRequestUrl, onOrderPaymentRequestCreated, onOrderPaymentRequestDeleted, onOrderPaymentRequestExpired, onOrderPaymentRequestPaid, onOrderPaymentRequestUpdated, onOrderPaymentRequestVoided, queryOrderPaymentRequests, typedQueryOrderPaymentRequests, updateExtendedFields, updateOrderPaymentRequest, utils, voidOrderPaymentRequest };
|