stripe 19.4.0-alpha.1 → 19.4.0-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 19.4.0-alpha.2 - 2025-11-13
+This release changes the pinned API version to `2025-10-29.preview`.
+
+* [#2501](https://github.com/stripe/stripe-node/pull/2501) Update generated code for private-preview
+  * Add support for new resource `Issuing.Program`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `Issuing.Program`
+  * Add support for `schedule` on `Discount`
+  * Add support for `applicable_fees` on `DelegatedCheckout.RequestedSession.total_details`
+  * Add support for `schedule_details` on `Invoice.parent`, `InvoiceItem.parent`, `InvoiceLineItem.parent`, and `QuotePreviewInvoice.parent`
+  * Add support for new value `schedule_details` on enum `InvoiceItem.parent.type`
+  * Add support for `billing_schedules` on `InvoiceCreatePreviewParams.schedule_details`, `QuotePreviewSubscriptionSchedule`, `SubscriptionScheduleCreateParams`, `SubscriptionScheduleUpdateParams`, and `SubscriptionSchedule`
+  * Add support for new value `schedule_details` on enums `Invoice.parent.type` and `QuotePreviewInvoice.parent.type`
+  * Add support for new value `schedule_details` on enum `InvoiceLineItem.parent.type`
+  * Add support for `latest_invoice` on `QuotePreviewSubscriptionSchedule` and `SubscriptionSchedule`
+  * Add support for `phase_effective_at` on `QuotePreviewSubscriptionSchedule.default_settings`, `SubscriptionSchedule.default_settings`, `SubscriptionScheduleCreateParams.default_settings`, and `SubscriptionScheduleUpdateParams.default_settings`
+* [#2494](https://github.com/stripe/stripe-node/pull/2494) Update generated code for private-preview
+  * Remove support for resource `V2.Tax.AutomaticRule`
+  * Remove support for `create`, `deactivate`, `find`, `retrieve`, and `update` methods on resource `V2.Tax.AutomaticRule`
+  * Add support for `self_reported_income` and `self_reported_monthly_housing_payment` on `AccountCreateParams.individual`, `AccountCreatePersonParams`, `AccountUpdateParams.individual`, `AccountUpdatePersonParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
+  * Add support for new values `amendment_end`, `line_ends_at`, `schedule_end`, and `upcoming_invoice` on enums `InvoiceCreatePreviewParams.subscription_details.billing_schedules[].bill_until.type`, `Subscription.billing_schedules[].bill_until.type`, `SubscriptionCreateParams.billing_schedules[].bill_until.type`, and `SubscriptionUpdateParams.billing_schedules[].bill_until.type`
+  * Add support for `billing_schedules` and `phase_effective_at` on `Quote.subscription_data_overrides[]`, `Quote.subscription_data`, `QuoteCreateParams.subscription_data_overrides[]`, `QuoteCreateParams.subscription_data`, `QuoteUpdateParams.subscription_data_overrides[]`, and `QuoteUpdateParams.subscription_data`
+  * Add support for `bill_from` on `Subscription.billing_schedules[]`
+  * Add support for `amendment_end` and `line_ends_at` on `Subscription.billing_schedules[].bill_until`
+
 ## 19.4.0-alpha.1 - 2025-11-06
 * [#2489](https://github.com/stripe/stripe-node/pull/2489) Update generated code for private-preview
   * Add support for new resources `TransitBalance`, `V2.Reporting.ReportRun`, `V2.Reporting.Report`
@@ -9,6 +33,14 @@
   * Add support for `allocated_funds` on `Charge`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, and `PaymentIntentUpdateParams`
   * Add support for thin events `V2ReportingReportRunCreatedEvent`, `V2ReportingReportRunFailedEvent`, `V2ReportingReportRunSucceededEvent`, and `V2ReportingReportRunUpdatedEvent` with related object `V2.Reporting.ReportRun`
 
+## 19.3.1 - 2025-11-12
+* [#2500](https://github.com/stripe/stripe-node/pull/2500) Use `TextEncoder` instead of `Buffer` to ensure support in other JS environments
+  * Fixes issues like [#2499](https://github.com/stripe/stripe-node/issues/2499) and [#2493](https://github.com/stripe/stripe-node/issues/2493) where use of `Buffer.byteLength` was causing errors in some runtime environments.
+
+## 19.3.0 - 2025-11-05
+* [#2488](https://github.com/stripe/stripe-node/pull/2488) Update generated code
+  * Add support for `capture_method` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
+
 ## 19.3.0-beta.1 - 2025-10-29
 
 This release changes the pinned API version to `2025-10-29.preview`.

package/OPENAPI_VERSION

@@ -1 +1 @@
-v2110
+v2120

package/README.md

@@ -565,6 +565,8 @@ npm install stripe@private-preview --save
 
 ### Custom requests
 
+> This feature is only available from version 17 of this SDK.
+
 If you would like to send a request to an undocumented API (for example you are in a private beta), or if you prefer to bypass the method definitions in the library and specify your request details directly, you can use the `rawRequest` method on the StripeClient object.
 
 ```javascript

package/VERSION

@@ -1 +1 @@
-19.4.0-alpha.1
+19.4.0-alpha.2

package/cjs/RequestSender.js

@@ -430,7 +430,7 @@ class RequestSender {
                     contentType: apiMode == 'v2'
                         ? 'application/json'
                         : 'application/x-www-form-urlencoded',
-                    contentLength: Buffer.byteLength(requestData, 'utf8'),
+                    contentLength: new TextEncoder().encode(requestData).length,
                     apiVersion: apiVersion,
                     clientUserAgent,
                     method,

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-09-30.preview';
+exports.ApiVersion = '2025-10-29.preview';

package/cjs/resources/Issuing/Programs.js

@@ -0,0 +1,22 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Programs = void 0;
+const StripeResource_js_1 = require("../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Programs = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/issuing/programs' }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/issuing/programs/{program}',
+    }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/issuing/programs/{program}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/issuing/programs',
+        methodType: 'list',
+    }),
+});

