@wix/auto_sdk_payments_saved-payment-methods 1.0.41 → 1.0.43

package/build/es/schemas.mjs

@@ -2,25 +2,25 @@
 import * as z from "zod";
 var UpsertSavedPaymentMethodRequest = z.object({
   savedPaymentMethod: z.object({
-    _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+    _id: z.string().describe("Saved payment method ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-      "Represents the current state of a saved payment method. Each time saved payment method is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision."
+      "Revision number, which increments by 1 each time the saved payment method is updated.\nTo prevent conflicting changes, the current revision must be passed when updating the saved payment method."
     ).optional().nullable(),
-    _createdDate: z.date().describe("SavedPaymentMethod creation time.").optional().nullable(),
-    _updatedDate: z.date().describe("SavedPaymentMethod last update time.").optional().nullable(),
-    siteMemberId: z.string().describe("Saved payment method owner's member ID.").regex(
+    _createdDate: z.date().describe("Date and time the saved payment method was created.").optional().nullable(),
+    _updatedDate: z.date().describe("Date and time the saved payment method was last updated.").optional().nullable(),
+    siteMemberId: z.string().describe("ID of the site member who owns this saved payment method.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     primary: z.boolean().describe(
-      "Defines whether this payment method is primary for the member. Member can only have at most one primary saved payment method."
+      "Whether this saved payment method is the primary one for the member. Each member can have at most one primary saved payment method. The primary method is selected by default during checkout."
     ).optional(),
     paymentMethod: z.object({
       typeId: z.string().describe(
-        "Legacy payment method type ID. Supported values are `creditCard`, `payPal`."
+        "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
       ).min(1).max(100),
       paymentMethodTypeId: z.string().describe("Payment method type ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
@@ -31,35 +31,39 @@ var UpsertSavedPaymentMethodRequest = z.object({
         "Must be a valid GUID"
       ).optional().nullable(),
       cardInfo: z.object({
-        lastFourDigits: z.string().describe("Credit card's last 4 digits.").min(4).max(4).optional().nullable(),
+        lastFourDigits: z.string().describe("Payment card's last 4 digits.").min(4).max(4).optional().nullable(),
         bin: z.string().describe(
-          "Credit card's BIN (Bank Identification Number). It's first 4-6 digits of card's number."
+          "Payment card's BIN (Bank Identification Number). First 4-6 digits of the card number."
         ).min(4).max(6).optional().nullable(),
-        expirationMonth: z.number().int().describe("Credit card's expiration month.").min(1).max(12),
-        expirationYear: z.number().int().describe("Credit card's expiration year.").min(2e3).max(2099),
-        cardholderName: z.string().describe("Card holder's full name specified on the card.").min(1).max(1e3).optional().nullable()
-      }).describe("Details of credit card.").optional()
+        expirationMonth: z.number().int().describe("Payment card's expiration month.").min(1).max(12),
+        expirationYear: z.number().int().describe("Payment card's expiration year.").min(2e3).max(2099),
+        cardholderName: z.string().describe("Cardholder's full name as it appears on the card.").min(1).max(1e3).optional().nullable()
+      }).describe("Payment card details.").optional()
     }).describe("Payment method details."),
     merchantUseAllowed: z.boolean().describe(
-      "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+      "Whether the merchant can use this payment method for unscheduled payments, such as manual charges.\nEven when set to `false`, the payment method can still be used for scheduled payments such as subscription renewals without the buyer being present."
     ).optional().nullable(),
     sensitiveInfo: z.object({
       cardSensitiveInfo: z.object({
-        persistentToken: z.string().describe("Persistent token of credit card tokenized by Wix.").regex(
+        persistentToken: z.string().describe(
+          "Persistent token of a payment card tokenized by Wix."
+        ).regex(
           /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
           "Must be a valid GUID"
         ).optional().nullable()
-      }).describe("Sensitive details of credit card like card token.").optional()
-    }).describe("Saved payment method sensitive information.").optional(),
+      }).describe("Payment card sensitive details.").optional()
+    }).describe("Saved payment method's sensitive information.").optional(),
     extendedFields: z.object({
       namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
         "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
       ).optional()
-    }).describe("Data Extensions").optional()
-  }).describe("Saved payment method."),
+    }).describe(
+      "Custom field data for the saved payment method object.\n\n[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."
+    ).optional()
+  }).describe("Saved payment method to create or update."),
   options: z.object({
     temporaryCardToken: z.string().describe(
-      "Temporary token of credit card tokenized by Wix. This token is used to create a persistent token"
+      "Temporary token of a payment card tokenized by Wix. Used to create a persistent token for future transactions."
     ).regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
@@ -68,25 +72,25 @@ var UpsertSavedPaymentMethodRequest = z.object({
 });
 var UpsertSavedPaymentMethodResponse = z.object({
   savedPaymentMethod: z.object({
-    _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+    _id: z.string().describe("Saved payment method ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-      "Represents the current state of a saved payment method. Each time saved payment method is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision."
+      "Revision number, which increments by 1 each time the saved payment method is updated.\nTo prevent conflicting changes, the current revision must be passed when updating the saved payment method."
     ).optional().nullable(),
-    _createdDate: z.date().describe("SavedPaymentMethod creation time.").optional().nullable(),
-    _updatedDate: z.date().describe("SavedPaymentMethod last update time.").optional().nullable(),
-    siteMemberId: z.string().describe("Saved payment method owner's member ID.").regex(
+    _createdDate: z.date().describe("Date and time the saved payment method was created.").optional().nullable(),
+    _updatedDate: z.date().describe("Date and time the saved payment method was last updated.").optional().nullable(),
+    siteMemberId: z.string().describe("ID of the site member who owns this saved payment method.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
       "Must be a valid GUID"
     ).optional().nullable(),
     primary: z.boolean().describe(
-      "Defines whether this payment method is primary for the member. Member can only have at most one primary saved payment method."
+      "Whether this saved payment method is the primary one for the member. Each member can have at most one primary saved payment method. The primary method is selected by default during checkout."
     ).optional(),
     paymentMethod: z.object({
       typeId: z.string().describe(
-        "Legacy payment method type ID. Supported values are `creditCard`, `payPal`."
+        "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
       ).min(1).max(100).optional(),
       paymentMethodTypeId: z.string().describe("Payment method type ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
@@ -97,32 +101,36 @@ var UpsertSavedPaymentMethodResponse = z.object({
         "Must be a valid GUID"
       ).optional().nullable(),
       cardInfo: z.object({
-        lastFourDigits: z.string().describe("Credit card's last 4 digits.").min(4).max(4).optional().nullable(),
+        lastFourDigits: z.string().describe("Payment card's last 4 digits.").min(4).max(4).optional().nullable(),
         bin: z.string().describe(
-          "Credit card's BIN (Bank Identification Number). It's first 4-6 digits of card's number."
+          "Payment card's BIN (Bank Identification Number). First 4-6 digits of the card number."
         ).min(4).max(6).optional().nullable(),
-        expirationMonth: z.number().int().describe("Credit card's expiration month.").min(1).max(12).optional().nullable(),
-        expirationYear: z.number().int().describe("Credit card's expiration year.").min(2e3).max(2099).optional().nullable(),
-        cardholderName: z.string().describe("Card holder's full name specified on the card.").min(1).max(1e3).optional().nullable()
-      }).describe("Details of credit card.").optional()
+        expirationMonth: z.number().int().describe("Payment card's expiration month.").min(1).max(12).optional().nullable(),
+        expirationYear: z.number().int().describe("Payment card's expiration year.").min(2e3).max(2099).optional().nullable(),
+        cardholderName: z.string().describe("Cardholder's full name as it appears on the card.").min(1).max(1e3).optional().nullable()
+      }).describe("Payment card details.").optional()
     }).describe("Payment method details.").optional(),
     merchantUseAllowed: z.boolean().describe(
-      "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+      "Whether the merchant can use this payment method for unscheduled payments, such as manual charges.\nEven when set to `false`, the payment method can still be used for scheduled payments such as subscription renewals without the buyer being present."
     ).optional().nullable(),
     sensitiveInfo: z.object({
       cardSensitiveInfo: z.object({
-        persistentToken: z.string().describe("Persistent token of credit card tokenized by Wix.").regex(
+        persistentToken: z.string().describe(
+          "Persistent token of a payment card tokenized by Wix."
+        ).regex(
           /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
           "Must be a valid GUID"
         ).optional().nullable()
-      }).describe("Sensitive details of credit card like card token.").optional()
-    }).describe("Saved payment method sensitive information.").optional(),
+      }).describe("Payment card sensitive details.").optional()
+    }).describe("Saved payment method's sensitive information.").optional(),
     extendedFields: z.object({
       namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
         "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
       ).optional()
-    }).describe("Data Extensions").optional()
-  }).describe("Saved payment method.").optional()
+    }).describe(
+      "Custom field data for the saved payment method object.\n\n[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."
+    ).optional()
+  }).describe("Created or updated saved payment method.").optional()
 });
 var GetSavedPaymentMethodRequest = z.object({
   savedPaymentMethodId: z.string().describe("Unique identifier of a saved payment method.").regex(
@@ -134,25 +142,25 @@ var GetSavedPaymentMethodRequest = z.object({
   }).optional()
 });
 var GetSavedPaymentMethodResponse = z.object({
-  _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+  _id: z.string().describe("Saved payment method ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-    "Represents the current state of a saved payment method. Each time saved payment method is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision."
+    "Revision number, which increments by 1 each time the saved payment method is updated.\nTo prevent conflicting changes, the current revision must be passed when updating the saved payment method."
   ).optional().nullable(),
-  _createdDate: z.date().describe("SavedPaymentMethod creation time.").optional().nullable(),
-  _updatedDate: z.date().describe("SavedPaymentMethod last update time.").optional().nullable(),
-  siteMemberId: z.string().describe("Saved payment method owner's member ID.").regex(
+  _createdDate: z.date().describe("Date and time the saved payment method was created.").optional().nullable(),
+  _updatedDate: z.date().describe("Date and time the saved payment method was last updated.").optional().nullable(),
+  siteMemberId: z.string().describe("ID of the site member who owns this saved payment method.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   primary: z.boolean().describe(
-    "Defines whether this payment method is primary for the member. Member can only have at most one primary saved payment method."
+    "Whether this saved payment method is the primary one for the member. Each member can have at most one primary saved payment method. The primary method is selected by default during checkout."
   ).optional(),
   paymentMethod: z.object({
     typeId: z.string().describe(
-      "Legacy payment method type ID. Supported values are `creditCard`, `payPal`."
+      "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
     ).min(1).max(100).optional(),
     paymentMethodTypeId: z.string().describe("Payment method type ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
@@ -163,31 +171,33 @@ var GetSavedPaymentMethodResponse = z.object({
       "Must be a valid GUID"
     ).optional().nullable(),
     cardInfo: z.object({
-      lastFourDigits: z.string().describe("Credit card's last 4 digits.").min(4).max(4).optional().nullable(),
+      lastFourDigits: z.string().describe("Payment card's last 4 digits.").min(4).max(4).optional().nullable(),
       bin: z.string().describe(
-        "Credit card's BIN (Bank Identification Number). It's first 4-6 digits of card's number."
+        "Payment card's BIN (Bank Identification Number). First 4-6 digits of the card number."
       ).min(4).max(6).optional().nullable(),
-      expirationMonth: z.number().int().describe("Credit card's expiration month.").min(1).max(12).optional().nullable(),
-      expirationYear: z.number().int().describe("Credit card's expiration year.").min(2e3).max(2099).optional().nullable(),
-      cardholderName: z.string().describe("Card holder's full name specified on the card.").min(1).max(1e3).optional().nullable()
-    }).describe("Details of credit card.").optional()
+      expirationMonth: z.number().int().describe("Payment card's expiration month.").min(1).max(12).optional().nullable(),
+      expirationYear: z.number().int().describe("Payment card's expiration year.").min(2e3).max(2099).optional().nullable(),
+      cardholderName: z.string().describe("Cardholder's full name as it appears on the card.").min(1).max(1e3).optional().nullable()
+    }).describe("Payment card details.").optional()
   }).describe("Payment method details.").optional(),
   merchantUseAllowed: z.boolean().describe(
-    "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+    "Whether the merchant can use this payment method for unscheduled payments, such as manual charges.\nEven when set to `false`, the payment method can still be used for scheduled payments such as subscription renewals without the buyer being present."
   ).optional().nullable(),
   sensitiveInfo: z.object({
     cardSensitiveInfo: z.object({
-      persistentToken: z.string().describe("Persistent token of credit card tokenized by Wix.").regex(
+      persistentToken: z.string().describe("Persistent token of a payment card tokenized by Wix.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable()
-    }).describe("Sensitive details of credit card like card token.").optional()
-  }).describe("Saved payment method sensitive information.").optional(),
+    }).describe("Payment card sensitive details.").optional()
+  }).describe("Saved payment method's sensitive information.").optional(),
   extendedFields: z.object({
     namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
       "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
     ).optional()
-  }).describe("Data Extensions").optional()
+  }).describe(
+    "Custom field data for the saved payment method object.\n\n[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."
+  ).optional()
 });
 var DeleteSavedPaymentMethodRequest = z.object({
   savedPaymentMethodId: z.string().describe("Unique identifier of a saved payment method.").regex(
@@ -199,13 +209,13 @@ var DeleteSavedPaymentMethodResponse = z.object({});
 var ListSavedPaymentMethodsRequest = z.object({
   options: z.object({
     siteMemberId: z.string().describe(
-      "Site member that owns saved payment methods.\nPass `me` to list saved payment method of the current site member."
+      "ID of the site member whose saved payment methods to list. Pass `me` to list the current site member's saved payment methods."
     ).min(2).max(36).optional().nullable(),
     paymentMethodTypeId: z.string().describe(
-      "Payment method type id. Supported values are `creditCard`, `payPal`."
+      "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
     ).min(1).max(100).optional().nullable(),
     merchantUseAllowed: z.boolean().describe(
-      "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+      "Whether to filter by saved payment methods that are allowed for unscheduled merchant-initiated payments."
     ).optional().nullable(),
     fields: z.array(z.enum(["SENSITIVE_INFO"])).max(1).optional(),
     paging: z.object({
@@ -214,32 +224,32 @@ var ListSavedPaymentMethodsRequest = z.object({
         "Pointer to the next or previous page in the list of results.\n\nPass the relevant cursor token from the `pagingMetadata` object in the previous call's response.\nNot relevant for the first request."
       ).max(16e3).optional().nullable()
     }).describe(
-      "Paging for limit the response size.\nIf no paging provider default response limit 100 will be used."
+      "Cursor paging parameters.\n\nDefault: `100` results per page."
     ).optional()
   }).optional()
 });
 var ListSavedPaymentMethodsResponse = z.object({
   savedPaymentMethods: z.array(
     z.object({
-      _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+      _id: z.string().describe("Saved payment method ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of a saved payment method. Each time saved payment method is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision."
+        "Revision number, which increments by 1 each time the saved payment method is updated.\nTo prevent conflicting changes, the current revision must be passed when updating the saved payment method."
       ).optional().nullable(),
-      _createdDate: z.date().describe("SavedPaymentMethod creation time.").optional().nullable(),
-      _updatedDate: z.date().describe("SavedPaymentMethod last update time.").optional().nullable(),
-      siteMemberId: z.string().describe("Saved payment method owner's member ID.").regex(
+      _createdDate: z.date().describe("Date and time the saved payment method was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the saved payment method was last updated.").optional().nullable(),
+      siteMemberId: z.string().describe("ID of the site member who owns this saved payment method.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       primary: z.boolean().describe(
-        "Defines whether this payment method is primary for the member. Member can only have at most one primary saved payment method."
+        "Whether this saved payment method is the primary one for the member. Each member can have at most one primary saved payment method. The primary method is selected by default during checkout."
       ).optional(),
       paymentMethod: z.object({
         typeId: z.string().describe(
-          "Legacy payment method type ID. Supported values are `creditCard`, `payPal`."
+          "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
         ).min(1).max(100).optional(),
         paymentMethodTypeId: z.string().describe("Payment method type ID.").regex(
           /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
@@ -250,31 +260,35 @@ var ListSavedPaymentMethodsResponse = z.object({
           "Must be a valid GUID"
         ).optional().nullable(),
         cardInfo: z.object({
-          lastFourDigits: z.string().describe("Credit card's last 4 digits.").min(4).max(4).optional().nullable(),
+          lastFourDigits: z.string().describe("Payment card's last 4 digits.").min(4).max(4).optional().nullable(),
           bin: z.string().describe(
-            "Credit card's BIN (Bank Identification Number). It's first 4-6 digits of card's number."
+            "Payment card's BIN (Bank Identification Number). First 4-6 digits of the card number."
           ).min(4).max(6).optional().nullable(),
-          expirationMonth: z.number().int().describe("Credit card's expiration month.").min(1).max(12).optional().nullable(),
-          expirationYear: z.number().int().describe("Credit card's expiration year.").min(2e3).max(2099).optional().nullable(),
-          cardholderName: z.string().describe("Card holder's full name specified on the card.").min(1).max(1e3).optional().nullable()
-        }).describe("Details of credit card.").optional()
+          expirationMonth: z.number().int().describe("Payment card's expiration month.").min(1).max(12).optional().nullable(),
+          expirationYear: z.number().int().describe("Payment card's expiration year.").min(2e3).max(2099).optional().nullable(),
+          cardholderName: z.string().describe("Cardholder's full name as it appears on the card.").min(1).max(1e3).optional().nullable()
+        }).describe("Payment card details.").optional()
       }).describe("Payment method details.").optional(),
       merchantUseAllowed: z.boolean().describe(
-        "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+        "Whether the merchant can use this payment method for unscheduled payments, such as manual charges.\nEven when set to `false`, the payment method can still be used for scheduled payments such as subscription renewals without the buyer being present."
       ).optional().nullable(),
       sensitiveInfo: z.object({
         cardSensitiveInfo: z.object({
-          persistentToken: z.string().describe("Persistent token of credit card tokenized by Wix.").regex(
+          persistentToken: z.string().describe(
+            "Persistent token of a payment card tokenized by Wix."
+          ).regex(
             /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
             "Must be a valid GUID"
           ).optional().nullable()
-        }).describe("Sensitive details of credit card like card token.").optional()
-      }).describe("Saved payment method sensitive information.").optional(),
+        }).describe("Payment card sensitive details.").optional()
+      }).describe("Saved payment method's sensitive information.").optional(),
       extendedFields: z.object({
         namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
           "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
         ).optional()
-      }).describe("Data Extensions").optional()
+      }).describe(
+        "Custom field data for the saved payment method object.\n\n[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."
+      ).optional()
     })
   ).optional(),
   pagingMetadata: z.object({
@@ -292,34 +306,38 @@ var ListSavedPaymentMethodsResponse = z.object({
     hasNext: z.boolean().describe(
       "Whether there are more pages to retrieve following the current page.\n\n+ `true`: Another page of results can be retrieved.\n+ `false`: This is the last page."
     ).optional().nullable()
-  }).describe("Paging metadata.").optional()
+  }).describe("Details on the paged set of results returned.").optional()
 });
 var UpdateSavedPaymentMethodRequest = z.object({
-  _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+  _id: z.string().describe("Saved payment method ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ),
   options: z.object({
     savedPaymentMethod: z.object({
-      _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+      _id: z.string().describe("Saved payment method ID.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-        "Represents the current state of a saved payment method. Each time saved payment method is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision."
+        "Revision number, which increments by 1 each time the saved payment method is updated.\nTo prevent conflicting changes, the current revision must be passed when updating the saved payment method."
       ),
-      _createdDate: z.date().describe("SavedPaymentMethod creation time.").optional().nullable(),
-      _updatedDate: z.date().describe("SavedPaymentMethod last update time.").optional().nullable(),
-      siteMemberId: z.string().describe("Saved payment method owner's member ID.").regex(
+      _createdDate: z.date().describe("Date and time the saved payment method was created.").optional().nullable(),
+      _updatedDate: z.date().describe(
+        "Date and time the saved payment method was last updated."
+      ).optional().nullable(),
+      siteMemberId: z.string().describe(
+        "ID of the site member who owns this saved payment method."
+      ).regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable(),
       primary: z.boolean().describe(
-        "Defines whether this payment method is primary for the member. Member can only have at most one primary saved payment method."
+        "Whether this saved payment method is the primary one for the member. Each member can have at most one primary saved payment method. The primary method is selected by default during checkout."
       ).optional(),
       paymentMethod: z.object({
         typeId: z.string().describe(
-          "Legacy payment method type ID. Supported values are `creditCard`, `payPal`."
+          "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
         ).min(1).max(100).optional(),
         paymentMethodTypeId: z.string().describe("Payment method type ID.").regex(
           /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
@@ -330,56 +348,60 @@ var UpdateSavedPaymentMethodRequest = z.object({
           "Must be a valid GUID"
         ).optional().nullable(),
         cardInfo: z.object({
-          lastFourDigits: z.string().describe("Credit card's last 4 digits.").min(4).max(4).optional().nullable(),
+          lastFourDigits: z.string().describe("Payment card's last 4 digits.").min(4).max(4).optional().nullable(),
           bin: z.string().describe(
-            "Credit card's BIN (Bank Identification Number). It's first 4-6 digits of card's number."
+            "Payment card's BIN (Bank Identification Number). First 4-6 digits of the card number."
           ).min(4).max(6).optional().nullable(),
-          expirationMonth: z.number().int().describe("Credit card's expiration month.").min(1).max(12).optional().nullable(),
-          expirationYear: z.number().int().describe("Credit card's expiration year.").min(2e3).max(2099).optional().nullable(),
-          cardholderName: z.string().describe("Card holder's full name specified on the card.").min(1).max(1e3).optional().nullable()
-        }).describe("Details of credit card.").optional()
+          expirationMonth: z.number().int().describe("Payment card's expiration month.").min(1).max(12).optional().nullable(),
+          expirationYear: z.number().int().describe("Payment card's expiration year.").min(2e3).max(2099).optional().nullable(),
+          cardholderName: z.string().describe(
+            "Cardholder's full name as it appears on the card."
+          ).min(1).max(1e3).optional().nullable()
+        }).describe("Payment card details.").optional()
       }).describe("Payment method details.").optional(),
       merchantUseAllowed: z.boolean().describe(
-        "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+        "Whether the merchant can use this payment method for unscheduled payments, such as manual charges.\nEven when set to `false`, the payment method can still be used for scheduled payments such as subscription renewals without the buyer being present."
       ).optional().nullable(),
       sensitiveInfo: z.object({
         cardSensitiveInfo: z.object({
           persistentToken: z.string().describe(
-            "Persistent token of credit card tokenized by Wix."
+            "Persistent token of a payment card tokenized by Wix."
           ).regex(
             /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
             "Must be a valid GUID"
           ).optional().nullable()
-        }).describe("Sensitive details of credit card like card token.").optional()
-      }).describe("Saved payment method sensitive information.").optional(),
+        }).describe("Payment card sensitive details.").optional()
+      }).describe("Saved payment method's sensitive information.").optional(),
       extendedFields: z.object({
         namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
           "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
         ).optional()
-      }).describe("Data Extensions").optional()
+      }).describe(
+        "Custom field data for the saved payment method object.\n\n[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."
+      ).optional()
     }).describe("Saved payment method to update.").optional()
   }).optional()
 });
 var UpdateSavedPaymentMethodResponse = z.object({
-  _id: z.string().describe("Unique identifier of a saved payment method.").regex(
+  _id: z.string().describe("Saved payment method ID.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
-    "Represents the current state of a saved payment method. Each time saved payment method is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision."
+    "Revision number, which increments by 1 each time the saved payment method is updated.\nTo prevent conflicting changes, the current revision must be passed when updating the saved payment method."
   ).optional().nullable(),
-  _createdDate: z.date().describe("SavedPaymentMethod creation time.").optional().nullable(),
-  _updatedDate: z.date().describe("SavedPaymentMethod last update time.").optional().nullable(),
-  siteMemberId: z.string().describe("Saved payment method owner's member ID.").regex(
+  _createdDate: z.date().describe("Date and time the saved payment method was created.").optional().nullable(),
+  _updatedDate: z.date().describe("Date and time the saved payment method was last updated.").optional().nullable(),
+  siteMemberId: z.string().describe("ID of the site member who owns this saved payment method.").regex(
     /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
     "Must be a valid GUID"
   ).optional().nullable(),
   primary: z.boolean().describe(
-    "Defines whether this payment method is primary for the member. Member can only have at most one primary saved payment method."
+    "Whether this saved payment method is the primary one for the member. Each member can have at most one primary saved payment method. The primary method is selected by default during checkout."
   ).optional(),
   paymentMethod: z.object({
     typeId: z.string().describe(
-      "Legacy payment method type ID. Supported values are `creditCard`, `payPal`."
+      "Legacy payment method type ID. Supported values: `creditCard`, `payPal`."
     ).min(1).max(100).optional(),
     paymentMethodTypeId: z.string().describe("Payment method type ID.").regex(
       /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
@@ -390,31 +412,33 @@ var UpdateSavedPaymentMethodResponse = z.object({
       "Must be a valid GUID"
     ).optional().nullable(),
     cardInfo: z.object({
-      lastFourDigits: z.string().describe("Credit card's last 4 digits.").min(4).max(4).optional().nullable(),
+      lastFourDigits: z.string().describe("Payment card's last 4 digits.").min(4).max(4).optional().nullable(),
       bin: z.string().describe(
-        "Credit card's BIN (Bank Identification Number). It's first 4-6 digits of card's number."
+        "Payment card's BIN (Bank Identification Number). First 4-6 digits of the card number."
       ).min(4).max(6).optional().nullable(),
-      expirationMonth: z.number().int().describe("Credit card's expiration month.").min(1).max(12).optional().nullable(),
-      expirationYear: z.number().int().describe("Credit card's expiration year.").min(2e3).max(2099).optional().nullable(),
-      cardholderName: z.string().describe("Card holder's full name specified on the card.").min(1).max(1e3).optional().nullable()
-    }).describe("Details of credit card.").optional()
+      expirationMonth: z.number().int().describe("Payment card's expiration month.").min(1).max(12).optional().nullable(),
+      expirationYear: z.number().int().describe("Payment card's expiration year.").min(2e3).max(2099).optional().nullable(),
+      cardholderName: z.string().describe("Cardholder's full name as it appears on the card.").min(1).max(1e3).optional().nullable()
+    }).describe("Payment card details.").optional()
   }).describe("Payment method details.").optional(),
   merchantUseAllowed: z.boolean().describe(
-    "Defines whether this payment method can be used by the merchant for making unscheduled payments.\nEven if it's set to `false` payment method still can be used for scheduled payments e.g. subscription renewal without the buyer being present."
+    "Whether the merchant can use this payment method for unscheduled payments, such as manual charges.\nEven when set to `false`, the payment method can still be used for scheduled payments such as subscription renewals without the buyer being present."
   ).optional().nullable(),
   sensitiveInfo: z.object({
     cardSensitiveInfo: z.object({
-      persistentToken: z.string().describe("Persistent token of credit card tokenized by Wix.").regex(
+      persistentToken: z.string().describe("Persistent token of a payment card tokenized by Wix.").regex(
         /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
         "Must be a valid GUID"
       ).optional().nullable()
-    }).describe("Sensitive details of credit card like card token.").optional()
-  }).describe("Saved payment method sensitive information.").optional(),
+    }).describe("Payment card sensitive details.").optional()
+  }).describe("Saved payment method's sensitive information.").optional(),
   extendedFields: z.object({
     namespaces: z.record(z.string(), z.record(z.string(), z.any())).describe(
       "Extended field data. Each key corresponds to the namespace of the app that created the extended fields.\nThe value of each key is structured according to the schema defined when the extended fields were configured.\n\nYou can only access fields for which you have the appropriate permissions.\n\nLearn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields)."
     ).optional()
-  }).describe("Data Extensions").optional()
+  }).describe(
+    "Custom field data for the saved payment method object.\n\n[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."
+  ).optional()
 });
 var MarkSavedPaymentMethodPrimaryRequest = z.object({
   savedPaymentMethodId: z.string().describe("Unique identifier of a saved payment method.").regex(