stripe 20.1.0-alpha.2 → 20.1.0-alpha.4

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 20.1.0-alpha.4 - 2025-12-04
+* [#2519](https://github.com/stripe/stripe-node/pull/2519) Update generated code for private-preview
+  * Add support for event notifications `V2IamApiKeyCreatedEvent`, `V2IamApiKeyDefaultSecretRevealedEvent`, `V2IamApiKeyExpiredEvent`, `V2IamApiKeyPermissionsUpdatedEvent`, `V2IamApiKeyRotatedEvent`, and `V2IamApiKeyUpdatedEvent`
+* [#2517](https://github.com/stripe/stripe-node/pull/2517) Update generated code for private-preview
+  * Add support for `check_scanning` on `AccountSession.components`
+  * Add support for `client` on `V2.Core.Event.reason.request`
+  * Add support for `stripe_balance_payment` on `V2.MoneyManagement.ReceivedCredit` and `V2.MoneyManagement.ReceivedDebit`
+  * Add support for new value `stripe_balance_payment` on enum `V2.MoneyManagement.ReceivedCredit.type`
+  * Add support for `balance_transfer` on `V2.MoneyManagement.ReceivedDebit`
+  * Add support for new values `balance_transfer` and `stripe_balance_payment` on enum `V2.MoneyManagement.ReceivedDebit.type`
+  * Add support for `include` on `V2.Core.EventListParams` and `V2.Core.EventRetrieveParams`
+
+## 20.1.0-alpha.3 - 2025-11-24
+* [#2512](https://github.com/stripe/stripe-node/pull/2512) Update generated code for private-preview
+  * Add support for new resource `ProductCatalog.TrialOffer`
+  * Add support for `create` method on resource `ProductCatalog.TrialOffer`
+  * Remove support for `amount_subtotal_after_discount` on `DelegatedCheckout.RequestedSession.line_item_details[]` and `DelegatedCheckout.RequestedSession.total_details`
+  * Remove support for `amount_total`, `unit_amount_after_discount`, and `unit_discount` on `DelegatedCheckout.RequestedSession.line_item_details[]`
+  * Add support for `amount_cart_discount` and `amount_items_discount` on `DelegatedCheckout.RequestedSession.total_details`
+  * Remove support for `amount_discount` on `DelegatedCheckout.RequestedSession.total_details`
+  * Add support for `payments_orchestration` on `PaymentIntentCreateParams` and `PaymentIntent`
+
 ## 20.1.0-alpha.2 - 2025-11-20
 This release changes the pinned API version to `2025-11-17.preview`.
 

package/OPENAPI_VERSION

@@ -1 +1 @@
-v2128
+v2132

package/VERSION

@@ -1 +1 @@
-20.1.0-alpha.2
+20.1.0-alpha.4

package/cjs/resources/ProductCatalog/TrialOffers.js

@@ -0,0 +1,12 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrialOffers = void 0;
+const StripeResource_js_1 = require("../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.TrialOffers = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/product_catalog/trial_offers',
+    }),
+});

package/cjs/resources.js