package/cjs/resources.js

@@ -13,7 +13,6 @@ const Alerts_js_1 = require("./resources/Billing/Alerts.js");
 const Associations_js_1 = require("./resources/Tax/Associations.js");
 const Authorizations_js_1 = require("./resources/Issuing/Authorizations.js");
 const Authorizations_js_2 = require("./resources/TestHelpers/Issuing/Authorizations.js");
-const AutomaticRules_js_1 = require("./resources/V2/Tax/AutomaticRules.js");
 const BillSettings_js_1 = require("./resources/V2/Billing/BillSettings.js");
 const BlocklistEntries_js_1 = require("./resources/Identity/BlocklistEntries.js");
 const Cadences_js_1 = require("./resources/V2/Billing/Cadences.js");
@@ -91,6 +90,7 @@ const PricingPlanSubscriptions_js_1 = require("./resources/V2/Billing/PricingPla
 const PricingPlans_js_1 = require("./resources/V2/Billing/PricingPlans.js");
 const Products_js_1 = require("./resources/Climate/Products.js");
 const Profiles_js_1 = require("./resources/V2/Billing/Profiles.js");
+const Programs_js_1 = require("./resources/Issuing/Programs.js");
 const RateCardSubscriptions_js_1 = require("./resources/V2/Billing/RateCardSubscriptions.js");
 const RateCards_js_1 = require("./resources/V2/Billing/RateCards.js");
 const ReaderCollectedData_js_1 = require("./resources/Terminal/ReaderCollectedData.js");
@@ -320,6 +320,7 @@ exports.Issuing = (0, ResourceNamespace_js_1.resourceNamespace)('issuing', {
     FraudLiabilityDebits: FraudLiabilityDebits_js_1.FraudLiabilityDebits,
     PersonalizationDesigns: PersonalizationDesigns_js_1.PersonalizationDesigns,
     PhysicalBundles: PhysicalBundles_js_1.PhysicalBundles,
+    Programs: Programs_js_1.Programs,
     Tokens: Tokens_js_1.Tokens,
     Transactions: Transactions_js_2.Transactions,
 });
@@ -448,7 +449,6 @@ exports.V2 = (0, ResourceNamespace_js_1.resourceNamespace)('v2', {
         ReportRuns: ReportRuns_js_2.ReportRuns,
         Reports: Reports_js_1.Reports,
     }),
-    Tax: (0, ResourceNamespace_js_1.resourceNamespace)('tax', { AutomaticRules: AutomaticRules_js_1.AutomaticRules }),
     TestHelper: (0, ResourceNamespace_js_1.resourceNamespace)('testHelper', {
         FinancialAddresses: FinancialAddresses_js_2.FinancialAddresses,
         MoneyManagement: MoneyManagement_js_1.MoneyManagement,

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 = '19.4.0-alpha.1';
+    Stripe.PACKAGE_VERSION = '19.4.0-alpha.2';
     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/RequestSender.js

@@ -427,7 +427,7 @@ export class RequestSender {
                     contentType: apiMode == 'v2'
                         ? 'application/json'
                         : 'application/x-www-form-urlencoded',
-                    contentLength: Buffer.byteLength(requestData, 'utf8'),
+                    contentLength: new TextEncoder().encode(requestData).length,
                     apiVersion: apiVersion,
                     clientUserAgent,
                     method,

package/esm/apiVersion.js

@@ -1,2 +1,2 @@
 // File generated from our OpenAPI spec
-export const ApiVersion = '2025-09-30.preview';
+export const ApiVersion = '2025-10-29.preview';

package/esm/resources/Issuing/Programs.js

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Programs = StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/issuing/programs' }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/issuing/programs/{program}',
+    }),
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/issuing/programs/{program}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/issuing/programs',
+        methodType: 'list',
+    }),
+});

