@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.
Files changed (49) hide show
  1. package/build/cjs/index.d.ts +33 -16
  2. package/build/cjs/index.js +100 -0
  3. package/build/cjs/index.js.map +1 -1
  4. package/build/cjs/index.typings.d.ts +171 -61
  5. package/build/cjs/index.typings.js +91 -0
  6. package/build/cjs/index.typings.js.map +1 -1
  7. package/build/cjs/meta.d.ts +116 -35
  8. package/build/cjs/meta.js +65 -0
  9. package/build/cjs/meta.js.map +1 -1
  10. package/build/cjs/schemas.d.ts +5 -1
  11. package/build/cjs/schemas.js +116 -117
  12. package/build/cjs/schemas.js.map +1 -1
  13. package/build/es/index.d.mts +33 -16
  14. package/build/es/index.mjs +99 -0
  15. package/build/es/index.mjs.map +1 -1
  16. package/build/es/index.typings.d.mts +171 -61
  17. package/build/es/index.typings.mjs +90 -0
  18. package/build/es/index.typings.mjs.map +1 -1
  19. package/build/es/meta.d.mts +116 -35
  20. package/build/es/meta.mjs +64 -0
  21. package/build/es/meta.mjs.map +1 -1
  22. package/build/es/schemas.d.mts +5 -1
  23. package/build/es/schemas.mjs +113 -116
  24. package/build/es/schemas.mjs.map +1 -1
  25. package/build/internal/cjs/index.d.ts +40 -18
  26. package/build/internal/cjs/index.js +100 -0
  27. package/build/internal/cjs/index.js.map +1 -1
  28. package/build/internal/cjs/index.typings.d.ts +187 -71
  29. package/build/internal/cjs/index.typings.js +91 -0
  30. package/build/internal/cjs/index.typings.js.map +1 -1
  31. package/build/internal/cjs/meta.d.ts +116 -35
  32. package/build/internal/cjs/meta.js +65 -0
  33. package/build/internal/cjs/meta.js.map +1 -1
  34. package/build/internal/cjs/schemas.d.ts +5 -1
  35. package/build/internal/cjs/schemas.js +116 -117
  36. package/build/internal/cjs/schemas.js.map +1 -1
  37. package/build/internal/es/index.d.mts +40 -18
  38. package/build/internal/es/index.mjs +99 -0
  39. package/build/internal/es/index.mjs.map +1 -1
  40. package/build/internal/es/index.typings.d.mts +187 -71
  41. package/build/internal/es/index.typings.mjs +90 -0
  42. package/build/internal/es/index.typings.mjs.map +1 -1
  43. package/build/internal/es/meta.d.mts +116 -35
  44. package/build/internal/es/meta.mjs +64 -0
  45. package/build/internal/es/meta.mjs.map +1 -1
  46. package/build/internal/es/schemas.d.mts +5 -1
  47. package/build/internal/es/schemas.mjs +113 -116
  48. package/build/internal/es/schemas.mjs.map +1 -1
  49. package/package.json +2 -2
@@ -9,7 +9,7 @@ interface OrderPaymentRequest {
9
9
  */
10
10
  _id?: string | null;
11
11
  /**
12
- * Additional parameters to identify the source of the order payment request.
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
- * Currency code. The value will always match the currency used in the order.
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 id which is associated with this payment request
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 to be displayed to the customer on the payment page. Provide a clear and descriptive title to inform the customer about what they are paying for.
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 to be displayed to the customer on the payment page. Write a detailed description so the customer understands what they are paying for.
58
+ * Description displayed to the customer on the payment page.
59
59
  * @maxLength 300
60
60
  */
61
61
  description?: string | null;
62
62
  /**
63
- * Time and date the order payment request expires.
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
- /** [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the [app dashboard](https://dev.wix.com/dc3/my-apps/) before they can be accessed with API calls. */
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 OrderPaymentRequest was created.
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 OrderPaymentRequest was last updated.
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
- * A collection of action links (e.g., navigation or error resolution URLs) intended for client-side use.
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
- * Charges information for each subscription in the order.
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
- * App Def ID that created the order payment request.
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 an ID from an external system, indicating the original source of the order payment request.
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
- /** @documentationMaturity preview
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
- * A general navigation action link rendered as an anchor in the UI.
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
- /** An action link rendered as a button in error messages in the UI. */
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 that will be applied for subscription.
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 the order payment request status changes to paid */
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 the order payment request status changes to expired */
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 the order payment request status changes to voided */
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
- /** OrderPaymentRequest to be created. */
225
+ /** Order payment request to create. */
217
226
  orderPaymentRequest?: OrderPaymentRequest;
218
227
  }
