stripe 20.4.0-alpha.3 → 20.4.0-alpha.4

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 20.4.0-alpha.4 - 2026-02-19
+* [#2574](https://github.com/stripe/stripe-node/pull/2574) Update generated code for private-preview
+  * ⚠️ Add support for new value `spend_threshold` on enums `Billing.Alert.alert_type`, `Billing.AlertCreateParams.alert_type`, and `Billing.AlertListParams.alert_type`
+  * Add support for `spend_threshold` on `Billing.AlertCreateParams` and `Billing.Alert`
+  * Add support for `invoice_item`, `proration_details`, `proration`, and `subscription` on `InvoiceLineItem.parent.schedule_details`
+  * Add support for `custom` on `PaymentMethodUpdateParams`
+  * Add support for `payment_method_reference` and `usage` on `PaymentMethod.custom`
+  * Add support for `outstanding_usage_through` and `unused_time_from` on `SubscriptionPauseParams.bill_for`
+  * ⚠️ Remove support for `outstanding_usage` and `unused_time` on `SubscriptionPauseParams.bill_for`
+  * ⚠️ Remove support for `payment_behavior` on `SubscriptionResumeParams`
+
 ## 20.4.0-alpha.3 - 2026-02-11
 * [#2572](https://github.com/stripe/stripe-node/pull/2572) Update generated code for private-preview
   * Add support for new resources `V2.Billing.CadenceSpendModifier`, `V2.Billing.OneTimeItem`, and `V2.Billing.RateCardCustomPricingUnitOverageRate`

package/OPENAPI_VERSION

@@ -1 +1 @@
-v2169
+v2176

package/VERSION

@@ -1 +1 @@
-20.4.0-alpha.3
+20.4.0-alpha.4

package/cjs/stripe.core.js

@@ -37,7 +37,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '20.4.0-alpha.3';
+    Stripe.PACKAGE_VERSION = '20.4.0-alpha.4';
     Stripe.API_VERSION = apiVersion_js_1.ApiVersion;
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;

package/esm/stripe.core.js

@@ -34,7 +34,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '20.4.0-alpha.3';
+    Stripe.PACKAGE_VERSION = '20.4.0-alpha.4';
     Stripe.API_VERSION = ApiVersion;
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "20.4.0-alpha.3",
+  "version": "20.4.0-alpha.4",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Billing/Alerts.d.ts

@@ -32,6 +32,11 @@ declare module 'stripe' {
          */
         livemode: boolean;
 
+        /**
+         * Encapsulates the alert's configuration to monitor spend on pricing plan subscriptions.
+         */
+        spend_threshold?: Alert.SpendThreshold | null;
+
         /**
          * Status of the alert. This can be active, inactive or archived.
          */
@@ -49,7 +54,10 @@ declare module 'stripe' {
       }
 
       namespace Alert {
-        type AlertType = 'credit_balance_threshold' | 'usage_threshold';
+        type AlertType =
+          | 'credit_balance_threshold'
+          | 'spend_threshold'
+          | 'usage_threshold';
 
         interface CreditBalanceThreshold {
           /**
@@ -159,6 +167,136 @@ declare module 'stripe' {
           }
         }
 
+        interface SpendThreshold {
+          /**
+           * Defines the period over which spend is aggregated.
+           */
+          aggregation_period: 'billing';
+
+          /**
+           * Filters to scope the spend calculation.
+           */
+          filters: SpendThreshold.Filters | null;
+
+          /**
+           * Defines the granularity of spend aggregation.
+           */
+          group_by: 'pricing_plan_subscription' | null;
+
+          /**
+           * The threshold value configuration for a spend threshold alert.
+           */
+          gte: SpendThreshold.Gte;
+        }
+
+        namespace SpendThreshold {
+          interface Filters {
+            /**
+             * Filter by billable item IDs.
+             */
+            billable_items: Array<string> | null;
+
+            /**
+             * Filter by billing cadence ID.
+             */
+            billing_cadence: string | null;
+
+            /**
+             * Filter by pricing plan ID.
+             */
+            pricing_plan: string | null;
+
+            /**
+             * Filter by pricing plan subscription ID.
+             */
+            pricing_plan_subscription: string | null;
+          }
+
+          interface Gte {
+            /**
+             * The monetary amount. Present when type is `amount`.
+             */
+            amount: Gte.Amount | null;
+
+            /**
+             * The custom pricing unit amount. Present when type is `custom_pricing_unit`.
+             */
+            custom_pricing_unit: Gte.CustomPricingUnit | null;
+
+            /**
+             * The type of the threshold amount.
+             */
+            type: Gte.Type;
+          }
+
+          namespace Gte {
+            interface Amount {
+              /**
+               * 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).
+               */
+              currency: string;
+
+              /**
+               * A positive integer representing the amount.
+               */
+              value: number;
+            }
+
+            interface CustomPricingUnit {
+              /**
+               * The custom pricing unit object.
+               */
+              custom_pricing_unit_details: CustomPricingUnit.CustomPricingUnitDetails | null;
+
+              /**
+               * Unique identifier for the object.
+               */
+              id: string;
+
+              /**
+               * A positive decimal string representing the amount.
+               */
+              value: string;
+            }
+
+            namespace CustomPricingUnit {
+              interface CustomPricingUnitDetails {
+                /**
+                 * Time at which the object was created. Measured in seconds since the Unix epoch.
+                 */
+                created: number;
+
+                /**
+                 * The name of the custom pricing unit.
+                 */
+                display_name: string;
+
+                /**
+                 * Unique identifier for the object.
+                 */
+                id: string;
+
+                /**
+                 * A lookup key for the custom pricing unit.
+                 */
+                lookup_key: string | null;
+
+                /**
+                 * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+                 */
+                metadata: Stripe.Metadata;
+
+                /**
+                 * The status of the custom pricing unit.
+                 */
+                status: string;
+              }
+            }
+
+            type Type = 'amount' | 'custom_pricing_unit';
+          }
+        }
+
         type Status = 'active' | 'archived' | 'inactive';
 
         interface UsageThreshold {

package/types/Billing/AlertsResource.d.ts

@@ -24,6 +24,11 @@ declare module 'stripe' {
          */
         expand?: Array<string>;
 
+        /**
+         * The configuration of the spend threshold.
+         */
+        spend_threshold?: AlertCreateParams.SpendThreshold;
+
         /**
          * The configuration of the usage threshold.
          */
@@ -31,7 +36,10 @@ declare module 'stripe' {
       }
 
       namespace AlertCreateParams {
-        type AlertType = 'credit_balance_threshold' | 'usage_threshold';
+        type AlertType =
+          | 'credit_balance_threshold'
+          | 'spend_threshold'
+          | 'usage_threshold';
 
         interface CreditBalanceThreshold {
           /**
@@ -164,6 +172,97 @@ declare module 'stripe' {
           }
         }
 
+        interface SpendThreshold {
+          /**
+           * Defines the period over which spend is aggregated.
+           */
+          aggregation_period: 'billing';
+
+          /**
+           * Filters to scope the spend calculation.
+           */
+          filters?: SpendThreshold.Filters;
+
+          /**
+           * Defines the granularity of spend aggregation. Defaults to `pricing_plan_subscription`.
+           */
+          group_by?: 'pricing_plan_subscription';
+
+          /**
+           * Defines at which value the alert will fire.
+           */
+          gte: SpendThreshold.Gte;
+        }
+
+        namespace SpendThreshold {
+          interface Filters {
+            /**
+             * Filter by billable item IDs. Maximum of 20 billable items.
+             */
+            billable_items?: Array<string>;
+
+            /**
+             * Filter by billing cadence ID.
+             */
+            billing_cadence?: string;
+
+            /**
+             * Filter by pricing plan ID.
+             */
+            pricing_plan?: string;
+
+            /**
+             * Filter by pricing plan subscription ID.
+             */
+            pricing_plan_subscription?: string;
+          }
+
+          interface Gte {
+            /**
+             * The monetary amount. Required when type is `amount`.
+             */
+            amount?: Gte.Amount;
+
+            /**
+             * The custom pricing unit amount. Required when type is `custom_pricing_unit`.
+             */
+            custom_pricing_unit?: Gte.CustomPricingUnit;
+
+            /**
+             * The type of the threshold amount.
+             */
+            type: Gte.Type;
+          }
+
+          namespace Gte {
+            interface Amount {
+              /**
+               * Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
+               */
+              currency: string;
+
+              /**
+               * An integer representing the amount of the threshold.
+               */
+              value: number;
+            }
+
+            interface CustomPricingUnit {
+              /**
+               * The ID of the custom pricing unit.
+               */
+              id: string;
+
+              /**
+               * A positive decimal string representing the amount of the custom pricing unit threshold.
+               */
+              value: string;
+            }
+
+            type Type = 'amount' | 'custom_pricing_unit';
+          }
+        }
+
         interface UsageThreshold {
           /**
            * The filters allows limiting the scope of this usage alert. You can only specify up to one filter at this time.
@@ -231,7 +330,10 @@ declare module 'stripe' {
       }
 
       namespace AlertListParams {
-        type AlertType = 'credit_balance_threshold' | 'usage_threshold';
+        type AlertType =
+          | 'credit_balance_threshold'
+          | 'spend_threshold'
+          | 'usage_threshold';
       }
 
       interface AlertActivateParams {

package/types/InvoiceLineItems.d.ts

@@ -272,9 +272,52 @@ declare module 'stripe' {
 
         interface ScheduleDetails {
           /**
-           * The subscription schedule that generated this line item
+           * The subscription schedule that generated this line item.
            */
           schedule: string;
+
+          /**
+           * The invoice item that generated this line item.
+           */
+          invoice_item: string | null;
+
+          /**
+           * Whether this is a proration.
+           */
+          proration: boolean;
+
+          /**
+           * Additional details for proration line items.
+           */
+          proration_details: ScheduleDetails.ProrationDetails | null;
+
+          /**
+           * The subscription that the schedule belongs to.
+           */
+          subscription: string | null;
+        }
+
+        namespace ScheduleDetails {
+          interface ProrationDetails {
+            /**
+             * For a credit proration `line_item`, the original debit line_items to which the credit proration applies.
+             */
+            credited_items: ProrationDetails.CreditedItems | null;
+          }
+
+          namespace ProrationDetails {
+            interface CreditedItems {
+              /**
+               * Invoice containing the credited invoice line items
+               */
+              invoice: string;
+
+              /**
+               * Credited invoice line items
+               */
+              invoice_line_items: Array<string>;
+            }
+          }
         }
 
         interface SubscriptionItemDetails {

package/types/PaymentMethods.d.ts

@@ -944,6 +944,16 @@ declare module 'stripe' {
          * ID of the Dashboard-only CustomPaymentMethodType. Not expandable.
          */
         type: string;
+
+        /**
+         * A reference to an external payment method, such as a PayPal Billing Agreement ID.
+         */
+        payment_method_reference?: string | null;
+
+        /**
+         * Indicates whether the payment method supports off-session payments.
+         */
+        usage?: 'off_session' | null;
       }
 
       namespace Custom {

package/types/PaymentMethodsResource.d.ts

@@ -972,6 +972,11 @@ declare module 'stripe' {
        */
       card?: PaymentMethodUpdateParams.Card;
 
+      /**
+       * If this is a `custom` PaymentMethod, this hash contains details about the Custom payment method.
+       */
+      custom?: PaymentMethodUpdateParams.Custom;
+
       /**
        * Specifies which fields in the response should be expanded.
        */
@@ -1053,6 +1058,18 @@ declare module 'stripe' {
         }
       }
 
+      interface Custom {
+        /**
+         * A reference to an external payment method, such as a PayPal Billing Agreement ID.
+         */
+        payment_method_reference?: string;
+
+        /**
+         * Indicates whether the payment method supports off-session payments.
+         */
+        usage?: 'off_session';
+      }
+
       interface Payto {
         /**
          * The account number for the bank account.

package/types/SubscriptionsResource.d.ts

@@ -3185,14 +3185,38 @@ declare module 'stripe' {
     namespace SubscriptionPauseParams {
       interface BillFor {
         /**
-         * Controls whether to debit for accrued metered usage in the current billing period. The default is `true`.
+         * Controls when to bill for metered usage in the current period. Defaults to `{ type: "now" }`.
          */
-        outstanding_usage?: boolean;
+        outstanding_usage_through?: BillFor.OutstandingUsageThrough;
 
         /**
-         * Controls whether to credit for licensed items in the current billing period. The default is `true`.
+         * Controls when to credit for unused time on licensed items. Defaults to `{ type: "now" }`.
          */
-        unused_time?: boolean;
+        unused_time_from?: BillFor.UnusedTimeFrom;
+      }
+
+      namespace BillFor {
+        interface OutstandingUsageThrough {
+          /**
+           * When to bill metered usage in the current period.
+           */
+          type: OutstandingUsageThrough.Type;
+        }
+
+        namespace OutstandingUsageThrough {
+          type Type = 'none' | 'now';
+        }
+
+        interface UnusedTimeFrom {
+          /**
+           * When to credit for unused time.
+           */
+          type: UnusedTimeFrom.Type;
+        }
+
+        namespace UnusedTimeFrom {
+          type Type = 'item_current_period_start' | 'none' | 'now';
+        }
       }
 
       type InvoicingBehavior = 'invoice' | 'pending_invoice_item';
@@ -3209,11 +3233,6 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
-      /**
-       * Controls when the subscription transitions from `paused` to `active`. Determines how payment on the invoice affects the resumption process.The default is `pending_if_incomplete`.
-       */
-      payment_behavior?: SubscriptionResumeParams.PaymentBehavior;
-
       /**
        * Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) resulting from the `billing_cycle_anchor` being `unchanged`. When the `billing_cycle_anchor` is set to `now` (default value), no prorations are generated. If no value is passed, the default is `create_prorations`.
        */
@@ -3228,8 +3247,6 @@ declare module 'stripe' {
     namespace SubscriptionResumeParams {
       type BillingCycleAnchor = 'now' | 'unchanged';
 
-      type PaymentBehavior = 'allow_incomplete' | 'pending_if_incomplete';
-
       type ProrationBehavior = 'always_invoice' | 'create_prorations' | 'none';
     }