stripe 18.5.0-beta.1 → 18.5.0

package/types/SubscriptionsResource.d.ts

@@ -3,6 +3,11 @@
 declare module 'stripe' {
   namespace Stripe {
     interface SubscriptionCreateParams {
+      /**
+       * The identifier of the customer to subscribe.
+       */
+      customer: string;
+
       /**
        * A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
        */
@@ -65,16 +70,6 @@ declare module 'stripe' {
        */
       currency?: string;
 
-      /**
-       * The identifier of the customer to subscribe.
-       */
-      customer?: string;
-
-      /**
-       * The identifier of the account to subscribe.
-       */
-      customer_account?: string;
-
       /**
        * Number of days a customer has to pay invoices generated by this subscription. Valid only for subscriptions where `collection_method` is set to `send_invoice`.
        */
@@ -162,11 +157,6 @@ declare module 'stripe' {
         SubscriptionCreateParams.PendingInvoiceItemInterval
       >;
 
-      /**
-       * If specified, the invoicing for the given billing cycle iterations will be processed now.
-       */
-      prebilling?: SubscriptionCreateParams.Prebilling;
-
       /**
        * Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) resulting from the `billing_cycle_anchor`. If no value is passed, the default is `create_prorations`.
        */
@@ -205,6 +195,16 @@ declare module 'stripe' {
          */
         discounts?: Array<AddInvoiceItem.Discount>;
 
+        /**
+         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         */
+        metadata?: Stripe.MetadataParam;
+
+        /**
+         * The period associated with this invoice item. Defaults to the current period of the subscription.
+         */
+        period?: AddInvoiceItem.Period;
+
         /**
          * The ID of the price object. One of `price` or `price_data` is required.
          */
@@ -238,53 +238,55 @@ declare module 'stripe' {
            */
           discount?: string;
 
-          /**
-           * Details to determine how long the discount should be applied for.
-           */
-          discount_end?: Discount.DiscountEnd;
-
           /**
            * ID of the promotion code to create a new discount for.
            */
           promotion_code?: string;
         }
 
-        namespace Discount {
-          interface DiscountEnd {
-            /**
-             * Time span for the redeemed discount.
-             */
-            duration?: DiscountEnd.Duration;
+        interface Period {
+          /**
+           * End of the invoice item period.
+           */
+          end: Period.End;
 
+          /**
+           * Start of the invoice item period.
+           */
+          start: Period.Start;
+        }
+
+        namespace Period {
+          interface End {
             /**
-             * A precise Unix timestamp for the discount to end. Must be in the future.
+             * A precise Unix timestamp for the end of the invoice item period. Must be greater than or equal to `period.start`.
              */
             timestamp?: number;
 
             /**
-             * The type of calculation made to determine when the discount ends.
+             * Select how to calculate the end of the invoice item period.
              */
-            type: DiscountEnd.Type;
+            type: End.Type;
           }
 
-          namespace DiscountEnd {
-            interface Duration {
-              /**
-               * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-               */
-              interval: Duration.Interval;
+          namespace End {
+            type Type = 'min_item_period_end' | 'timestamp';
+          }
 
-              /**
-               * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-               */
-              interval_count: number;
-            }
+          interface Start {
+            /**
+             * A precise Unix timestamp for the start of the invoice item period. Must be less than or equal to `period.end`.
+             */
+            timestamp?: number;
 
-            namespace Duration {
-              type Interval = 'day' | 'month' | 'week' | 'year';
-            }
+            /**
+             * Select how to calculate the start of the invoice item period.
+             */
+            type: Start.Type;
+          }
 
-            type Type = 'duration' | 'timestamp';
+          namespace Start {
+            type Type = 'max_item_period_start' | 'now' | 'timestamp';
           }
         }
 
@@ -352,27 +354,27 @@ declare module 'stripe' {
 
       interface BillingCycleAnchorConfig {
         /**
-         * The day of the month the billing_cycle_anchor should be. Ranges from 1 to 31.
+         * The day of the month the anchor should be. Ranges from 1 to 31.
          */
         day_of_month: number;
 
         /**
-         * The hour of the day the billing_cycle_anchor should be. Ranges from 0 to 23.
+         * The hour of the day the anchor should be. Ranges from 0 to 23.
          */
         hour?: number;
 
         /**
-         * The minute of the hour the billing_cycle_anchor should be. Ranges from 0 to 59.
+         * The minute of the hour the anchor should be. Ranges from 0 to 59.
          */
         minute?: number;
 
         /**
-         * The month to start full cycle billing periods. Ranges from 1 to 12.
+         * The month to start full cycle periods. Ranges from 1 to 12.
          */
         month?: number;
 
         /**
-         * The second of the minute the billing_cycle_anchor should be. Ranges from 0 to 59.
+         * The second of the minute the anchor should be. Ranges from 0 to 59.
          */
         second?: number;
       }
@@ -415,56 +417,12 @@ declare module 'stripe' {
          */
         discount?: string;
 
-        /**
-         * Details to determine how long the discount should be applied for.
-         */
-        discount_end?: Discount.DiscountEnd;
-
         /**
          * ID of the promotion code to create a new discount for.
          */
         promotion_code?: string;
       }
 
-      namespace Discount {
-        interface DiscountEnd {
-          /**
-           * Time span for the redeemed discount.
-           */
-          duration?: DiscountEnd.Duration;
-
-          /**
-           * A precise Unix timestamp for the discount to end. Must be in the future.
-           */
-          timestamp?: number;
-
-          /**
-           * The type of calculation made to determine when the discount ends.
-           */
-          type: DiscountEnd.Type;
-        }
-
-        namespace DiscountEnd {
-          interface Duration {
-            /**
-             * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-             */
-            interval: Duration.Interval;
-
-            /**
-             * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-             */
-            interval_count: number;
-          }
-
-          namespace Duration {
-            type Interval = 'day' | 'month' | 'week' | 'year';
-          }
-
-          type Type = 'duration' | 'timestamp';
-        }
-      }
-
       interface InvoiceSettings {
         /**
          * The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
@@ -535,11 +493,6 @@ declare module 'stripe' {
          * A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
          */
         tax_rates?: Stripe.Emptyable<Array<string>>;
-
-        /**
-         * Define options to configure the trial on the subscription item.
-         */
-        trial?: Item.Trial;
       }
 
       namespace Item {
@@ -561,56 +514,12 @@ declare module 'stripe' {
            */
           discount?: string;
 
-          /**
-           * Details to determine how long the discount should be applied for.
-           */
-          discount_end?: Discount.DiscountEnd;
-
           /**
            * ID of the promotion code to create a new discount for.
            */
           promotion_code?: string;
         }
 
-        namespace Discount {
-          interface DiscountEnd {
-            /**
-             * Time span for the redeemed discount.
-             */
-            duration?: DiscountEnd.Duration;
-
-            /**
-             * A precise Unix timestamp for the discount to end. Must be in the future.
-             */
-            timestamp?: number;
-
-            /**
-             * The type of calculation made to determine when the discount ends.
-             */
-            type: DiscountEnd.Type;
-          }
-
-          namespace DiscountEnd {
-            interface Duration {
-              /**
-               * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-               */
-              interval: Duration.Interval;
-
-              /**
-               * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-               */
-              interval_count: number;
-            }
-
-            namespace Duration {
-              type Interval = 'day' | 'month' | 'week' | 'year';
-            }
-
-            type Type = 'duration' | 'timestamp';
-          }
-        }
-
         interface PriceData {
           /**
            * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
@@ -662,22 +571,6 @@ declare module 'stripe' {
 
           type TaxBehavior = 'exclusive' | 'inclusive' | 'unspecified';
         }
-
-        interface Trial {
-          /**
-           * List of price IDs which, if present on the subscription following a paid trial, constitute opting-in to the paid trial. Currently only supports at most 1 price ID.
-           */
-          converts_to?: Array<string>;
-
-          /**
-           * Determines the type of trial for this item.
-           */
-          type: Trial.Type;
-        }
-
-        namespace Trial {
-          type Type = 'free' | 'paid';
-        }
       }
 
       type PaymentBehavior =
@@ -729,13 +622,6 @@ declare module 'stripe' {
             PaymentMethodOptions.CustomerBalance
           >;
 
-          /**
-           * This sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice's PaymentIntent.
-           */
-          id_bank_transfer?: Stripe.Emptyable<
-            PaymentMethodOptions.IdBankTransfer
-          >;
-
           /**
            * This sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent.
            */
@@ -746,11 +632,6 @@ declare module 'stripe' {
            */
           sepa_debit?: Stripe.Emptyable<PaymentMethodOptions.SepaDebit>;
 
-          /**
-           * This sub-hash contains details about the UPI payment method options to pass to the invoice's PaymentIntent.
-           */
-          upi?: Stripe.Emptyable<PaymentMethodOptions.Upi>;
-
           /**
            * This sub-hash contains details about the ACH direct debit payment method options to pass to the invoice's PaymentIntent.
            */
@@ -890,47 +771,10 @@ declare module 'stripe' {
             }
           }
 
-          interface IdBankTransfer {}
-
           interface Konbini {}
 
           interface SepaDebit {}
 
-          interface Upi {
-            /**
-             * Configuration options for setting up an eMandate
-             */
-            mandate_options?: Upi.MandateOptions;
-          }
-
-          namespace Upi {
-            interface MandateOptions {
-              /**
-               * Amount to be charged for future payments.
-               */
-              amount?: number;
-
-              /**
-               * One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
-               */
-              amount_type?: MandateOptions.AmountType;
-
-              /**
-               * A description of the mandate or subscription that is meant to be displayed to the customer.
-               */
-              description?: string;
-
-              /**
-               * End date of the mandate or subscription. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
-               */
-              end_date?: number;
-            }
-
-            namespace MandateOptions {
-              type AmountType = 'fixed' | 'maximum';
-            }
-          }
-
           interface UsBankAccount {
             /**
              * Additional fields for Financial Connections Session creation
@@ -967,11 +811,6 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
-
-                /**
-                 * ID of the institution to use to filter for selectable accounts.
-                 */
-                institution?: string;
               }
 
               namespace Filters {
@@ -984,11 +823,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch =
-                | 'balances'
-                | 'inferred_balances'
-                | 'ownership'
-                | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
@@ -1008,13 +843,11 @@ declare module 'stripe' {
           | 'card'
           | 'cashapp'
           | 'crypto'
-          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
           | 'giropay'
           | 'grabpay'
-          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -1034,9 +867,7 @@ declare module 'stripe' {
           | 'sepa_credit_transfer'
           | 'sepa_debit'
           | 'sofort'
-          | 'stripe_balance'
           | 'swish'
-          | 'upi'
           | 'us_bank_account'
           | 'wechat_pay';
 
@@ -1059,22 +890,6 @@ declare module 'stripe' {
         type Interval = 'day' | 'month' | 'week' | 'year';
       }
 
-      interface Prebilling {
-        /**
-         * This is used to determine the number of billing cycles to prebill.
-         */
-        iterations: number;
-
-        /**
-         * Whether to cancel or preserve `prebilling` if the subscription is updated during the prebilled period. The default value is `reset`.
-         */
-        update_behavior?: Prebilling.UpdateBehavior;
-      }
-
-      namespace Prebilling {
-        type UpdateBehavior = 'prebill' | 'reset';
-      }
-
       type ProrationBehavior = 'always_invoice' | 'create_prorations' | 'none';
 
       interface TransferData {
@@ -1255,11 +1070,6 @@ declare module 'stripe' {
         SubscriptionUpdateParams.PendingInvoiceItemInterval
       >;
 
-      /**
-       * If specified, the invoicing for the given billing cycle iterations will be processed now.
-       */
-      prebilling?: SubscriptionUpdateParams.Prebilling;
-
       /**
        * Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`.
        */
@@ -1298,6 +1108,16 @@ declare module 'stripe' {
          */
         discounts?: Array<AddInvoiceItem.Discount>;
 
+        /**
+         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         */
+        metadata?: Stripe.MetadataParam;
+
+        /**
+         * The period associated with this invoice item. Defaults to the current period of the subscription.
+         */
+        period?: AddInvoiceItem.Period;
+
         /**
          * The ID of the price object. One of `price` or `price_data` is required.
          */
@@ -1331,53 +1151,55 @@ declare module 'stripe' {
            */
           discount?: string;
 
-          /**
-           * Details to determine how long the discount should be applied for.
-           */
-          discount_end?: Discount.DiscountEnd;
-
           /**
            * ID of the promotion code to create a new discount for.
            */
           promotion_code?: string;
         }
 
-        namespace Discount {
-          interface DiscountEnd {
-            /**
-             * Time span for the redeemed discount.
-             */
-            duration?: DiscountEnd.Duration;
+        interface Period {
+          /**
+           * End of the invoice item period.
+           */
+          end: Period.End;
 
+          /**
+           * Start of the invoice item period.
+           */
+          start: Period.Start;
+        }
+
+        namespace Period {
+          interface End {
             /**
-             * A precise Unix timestamp for the discount to end. Must be in the future.
+             * A precise Unix timestamp for the end of the invoice item period. Must be greater than or equal to `period.start`.
              */
             timestamp?: number;
 
             /**
-             * The type of calculation made to determine when the discount ends.
+             * Select how to calculate the end of the invoice item period.
              */
-            type: DiscountEnd.Type;
+            type: End.Type;
           }
 
-          namespace DiscountEnd {
-            interface Duration {
-              /**
-               * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-               */
-              interval: Duration.Interval;
+          namespace End {
+            type Type = 'min_item_period_end' | 'timestamp';
+          }
 
-              /**
-               * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-               */
-              interval_count: number;
-            }
+          interface Start {
+            /**
+             * A precise Unix timestamp for the start of the invoice item period. Must be less than or equal to `period.end`.
+             */
+            timestamp?: number;
 
-            namespace Duration {
-              type Interval = 'day' | 'month' | 'week' | 'year';
-            }
+            /**
+             * Select how to calculate the start of the invoice item period.
+             */
+            type: Start.Type;
+          }
 
-            type Type = 'duration' | 'timestamp';
+          namespace Start {
+            type Type = 'max_item_period_start' | 'now' | 'timestamp';
           }
         }
 
@@ -1496,56 +1318,12 @@ declare module 'stripe' {
          */
         discount?: string;
 
-        /**
-         * Details to determine how long the discount should be applied for.
-         */
-        discount_end?: Discount.DiscountEnd;
-
         /**
          * ID of the promotion code to create a new discount for.
          */
         promotion_code?: string;
       }
 
-      namespace Discount {
-        interface DiscountEnd {
-          /**
-           * Time span for the redeemed discount.
-           */
-          duration?: DiscountEnd.Duration;
-
-          /**
-           * A precise Unix timestamp for the discount to end. Must be in the future.
-           */
-          timestamp?: number;
-
-          /**
-           * The type of calculation made to determine when the discount ends.
-           */
-          type: DiscountEnd.Type;
-        }
-
-        namespace DiscountEnd {
-          interface Duration {
-            /**
-             * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-             */
-            interval: Duration.Interval;
-
-            /**
-             * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-             */
-            interval_count: number;
-          }
-
-          namespace Duration {
-            type Interval = 'day' | 'month' | 'week' | 'year';
-          }
-
-          type Type = 'duration' | 'timestamp';
-        }
-      }
-
       interface InvoiceSettings {
         /**
          * The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
@@ -1652,56 +1430,12 @@ declare module 'stripe' {
            */
           discount?: string;
 
-          /**
-           * Details to determine how long the discount should be applied for.
-           */
-          discount_end?: Discount.DiscountEnd;
-
           /**
            * ID of the promotion code to create a new discount for.
            */
           promotion_code?: string;
         }
 
-        namespace Discount {
-          interface DiscountEnd {
-            /**
-             * Time span for the redeemed discount.
-             */
-            duration?: DiscountEnd.Duration;
-
-            /**
-             * A precise Unix timestamp for the discount to end. Must be in the future.
-             */
-            timestamp?: number;
-
-            /**
-             * The type of calculation made to determine when the discount ends.
-             */
-            type: DiscountEnd.Type;
-          }
-
-          namespace DiscountEnd {
-            interface Duration {
-              /**
-               * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-               */
-              interval: Duration.Interval;
-
-              /**
-               * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-               */
-              interval_count: number;
-            }
-
-            namespace Duration {
-              type Interval = 'day' | 'month' | 'week' | 'year';
-            }
-
-            type Type = 'duration' | 'timestamp';
-          }
-        }
-
         interface PriceData {
           /**
            * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
@@ -1820,13 +1554,6 @@ declare module 'stripe' {
             PaymentMethodOptions.CustomerBalance
           >;
 
-          /**
-           * This sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice's PaymentIntent.
-           */
-          id_bank_transfer?: Stripe.Emptyable<
-            PaymentMethodOptions.IdBankTransfer
-          >;
-
           /**
            * This sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1837,11 +1564,6 @@ declare module 'stripe' {
            */
           sepa_debit?: Stripe.Emptyable<PaymentMethodOptions.SepaDebit>;
 
-          /**
-           * This sub-hash contains details about the UPI payment method options to pass to the invoice's PaymentIntent.
-           */
-          upi?: Stripe.Emptyable<PaymentMethodOptions.Upi>;
-
           /**
            * This sub-hash contains details about the ACH direct debit payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1981,47 +1703,10 @@ declare module 'stripe' {
             }
           }
 
-          interface IdBankTransfer {}
-
           interface Konbini {}
 
           interface SepaDebit {}
 
-          interface Upi {
-            /**
-             * Configuration options for setting up an eMandate
-             */
-            mandate_options?: Upi.MandateOptions;
-          }
-
-          namespace Upi {
-            interface MandateOptions {
-              /**
-               * Amount to be charged for future payments.
-               */
-              amount?: number;
-
-              /**
-               * One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
-               */
-              amount_type?: MandateOptions.AmountType;
-
-              /**
-               * A description of the mandate or subscription that is meant to be displayed to the customer.
-               */
-              description?: string;
-
-              /**
-               * End date of the mandate or subscription. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
-               */
-              end_date?: number;
-            }
-
-            namespace MandateOptions {
-              type AmountType = 'fixed' | 'maximum';
-            }
-          }
-
           interface UsBankAccount {
             /**
              * Additional fields for Financial Connections Session creation
@@ -2058,11 +1743,6 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
-
-                /**
-                 * ID of the institution to use to filter for selectable accounts.
-                 */
-                institution?: string;
               }
 
               namespace Filters {
@@ -2075,11 +1755,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch =
-                | 'balances'
-                | 'inferred_balances'
-                | 'ownership'
-                | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
@@ -2099,13 +1775,11 @@ declare module 'stripe' {
           | 'card'
           | 'cashapp'
           | 'crypto'
-          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
           | 'giropay'
           | 'grabpay'
-          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -2125,9 +1799,7 @@ declare module 'stripe' {
           | 'sepa_credit_transfer'
           | 'sepa_debit'
           | 'sofort'
-          | 'stripe_balance'
           | 'swish'
-          | 'upi'
           | 'us_bank_account'
           | 'wechat_pay';
 
@@ -2150,22 +1822,6 @@ declare module 'stripe' {
         type Interval = 'day' | 'month' | 'week' | 'year';
       }
 
-      interface Prebilling {
-        /**
-         * This is used to determine the number of billing cycles to prebill.
-         */
-        iterations: number;
-
-        /**
-         * Whether to cancel or preserve `prebilling` if the subscription is updated during the prebilled period. The default value is `reset`.
-         */
-        update_behavior?: Prebilling.UpdateBehavior;
-      }
-
-      namespace Prebilling {
-        type UpdateBehavior = 'prebill' | 'reset';
-      }
-
       type ProrationBehavior = 'always_invoice' | 'create_prorations' | 'none';
 
       interface TransferData {
@@ -2218,12 +1874,12 @@ declare module 'stripe' {
       created?: Stripe.RangeQueryParam | number;
 
       /**
-       * Only return subscriptions whose current_period_end falls within the given date interval.
+       * Only return subscriptions whose minimum item current_period_end falls within the given date interval.
        */
       current_period_end?: Stripe.RangeQueryParam | number;
 
       /**
-       * Only return subscriptions whose current_period_start falls within the given date interval.
+       * Only return subscriptions whose maximum item current_period_start falls within the given date interval.
        */
       current_period_start?: Stripe.RangeQueryParam | number;
 
@@ -2232,11 +1888,6 @@ declare module 'stripe' {
        */
       customer?: string;
 
-      /**
-       * The ID of the account whose subscriptions will be retrieved.
-       */
-      customer_account?: string;
-
       /**
        * Specifies which fields in the response should be expanded.
        */
@@ -2415,10 +2066,7 @@ declare module 'stripe' {
        * Schedules provide the flexibility to model more complex billing configurations that change over time.
        */
       create(
-        params?: SubscriptionCreateParams,
-        options?: RequestOptions
-      ): Promise<Stripe.Response<Stripe.Subscription>>;
-      create(
+        params: SubscriptionCreateParams,
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.Subscription>>;