@wix/auto_sdk_ecom_order-payment-requests 1.0.61 → 1.0.62

package/build/internal/es/index.typings.d.mts

@@ -235,6 +235,73 @@ interface CreateOrderPaymentRequestResponse {
      */
     orderPaymentRequestUrl?: string;
 }
+interface BulkCreateOrderPaymentRequestsRequest {
+    /**
+     * Order payment requests to create.
+     * @minSize 1
+     * @maxSize 100
+     */
+    orderPaymentRequests: OrderPaymentRequest[];
+    /**
+     * Whether to return the created order payment requests and their payment page URLs in the response.
+     * Default: `false`.
+     */
+    returnEntity?: boolean;
+}
+interface BulkCreateOrderPaymentRequestsResponse {
+    /**
+     * Results of the bulk create operation in the same order as the request items.
+     * @minSize 1
+     * @maxSize 100
+     */
+    results?: BulkOrderPaymentRequestResult[];
+    /** Metadata about the bulk create operation. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface ItemMetadata {
+    /**
+     * Item ID. Provided only whenever possible. For example, `itemId` can't be provided when item creation has failed.
+     * @format GUID
+     */
+    _id?: string | null;
+    /** Index of the item within the request array. Allows for correlation between request and response items. */
+    originalIndex?: number;
+    /** Whether the requested action for this item was successful. When `false`, the `error` field is returned. */
+    success?: boolean;
+    /** Details about the error in case of failure. */
+    error?: ApplicationError;
+}
+interface ApplicationError {
+    /** Error code. */
+    code?: string;
+    /** Description of the error. */
+    description?: string;
+    /** Data related to the error. */
+    data?: Record<string, any> | null;
+}
+interface BulkOrderPaymentRequestItem {
+    /** Created order payment request. */
+    orderPaymentRequest?: OrderPaymentRequest;
+    /**
+     * Payment page URL for the created order payment request.
+     * @format WEB_URL
+     */
+    orderPaymentRequestUrl?: string;
+}
+interface BulkOrderPaymentRequestResult {
+    /** Metadata about this item, including its original request index and any error. */
+    itemMetadata?: ItemMetadata;
+    /** Created order payment request and its payment page URL. Returned when `returnEntity` is `true`. */
+    item?: BulkOrderPaymentRequestItem;
+}
+interface BulkActionMetadata {
+    /** Number of items that were successfully processed. */
+    totalSuccesses?: number;
+    /** Number of items that couldn't be processed. */
+    totalFailures?: number;
+    /** Number of failures without details because detailed failure threshold was exceeded. */
+    undetailedFailures?: number;
+}
 interface GetOrderPaymentRequestRequest {
     /**
      * ID of the order payment request to retrieve.
@@ -822,6 +889,36 @@ interface CreateOrderPaymentRequestOptions {
     /** Order payment request to create. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
+/**
+ * Creates multiple order payment requests in a single request. Works synchronously.
+ *
+ * The response contains an item-level result for every requested order payment request. Items are processed independently, so some may succeed while others fail.
+ *
+ * Per-item failures are returned in `results[].itemMetadata.error`. Possible application error codes are:
+ * - `ORDER_NOT_FOUND`: The referenced order wasn't found.
+ * - `PARTIAL_PAYMENT_NOT_SUPPORTED_FOR_SUBSCRIPTION`: The requested amount doesn't equal the subscription order total.
+ * - `INVALID_ORDER_STATUS_FOR_SUBSCRIPTION`: The subscription order isn't in `INITIALIZED` status.
+ * - `SITE_NOT_PUBLISHED`: The site isn't published.
+ * - `ORDER_PAYMENT_REQUEST_PAGE_NOT_FOUND`: The Payment Request Page isn't available on the site.
+ * @param orderPaymentRequests - Order payment requests to create.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField orderPaymentRequests
+ * @requiredField orderPaymentRequests.amount
+ * @requiredField orderPaymentRequests.orderId
+ * @requiredField orderPaymentRequests.source.externalId
+ * @requiredField orderPaymentRequests.title
+ * @permissionId ecom:v1:order_payment_request:bulk_create_order_payment_requests
+ * @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.BulkCreateOrderPaymentRequests
+ */
+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>>;
+interface BulkCreateOrderPaymentRequestsOptions {
+    /**
+     * Whether to return the created order payment requests and their payment page URLs in the response.
+     * Default: `false`.
+     */
+    returnEntity?: boolean;
+}
 /**
  * Retrieves an order payment request.
  * @param orderPaymentRequestId - ID of the order payment request to retrieve.
@@ -1191,7 +1288,7 @@ interface UpdateExtendedFieldsOptions {
  *
  * 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.
  * @param orderPaymentRequestId - ID of the order payment request to void.
- * @internal
+ * @public
  * @documentationMaturity preview
  * @requiredField orderPaymentRequestId
  * @permissionId ECOM.ORDER_PAYMENT_REQUEST_UPDATE
@@ -1202,4 +1299,4 @@ declare function voidOrderPaymentRequest(orderPaymentRequestId: string): Promise
     __applicationErrorsType?: VoidOrderPaymentRequestApplicationErrors;
 }>;
 
-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 };
+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 };

package/build/internal/es/index.typings.mjs

@@ -94,6 +94,49 @@ function createOrderPaymentRequest(payload) {
   }
   return __createOrderPaymentRequest;
 }
+function bulkCreateOrderPaymentRequests(payload) {
+  function __bulkCreateOrderPaymentRequests({ host }) {
+    const serializedData = transformPaths(payload, [
+      {
+        transformFn: transformSDKTimestampToRESTTimestamp,
+        paths: [
+          { path: "orderPaymentRequests.expirationDate" },
+          { path: "orderPaymentRequests.createdDate" },
+          { path: "orderPaymentRequests.updatedDate" }
+        ]
+      }
+    ]);
+    const metadata = {
+      entityFqdn: "wix.ecom.v1.order_payment_request",
+      method: "POST",
+      methodFqn: "wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.BulkCreateOrderPaymentRequests",
+      packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
+      url: resolveWixEcomOrderPaymentRequestApiV1OrderPaymentRequestsServiceUrl(
+        {
+          protoPath: "/v1/bulk/order-payment-requests/create",
+          data: serializedData,
+          host
+        }
+      ),
+      data: serializedData,
+      transformResponse: (payload2) => transformPaths(payload2, [
+        {
+          transformFn: transformRESTTimestampToSDKTimestamp,
+          paths: [
+            { path: "results.item.orderPaymentRequest.expirationDate" },
+            { path: "results.item.orderPaymentRequest.createdDate" },
+            { path: "results.item.orderPaymentRequest.updatedDate" }
+          ]
+        }
+      ])
+    };
+    return metadata;
+  }
+  return __bulkCreateOrderPaymentRequests;
+}
 function getOrderPaymentRequest(payload) {
   function __getOrderPaymentRequest({ host }) {
     const metadata = {
@@ -369,6 +412,52 @@ async function createOrderPaymentRequest2(options) {
     throw transformedError;
   }
 }
+async function bulkCreateOrderPaymentRequests2(orderPaymentRequests, options) {
+  const { httpClient, sideEffects } = arguments[2];
+  const payload = transformPaths2(
+    renameKeysFromSDKRequestToRESTRequest({
+      orderPaymentRequests,
+      returnEntity: options?.returnEntity
+    }),
+    [
+      {
+        transformFn: transformSDKImageToRESTImage,
+        paths: [{ path: "orderPaymentRequests.image" }]
+      }
+    ]
+  );
+  const reqOpts = bulkCreateOrderPaymentRequests(
+    payload
+  );
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return renameKeysFromRESTResponseToSDKResponse(
+      transformPaths2(result.data, [
+        {
+          transformFn: transformRESTImageToSDKImage,
+          paths: [{ path: "results.item.orderPaymentRequest.image" }]
+        }
+      ])
+    );
+  } catch (err) {
+    const transformedError = sdkTransformError(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          orderPaymentRequests: "$[0]",
+          returnEntity: "$[1].returnEntity"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["orderPaymentRequests", "options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
 async function getOrderPaymentRequest2(orderPaymentRequestId) {
   const { httpClient, sideEffects } = arguments[1];
   const payload = renameKeysFromSDKRequestToRESTRequest({
@@ -646,6 +735,7 @@ export {
   SortOrder,
   Status,
   WebhookIdentityType,
+  bulkCreateOrderPaymentRequests2 as bulkCreateOrderPaymentRequests,
   createOrderPaymentRequest2 as createOrderPaymentRequest,
   deleteOrderPaymentRequest2 as deleteOrderPaymentRequest,
   getOrderPaymentRequest2 as getOrderPaymentRequest,