@@ -2,7 +2,7 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SetupAttempts = exports.Reviews = exports.Refunds = exports.Quotes = exports.PromotionCodes = exports.Products = exports.Prices = exports.Plans = exports.Payouts = exports.PaymentRecords = exports.PaymentMethods = exports.PaymentMethodDomains = exports.PaymentMethodConfigurations = exports.PaymentLinks = exports.PaymentIntents = exports.PaymentAttemptRecords = exports.Orders = exports.OAuth = exports.Margins = exports.Mandates = exports.Invoices = exports.InvoiceRenderingTemplates = exports.InvoicePayments = exports.InvoiceItems = exports.FxQuotes = exports.Files = exports.FileLinks = exports.ExternalAccounts = exports.ExchangeRates = exports.Events = exports.EphemeralKeys = exports.Disputes = exports.Customers = exports.CustomerSessions = exports.CreditNotes = exports.Coupons = exports.CountrySpecs = exports.ConfirmationTokens = exports.Charges = exports.BalanceTransfers = exports.BalanceTransactions = exports.BalanceSettings = exports.Balance = exports.ApplicationFees = exports.ApplePayDomains = exports.Accounts = exports.AccountSessions = exports.AccountNotices = exports.AccountLinks = exports.Account = void 0;
-exports.V2 = exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.Privacy = exports.Issuing = exports.Identity = exports.Forwarding = exports.FinancialConnections = exports.Entitlements = exports.DelegatedCheckout = exports.Climate = exports.Checkout = exports.Capital = exports.BillingPortal = exports.Billing = exports.Apps = exports.WebhookEndpoints = exports.Transfers = exports.Topups = exports.Tokens = exports.TaxRates = exports.TaxIds = exports.TaxCodes = exports.Subscriptions = exports.SubscriptionSchedules = exports.SubscriptionItems = exports.Sources = exports.ShippingRates = exports.SetupIntents = void 0;
+exports.V2 = exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.ProductCatalog = exports.Privacy = exports.Issuing = exports.Identity = exports.Forwarding = exports.FinancialConnections = exports.Entitlements = exports.DelegatedCheckout = exports.Climate = exports.Checkout = exports.Capital = exports.BillingPortal = exports.Billing = exports.Apps = exports.WebhookEndpoints = exports.Transfers = exports.Topups = exports.Tokens = exports.TaxRates = exports.TaxIds = exports.TaxCodes = exports.Subscriptions = exports.SubscriptionSchedules = exports.SubscriptionItems = exports.Sources = exports.ShippingRates = exports.SetupIntents = void 0;
 const ResourceNamespace_js_1 = require("./ResourceNamespace.js");
 const AccountEvaluations_js_1 = require("./resources/Radar/AccountEvaluations.js");
 const AccountLinks_js_1 = require("./resources/V2/Core/AccountLinks.js");
@@ -133,6 +133,7 @@ const Transactions_js_3 = require("./resources/Tax/Transactions.js");
 const Transactions_js_4 = require("./resources/TestHelpers/Issuing/Transactions.js");
 const Transactions_js_5 = require("./resources/Treasury/Transactions.js");
 const Transactions_js_6 = require("./resources/V2/MoneyManagement/Transactions.js");
+const TrialOffers_js_1 = require("./resources/ProductCatalog/TrialOffers.js");
 const UsBankAccounts_js_1 = require("./resources/V2/Core/Vault/UsBankAccounts.js");
 const ValueListItems_js_1 = require("./resources/Radar/ValueListItems.js");
 const ValueLists_js_1 = require("./resources/Radar/ValueLists.js");
@@ -332,6 +333,9 @@ exports.Issuing = (0, ResourceNamespace_js_1.resourceNamespace)('issuing', {
 exports.Privacy = (0, ResourceNamespace_js_1.resourceNamespace)('privacy', {
     RedactionJobs: RedactionJobs_js_1.RedactionJobs,
 });
+exports.ProductCatalog = (0, ResourceNamespace_js_1.resourceNamespace)('productCatalog', {
+    TrialOffers: TrialOffers_js_1.TrialOffers,
+});
 exports.Radar = (0, ResourceNamespace_js_1.resourceNamespace)('radar', {
     AccountEvaluations: AccountEvaluations_js_1.AccountEvaluations,
     EarlyFraudWarnings: EarlyFraudWarnings_js_1.EarlyFraudWarnings,

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.1.0-alpha.2';
+    Stripe.PACKAGE_VERSION = '20.1.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/resources/ProductCatalog/TrialOffers.js

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const TrialOffers = StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/product_catalog/trial_offers',
+    }),
+});

package/esm/resources.js

@@ -129,6 +129,7 @@ import { Transactions as TaxTransactions } from './resources/Tax/Transactions.js
 import { Transactions as TestHelpersIssuingTransactions } from './resources/TestHelpers/Issuing/Transactions.js';
 import { Transactions as TreasuryTransactions } from './resources/Treasury/Transactions.js';
 import { Transactions as V2MoneyManagementTransactions } from './resources/V2/MoneyManagement/Transactions.js';
