stripe 18.1.1 → 18.2.0

package/types/PaymentMethodsResource.d.ts

@@ -1011,9 +1011,9 @@ declare module 'stripe' {
 
     class PaymentMethodsResource {
       /**
-       * Creates a PaymentMethod object. Read the [Stripe.js reference](https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
+       * Creates a PaymentMethod object. Read the [Stripe.js reference](https://docs.stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
        *
-       * Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
+       * Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://docs.stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
        */
       create(
         params?: PaymentMethodCreateParams,
@@ -1024,7 +1024,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.PaymentMethod>>;
 
       /**
-       * Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer)
+       * Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer)
        */
       retrieve(
         id: string,
@@ -1046,7 +1046,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.PaymentMethod>>;
 
       /**
-       * Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer_list) API instead.
+       * Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead.
        */
       list(
         params?: PaymentMethodListParams,
@@ -1057,16 +1057,16 @@ declare module 'stripe' {
       /**
        * Attaches a PaymentMethod object to a Customer.
        *
-       * To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
-       * or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
+       * To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
+       * or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
        * These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
        * endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
        * future use, which makes later declines and payment friction more likely.
-       * See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
+       * See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
        * future payments.
        *
        * To use this PaymentMethod as the default for invoice or subscription payments,
-       * set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
+       * set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
        * on the Customer to the PaymentMethod's ID.
        */
       attach(

package/types/Payouts.d.ts

@@ -5,9 +5,9 @@ declare module 'stripe' {
     /**
      * A `Payout` object is created when you receive funds from Stripe, or when you
      * initiate a payout to either a bank account or debit card of a [connected
-     * Stripe account](https://stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
+     * Stripe account](https://docs.stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
      * and list all payouts. Payouts are made on [varying
-     * schedules](https://stripe.com/docs/connect/manage-payout-schedule), depending on your country and
+     * schedules](https://docs.stripe.com/docs/connect/manage-payout-schedule), depending on your country and
      * industry.
      *
      * Related guide: [Receiving payouts](https://stripe.com/docs/payouts)

package/types/PayoutsResource.d.ts

@@ -122,11 +122,11 @@ declare module 'stripe' {
 
     class PayoutsResource {
       /**
-       * To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://stripe.com/docs/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
+       * To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://docs.stripe.com/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
        *
        * If your API key is in test mode, money won't actually be sent, though every other action occurs as if you're in live mode.
        *
-       * If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://stripe.com/docs/api#balance_object) details available and pending amounts by source type.
+       * If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://docs.stripe.com/api#balance_object) details available and pending amounts by source type.
        */
       create(
         params: PayoutCreateParams,

package/types/Persons.d.ts

@@ -25,9 +25,9 @@ declare module 'stripe' {
     /**
      * This is an object representing a person associated with a Stripe account.
      *
-     * A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
+     * A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
      *
-     * See the [Standard onboarding](https://stripe.com/connect/standard-accounts) or [Express onboarding](https://stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://stripe.com/connect/handling-api-verification#person-information).
+     * See the [Standard onboarding](https://docs.stripe.com/connect/standard-accounts) or [Express onboarding](https://docs.stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://docs.stripe.com/connect/handling-api-verification#person-information).
      */
     interface Person {
       /**
@@ -72,27 +72,27 @@ declare module 'stripe' {
       dob?: Person.Dob;
 
       /**
-       * The person's email address. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The person's email address. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       email?: string | null;
 
       /**
-       * The person's first name. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The person's first name. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       first_name?: string | null;
 
       /**
-       * The Kana variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kana variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       first_name_kana?: string | null;
 
       /**
-       * The Kanji variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kanji variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       first_name_kanji?: string | null;
 
       /**
-       * A list of alternate names or aliases that the person is known by. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * A list of alternate names or aliases that the person is known by. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       full_name_aliases?: Array<string>;
 
@@ -117,17 +117,17 @@ declare module 'stripe' {
       id_number_secondary_provided?: boolean;
 
       /**
-       * The person's last name. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The person's last name. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       last_name?: string | null;
 
       /**
-       * The Kana variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kana variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       last_name_kana?: string | null;
 
       /**
-       * The Kanji variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kanji variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       last_name_kanji?: string | null;
 

package/types/PlansResource.d.ts

@@ -248,7 +248,7 @@ declare module 'stripe' {
 
     class PlansResource {
       /**
-       * You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
+       * You can now model subscriptions more flexibly using the [Prices API](https://docs.stripe.com/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
        */
       create(
         params: PlanCreateParams,

package/types/PricesResource.d.ts

@@ -584,7 +584,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.Price>>;
 
       /**
-       * Returns a list of your active prices, excluding [inline prices](https://stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
+       * Returns a list of your active prices, excluding [inline prices](https://docs.stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
        */
       list(
         params?: PriceListParams,
@@ -593,7 +593,7 @@ declare module 'stripe' {
       list(options?: RequestOptions): ApiListPromise<Stripe.Price>;
 
       /**
-       * Search for prices you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+       * Search for prices you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
        * Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
        * conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
        * to an hour behind during outages. Search functionality is not available to merchants in India.

package/types/ProductsResource.d.ts

@@ -602,7 +602,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.ProductFeature>>;
 
       /**
-       * Search for products you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+       * Search for products you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
        * Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
        * conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
        * to an hour behind during outages. Search functionality is not available to merchants in India.

package/types/PromotionCodesResource.d.ts

@@ -177,7 +177,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.PromotionCode>>;
 
       /**
-       * Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://stripe.com/docs/api/promotion_codes/list) with the desired code.
+       * Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://docs.stripe.com/docs/api/promotion_codes/list) with the desired code.
        */
       retrieve(
         id: string,

package/types/Quotes.d.ts

@@ -306,9 +306,9 @@ declare module 'stripe' {
                 amount: number;
 
                 /**
-                 * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+                 * Tax rates can be applied to [invoices](https://docs.stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://docs.stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://docs.stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
                  *
-                 * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
+                 * Related guide: [Tax rates](https://docs.stripe.com/billing/taxes/tax-rates)
                  */
                 rate: Stripe.TaxRate;
 
@@ -420,9 +420,9 @@ declare module 'stripe' {
                 amount: number;
 
                 /**
-                 * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+                 * Tax rates can be applied to [invoices](https://docs.stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://docs.stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://docs.stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
                  *
-                 * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
+                 * Related guide: [Tax rates](https://docs.stripe.com/billing/taxes/tax-rates)
                  */
                 rate: Stripe.TaxRate;
 
@@ -595,9 +595,9 @@ declare module 'stripe' {
             amount: number;
 
             /**
-             * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+             * Tax rates can be applied to [invoices](https://docs.stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://docs.stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://docs.stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
              *
-             * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
+             * Related guide: [Tax rates](https://docs.stripe.com/billing/taxes/tax-rates)
              */
             rate: Stripe.TaxRate;
 

package/types/Radar/EarlyFraudWarningsResource.d.ts

@@ -36,7 +36,7 @@ declare module 'stripe' {
         /**
          * Retrieves the details of an early fraud warning that has previously been created.
          *
-         * Please refer to the [early fraud warning](https://stripe.com/docs/api#early_fraud_warning_object) object reference for more details.
+         * Please refer to the [early fraud warning](https://docs.stripe.com/api#early_fraud_warning_object) object reference for more details.
          */
         retrieve(
           id: string,

package/types/Refunds.d.ts

@@ -340,7 +340,12 @@ declare module 'stripe' {
 
         interface Paynow {}
 
-        interface Paypal {}
+        interface Paypal {
+          /**
+           * For refunds declined by the network, a decline code provided by the network which indicates the reason the refund failed.
+           */
+          network_decline_code: string | null;
+        }
 
         interface Pix {}
 

package/types/Reviews.d.ts

@@ -5,7 +5,7 @@ declare module 'stripe' {
     /**
      * Reviews can be used to supplement automated fraud detection with human expertise.
      *
-     * Learn more about [Radar](https://stripe.com/radar) and reviewing payments
+     * Learn more about [Radar](https://docs.stripe.com/radar) and reviewing payments
      * [here](https://stripe.com/docs/radar/reviews).
      */
     interface Review {

package/types/SetupAttempts.d.ts

@@ -713,6 +713,7 @@ declare module 'stripe' {
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
+          | 'forwarding_api_upstream_error'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'

package/types/SetupIntents.d.ts

@@ -357,6 +357,7 @@ declare module 'stripe' {
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
+          | 'forwarding_api_upstream_error'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'
@@ -492,7 +493,7 @@ declare module 'stripe' {
         redirect_to_url?: NextAction.RedirectToUrl;
 
         /**
-         * Type of the next action to perform, one of `redirect_to_url`, `use_stripe_sdk`, `alipay_handle_redirect`, `oxxo_display_details`, or `verify_with_microdeposits`.
+         * Type of the next action to perform. Refer to the other child attributes under `next_action` for available values. Examples include: `redirect_to_url`, `use_stripe_sdk`, `alipay_handle_redirect`, `oxxo_display_details`, or `verify_with_microdeposits`.
          */
         type: string;
 

package/types/SetupIntentsResource.d.ts

@@ -3939,7 +3939,7 @@ declare module 'stripe' {
       /**
        * Creates a SetupIntent object.
        *
-       * After you create the SetupIntent, attach a payment method and [confirm](https://stripe.com/docs/api/setup_intents/confirm)
+       * After you create the SetupIntent, attach a payment method and [confirm](https://docs.stripe.com/docs/api/setup_intents/confirm)
        * it to collect any required permissions to charge the payment method later.
        */
       create(
@@ -3955,7 +3955,7 @@ declare module 'stripe' {
        *
        * Client-side retrieval using a publishable key is allowed when the client_secret is provided in the query string.
        *
-       * When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the [SetupIntent](https://stripe.com/docs/api#setup_intent_object) object reference for more details.
+       * When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the [SetupIntent](https://docs.stripe.com/api#setup_intent_object) object reference for more details.
        */
       retrieve(
         id: string,
@@ -3988,7 +3988,7 @@ declare module 'stripe' {
       /**
        * You can cancel a SetupIntent object when it's in one of these statuses: requires_payment_method, requires_confirmation, or requires_action.
        *
-       * After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error. You can't cancel the SetupIntent for a Checkout Session. [Expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead.
+       * After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error. You can't cancel the SetupIntent for a Checkout Session. [Expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire) instead.
        */
       cancel(
         id: string,

package/types/SourcesResource.d.ts

@@ -577,7 +577,7 @@ declare module 'stripe' {
       /**
        * Updates the specified source by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
        *
-       * This request accepts the metadata and owner as arguments. It is also possible to update type specific information for selected payment methods. Please refer to our [payment method guides](https://stripe.com/docs/sources) for more detail.
+       * This request accepts the metadata and owner as arguments. It is also possible to update type specific information for selected payment methods. Please refer to our [payment method guides](https://docs.stripe.com/docs/sources) for more detail.
        */
       update(
         id: string,

package/types/SubscriptionItems.d.ts

@@ -37,6 +37,11 @@ declare module 'stripe' {
        */
       object: 'subscription_item';
 
+      /**
+       * Define thresholds at which an invoice will be sent, and the related subscription advanced to a new billing period
+       */
+      billing_thresholds: SubscriptionItem.BillingThresholds | null;
+
       /**
        * Time at which the object was created. Measured in seconds since the Unix epoch.
        */
@@ -104,5 +109,14 @@ declare module 'stripe' {
        */
       tax_rates: Array<Stripe.TaxRate> | null;
     }
+
+    namespace SubscriptionItem {
+      interface BillingThresholds {
+        /**
+         * Usage threshold that triggers the subscription to create an invoice
+         */
+        usage_gte: number | null;
+      }
+    }
   }
 }

package/types/SubscriptionItemsResource.d.ts

@@ -8,6 +8,13 @@ declare module 'stripe' {
        */
       subscription: string;
 
+      /**
+       * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
+       */
+      billing_thresholds?: Stripe.Emptyable<
+        SubscriptionItemCreateParams.BillingThresholds
+      >;
+
       /**
        * The coupons to redeem into discounts for the subscription item.
        */
@@ -73,6 +80,13 @@ declare module 'stripe' {
     }
 
     namespace SubscriptionItemCreateParams {
+      interface BillingThresholds {
+        /**
+         * Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
+         */
+        usage_gte: number;
+      }
+
       interface Discount {
         /**
          * ID of the coupon to create a new discount for.
@@ -159,6 +173,13 @@ declare module 'stripe' {
     }
 
     interface SubscriptionItemUpdateParams {
+      /**
+       * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
+       */
+      billing_thresholds?: Stripe.Emptyable<
+        SubscriptionItemUpdateParams.BillingThresholds
+      >;
+
       /**
        * The coupons to redeem into discounts for the subscription item.
        */
@@ -229,6 +250,13 @@ declare module 'stripe' {
     }
 
     namespace SubscriptionItemUpdateParams {
+      interface BillingThresholds {
+        /**
+         * Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
+         */
+        usage_gte: number;
+      }
+
       interface Discount {
         /**
          * ID of the coupon to create a new discount for.

package/types/SubscriptionSchedules.d.ts

@@ -126,6 +126,11 @@ declare module 'stripe' {
          */
         billing_cycle_anchor: DefaultSettings.BillingCycleAnchor;
 
+        /**
+         * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
+         */
+        billing_thresholds: DefaultSettings.BillingThresholds | null;
+
         /**
          * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`.
          */
@@ -192,6 +197,18 @@ declare module 'stripe' {
 
         type BillingCycleAnchor = 'automatic' | 'phase_start';
 
+        interface BillingThresholds {
+          /**
+           * Monetary threshold that triggers the subscription to create an invoice
+           */
+          amount_gte: number | null;
+
+          /**
+           * Indicates if the `billing_cycle_anchor` should be reset when a threshold is reached. If true, `billing_cycle_anchor` will be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not be `true` if the subscription contains items with plans that have `aggregate_usage=last_ever`.
+           */
+          reset_billing_cycle_anchor: boolean | null;
+        }
+
         type CollectionMethod = 'charge_automatically' | 'send_invoice';
 
         interface InvoiceSettings {
@@ -261,6 +278,11 @@ declare module 'stripe' {
          */
         billing_cycle_anchor: Phase.BillingCycleAnchor | null;
 
+        /**
+         * Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
+         */
+        billing_thresholds: Phase.BillingThresholds | null;
+
         /**
          * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`.
          */
@@ -317,7 +339,7 @@ declare module 'stripe' {
         on_behalf_of: string | Stripe.Account | null;
 
         /**
-         * If the subscription schedule will prorate when transitioning to this phase. Possible values are `create_prorations` and `none`.
+         * When transitioning phases, controls how prorations are handled (if any). Possible values are `create_prorations`, `none`, and `always_invoice`.
          */
         proration_behavior: Phase.ProrationBehavior;
 
@@ -416,6 +438,18 @@ declare module 'stripe' {
 
         type BillingCycleAnchor = 'automatic' | 'phase_start';
 
+        interface BillingThresholds {
+          /**
+           * Monetary threshold that triggers the subscription to create an invoice
+           */
+          amount_gte: number | null;
+
+          /**
+           * Indicates if the `billing_cycle_anchor` should be reset when a threshold is reached. If true, `billing_cycle_anchor` will be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not be `true` if the subscription contains items with plans that have `aggregate_usage=last_ever`.
+           */
+          reset_billing_cycle_anchor: boolean | null;
+        }
+
         type CollectionMethod = 'charge_automatically' | 'send_invoice';
 
         interface Discount {
@@ -473,6 +507,11 @@ declare module 'stripe' {
         }
 
         interface Item {
+          /**
+           * Define thresholds at which an invoice will be sent, and the related subscription advanced to a new billing period
+           */
+          billing_thresholds: Item.BillingThresholds | null;
+
           /**
            * The discounts applied to the subscription item. Subscription item discounts are applied before subscription discounts. Use `expand[]=discounts` to expand each discount.
            */
@@ -505,6 +544,13 @@ declare module 'stripe' {
         }
 
         namespace Item {
+          interface BillingThresholds {
+            /**
+             * Usage threshold that triggers the subscription to create an invoice
+             */
+            usage_gte: number | null;
+          }
+
           interface Discount {
             /**
              * ID of the coupon to create a new discount for.