@wix/auto_sdk_ecom_order-payment-requests 1.0.59 → 1.0.61

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

@@ -9,12 +9,12 @@ interface OrderPaymentRequest {
      */
     _id?: string | null;
     /**
-     * Additional parameters to identify the source of the order payment request.
+     * Details about the source that created the order payment request.
      * @immutable
      */
     source?: Source;
     /**
-     * status.
+     * Payment request status. Set by the system. A new order payment request starts as `UNPAID`, unless `expirationDate` is already in the past at creation time, in which case it is created as `EXPIRED`. The system sets the status to `PAID` once payment is collected, `EXPIRED` when the expiration date passes, or `VOIDED` when the request is voided.
      * @readonly
      */
     status?: StatusWithLiterals;
@@ -31,49 +31,52 @@ interface OrderPaymentRequest {
      */
     orderNumber?: string | null;
     /**
-     * Amount to collect.
-     * > **Note:** The amount can only be set once.
+     * Amount to collect. Set when the order payment request is created and can't be changed afterward.
      * @immutable
      */
     amount?: Price;
     /**
-     * Currency code. The value will always match the currency used in the order.
+     * Three-letter currency code in [ISO-4217 alphabetic format](http://en.wikipedia.org/wiki/ISO_4217). Always matches the order's currency.
      * @format CURRENCY
      * @readonly
      */
     currency?: string;
     /**
-     * Payment gateway order id which is associated with this payment request
+     * Payment gateway order ID associated with this payment request.
      * @readonly
      * @minLength 1
      * @maxLength 100
      */
     paymentGatewayOrderId?: string | null;
     /**
-     * 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.
+     * Title displayed to the customer on the payment page.
      * @minLength 1
      * @maxLength 200
      */
     title?: string;
     /**
-     * Description to be displayed to the customer on the payment page. Write a detailed description so the customer understands what they are paying for.
+     * Description displayed to the customer on the payment page.
      * @maxLength 300
      */
     description?: string | null;
     /**
-     * Time and date the order payment request expires.
+     * Date and time the order payment request expires. If not provided, the order payment request doesn't expire.
      * @immutable
      */
     expirationDate?: Date | null;
-    /** [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. */
+    /**
+     * Custom field data for this order payment request.
+     *
+     * [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.
+     */
     extendedFields?: ExtendedFields;
     /**
-     * Date and time the OrderPaymentRequest was created.
+     * Date and time the order payment request was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date and time the OrderPaymentRequest was last updated.
+     * Date and time the order payment request was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
@@ -85,14 +88,12 @@ interface OrderPaymentRequest {
      */
     blockedPaymentMethods?: PaymentMethodWithLiterals[];
     /**
-     * A collection of action links (e.g., navigation or error resolution URLs) intended for client-side use.
-     *
-     * These actions are optional and may be conditionally rendered based on the client context.
+     * Action links rendered by the payment page, such as navigation links or error resolution URLs.
      * @internal
      */
     actionLinks?: ActionLinks;
     /**
-     * Charges information for each subscription in the order.
+     * Subscription charges for the order. Displayed to the customer on the payment page so they're aware that paying activates a subscription.
      * @internal
      * @maxSize 100
      * @readonly
@@ -101,7 +102,7 @@ interface OrderPaymentRequest {
 }
 interface Source {
     /**
-     * App Def ID that created the order payment request.
+     * ID of the app that created the order payment request.
      * @format GUID
      * @minLength 1
      * @maxLength 100
@@ -109,7 +110,7 @@ interface Source {
      */
     appId?: string | null;
     /**
-     * Reference to an ID from an external system, indicating the original source of the order payment request.
+     * 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.
      * @minLength 1
      * @maxLength 100
      * @immutable
@@ -117,10 +118,15 @@ interface Source {
     externalId?: string;
 }
 declare enum Status {
+    /** Payment is owed but hasn't been collected yet. */
     UNPAID = "UNPAID",
+    /** Payment has been collected. */
     PAID = "PAID",
+    /** The order payment request has passed its `expirationDate` without being paid. */
     EXPIRED = "EXPIRED",
-    /** @documentationMaturity preview
+    /**
+     * The order payment request was voided and can no longer be paid.
+     * @documentationMaturity preview
      * @internal
      */
     VOIDED = "VOIDED"
@@ -158,11 +164,13 @@ declare enum PaymentMethod {
 type PaymentMethodWithLiterals = PaymentMethod | 'MANUAL';
 interface ActionLinks {
     /**
-     * A general navigation action link rendered as an anchor in the UI.
+     * Navigation action links rendered as anchors on the payment page.
+     *
+     * Currently supports a single action link.
      * @maxSize 1
      */
     general?: ActionLink[];
-    /** An action link rendered as a button in error messages in the UI. */
+    /** Action link rendered as a button in error messages on the payment page. */
     error?: ActionLink;
 }
 interface ActionLink {
@@ -186,7 +194,7 @@ interface SubscriptionInfo {
      */
     title?: string;
     /**
-     * Description of the charges that will be applied for subscription.
+     * Description of the charges applied for the subscription.
      * @maxLength 1000
      */
     chargeDescription?: string | null;
@@ -198,30 +206,30 @@ interface SubscriptionInfo {
     /** Whether the subscription renews automatically. */
     autoRenewal?: boolean;
 }
-/** Triggered when the order payment request status changes to paid */
+/** Triggered when an order payment request's `status` changes to `PAID`. */
 interface OrderPaymentRequestPaid {
-    /** Order payment request */
+    /** Order payment request that was paid. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
-/** Triggered when the order payment request status changes to expired */
+/** Triggered when an order payment request's `status` changes to `EXPIRED`. */
 interface OrderPaymentRequestExpired {
-    /** Order payment request */
+    /** Order payment request that expired. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
-/** Triggered when the order payment request status changes to voided */
+/** Triggered when an order payment request's `status` changes to `VOIDED`. */
 interface OrderPaymentRequestVoided {
-    /** Order payment request */
+    /** Order payment request that was voided. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
 interface CreateOrderPaymentRequestRequest {
-    /** OrderPaymentRequest to be created. */
+    /** Order payment request to create. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
 interface CreateOrderPaymentRequestResponse {
-    /** The created OrderPaymentRequest. */
+    /** Created order payment request. */
     orderPaymentRequest?: OrderPaymentRequest;
     /**
-     * Order payment request URL.
+     * Payment page URL for the order payment request. Share this URL with the customer so they can complete the payment.
      * @minLength 1
      * @maxLength 100
      */
@@ -229,26 +237,26 @@ interface CreateOrderPaymentRequestResponse {
 }
 interface GetOrderPaymentRequestRequest {
     /**
-     * ID of the OrderPaymentRequest to retrieve.
+     * ID of the order payment request to retrieve.
      * @format GUID
      */
     orderPaymentRequestId: string;
 }
 interface GetOrderPaymentRequestResponse {
-    /** The requested OrderPaymentRequest. */
+    /** Retrieved order payment request. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
 interface UpdateOrderPaymentRequestRequest {
-    /** OrderPaymentRequest to be updated, may be partial. */
+    /** Order payment request to update. */
     orderPaymentRequest: OrderPaymentRequest;
 }
 interface UpdateOrderPaymentRequestResponse {
-    /** Updated OrderPaymentRequest. */
+    /** Updated order payment request. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
 interface DeleteOrderPaymentRequestRequest {
     /**
-     * Id of the OrderPaymentRequest to delete.
+     * ID of the order payment request to delete.
      * @format GUID
      */
     orderPaymentRequestId: string;
@@ -315,11 +323,11 @@ interface CursorPaging {
 }
 interface QueryOrderPaymentRequestsResponse {
     /**
-     * List of payment requests.
+     * List of order payment requests.
      * @maxSize 1000
      */
     orderPaymentRequests?: OrderPaymentRequest[];
-    /** Paging metadata */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
@@ -349,14 +357,14 @@ interface Cursors {
 }
 interface GetOrderPaymentRequestURLRequest {
     /**
-     * Order Payment Request ID.
+     * ID of the order payment request.
      * @format GUID
      */
     orderPaymentRequestId: string;
 }
 interface GetOrderPaymentRequestURLResponse {
     /**
-     * Order Payment Request URL.
+     * Payment page URL for the order payment request.
      * @minLength 1
      * @maxLength 100
      */
@@ -371,7 +379,7 @@ interface UpdateExtendedFieldsRequest {
     namespaceData: Record<string, any> | null;
 }
 interface UpdateExtendedFieldsResponse {
-    /** Updated OrderPaymentRequest. */
+    /** Updated order payment request. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
 interface VoidOrderPaymentRequestRequest {
@@ -551,6 +559,10 @@ type CreateOrderPaymentRequestApplicationErrors = {
     code?: 'INVALID_ORDER_STATUS_FOR_SUBSCRIPTION';
     description?: string;
     data?: Record<string, any>;
+} | {
+    code?: 'ORDER_PAYMENT_REQUEST_PAGE_NOT_FOUND';
+    description?: string;
+    data?: Record<string, any>;
 };
 /** @docsIgnore */
 type GetOrderPaymentRequestApplicationErrors = {
@@ -572,7 +584,7 @@ type UpdateOrderPaymentRequestApplicationErrors = {
     description?: string;
     data?: Record<string, any>;
 } | {
-    code?: 'CANNOT_UPDATE_SUBSCRIPTION_ORDER_PAYMENT_REQUEST_PRICE';
+    code?: 'CANNOT_UPDATE_ORDER_PAYMENT_REQUEST_AMOUNT';
     description?: string;
     data?: Record<string, any>;
 };
@@ -606,8 +618,193 @@ type VoidOrderPaymentRequestApplicationErrors = {
     description?: string;
     data?: Record<string, any>;
 };
+interface BaseEventMetadata {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+    /** Details related to the account */
+    accountInfo?: AccountInfo;
+}
+interface EventMetadata extends BaseEventMetadata {
+    /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
+    _id?: string;
+    /**
+     * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+     * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+     */
+    entityFqdn?: string;
+    /**
+     * Event action name, placed at the top level to make it easier for users to dispatch messages.
+     * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at `16:00` and then again at `16:01`, the second update will always have a higher sequence number.
+     * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+     */
+    entityEventSequence?: string | null;
+    accountInfo?: AccountInfoMetadata;
+}
+interface AccountInfoMetadata {
+    /** ID of the Wix account associated with the event */
+    accountId: string;
+    /** ID of the Wix site associated with the event. Only included when the event is tied to a specific site. */
+    siteId?: string;
+    /** ID of the parent Wix account. Only included when 'accountId' belongs to a child account. */
+    parentAccountId?: string;
+}
+interface OrderPaymentRequestCreatedEnvelope {
+    entity: OrderPaymentRequest;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when an order payment request is created.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
+ * @webhook
+ * @eventType wix.ecom.v1.order_payment_request_created
+ * @slug created
+ * @documentationMaturity preview
+ */
+declare function onOrderPaymentRequestCreated(handler: (event: OrderPaymentRequestCreatedEnvelope) => void | Promise<void>): void;
+interface OrderPaymentRequestDeletedEnvelope {
+    entity: OrderPaymentRequest;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when an order payment request is deleted.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
+ * @webhook
+ * @eventType wix.ecom.v1.order_payment_request_deleted
+ * @slug deleted
+ * @documentationMaturity preview
+ */
+declare function onOrderPaymentRequestDeleted(handler: (event: OrderPaymentRequestDeletedEnvelope) => void | Promise<void>): void;
+interface OrderPaymentRequestExpiredEnvelope {
+    data: OrderPaymentRequestExpired;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when an order payment request's `status` changes to `EXPIRED`.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
+ * @webhook
+ * @eventType wix.ecom.v1.order_payment_request_expired
+ * @slug expired
+ * @documentationMaturity preview
+ */
+declare function onOrderPaymentRequestExpired(handler: (event: OrderPaymentRequestExpiredEnvelope) => void | Promise<void>): void;
+interface OrderPaymentRequestPaidEnvelope {
+    data: OrderPaymentRequestPaid;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when an order payment request's `status` changes to `PAID`.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
+ * @webhook
+ * @eventType wix.ecom.v1.order_payment_request_paid
+ * @slug paid
+ * @documentationMaturity preview
+ */
+declare function onOrderPaymentRequestPaid(handler: (event: OrderPaymentRequestPaidEnvelope) => void | Promise<void>): void;
+interface OrderPaymentRequestUpdatedEnvelope {
+    entity: OrderPaymentRequest;
+    metadata: EventMetadata;
+}
 /**
- * Creates a order payment request.
+ * Triggered when an order payment request is updated.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
+ * @webhook
+ * @eventType wix.ecom.v1.order_payment_request_updated
+ * @slug updated
+ * @documentationMaturity preview
+ */
+declare function onOrderPaymentRequestUpdated(handler: (event: OrderPaymentRequestUpdatedEnvelope) => void | Promise<void>): void;
+interface OrderPaymentRequestVoidedEnvelope {
+    data: OrderPaymentRequestVoided;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when an order payment request's `status` changes to `VOIDED`.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
+ * @permissionScope Manage Stores
+ * @permissionScopeId SCOPE.STORES.MANAGE-STORES
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
+ * @permissionScope Manage eCommerce - all permissions
+ * @permissionScopeId SCOPE.DC-ECOM-MEGA.MANAGE-ECOM
+ * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
+ * @webhook
+ * @eventType wix.ecom.v1.order_payment_request_voided
+ * @slug voided
+ * @documentationMaturity preview
+ */
+declare function onOrderPaymentRequestVoided(handler: (event: OrderPaymentRequestVoidedEnvelope) => void | Promise<void>): void;
+/**
+ * Creates an order payment request.
+ *
+ * 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).
+ *
+ * Creation fails with `ORDER_PAYMENT_REQUEST_PAGE_NOT_FOUND` if the site doesn't have a Payment Request Page added and published.
  * @public
  * @documentationMaturity preview
  * @requiredField options.orderPaymentRequest.amount
@@ -615,34 +812,34 @@ type VoidOrderPaymentRequestApplicationErrors = {
  * @requiredField options.orderPaymentRequest.title
  * @permissionId ECOM.ORDER_PAYMENT_REQUEST_CREATE
  * @applicableIdentity APP
- * @returns The created OrderPaymentRequest.
+ * @returns Created order payment request.
  * @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.CreateOrderPaymentRequest
  */
 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> & {
     __applicationErrorsType?: CreateOrderPaymentRequestApplicationErrors;
 }>;
 interface CreateOrderPaymentRequestOptions {
-    /** OrderPaymentRequest to be created. */
+    /** Order payment request to create. */
     orderPaymentRequest?: OrderPaymentRequest;
 }
 /**
- * Retrieves a order payment request.
- * @param orderPaymentRequestId - ID of the OrderPaymentRequest to retrieve.
+ * Retrieves an order payment request.
+ * @param orderPaymentRequestId - ID of the order payment request to retrieve.
  * @public
  * @documentationMaturity preview
  * @requiredField orderPaymentRequestId
  * @permissionId ECOM.ORDER_PAYMENT_REQUEST_READ
  * @applicableIdentity APP
- * @returns The requested OrderPaymentRequest.
+ * @returns Retrieved order payment request.
  * @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.GetOrderPaymentRequest
  */
 declare function getOrderPaymentRequest(orderPaymentRequestId: string): Promise<NonNullablePaths<OrderPaymentRequest, `source.externalId` | `status` | `orderId` | `amount.amount` | `amount.formattedAmount` | `currency` | `title` | `blockedPaymentMethods`, 3> & {
     __applicationErrorsType?: GetOrderPaymentRequestApplicationErrors;
 }>;
 /**
- * Updates a order payment request.
+ * Updates an order payment request.
  *
- * Please note that only `UNPAID` payment requests can be updated.
+ * Only `UNPAID` order payment requests can be updated. The `amount` can't be changed after the order payment request is created.
  * @param _id - Order payment request ID.
  * @public
  * @documentationMaturity preview
@@ -650,7 +847,7 @@ declare function getOrderPaymentRequest(orderPaymentRequestId: string): Promise<
  * @requiredField orderPaymentRequest
  * @permissionId ECOM.ORDER_PAYMENT_REQUEST_UPDATE
  * @applicableIdentity APP
- * @returns Updated OrderPaymentRequest.
+ * @returns Updated order payment request.
  * @fqn wix.ecom.order_payment_request.api.v1.OrderPaymentRequestsService.UpdateOrderPaymentRequest
  */
 declare function updateOrderPaymentRequest(_id: string, orderPaymentRequest: UpdateOrderPaymentRequest): Promise<NonNullablePaths<OrderPaymentRequest, `source.externalId` | `status` | `orderId` | `amount.amount` | `amount.formattedAmount` | `currency` | `title` | `blockedPaymentMethods`, 3> & {
@@ -664,12 +861,12 @@ interface UpdateOrderPaymentRequest {
      */
     _id?: string | null;
     /**
-     * Additional parameters to identify the source of the order payment request.
+     * Details about the source that created the order payment request.
      * @immutable
      */
     source?: Source;
     /**
-     * status.
+     * Payment request status. Set by the system. A new order payment request starts as `UNPAID`, unless `expirationDate` is already in the past at creation time, in which case it is created as `EXPIRED`. The system sets the status to `PAID` once payment is collected, `EXPIRED` when the expiration date passes, or `VOIDED` when the request is voided.
      * @readonly
      */
     status?: StatusWithLiterals;
@@ -686,49 +883,52 @@ interface UpdateOrderPaymentRequest {
      */
     orderNumber?: string | null;
     /**
-     * Amount to collect.
-     * > **Note:** The amount can only be set once.
+     * Amount to collect. Set when the order payment request is created and can't be changed afterward.
      * @immutable
      */
     amount?: Price;
     /**
-     * Currency code. The value will always match the currency used in the order.
+     * Three-letter currency code in [ISO-4217 alphabetic format](http://en.wikipedia.org/wiki/ISO_4217). Always matches the order's currency.
      * @format CURRENCY
      * @readonly
      */
     currency?: string;
     /**
-     * Payment gateway order id which is associated with this payment request
+     * Payment gateway order ID associated with this payment request.
      * @readonly
      * @minLength 1
      * @maxLength 100
      */
     paymentGatewayOrderId?: string | null;
     /**
-     * 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.
+     * Title displayed to the customer on the payment page.
      * @minLength 1
      * @maxLength 200
      */
     title?: string;
     /**
-     * Description to be displayed to the customer on the payment page. Write a detailed description so the customer understands what they are paying for.
+     * Description displayed to the customer on the payment page.
      * @maxLength 300
      */
     description?: string | null;
     /**
-     * Time and date the order payment request expires.
+     * Date and time the order payment request expires. If not provided, the order payment request doesn't expire.
      * @immutable
      */
     expirationDate?: Date | null;
-    /** [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. */
+    /**
+     * Custom field data for this order payment request.
+     *
+     * [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.
+     */
     extendedFields?: ExtendedFields;
     /**
-     * Date and time the OrderPaymentRequest was created.
+     * Date and time the order payment request was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date and time the OrderPaymentRequest was last updated.
+     * Date and time the order payment request was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
@@ -740,14 +940,12 @@ interface UpdateOrderPaymentRequest {
      */
     blockedPaymentMethods?: PaymentMethodWithLiterals[];
     /**
-     * A collection of action links (e.g., navigation or error resolution URLs) intended for client-side use.
-     *
-     * These actions are optional and may be conditionally rendered based on the client context.
+     * Action links rendered by the payment page, such as navigation links or error resolution URLs.
      * @internal
      */
     actionLinks?: ActionLinks;
     /**
-     * Charges information for each subscription in the order.
+     * Subscription charges for the order. Displayed to the customer on the payment page so they're aware that paying activates a subscription.
      * @internal
      * @maxSize 100
      * @readonly
@@ -755,10 +953,10 @@ interface UpdateOrderPaymentRequest {
     subscriptionInfo?: SubscriptionInfo[];
 }
 /**
- * Deletes a order payment request.
+ * Deletes an order payment request.
  *
- * Please note that only `UNPAID` and `VOIDED` payment requests can be deleted.
- * @param orderPaymentRequestId - Id of the OrderPaymentRequest to delete.
+ * 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`.
+ * @param orderPaymentRequestId - ID of the order payment request to delete.
  * @public
  * @documentationMaturity preview
  * @requiredField orderPaymentRequestId
@@ -770,11 +968,11 @@ declare function deleteOrderPaymentRequest(orderPaymentRequestId: string): Promi
     __applicationErrorsType?: DeleteOrderPaymentRequestApplicationErrors;
 }>;
 /**
- * Retrieves a list of Payment Requests, given the provided [paging, filtering, and sorting][1].
+ * 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).
  *
- * Query Payment Requests runs with these defaults, which you can override:
- * - `createdDate` is sorted in DESC order
- * - `cursorPaging.limit` is 100
+ * Query Order Payment Requests runs with these defaults, which you can override:
+ * - `_createdDate` is sorted in `DESC` order
+ * - `cursorPaging.limit` is `100`
  *
  * To learn about working with _Query_ endpoints, see
  * [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language), and
@@ -957,8 +1155,8 @@ declare const utils: {
     };
 };
 /**
- * Retrieves the order payment request page URL of a specified order payment request.
- * @param orderPaymentRequestId - Order Payment Request ID.
+ * Retrieves the payment page URL for an order payment request.
+ * @param orderPaymentRequestId - ID of the order payment request.
  * @public
  * @documentationMaturity preview
  * @requiredField orderPaymentRequestId
@@ -970,7 +1168,7 @@ declare function getOrderPaymentRequestUrl(orderPaymentRequestId: string): Promi
     __applicationErrorsType?: GetOrderPaymentRequestUrlApplicationErrors;
 }>;
 /**
- * Updates extended fields of a order payment request
+ * Updates the extended fields of an order payment request.
  * @param _id - ID of the entity to update.
  * @param namespace - Identifier for the app whose extended fields are being updated.
  * @public
@@ -989,9 +1187,9 @@ interface UpdateExtendedFieldsOptions {
     namespaceData: Record<string, any> | null;
 }
 /**
- * Voids the given order payment request
+ * Voids the given order payment request.
  *
- * Please note that only `UNPAID` payment requests can be voided.
+ * 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
  * @documentationMaturity preview
@@ -1004,4 +1202,4 @@ declare function voidOrderPaymentRequest(orderPaymentRequestId: string): Promise
     __applicationErrorsType?: VoidOrderPaymentRequestApplicationErrors;
 }>;
 
-export { type AccountInfo, type ActionEvent, type ActionLink, type ActionLinks, 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 ExtendedFields, type GetOrderPaymentRequestApplicationErrors, type GetOrderPaymentRequestRequest, type GetOrderPaymentRequestResponse, type GetOrderPaymentRequestURLRequest, type GetOrderPaymentRequestURLResponse, type GetOrderPaymentRequestUrlApplicationErrors, type IdentificationData, type IdentificationDataIdOneOf, type MessageEnvelope, type OrderPaymentRequest, type OrderPaymentRequestExpired, type OrderPaymentRequestPaid, type OrderPaymentRequestQuery, type OrderPaymentRequestQuerySpec, type OrderPaymentRequestVoided, 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, queryOrderPaymentRequests, typedQueryOrderPaymentRequests, updateExtendedFields, updateOrderPaymentRequest, utils, voidOrderPaymentRequest };
+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 };