stripe 18.2.0-beta.1 → 18.3.0-beta.1

package/types/PromotionCodesResource.d.ts

@@ -187,7 +187,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/QuotePreviewInvoices.d.ts

@@ -27,7 +27,7 @@ declare module 'stripe' {
      * Stripe applies any customer credit on the account before determining the
      * amount due for the invoice (i.e., the amount that will be actually
      * charged). If the amount due for the invoice is less than Stripe's [minimum allowed charge
-     * per currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts), the
+     * per currency](https://docs.stripe.com/docs/currencies#minimum-and-maximum-charge-amounts), the
      * invoice is automatically marked paid, and we add the amount due to the
      * customer's credit balance which is applied to the next invoice.
      *
@@ -38,7 +38,7 @@ declare module 'stripe' {
      */
     interface QuotePreviewInvoice {
       /**
-       * Unique identifier for the object. This property is always present unless the invoice is an upcoming invoice. See [Retrieve an upcoming invoice](https://stripe.com/docs/api/invoices/upcoming) for more details.
+       * Unique identifier for the object. For preview invoices created using the [create preview](https://stripe.com/docs/api/invoices/create_preview) endpoint, this id will be prefixed with `upcoming_in`.
        */
       id: string;
 
@@ -310,12 +310,12 @@ declare module 'stripe' {
       payments?: ApiList<Stripe.InvoicePayment>;
 
       /**
-       * End of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
+       * End of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
        */
       period_end: number;
 
       /**
-       * Start of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
+       * Start of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
        */
       period_start: number;
 
@@ -934,9 +934,7 @@ declare module 'stripe' {
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
-          | 'gift_card_balance_insufficient'
-          | 'gift_card_code_exists'
-          | 'gift_card_inactive'
+          | 'forwarding_api_upstream_error'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'
@@ -1466,9 +1464,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/QuotePreviewSubscriptionSchedules.d.ts

@@ -33,7 +33,7 @@ declare module 'stripe' {
       billing_behavior?: QuotePreviewSubscriptionSchedule.BillingBehavior;
 
       /**
-       * The [billing mode](https://stripe.com/api/subscriptions/create#create_subscription-billing_mode) that will be used to process all future operations for the subscription schedule.
+       * The [billing mode](https://docs.stripe.com/api/subscriptions/create#create_subscription-billing_mode) that will be used to process all future operations for the subscription schedule.
        */
       billing_mode?: QuotePreviewSubscriptionSchedule.BillingMode;
 
@@ -176,6 +176,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`.
          */
@@ -242,6 +247,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 {
@@ -342,6 +359,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`.
          */
@@ -403,7 +425,7 @@ declare module 'stripe' {
         pause_collection?: Phase.PauseCollection | 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;
 
@@ -531,6 +553,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 {
@@ -607,6 +641,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.
            */
@@ -644,6 +683,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.

package/types/Quotes.d.ts

@@ -385,9 +385,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;
 
@@ -499,9 +499,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;
 
@@ -760,7 +760,7 @@ declare module 'stripe' {
         billing_cycle_anchor?: 'reset' | null;
 
         /**
-         * The [billing mode](https://stripe.com/api/subscriptions/create#create_subscription-billing_mode) that will be set on the subscription once the quote is accepted.
+         * The [billing mode](https://docs.stripe.com/api/subscriptions/create#create_subscription-billing_mode) that will be set on the subscription once the quote is accepted.
          */
         billing_mode?: SubscriptionData.BillingMode;
 
@@ -1197,9 +1197,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/QuotesResource.d.ts

@@ -1042,7 +1042,7 @@ declare module 'stripe' {
         billing_cycle_anchor?: Stripe.Emptyable<'reset'>;
 
         /**
-         * Configure billing_mode to opt in improved credit proration behavior.Once a quote that creates a subscription or subscription schedule is accepted,all future operations on the subscription or subscription schedule will be processed based on this billing_mode.
+         * Controls how prorations and invoices for subscriptions are calculated and orchestrated.
          */
         billing_mode?: SubscriptionData.BillingMode;
 

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

@@ -354,7 +354,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

@@ -755,9 +755,7 @@ declare module 'stripe' {
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
-          | 'gift_card_balance_insufficient'
-          | 'gift_card_code_exists'
-          | 'gift_card_inactive'
+          | 'forwarding_api_upstream_error'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'

package/types/SetupIntents.d.ts

@@ -365,9 +365,7 @@ declare module 'stripe' {
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
-          | 'gift_card_balance_insufficient'
-          | 'gift_card_code_exists'
-          | 'gift_card_inactive'
+          | 'forwarding_api_upstream_error'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'
@@ -507,7 +505,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

@@ -4666,7 +4666,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(
@@ -4682,7 +4682,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,
@@ -4715,7 +4715,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.
        */
@@ -111,6 +116,13 @@ declare module 'stripe' {
     }
 
     namespace SubscriptionItem {
+      interface BillingThresholds {
+        /**
+         * Usage threshold that triggers the subscription to create an invoice
+         */
+        usage_gte: number | null;
+      }
+
       interface Trial {
         /**
          * List of price IDs which, if present on the subscription following a paid trial, constitute opting-in to the paid trial.
@@ -127,5 +139,14 @@ declare module 'stripe' {
         type Type = 'free' | 'paid';
       }
     }
+
+    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.
        */
@@ -78,6 +85,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.
@@ -224,6 +238,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.
        */
@@ -294,6 +315,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

@@ -33,7 +33,7 @@ declare module 'stripe' {
       billing_behavior?: SubscriptionSchedule.BillingBehavior;
 
       /**
-       * The [billing mode](https://stripe.com/api/subscriptions/create#create_subscription-billing_mode) that will be used to process all future operations for the subscription schedule.
+       * The [billing mode](https://docs.stripe.com/api/subscriptions/create#create_subscription-billing_mode) that will be used to process all future operations for the subscription schedule.
        */
       billing_mode?: SubscriptionSchedule.BillingMode;
 
@@ -155,6 +155,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`.
          */
@@ -221,6 +226,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 {
@@ -321,6 +338,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`.
          */
@@ -382,7 +404,7 @@ declare module 'stripe' {
         pause_collection?: Phase.PauseCollection | 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;
 
@@ -510,6 +532,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 {
@@ -586,6 +620,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.
            */
@@ -623,6 +662,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.