package/esm/resources.js

@@ -9,7 +9,6 @@ import { Alerts as BillingAlerts } from './resources/Billing/Alerts.js';
 import { Associations as TaxAssociations } from './resources/Tax/Associations.js';
 import { Authorizations as IssuingAuthorizations } from './resources/Issuing/Authorizations.js';
 import { Authorizations as TestHelpersIssuingAuthorizations } from './resources/TestHelpers/Issuing/Authorizations.js';
-import { AutomaticRules as V2TaxAutomaticRules } from './resources/V2/Tax/AutomaticRules.js';
 import { BillSettings as V2BillingBillSettings } from './resources/V2/Billing/BillSettings.js';
 import { BlocklistEntries as IdentityBlocklistEntries } from './resources/Identity/BlocklistEntries.js';
 import { Cadences as V2BillingCadences } from './resources/V2/Billing/Cadences.js';
@@ -87,6 +86,7 @@ import { PricingPlanSubscriptions as V2BillingPricingPlanSubscriptions } from '.
 import { PricingPlans as V2BillingPricingPlans } from './resources/V2/Billing/PricingPlans.js';
 import { Products as ClimateProducts } from './resources/Climate/Products.js';
 import { Profiles as V2BillingProfiles } from './resources/V2/Billing/Profiles.js';
+import { Programs as IssuingPrograms } from './resources/Issuing/Programs.js';
 import { RateCardSubscriptions as V2BillingRateCardSubscriptions } from './resources/V2/Billing/RateCardSubscriptions.js';
 import { RateCards as V2BillingRateCards } from './resources/V2/Billing/RateCards.js';
 import { ReaderCollectedData as TerminalReaderCollectedData } from './resources/Terminal/ReaderCollectedData.js';
@@ -254,6 +254,7 @@ export const Issuing = resourceNamespace('issuing', {
     FraudLiabilityDebits: IssuingFraudLiabilityDebits,
     PersonalizationDesigns: IssuingPersonalizationDesigns,
     PhysicalBundles: IssuingPhysicalBundles,
+    Programs: IssuingPrograms,
     Tokens: IssuingTokens,
     Transactions: IssuingTransactions,
 });