219
228
  interface CreateOrderPaymentRequestResponse {
220
- /** The created OrderPaymentRequest. */
229
+ /** Created order payment request. */
221
230
  orderPaymentRequest?: OrderPaymentRequest;
222
231
  /**
223
- * Order payment request URL.
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 OrderPaymentRequest to retrieve.
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
- /** The requested OrderPaymentRequest. */
313
+ /** Retrieved order payment request. */
238
314
  orderPaymentRequest?: OrderPaymentRequest;
239
315
  }
240
316
  interface UpdateOrderPaymentRequestRequest {
241
- /** OrderPaymentRequest to be updated, may be partial. */
317
+ /** Order payment request to update. */
242
318
  orderPaymentRequest: OrderPaymentRequest;
243
319
  }
244
320
  interface UpdateOrderPaymentRequestResponse {
245
- /** Updated OrderPaymentRequest. */
321
+ /** Updated order payment request. */
246
322
  orderPaymentRequest?: OrderPaymentRequest;
247
323
  }
248
324
  interface DeleteOrderPaymentRequestRequest {
249
325
  /**
250
- * Id of the OrderPaymentRequest to delete.
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
- * Order Payment Request ID.
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
- * Order Payment Request URL.
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 OrderPaymentRequest. */
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 is updated to `"EXPIRED"`.
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 is updated to `"PAID"`.
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 is updated to `"VOIDED"`.
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 a order payment request.
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 The created OrderPaymentRequest.
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
- /** OrderPaymentRequest to be created. */
889
+ /** Order payment request to create. */
806
890
  orderPaymentRequest?: OrderPaymentRequest;
807
891
  }
808
892
  /**
809
- * Retrieves a order payment request.
810
- * @param orderPaymentRequestId - ID of the OrderPaymentRequest to retrieve.
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 The requested OrderPaymentRequest.
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 OrderPaymentRequest.
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
- * Additional parameters to identify the source of the order payment request.
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
- * Currency code. The value will always match the currency used in the order.
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 id which is associated with this payment request
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 to be displayed to the customer on the payment page. Provide a clear and descriptive title to inform the customer about what they are paying for.
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 to be displayed to the customer on the payment page. Write a detailed description so the customer understands what they are paying for.
1007
+ * Description displayed to the customer on the payment page.
894
1008
  * @maxLength 300
895
1009
  */
896
1010
  description?: string | null;
897
1011
  /**
898
- * Time and date the order payment request expires.
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
- /** [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the [app dashboard](https://dev.wix.com/dc3/my-apps/) before they can be accessed with API calls. */
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 OrderPaymentRequest was created.
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 OrderPaymentRequest was last updated.
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
- * A collection of action links (e.g., navigation or error resolution URLs) intended for client-side use.
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
- * Charges information for each subscription in the order.
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 - Id of the OrderPaymentRequest to delete.
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 Payment Requests, given the provided [paging, filtering, and sorting][1].
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
- * - `createdDate` is sorted in DESC order
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 order payment request page URL of a specified order payment request.
1140
- * @param orderPaymentRequestId - Order Payment Request ID.
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 a order payment request
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
- * @internal
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 };