+import { TrialOffers as ProductCatalogTrialOffers } from './resources/ProductCatalog/TrialOffers.js';
 import { UsBankAccounts as V2CoreVaultUsBankAccounts } from './resources/V2/Core/Vault/UsBankAccounts.js';
 import { ValueListItems as RadarValueListItems } from './resources/Radar/ValueListItems.js';
 import { ValueLists as RadarValueLists } from './resources/Radar/ValueLists.js';
@@ -265,6 +266,9 @@ export const Issuing = resourceNamespace('issuing', {
 export const Privacy = resourceNamespace('privacy', {
     RedactionJobs: PrivacyRedactionJobs,
 });
+export const ProductCatalog = resourceNamespace('productCatalog', {
+    TrialOffers: ProductCatalogTrialOffers,
+});
 export const Radar = resourceNamespace('radar', {
     AccountEvaluations: RadarAccountEvaluations,
     EarlyFraudWarnings: RadarEarlyFraudWarnings,

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

package/types/AccountSessions.d.ts

@@ -89,6 +89,11 @@ declare module 'stripe' {
         tax_registrations: Components.TaxRegistrations;
 
         tax_settings: Components.TaxSettings;
+
+        /**
+         * Configuration for the [check scanning](https://docs.stripe.com/connect/supported-embedded-components/check-scanning/) embedded component.
+         */
+        check_scanning?: Components.CheckScanning | null;
       }
 
       namespace Components {
@@ -215,6 +220,19 @@ declare module 'stripe' {
           interface Features {}
         }
 
+        interface CheckScanning {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+
+          features: CheckScanning.Features;
+        }
+
+        namespace CheckScanning {
+          interface Features {}
+        }
+
         interface DisputesList {
           /**
            * Whether the embedded component is enabled.

package/types/AccountsResource.d.ts

@@ -1781,14 +1781,26 @@ declare module 'stripe' {
         }
 
         interface SelfReportedIncome {
+          /**
+           * The amount in the minor currency unit (for example, cents for USD).
+           */
           amount: number;
 
+          /**
+           * 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;
         }
 
         interface SelfReportedMonthlyHousingPayment {
+          /**
+           * The amount in the minor currency unit (for example, cents for USD).
+           */
           amount: number;
 
+          /**
+           * 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;
         }
 
@@ -3932,14 +3944,26 @@ declare module 'stripe' {
         }
 
         interface SelfReportedIncome {
+          /**
+           * The amount in the minor currency unit (for example, cents for USD).
+           */
           amount: number;
 
+          /**
+           * 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;
         }
 
         interface SelfReportedMonthlyHousingPayment {
+          /**
+           * The amount in the minor currency unit (for example, cents for USD).
+           */
           amount: number;
 
+          /**
+           * 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;
         }
 
@@ -4780,14 +4804,26 @@ declare module 'stripe' {
       }
 
       interface SelfReportedIncome {
+        /**
+         * The amount in the minor currency unit (for example, cents for USD).
+         */
         amount: number;
 
+        /**
+         * 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;
       }
 
       interface SelfReportedMonthlyHousingPayment {
+        /**
+         * The amount in the minor currency unit (for example, cents for USD).
+         */
         amount: number;
 
+        /**
+         * 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;
       }
 
@@ -5431,14 +5467,26 @@ declare module 'stripe' {
       }
 
       interface SelfReportedIncome {
+        /**
+         * The amount in the minor currency unit (for example, cents for USD).
+         */
         amount: number;
 
+        /**
+         * 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;
       }
 
       interface SelfReportedMonthlyHousingPayment {
+        /**
+         * The amount in the minor currency unit (for example, cents for USD).
+         */
         amount: number;
 
+        /**
+         * 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;
       }
 

package/types/DelegatedCheckout/RequestedSessions.d.ts

@@ -272,26 +272,6 @@ declare module 'stripe' {
            * The total before any discounts or taxes are applied.
            */
           amount_subtotal: number;
-
-          /**
-           * The total after discounts but before taxes are applied.
-           */
-          amount_subtotal_after_discount: number;
-
-          /**
-           * The total after discounts and taxes.
-           */
-          amount_total: number;
-
-          /**
-           * The per-unit amount of the item after discounts but before taxes are applied.
-           */
-          unit_amount_after_discount: number;
-
-          /**
-           * The per-unit discount amount. If no discount were applied, defaults to 0.
-           */
-          unit_discount: number;
         }
 
         interface OrderDetails {
@@ -369,11 +349,6 @@ declare module 'stripe' {
         type Status = 'completed' | 'expired' | 'open';
 
         interface TotalDetails {
-          /**
-           * The amount discount of the total details.
-           */
-          amount_discount: number | null;
-
           /**
            * The amount fulfillment of the total details.
            */
@@ -385,9 +360,14 @@ declare module 'stripe' {
           amount_tax: number | null;
 
           /**
-           * Total of all items after discounts but before taxes are applied.
+           * The amount of order-level discounts applied to the cart. The total discount amount for this session can be computed by summing the cart discount and the item discounts.
+           */
+          amount_cart_discount: number | null;
+
+          /**
+           * The amount of item-level discounts applied to the cart. The total discount amount for this session can be computed by summing the cart discount and the item discounts.
            */
-          amount_subtotal_after_discount: number | null;
+          amount_items_discount: number | null;
 
           /**
            * The applicable fees of the total details.

package/types/DelegatedCheckout/RequestedSessionsResource.d.ts

@@ -113,7 +113,7 @@ declare module 'stripe' {
             postal_code: string;
 
             /**
-             * State, county, province, or region.
+             * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
              */
             state: string;
           }
@@ -199,7 +199,7 @@ declare module 'stripe' {
               postal_code: string;
 
               /**
-               * State, county, province, or region.
+               * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
                */
               state: string;
             }
@@ -338,7 +338,7 @@ declare module 'stripe' {
             postal_code: string;
 
             /**
-             * State, county, province, or region.
+             * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
              */
             state: string;
           }
@@ -445,7 +445,7 @@ declare module 'stripe' {
               postal_code: string;
 
               /**
-               * State, county, province, or region.
+               * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
                */
               state: string;
             }

package/types/PaymentIntents.d.ts

@@ -191,6 +191,11 @@ declare module 'stripe' {
        */
       payment_method_types: Array<string>;
 
+      /**
+       * When you enable this parameter, this PaymentIntent will route your payment to processors that you configure in the dashboard.
+       */
+      payments_orchestration?: PaymentIntent.PaymentsOrchestration | null;
+
       presentment_details?: PaymentIntent.PresentmentDetails;
 
       /**
@@ -3674,6 +3679,13 @@ declare module 'stripe' {
         }
       }
 
+      interface PaymentsOrchestration {
+        /**
+         * Whether this feature is enabled.
+         */
+        enabled: boolean;
+      }
+
       interface PresentmentDetails {
         /**
          * Amount intended to be collected by this payment, denominated in `presentment_currency`.

package/types/PaymentIntentsResource.d.ts

@@ -166,6 +166,11 @@ declare module 'stripe' {
        */
       payment_method_types?: Array<string>;
 
+      /**
+       * When you enable this parameter, this PaymentIntent will route your payment to processors that you configure in the dashboard.
+       */
+      payments_orchestration?: PaymentIntentCreateParams.PaymentsOrchestration;
+
       /**
        * Options to configure Radar. Learn more about [Radar Sessions](https://stripe.com/docs/radar/radar-session).
        */
@@ -6984,6 +6989,13 @@ declare module 'stripe' {
         }
       }
 
+      interface PaymentsOrchestration {
+        /**
+         * Whether this feature is enabled.
+         */
+        enabled: boolean;
+      }
+
       interface RadarOptions {
         /**
          * A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.

package/types/Persons.d.ts

@@ -676,7 +676,7 @@ declare module 'stripe' {
 
       interface SelfReportedIncome {
         /**
-         * Amount in the minor currency unit (e.g., cents for USD)
+         * The amount in the minor currency unit (for example, cents for USD).
          */
         amount: number;
 
@@ -688,7 +688,7 @@ declare module 'stripe' {
 
       interface SelfReportedMonthlyHousingPayment {
         /**
-         * Amount in the minor currency unit (e.g., cents for USD)
+         * The amount in the minor currency unit (for example, cents for USD).
          */
         amount: number;
 

package/types/ProductCatalog/TrialOffers.d.ts

@@ -0,0 +1,77 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace ProductCatalog {
+      /**
+       * Resource for the TrialOffer API, used to describe a subscription item's trial period settings.
+       * Renders a TrialOffer object that describes the price, duration, end_behavior of a trial offer.
+       */
+      interface TrialOffer {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'product_catalog.trial_offer';
+
+        duration: TrialOffer.Duration;
+
+        end_behavior: TrialOffer.EndBehavior;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * The price during the trial offer.
+         */
+        price: string | Stripe.Price;
+      }
+
+      namespace TrialOffer {
+        interface Duration {
+          relative: Duration.Relative;
+
+          /**
+           * The type of trial offer duration.
+           */
+          type: Duration.Type;
+        }
+
+        namespace Duration {
+          interface Relative {
+            /**
+             * The number of iterations of the price's interval for this trial offer.
+             */
+            iterations: number;
+          }
+
+          type Type = 'relative' | 'timestamp';
+        }
+
+        interface EndBehavior {
+          transition: EndBehavior.Transition;
+
+          /**
+           * The type of behavior when the trial offer ends.
+           */
+          type: 'transition';
+        }
+
+        namespace EndBehavior {
+          interface Transition {
+            /**
+             * The new price to use at the end of the trial offer period.
+             */
+            price: string;
+          }
+        }
+      }
+    }
+  }
+}

package/types/ProductCatalog/TrialOffersResource.d.ts

@@ -0,0 +1,80 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace ProductCatalog {
+      interface TrialOfferCreateParams {
+        /**
+         * Duration of one service period of the trial.
+         */
+        duration: TrialOfferCreateParams.Duration;
+
+        /**
+         * Define behavior that occurs at the end of the trial.
+         */
+        end_behavior: TrialOfferCreateParams.EndBehavior;
+
+        /**
+         * Price configuration during the trial period (amount, billing scheme, etc).
+         */
+        price: string;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      namespace TrialOfferCreateParams {
+        interface Duration {
+          /**
+           * The relative duration of the trial period computed as the number of recurring price intervals.
+           */
+          relative?: Duration.Relative;
+
+          /**
+           * Specifies how the trial offer duration is determined.
+           */
+          type: Duration.Type;
+        }
+
+        namespace Duration {
+          interface Relative {
+            /**
+             * The number of recurring price's interval to apply for the trial period.
+             */
+            iterations: number;
+          }
+
+          type Type = 'relative' | 'timestamp';
+        }
+
+        interface EndBehavior {
+          /**
+           * The transition to apply when the trial offer ends.
+           */
+          transition: EndBehavior.Transition;
+        }
+
+        namespace EndBehavior {
+          interface Transition {
+            /**
+             * The price to transition the recurring item to when the trial offer ends.
+             */
+            price: string;
+          }
+        }
+      }
+
+      class TrialOffersResource {
+        /**
+         * Creates a trial offer.
+         */
+        create(
+          params: TrialOfferCreateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.ProductCatalog.TrialOffer>>;
+      }
+    }
+  }
+}

package/types/TokensResource.d.ts

@@ -493,14 +493,26 @@ declare module 'stripe' {
           }
 
           interface SelfReportedIncome {
+            /**
+             * The amount in the minor currency unit (for example, cents for USD).
+             */
             amount: number;
 
+            /**
+             * 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;
           }
 
           interface SelfReportedMonthlyHousingPayment {
+            /**
+             * The amount in the minor currency unit (for example, cents for USD).
+             */
             amount: number;
 
+            /**
+             * 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;
           }
 
@@ -955,14 +967,26 @@ declare module 'stripe' {
         }
 
         interface SelfReportedIncome {
+          /**
+           * The amount in the minor currency unit (for example, cents for USD).
+           */
           amount: number;
 
+          /**
+           * 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;
         }
 
         interface SelfReportedMonthlyHousingPayment {
+          /**
+           * The amount in the minor currency unit (for example, cents for USD).
+           */
           amount: number;
 
+          /**
+           * 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;
         }
 

package/types/V2/Core/EventTypes.d.ts

@@ -86,6 +86,12 @@ declare module 'stripe' {
       | Stripe.Events.V2CoreHealthTrafficVolumeDropResolvedEvent
       | Stripe.Events.V2CoreHealthWebhookLatencyFiringEvent
       | Stripe.Events.V2CoreHealthWebhookLatencyResolvedEvent
+      | Stripe.Events.V2IamApiKeyCreatedEvent
+      | Stripe.Events.V2IamApiKeyDefaultSecretRevealedEvent
+      | Stripe.Events.V2IamApiKeyExpiredEvent
+      | Stripe.Events.V2IamApiKeyPermissionsUpdatedEvent
+      | Stripe.Events.V2IamApiKeyRotatedEvent
+      | Stripe.Events.V2IamApiKeyUpdatedEvent
       | Stripe.Events.V2MoneyManagementAdjustmentCreatedEvent
       | Stripe.Events.V2MoneyManagementFinancialAccountCreatedEvent
       | Stripe.Events.V2MoneyManagementFinancialAccountUpdatedEvent
@@ -221,6 +227,12 @@ declare module 'stripe' {
       | Stripe.Events.V2CoreHealthTrafficVolumeDropResolvedEventNotification
       | Stripe.Events.V2CoreHealthWebhookLatencyFiringEventNotification
       | Stripe.Events.V2CoreHealthWebhookLatencyResolvedEventNotification
+      | Stripe.Events.V2IamApiKeyCreatedEventNotification
+      | Stripe.Events.V2IamApiKeyDefaultSecretRevealedEventNotification
+      | Stripe.Events.V2IamApiKeyExpiredEventNotification
+      | Stripe.Events.V2IamApiKeyPermissionsUpdatedEventNotification
+      | Stripe.Events.V2IamApiKeyRotatedEventNotification
+      | Stripe.Events.V2IamApiKeyUpdatedEventNotification
       | Stripe.Events.V2MoneyManagementAdjustmentCreatedEventNotification
       | Stripe.Events.V2MoneyManagementFinancialAccountCreatedEventNotification
       | Stripe.Events.V2MoneyManagementFinancialAccountUpdatedEventNotification
@@ -3859,6 +3871,91 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs when an API Key is created.
+     */
+    export interface V2IamApiKeyCreatedEvent extends V2.Core.EventBase {
+      type: 'v2.iam.api_key.created';
+    }
+    export interface V2IamApiKeyCreatedEventNotification
+      extends V2.Core.EventNotificationBase {
+      type: 'v2.iam.api_key.created';
+      fetchEvent(): Promise<V2IamApiKeyCreatedEvent>;
+    }
+
+    /**
+     * Occurs when the default API Key's secret is revealed.
+     */
+    export interface V2IamApiKeyDefaultSecretRevealedEvent
+      extends V2.Core.EventBase {
+      type: 'v2.iam.api_key.default_secret_revealed';
+    }
+    export interface V2IamApiKeyDefaultSecretRevealedEventNotification
+      extends V2.Core.EventNotificationBase {
+      type: 'v2.iam.api_key.default_secret_revealed';
+      fetchEvent(): Promise<V2IamApiKeyDefaultSecretRevealedEvent>;
+    }
+
+    /**
+     * Occurs when an API Key is expired.
+     */
+    export interface V2IamApiKeyExpiredEvent extends V2.Core.EventBase {
+      type: 'v2.iam.api_key.expired';
+    }
+    export interface V2IamApiKeyExpiredEventNotification
+      extends V2.Core.EventNotificationBase {
+      type: 'v2.iam.api_key.expired';
+      fetchEvent(): Promise<V2IamApiKeyExpiredEvent>;
+    }
+
+    /**
+     * Occurs when an API Key's permissions are updated.
+     */
+    export interface V2IamApiKeyPermissionsUpdatedEvent
+      extends V2.Core.EventBase {
+      type: 'v2.iam.api_key.permissions_updated';
+    }
+    export interface V2IamApiKeyPermissionsUpdatedEventNotification
+      extends V2.Core.EventNotificationBase {
+      type: 'v2.iam.api_key.permissions_updated';
+      fetchEvent(): Promise<V2IamApiKeyPermissionsUpdatedEvent>;
+    }
+
+    /**
+     * Occurs when an API Key is rotated.
+     */
+    export interface V2IamApiKeyRotatedEvent extends V2.Core.EventBase {
+      type: 'v2.iam.api_key.rotated';
+      // Retrieves data specific to this event.
+      data: V2IamApiKeyRotatedEvent.Data;
+    }
+    export interface V2IamApiKeyRotatedEventNotification
+      extends V2.Core.EventNotificationBase {
+      type: 'v2.iam.api_key.rotated';
+      fetchEvent(): Promise<V2IamApiKeyRotatedEvent>;
+    }
+
+    namespace V2IamApiKeyRotatedEvent {
+      export interface Data {
+        /**
+         * ID of the new key that was created due to rotation.
+         */
+        new_api_key: string;
+      }
+    }
+
+    /**
+     * Occurs when an API Key is updated.
+     */
+    export interface V2IamApiKeyUpdatedEvent extends V2.Core.EventBase {
+      type: 'v2.iam.api_key.updated';
+    }
+    export interface V2IamApiKeyUpdatedEventNotification
+      extends V2.Core.EventNotificationBase {
+      type: 'v2.iam.api_key.updated';
+      fetchEvent(): Promise<V2IamApiKeyUpdatedEvent>;
+    }
+
     /**
      * Occurs when an Adjustment is created.
      */

package/types/V2/Core/Events.d.ts

@@ -23,6 +23,11 @@ declare module 'stripe' {
 
           namespace Reason {
             interface Request {
+              /**
+               * The client details that made the request.
+               */
+              client?: Request.Client;
+
               /**
                * ID of the API request that caused the event.
                */
@@ -33,6 +38,62 @@ declare module 'stripe' {
                */
               idempotency_key: string;
             }
+
+            namespace Request {
+              interface Client {
+                /**
+                 * The type of the client.
+                 */
+                type: Client.Type;
+
+                /**
+                 * API key that triggered the event.
+                 */
+                api_key?: Client.ApiKey;
+
+                /**
+                 * Dashboard user that triggered the event.
+                 */
+                dashboard_user?: Client.DashboardUser;
+
+                /**
+                 * Stripe action that triggered the event.
+                 */
+                stripe_action?: Client.StripeAction;
+              }
+
+              namespace Client {
+                interface ApiKey {
+                  /**
+                   * The ID of the API key.
+                   */
+                  id: string;
+                }
+
+                interface DashboardUser {
+                  /**
+                   * The email of the dashboard user.
+                   */
+                  email: string;
+
+                  /**
+                   * The IP address of the user.
+                   */
+                  ip_address: string;
+
+                  /**
+                   * The machine identifier of the user.
+                   */
+                  machine_identifier: string;
+                }
+
+                type StripeAction = {
+                  [key: string]: unknown;
+                };
+
+                type Type = 'api_key' | 'dashboard_user' | 'stripe_action';
+              }
+            }
           }
         }
 

package/types/V2/Core/EventsResource.d.ts

@@ -6,7 +6,12 @@ declare module 'stripe' {
   namespace Stripe {
     namespace V2 {
       namespace Core {
-        interface EventRetrieveParams {}
+        interface EventRetrieveParams {
+          /**
+           * Additional fields to include in the response.
+           */
+          include?: Array<'reason.request.client'>;
+        }
       }
 
       namespace Core {
@@ -16,6 +21,11 @@ declare module 'stripe' {
            */
           created?: Stripe.RangeQueryParam;
 
+          /**
+           * Additional fields to include in the response.
+           */
+          include?: Array<'reason.request.client'>;
+
           /**
            * The page size.
            */

package/types/V2/MoneyManagement/ReceivedCredits.d.ts

@@ -79,6 +79,11 @@ declare module 'stripe' {
            */
           status_transitions?: ReceivedCredit.StatusTransitions;
 
+          /**
+           * This object stores details about the stripe balance pay refund that resulted in the ReceivedCredit. Present if `type` field value is `stripe_balance_payment`.
+           */
+          stripe_balance_payment?: ReceivedCredit.StripeBalancePayment;
+
           /**
            * Open Enum. The type of flow that caused the ReceivedCredit.
            */
@@ -323,7 +328,18 @@ declare module 'stripe' {
             succeeded_at?: string;
           }
 
-          type Type = 'balance_transfer' | 'bank_transfer' | 'external_credit';
+          interface StripeBalancePayment {
+            /**
+             * Statement descriptor for the Stripe Balance Payment.
+             */
+            statement_descriptor?: string;
+          }
+
+          type Type =
+            | 'balance_transfer'
+            | 'bank_transfer'
+            | 'external_credit'
+            | 'stripe_balance_payment';
         }
       }
     }

package/types/V2/MoneyManagement/ReceivedDebits.d.ts

@@ -23,6 +23,11 @@ declare module 'stripe' {
            */
           amount: ReceivedDebit.Amount;
 
+          /**
+           * This object stores details about the balance transfer object that resulted in the ReceivedDebit.
+           */
+          balance_transfer?: ReceivedDebit.BalanceTransfer;
+
           /**
            * This object stores details about the originating banking transaction that resulted in the ReceivedDebit. Present if `type` field value is `bank_transfer`.
            */
@@ -75,7 +80,12 @@ declare module 'stripe' {
           status_transitions?: ReceivedDebit.StatusTransitions;
 
           /**
-           * Open Enum. The type of the ReceivedDebit.
+           * This object stores details about the Stripe Balance Payment that resulted in the ReceivedDebit.
+           */
+          stripe_balance_payment?: ReceivedDebit.StripeBalancePayment;
+
+          /**
+           * Open enum, the type of the received debit.
            */
           type: ReceivedDebit.Type;
         }
@@ -93,6 +103,18 @@ declare module 'stripe' {
             currency?: string;
           }
 
+          interface BalanceTransfer {
+            /**
+             * Open Enum. The type of balance transfer that originated the ReceivedDebit.
+             */
+            type: 'topup';
+
+            /**
+             * The ID of the topup object that originated the ReceivedDebit.
+             */
+            topup?: string;
+          }
+
           interface BankTransfer {
             /**
              * The Financial Address that was debited.
@@ -202,7 +224,23 @@ declare module 'stripe' {
             succeeded_at?: string;
           }
 
-          type Type = 'bank_transfer' | 'external_debit';
+          interface StripeBalancePayment {
+            /**
+             * ID of the debit agreement associated with this payment.
+             */
+            debit_agreement?: string;
+
+            /**
+             * Statement descriptor for the Stripe Balance Payment.
+             */
+            statement_descriptor?: string;
+          }
+
+          type Type =
+            | 'balance_transfer'
+            | 'bank_transfer'
+            | 'external_debit'
+            | 'stripe_balance_payment';
         }
       }
     }

package/types/index.d.ts

@@ -94,6 +94,7 @@
 ///<reference path='./PlansResource.d.ts' />
 ///<reference path='./PricesResource.d.ts' />
 ///<reference path='./Privacy/RedactionJobsResource.d.ts' />
+///<reference path='./ProductCatalog/TrialOffersResource.d.ts' />
 ///<reference path='./ProductsResource.d.ts' />
 ///<reference path='./PromotionCodesResource.d.ts' />
 ///<reference path='./QuotesResource.d.ts' />
@@ -329,6 +330,7 @@
 ///<reference path='./Prices.d.ts' />
 ///<reference path='./Privacy/RedactionJobValidationErrors.d.ts' />
 ///<reference path='./Privacy/RedactionJobs.d.ts' />
+///<reference path='./ProductCatalog/TrialOffers.d.ts' />
 ///<reference path='./ProductFeatures.d.ts' />
 ///<reference path='./Products.d.ts' />
 ///<reference path='./PromotionCodes.d.ts' />
@@ -601,6 +603,9 @@ declare module 'stripe' {
     privacy: {
       redactionJobs: Stripe.Privacy.RedactionJobsResource;
     };
+    productCatalog: {
+      trialOffers: Stripe.ProductCatalog.TrialOffersResource;
+    };
     radar: {
       accountEvaluations: Stripe.Radar.AccountEvaluationsResource;
       earlyFraudWarnings: Stripe.Radar.EarlyFraudWarningsResource;