@@ -382,7 +383,6 @@ export const V2 = resourceNamespace('v2', {
         ReportRuns: V2ReportingReportRuns,
         Reports: V2ReportingReports,
     }),
-    Tax: resourceNamespace('tax', { AutomaticRules: V2TaxAutomaticRules }),
     TestHelper: resourceNamespace('testHelper', {
         FinancialAddresses: V2TestHelpersFinancialAddresses,
         MoneyManagement: V2TestHelpersMoneyManagement,

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 = '19.4.0-alpha.1';
+    Stripe.PACKAGE_VERSION = '19.4.0-alpha.2';
     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": "19.4.0-alpha.1",
+  "version": "19.4.0-alpha.2",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/AccountsResource.d.ts

@@ -1716,6 +1716,16 @@ declare module 'stripe' {
          * The individual's verification document information.
          */
         verification?: Individual.Verification;
+
+        /**
+         * The credit applicant's self-reported yearly income in minor units.
+         */
+        self_reported_income?: Individual.SelfReportedIncome;
+
+        /**
+         * The credit applicant's self-reported monthly housing payment in minor units.
+         */
+        self_reported_monthly_housing_payment?: Individual.SelfReportedMonthlyHousingPayment;
       }
 
       namespace Individual {
@@ -1765,6 +1775,18 @@ declare module 'stripe' {
           title?: string;
         }
 
+        interface SelfReportedIncome {
+          amount: number;
+
+          currency: string;
+        }
+
+        interface SelfReportedMonthlyHousingPayment {
+          amount: number;
+
+          currency: string;
+        }
+
         interface Verification {
           /**
            * A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.
@@ -3824,6 +3846,16 @@ declare module 'stripe' {
          * The individual's verification document information.
          */
         verification?: Individual.Verification;
+
+        /**
+         * The credit applicant's self-reported yearly income in minor units.
+         */
+        self_reported_income?: Individual.SelfReportedIncome;
+
+        /**
+         * The credit applicant's self-reported monthly housing payment in minor units.
+         */
+        self_reported_monthly_housing_payment?: Individual.SelfReportedMonthlyHousingPayment;
       }
 
       namespace Individual {
@@ -3873,6 +3905,18 @@ declare module 'stripe' {
           title?: string;
         }
 
+        interface SelfReportedIncome {
+          amount: number;
+
+          currency: string;
+        }
+
+        interface SelfReportedMonthlyHousingPayment {
+          amount: number;
+
+          currency: string;
+        }
+
         interface Verification {
           /**
            * A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.
@@ -4539,6 +4583,16 @@ declare module 'stripe' {
        */
       relationship?: AccountCreatePersonParams.Relationship;
 
+      /**
+       * The credit applicant's self-reported yearly income in minor units.
+       */
+      self_reported_income?: AccountCreatePersonParams.SelfReportedIncome;
+
+      /**
+       * The credit applicant's self-reported monthly housing payment in minor units.
+       */
+      self_reported_monthly_housing_payment?: AccountCreatePersonParams.SelfReportedMonthlyHousingPayment;
+
       /**
        * The last four digits of the person's Social Security number (U.S. only).
        */
@@ -4683,6 +4737,18 @@ declare module 'stripe' {
         title?: string;
       }
 
+      interface SelfReportedIncome {
+        amount: number;
+
+        currency: string;
+      }
+
+      interface SelfReportedMonthlyHousingPayment {
+        amount: number;
+
+        currency: string;
+      }
+
       interface UsCfpbData {
         /**
          * The persons ethnicity details
@@ -5168,6 +5234,16 @@ declare module 'stripe' {
        */
       relationship?: AccountUpdatePersonParams.Relationship;
 
+      /**
+       * The credit applicant's self-reported yearly income in minor units.
+       */
+      self_reported_income?: AccountUpdatePersonParams.SelfReportedIncome;
+
+      /**
+       * The credit applicant's self-reported monthly housing payment in minor units.
+       */
+      self_reported_monthly_housing_payment?: AccountUpdatePersonParams.SelfReportedMonthlyHousingPayment;
+
       /**
        * The last four digits of the person's Social Security number (U.S. only).
        */
@@ -5312,6 +5388,18 @@ declare module 'stripe' {
         title?: string;
       }
 
+      interface SelfReportedIncome {
+        amount: number;
+
+        currency: string;
+      }
+
+      interface SelfReportedMonthlyHousingPayment {
+        amount: number;
+
+        currency: string;
+      }
+
       interface UsCfpbData {
         /**
          * The persons ethnicity details

package/types/DelegatedCheckout/RequestedSessions.d.ts

@@ -353,6 +353,30 @@ declare module 'stripe' {
            * The amount tax of the total details.
            */
           amount_tax: number | null;
+
+          /**
+           * The applicable fees of the total details.
+           */
+          applicable_fees: Array<TotalDetails.ApplicableFee> | null;
+        }
+
+        namespace TotalDetails {
+          interface ApplicableFee {
+            /**
+             * The amount of the applicable fee.
+             */
+            amount: number;
+
+            /**
+             * The description of the applicable fee.
+             */
+            description: string | null;
+
+            /**
+             * The display name of the applicable fee.
+             */
+            display_name: string;
+          }
         }
       }
     }

package/types/DelegatedCheckout/RequestedSessionsResource.d.ts

@@ -64,6 +64,9 @@ declare module 'stripe' {
 
       namespace RequestedSessionCreateParams {
         interface FulfillmentDetails {
+          /**
+           * The customer's address.
+           */
           address?: FulfillmentDetails.Address;
 
           /**
@@ -281,6 +284,9 @@ declare module 'stripe' {
 
       namespace RequestedSessionUpdateParams {
         interface FulfillmentDetails {
+          /**
+           * The customer's address.
+           */
           address?: FulfillmentDetails.Address;
 
           /**

package/types/Discounts.d.ts

@@ -51,6 +51,11 @@ declare module 'stripe' {
        */
       promotion_code: string | Stripe.PromotionCode | null;
 
+      /**
+       * The subscription schedule that this coupon is applied to, if it is applied to a particular subscription schedule.
+       */
+      schedule?: string | null;
+
       source: DeletedDiscount.Source;
 
       /**
@@ -140,6 +145,11 @@ declare module 'stripe' {
        */
       promotion_code: string | Stripe.PromotionCode | null;
 
+      /**
+       * The subscription schedule that this coupon is applied to, if it is applied to a particular subscription schedule.
+       */
+      schedule?: string | null;
+
       source: Discount.Source;
 
       /**

package/types/InvoiceItems.d.ts

@@ -169,6 +169,11 @@ declare module 'stripe' {
          * The type of parent that generated this invoice item
          */
         type: Parent.Type;
+
+        /**
+         * Details about the subscription schedule that generated this invoice item
+         */
+        schedule_details?: Parent.ScheduleDetails | null;
       }
 
       namespace Parent {
@@ -216,6 +221,13 @@ declare module 'stripe' {
           rate_card_version: string;
         }
 
+        interface ScheduleDetails {
+          /**
+           * The subscription schedule that generated this invoice item
+           */
+          schedule: string;
+        }
+
         interface SubscriptionDetails {
           /**
            * The subscription that generated this invoice item
@@ -231,6 +243,7 @@ declare module 'stripe' {
         type Type =
           | 'license_fee_subscription_details'
           | 'rate_card_subscription_details'
+          | 'schedule_details'
           | 'subscription_details';
       }
 

package/types/InvoiceLineItems.d.ts

@@ -158,6 +158,11 @@ declare module 'stripe' {
          * The type of parent that generated this line item
          */
         type: Parent.Type;
+
+        /**
+         * Details about the subscription schedule that generated this line item
+         */
+        schedule_details?: Parent.ScheduleDetails | null;
       }
 
       namespace Parent {
@@ -260,6 +265,13 @@ declare module 'stripe' {
           rate_card_version: string;
         }
 
+        interface ScheduleDetails {
+          /**
+           * The subscription schedule that generated this line item
+           */
+          schedule: string;
+        }
+
         interface SubscriptionItemDetails {
           /**
            * The invoice item that generated this line item
@@ -314,6 +326,7 @@ declare module 'stripe' {
           | 'invoice_item_details'
           | 'license_fee_subscription_details'
           | 'rate_card_subscription_details'
+          | 'schedule_details'
           | 'subscription_item_details';
       }
 

package/types/Invoices.d.ts

@@ -1109,6 +1109,11 @@ declare module 'stripe' {
          * The type of parent that generated this invoice
          */
         type: Parent.Type;
+
+        /**
+         * Details about the schedule that generated this invoice
+         */
+        schedule_details?: Parent.ScheduleDetails | null;
       }
 
       namespace Parent {
@@ -1126,6 +1131,13 @@ declare module 'stripe' {
           quote: string;
         }
 
+        interface ScheduleDetails {
+          /**
+           * The schedule that generated this invoice
+           */
+          schedule: string;
+        }
+
         interface SubscriptionDetails {
           /**
            * Set of [key-value pairs](https://stripe.com/docs/api/metadata) defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization.
@@ -1170,6 +1182,7 @@ declare module 'stripe' {
         type Type =
           | 'billing_cadence_details'
           | 'quote_details'
+          | 'schedule_details'
           | 'subscription_details';
       }
 

package/types/InvoicesResource.d.ts

@@ -2854,6 +2854,11 @@ declare module 'stripe' {
          * In cases where the `schedule_details` params update the currently active phase, specifies if and how to prorate at the time of the request.
          */
         proration_behavior?: ScheduleDetails.ProrationBehavior;
+
+        /**
+         * Sets the billing schedules for the subscription schedule.
+         */
+        billing_schedules?: Array<ScheduleDetails.BillingSchedule>;
       }
 
       namespace ScheduleDetails {
@@ -3481,6 +3486,80 @@ declare module 'stripe' {
           type Type = 'classic' | 'flexible';
         }
 
+        interface BillingSchedule {
+          /**
+           * Configure billing schedule differently for individual subscription items.
+           */
+          applies_to?: Array<BillingSchedule.AppliesTo>;
+
+          /**
+           * The end date for the billing schedule.
+           */
+          bill_until?: BillingSchedule.BillUntil;
+
+          /**
+           * Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+           */
+          key?: string;
+        }
+
+        namespace BillingSchedule {
+          interface AppliesTo {
+            /**
+             * The ID of the price object.
+             */
+            price?: string;
+
+            /**
+             * Controls which subscription items the billing schedule applies to.
+             */
+            type: 'price';
+          }
+
+          interface BillUntil {
+            /**
+             * Specifies the billing period.
+             */
+            duration?: BillUntil.Duration;
+
+            /**
+             * The end date of the billing schedule.
+             */
+            timestamp?: number;
+
+            /**
+             * Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+             */
+            type: BillUntil.Type;
+          }
+
+          namespace BillUntil {
+            interface Duration {
+              /**
+               * Specifies billing duration. Either `day`, `week`, `month` or `year`.
+               */
+              interval: Duration.Interval;
+
+              /**
+               * The multiplier applied to the interval.
+               */
+              interval_count?: number;
+            }
+
+            namespace Duration {
+              type Interval = 'day' | 'month' | 'week' | 'year';
+            }
+
+            type Type =
+              | 'amendment_end'
+              | 'duration'
+              | 'line_ends_at'
+              | 'schedule_end'
+              | 'timestamp'
+              | 'upcoming_invoice';
+          }
+        }
+
         type EndBehavior = 'cancel' | 'release';
 
         interface Phase {
@@ -4426,7 +4505,13 @@ declare module 'stripe' {
               type Interval = 'day' | 'month' | 'week' | 'year';
             }
 
-            type Type = 'duration' | 'timestamp';
+            type Type =
+              | 'amendment_end'
+              | 'duration'
+              | 'line_ends_at'
+              | 'schedule_end'
+              | 'timestamp'
+              | 'upcoming_invoice';
           }
         }