stripe 18.1.0.pre.alpha.2 → 18.1.0.pre.alpha.4

data/rbi/stripe.rbi

@@ -3053,6 +3053,28 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class CheckScanning < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Whether the embedded component is enabled.
+        sig { returns(T::Boolean) }
+        def enabled; end
+        # Attribute for field features
+        sig { returns(Features) }
+        def features; end
+        def self.inner_class_types
+          @inner_class_types = {features: Features}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class DisputesList < ::Stripe::StripeObject
         class Features < ::Stripe::StripeObject
           # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -3588,6 +3610,9 @@ module Stripe
       # Attribute for field tax_settings
       sig { returns(TaxSettings) }
       def tax_settings; end
+      # Configuration for the [check scanning](/connect/supported-embedded-components/check-scanning/) embedded component.
+      sig { returns(T.nilable(CheckScanning)) }
+      def check_scanning; end
       def self.inner_class_types
         @inner_class_types = {
           account_management: AccountManagement,
@@ -3612,6 +3637,7 @@ module Stripe
           payouts_list: PayoutsList,
           tax_registrations: TaxRegistrations,
           tax_settings: TaxSettings,
+          check_scanning: CheckScanning,
         }
       end
       def self.field_remappings
@@ -5556,7 +5582,7 @@ module Stripe
       end
     end
     class SelfReportedIncome < ::Stripe::StripeObject
-      # Amount in the minor currency unit (e.g., cents for USD)
+      # The amount in the minor currency unit (for example, cents for USD).
       sig { returns(Integer) }
       def amount; end
       # 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).
@@ -5570,7 +5596,7 @@ module Stripe
       end
     end
     class SelfReportedMonthlyHousingPayment < ::Stripe::StripeObject
-      # Amount in the minor currency unit (e.g., cents for USD)
+      # The amount in the minor currency unit (for example, cents for USD).
       sig { returns(Integer) }
       def amount; end
       # 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).
@@ -17954,7 +17980,7 @@ module Stripe
           # ZIP or postal code.
           sig { returns(T.nilable(String)) }
           def postal_code; end
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           sig { returns(T.nilable(String)) }
           def state; end
           def self.inner_class_types
@@ -18097,18 +18123,6 @@ module Stripe
         # The total before any discounts or taxes are applied.
         sig { returns(Integer) }
         def amount_subtotal; end
-        # The total after discounts but before taxes are applied.
-        sig { returns(Integer) }
-        def amount_subtotal_after_discount; end
-        # The total after discounts and taxes.
-        sig { returns(Integer) }
-        def amount_total; end
-        # The per-unit amount of the item after discounts but before taxes are applied.
-        sig { returns(Integer) }
-        def unit_amount_after_discount; end
-        # The per-unit discount amount. If no discount were applied, defaults to 0.
-        sig { returns(Integer) }
-        def unit_discount; end
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -18148,7 +18162,7 @@ module Stripe
             # ZIP or postal code.
             sig { returns(String) }
             def postal_code; end
-            # State, county, province, or region.
+            # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
             sig { returns(String) }
             def state; end
             def self.inner_class_types
@@ -18236,18 +18250,18 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The amount discount of the total details.
-        sig { returns(T.nilable(Integer)) }
-        def amount_discount; end
         # The amount fulfillment of the total details.
         sig { returns(T.nilable(Integer)) }
         def amount_fulfillment; end
         # The amount tax of the total details.
         sig { returns(T.nilable(Integer)) }
         def amount_tax; end
-        # 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.
+        sig { returns(T.nilable(Integer)) }
+        def amount_cart_discount; end
+        # 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.
         sig { returns(T.nilable(Integer)) }
-        def amount_subtotal_after_discount; end
+        def amount_items_discount; end
         # The applicable fees of the total details.
         sig { returns(T.nilable(T::Array[ApplicableFee])) }
         def applicable_fees; end
@@ -33347,6 +33361,17 @@ module Stripe
         @field_remappings = {}
       end
     end
+    class PaymentsOrchestration < ::Stripe::StripeObject
+      # Whether this feature is enabled.
+      sig { returns(T::Boolean) }
+      def enabled; end
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
     # Allocated Funds configuration for this PaymentIntent.
     sig { returns(T.nilable(AllocatedFunds)) }
     def allocated_funds; end
@@ -33510,6 +33535,9 @@ module Stripe
     # A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers).
     sig { returns(T.nilable(String)) }
     def transfer_group; end
+    # When you enable this parameter, this PaymentIntent will route your payment to processors that you configure in the dashboard.
+    sig { returns(T.nilable(PaymentsOrchestration)) }
+    def payments_orchestration; end
     # Manually reconcile the remaining amount for a customer_balance PaymentIntent.
     sig {
       params(params: T.any(::Stripe::PaymentIntentApplyCustomerBalanceParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::PaymentIntent)
@@ -41885,6 +41913,88 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  module 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.
+    class TrialOffer < APIResource
+      class Duration < ::Stripe::StripeObject
+        class Relative < ::Stripe::StripeObject
+          # The number of iterations of the price's interval for this trial offer.
+          sig { returns(Integer) }
+          def iterations; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field relative
+        sig { returns(Relative) }
+        def relative; end
+        # The type of trial offer duration.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {relative: Relative}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      class EndBehavior < ::Stripe::StripeObject
+        class Transition < ::Stripe::StripeObject
+          # The new price to use at the end of the trial offer period.
+          sig { returns(String) }
+          def price; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field transition
+        sig { returns(Transition) }
+        def transition; end
+        # The type of behavior when the trial offer ends.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {transition: Transition}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field duration
+      sig { returns(Duration) }
+      def duration; end
+      # Attribute for field end_behavior
+      sig { returns(EndBehavior) }
+      def end_behavior; end
+      # Unique identifier for the object.
+      sig { returns(String) }
+      def id; end
+      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      sig { returns(T::Boolean) }
+      def livemode; end
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      def object; end
+      # The price during the trial offer.
+      sig { returns(T.any(String, ::Stripe::Price)) }
+      def price; end
+      # Creates a trial offer.
+      sig {
+        params(params: T.any(::Stripe::ProductCatalog::TrialOfferCreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::ProductCatalog::TrialOffer)
+       }
+      def self.create(params = {}, opts = {}); end
+    end
+  end
+end
+# typed: true
 module Stripe
   # Products describe the specific goods or services you offer to your customers.
   # For example, you might offer a Standard and Premium version of your goods or service; each version would be a separate Product.
@@ -68938,6 +69048,57 @@ module Stripe
       class Event < APIResource
         class Reason < ::Stripe::StripeObject
           class Request < ::Stripe::StripeObject
+            class Client < ::Stripe::StripeObject
+              class ApiKey < ::Stripe::StripeObject
+                # The ID of the API key.
+                sig { returns(String) }
+                def id; end
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+              class DashboardUser < ::Stripe::StripeObject
+                # The email of the dashboard user.
+                sig { returns(String) }
+                def email; end
+                # The IP address of the user.
+                sig { returns(String) }
+                def ip_address; end
+                # The machine identifier of the user.
+                sig { returns(String) }
+                def machine_identifier; end
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+              # The type of the client.
+              sig { returns(String) }
+              def type; end
+              # API key that triggered the event.
+              sig { returns(T.nilable(ApiKey)) }
+              def api_key; end
+              # Dashboard user that triggered the event.
+              sig { returns(T.nilable(DashboardUser)) }
+              def dashboard_user; end
+              # Stripe action that triggered the event.
+              sig { returns(T.nilable(T::Hash[String, T.untyped])) }
+              def stripe_action; end
+              def self.inner_class_types
+                @inner_class_types = {api_key: ApiKey, dashboard_user: DashboardUser}
+              end
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The client details that made the request.
+            sig { returns(T.nilable(Client)) }
+            def client; end
             # ID of the API request that caused the event.
             sig { returns(String) }
             def id; end
@@ -68945,7 +69106,7 @@ module Stripe
             sig { returns(String) }
             def idempotency_key; end
             def self.inner_class_types
-              @inner_class_types = {}
+              @inner_class_types = {client: Client}
             end
             def self.field_remappings
               @field_remappings = {}
@@ -70992,6 +71153,17 @@ module Stripe
             @field_remappings = {}
           end
         end
+        class StripeBalancePayment < ::Stripe::StripeObject
+          # Statement descriptor for the Stripe Balance Payment.
+          sig { returns(T.nilable(String)) }
+          def statement_descriptor; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # The amount and currency of the ReceivedCredit.
         sig { returns(Amount) }
         def amount; end
@@ -71038,6 +71210,9 @@ module Stripe
         # This object stores details about the originating banking transaction that resulted in the ReceivedCredit. Present if `type` field value is `bank_transfer`.
         sig { returns(T.nilable(BankTransfer)) }
         def bank_transfer; end
+        # This object stores details about the stripe balance pay refund that resulted in the ReceivedCredit. Present if `type` field value is `stripe_balance_payment`.
+        sig { returns(T.nilable(StripeBalancePayment)) }
+        def stripe_balance_payment; end
       end
     end
   end
@@ -71119,6 +71294,20 @@ module Stripe
             @field_remappings = {}
           end
         end
+        class BalanceTransfer < ::Stripe::StripeObject
+          # Open Enum. The type of balance transfer that originated the ReceivedDebit.
+          sig { returns(String) }
+          def type; end
+          # The ID of the topup object that originated the ReceivedDebit.
+          sig { returns(T.nilable(String)) }
+          def topup; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         class BankTransfer < ::Stripe::StripeObject
           class UsBankAccount < ::Stripe::StripeObject
             # The name of the bank the debit originated from.
@@ -71159,6 +71348,20 @@ module Stripe
             @field_remappings = {}
           end
         end
+        class StripeBalancePayment < ::Stripe::StripeObject
+          # ID of the debit agreement associated with this payment.
+          sig { returns(T.nilable(String)) }
+          def debit_agreement; end
+          # Statement descriptor for the Stripe Balance Payment.
+          sig { returns(T.nilable(String)) }
+          def statement_descriptor; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # Amount and currency of the ReceivedDebit.
         sig { returns(Amount) }
         def amount; end
@@ -71193,15 +71396,21 @@ module Stripe
         # The time at which the ReceivedDebit transitioned to a particular status.
         sig { returns(T.nilable(StatusTransitions)) }
         def status_transitions; end
-        # Open Enum. The type of the ReceivedDebit.
+        # Open enum, the type of the received debit.
         sig { returns(String) }
         def type; end
         # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
         sig { returns(T::Boolean) }
         def livemode; end
+        # This object stores details about the balance transfer object that resulted in the ReceivedDebit.
+        sig { returns(T.nilable(BalanceTransfer)) }
+        def balance_transfer; end
         # This object stores details about the originating banking transaction that resulted in the ReceivedDebit. Present if `type` field value is `bank_transfer`.
         sig { returns(T.nilable(BankTransfer)) }
         def bank_transfer; end
+        # This object stores details about the Stripe Balance Payment that resulted in the ReceivedDebit.
+        sig { returns(T.nilable(StripeBalancePayment)) }
+        def stripe_balance_payment; end
       end
     end
   end
@@ -72070,6 +72279,7 @@ module Stripe
     attr_reader :prices
     attr_reader :privacy
     attr_reader :products
+    attr_reader :product_catalog
     attr_reader :promotion_codes
     attr_reader :quotes
     attr_reader :radar
@@ -75388,6 +75598,24 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  class ProductCatalogService < StripeService
+    attr_reader :trial_offers
+  end
+end
+# typed: true
+module Stripe
+  module ProductCatalog
+    class TrialOfferService < StripeService
+      # Creates a trial offer.
+      sig {
+        params(params: T.any(::Stripe::ProductCatalog::TrialOfferCreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::ProductCatalog::TrialOffer)
+       }
+      def create(params = {}, opts = {}); end
+    end
+  end
+end
+# typed: true
 module Stripe
   class PromotionCodeService < StripeService
     # A promotion code points to an underlying promotion. You can optionally restrict the code to a specific customer, redemption limit, and expiration date.
@@ -83232,12 +83460,12 @@ module Stripe
         ); end
       end
       class SelfReportedIncome < ::Stripe::RequestParams
-        # Attribute for param field amount
+        # The amount in the minor currency unit (for example, cents for USD).
         sig { returns(Integer) }
         def amount; end
         sig { params(_amount: Integer).returns(Integer) }
         def amount=(_amount); end
-        # Attribute for param field currency
+        # 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).
         sig { returns(String) }
         def currency; end
         sig { params(_currency: String).returns(String) }
@@ -83246,12 +83474,12 @@ module Stripe
         def initialize(amount: nil, currency: nil); end
       end
       class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
-        # Attribute for param field amount
+        # The amount in the minor currency unit (for example, cents for USD).
         sig { returns(Integer) }
         def amount; end
         sig { params(_amount: Integer).returns(Integer) }
         def amount=(_amount); end
-        # Attribute for param field currency
+        # 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).
         sig { returns(String) }
         def currency; end
         sig { params(_currency: String).returns(String) }
@@ -86733,12 +86961,12 @@ module Stripe
         ); end
       end
       class SelfReportedIncome < ::Stripe::RequestParams
-        # Attribute for param field amount
+        # The amount in the minor currency unit (for example, cents for USD).
         sig { returns(Integer) }
         def amount; end
         sig { params(_amount: Integer).returns(Integer) }
         def amount=(_amount); end
-        # Attribute for param field currency
+        # 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).
         sig { returns(String) }
         def currency; end
         sig { params(_currency: String).returns(String) }
@@ -86747,12 +86975,12 @@ module Stripe
         def initialize(amount: nil, currency: nil); end
       end
       class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
-        # Attribute for param field amount
+        # The amount in the minor currency unit (for example, cents for USD).
         sig { returns(Integer) }
         def amount; end
         sig { params(_amount: Integer).returns(Integer) }
         def amount=(_amount); end
-        # Attribute for param field currency
+        # 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).
         sig { returns(String) }
         def currency; end
         sig { params(_currency: String).returns(String) }
@@ -105104,7 +105332,7 @@ module Stripe
           def postal_code; end
           sig { params(_postal_code: String).returns(String) }
           def postal_code=(_postal_code); end
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           sig { returns(String) }
           def state; end
           sig { params(_state: String).returns(String) }
@@ -105236,7 +105464,7 @@ module Stripe
             def postal_code; end
             sig { params(_postal_code: String).returns(String) }
             def postal_code=(_postal_code); end
-            # State, county, province, or region.
+            # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
             sig { returns(String) }
             def state; end
             sig { params(_state: String).returns(String) }
@@ -105431,7 +105659,7 @@ module Stripe
           def postal_code; end
           sig { params(_postal_code: String).returns(String) }
           def postal_code=(_postal_code); end
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           sig { returns(String) }
           def state; end
           sig { params(_state: String).returns(String) }
@@ -105519,7 +105747,7 @@ module Stripe
             def postal_code; end
             sig { params(_postal_code: String).returns(String) }
             def postal_code=(_postal_code); end
-            # State, county, province, or region.
+            # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
             sig { returns(String) }
             def state; end
             sig { params(_state: String).returns(String) }
@@ -137383,6 +137611,15 @@ module Stripe
         zip: nil
       ); end
     end
+    class PaymentsOrchestration < ::Stripe::RequestParams
+      # Whether this feature is enabled.
+      sig { returns(T::Boolean) }
+      def enabled; end
+      sig { params(_enabled: T::Boolean).returns(T::Boolean) }
+      def enabled=(_enabled); end
+      sig { params(enabled: T::Boolean).void }
+      def initialize(enabled: nil); end
+    end
     class RadarOptions < ::Stripe::RequestParams
       # 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.
       sig { returns(T.nilable(String)) }
@@ -137746,8 +137983,15 @@ module Stripe
     def use_stripe_sdk; end
     sig { params(_use_stripe_sdk: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
     def use_stripe_sdk=(_use_stripe_sdk); end
+    # When you enable this parameter, this PaymentIntent will route your payment to processors that you configure in the dashboard.
+    sig { returns(T.nilable(PaymentIntentCreateParams::PaymentsOrchestration)) }
+    def payments_orchestration; end
     sig {
-      params(allocated_funds: T.nilable(PaymentIntentCreateParams::AllocatedFunds), amount: Integer, amount_details: T.nilable(PaymentIntentCreateParams::AmountDetails), application_fee_amount: T.nilable(Integer), automatic_payment_methods: T.nilable(PaymentIntentCreateParams::AutomaticPaymentMethods), capture_method: T.nilable(String), confirm: T.nilable(T::Boolean), confirmation_method: T.nilable(String), confirmation_token: T.nilable(String), currency: String, customer: T.nilable(String), customer_account: T.nilable(String), description: T.nilable(String), error_on_requires_action: T.nilable(T::Boolean), excluded_payment_method_types: T.nilable(T::Array[String]), expand: T.nilable(T::Array[String]), fx_quote: T.nilable(String), hooks: T.nilable(PaymentIntentCreateParams::Hooks), mandate: T.nilable(String), mandate_data: T.nilable(T.any(String, PaymentIntentCreateParams::MandateData)), metadata: T.nilable(T::Hash[String, String]), off_session: T.nilable(T.any(T::Boolean, String)), on_behalf_of: T.nilable(String), payment_details: T.nilable(PaymentIntentCreateParams::PaymentDetails), payment_method: T.nilable(String), payment_method_configuration: T.nilable(String), payment_method_data: T.nilable(PaymentIntentCreateParams::PaymentMethodData), payment_method_options: T.nilable(PaymentIntentCreateParams::PaymentMethodOptions), payment_method_types: T.nilable(T::Array[String]), radar_options: T.nilable(PaymentIntentCreateParams::RadarOptions), receipt_email: T.nilable(String), return_url: T.nilable(String), secret_key_confirmation: T.nilable(String), setup_future_usage: T.nilable(String), shipping: T.nilable(PaymentIntentCreateParams::Shipping), statement_descriptor: T.nilable(String), statement_descriptor_suffix: T.nilable(String), transfer_data: T.nilable(PaymentIntentCreateParams::TransferData), transfer_group: T.nilable(String), use_stripe_sdk: T.nilable(T::Boolean)).void
+      params(_payments_orchestration: T.nilable(PaymentIntentCreateParams::PaymentsOrchestration)).returns(T.nilable(PaymentIntentCreateParams::PaymentsOrchestration))
+     }
+    def payments_orchestration=(_payments_orchestration); end
+    sig {
+      params(allocated_funds: T.nilable(PaymentIntentCreateParams::AllocatedFunds), amount: Integer, amount_details: T.nilable(PaymentIntentCreateParams::AmountDetails), application_fee_amount: T.nilable(Integer), automatic_payment_methods: T.nilable(PaymentIntentCreateParams::AutomaticPaymentMethods), capture_method: T.nilable(String), confirm: T.nilable(T::Boolean), confirmation_method: T.nilable(String), confirmation_token: T.nilable(String), currency: String, customer: T.nilable(String), customer_account: T.nilable(String), description: T.nilable(String), error_on_requires_action: T.nilable(T::Boolean), excluded_payment_method_types: T.nilable(T::Array[String]), expand: T.nilable(T::Array[String]), fx_quote: T.nilable(String), hooks: T.nilable(PaymentIntentCreateParams::Hooks), mandate: T.nilable(String), mandate_data: T.nilable(T.any(String, PaymentIntentCreateParams::MandateData)), metadata: T.nilable(T::Hash[String, String]), off_session: T.nilable(T.any(T::Boolean, String)), on_behalf_of: T.nilable(String), payment_details: T.nilable(PaymentIntentCreateParams::PaymentDetails), payment_method: T.nilable(String), payment_method_configuration: T.nilable(String), payment_method_data: T.nilable(PaymentIntentCreateParams::PaymentMethodData), payment_method_options: T.nilable(PaymentIntentCreateParams::PaymentMethodOptions), payment_method_types: T.nilable(T::Array[String]), radar_options: T.nilable(PaymentIntentCreateParams::RadarOptions), receipt_email: T.nilable(String), return_url: T.nilable(String), secret_key_confirmation: T.nilable(String), setup_future_usage: T.nilable(String), shipping: T.nilable(PaymentIntentCreateParams::Shipping), statement_descriptor: T.nilable(String), statement_descriptor_suffix: T.nilable(String), transfer_data: T.nilable(PaymentIntentCreateParams::TransferData), transfer_group: T.nilable(String), use_stripe_sdk: T.nilable(T::Boolean), payments_orchestration: T.nilable(PaymentIntentCreateParams::PaymentsOrchestration)).void
      }
     def initialize(
       allocated_funds: nil,
@@ -137789,7 +138033,8 @@ module Stripe
       statement_descriptor_suffix: nil,
       transfer_data: nil,
       transfer_group: nil,
-      use_stripe_sdk: nil
+      use_stripe_sdk: nil,
+      payments_orchestration: nil
     ); end
   end
 end
@@ -168642,6 +168887,90 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  module ProductCatalog
+    class TrialOfferCreateParams < ::Stripe::RequestParams
+      class Duration < ::Stripe::RequestParams
+        class Relative < ::Stripe::RequestParams
+          # The number of recurring price's interval to apply for the trial period.
+          sig { returns(Integer) }
+          def iterations; end
+          sig { params(_iterations: Integer).returns(Integer) }
+          def iterations=(_iterations); end
+          sig { params(iterations: Integer).void }
+          def initialize(iterations: nil); end
+        end
+        # The relative duration of the trial period computed as the number of recurring price intervals.
+        sig { returns(T.nilable(ProductCatalog::TrialOfferCreateParams::Duration::Relative)) }
+        def relative; end
+        sig {
+          params(_relative: T.nilable(ProductCatalog::TrialOfferCreateParams::Duration::Relative)).returns(T.nilable(ProductCatalog::TrialOfferCreateParams::Duration::Relative))
+         }
+        def relative=(_relative); end
+        # Specifies how the trial offer duration is determined.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig {
+          params(relative: T.nilable(ProductCatalog::TrialOfferCreateParams::Duration::Relative), type: String).void
+         }
+        def initialize(relative: nil, type: nil); end
+      end
+      class EndBehavior < ::Stripe::RequestParams
+        class Transition < ::Stripe::RequestParams
+          # The price to transition the recurring item to when the trial offer ends.
+          sig { returns(String) }
+          def price; end
+          sig { params(_price: String).returns(String) }
+          def price=(_price); end
+          sig { params(price: String).void }
+          def initialize(price: nil); end
+        end
+        # The transition to apply when the trial offer ends.
+        sig { returns(ProductCatalog::TrialOfferCreateParams::EndBehavior::Transition) }
+        def transition; end
+        sig {
+          params(_transition: ProductCatalog::TrialOfferCreateParams::EndBehavior::Transition).returns(ProductCatalog::TrialOfferCreateParams::EndBehavior::Transition)
+         }
+        def transition=(_transition); end
+        sig {
+          params(transition: ProductCatalog::TrialOfferCreateParams::EndBehavior::Transition).void
+         }
+        def initialize(transition: nil); end
+      end
+      # Duration of one service period of the trial.
+      sig { returns(ProductCatalog::TrialOfferCreateParams::Duration) }
+      def duration; end
+      sig {
+        params(_duration: ProductCatalog::TrialOfferCreateParams::Duration).returns(ProductCatalog::TrialOfferCreateParams::Duration)
+       }
+      def duration=(_duration); end
+      # Define behavior that occurs at the end of the trial.
+      sig { returns(ProductCatalog::TrialOfferCreateParams::EndBehavior) }
+      def end_behavior; end
+      sig {
+        params(_end_behavior: ProductCatalog::TrialOfferCreateParams::EndBehavior).returns(ProductCatalog::TrialOfferCreateParams::EndBehavior)
+       }
+      def end_behavior=(_end_behavior); end
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T.nilable(T::Array[String])) }
+      def expand; end
+      sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+      def expand=(_expand); end
+      # Price configuration during the trial period (amount, billing scheme, etc).
+      sig { returns(String) }
+      def price; end
+      sig { params(_price: String).returns(String) }
+      def price=(_price); end
+      sig {
+        params(duration: ProductCatalog::TrialOfferCreateParams::Duration, end_behavior: ProductCatalog::TrialOfferCreateParams::EndBehavior, expand: T.nilable(T::Array[String]), price: String).void
+       }
+      def initialize(duration: nil, end_behavior: nil, expand: nil, price: nil); end
+    end
+  end
+end
+# typed: true
 module Stripe
   class ProductDeleteParams < ::Stripe::RequestParams; end
 end
@@ -198213,12 +198542,12 @@ module Stripe
           ); end
         end
         class SelfReportedIncome < ::Stripe::RequestParams
-          # Attribute for param field amount
+          # The amount in the minor currency unit (for example, cents for USD).
           sig { returns(Integer) }
           def amount; end
           sig { params(_amount: Integer).returns(Integer) }
           def amount=(_amount); end
-          # Attribute for param field currency
+          # 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).
           sig { returns(String) }
           def currency; end
           sig { params(_currency: String).returns(String) }
@@ -198227,12 +198556,12 @@ module Stripe
           def initialize(amount: nil, currency: nil); end
         end
         class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
-          # Attribute for param field amount
+          # The amount in the minor currency unit (for example, cents for USD).
           sig { returns(Integer) }
           def amount; end
           sig { params(_amount: Integer).returns(Integer) }
           def amount=(_amount); end
-          # Attribute for param field currency
+          # 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).
           sig { returns(String) }
           def currency; end
           sig { params(_currency: String).returns(String) }
@@ -199014,12 +199343,12 @@ module Stripe
         ); end
       end
       class SelfReportedIncome < ::Stripe::RequestParams
-        # Attribute for param field amount
+        # The amount in the minor currency unit (for example, cents for USD).
         sig { returns(Integer) }
         def amount; end
         sig { params(_amount: Integer).returns(Integer) }
         def amount=(_amount); end
-        # Attribute for param field currency
+        # 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).
         sig { returns(String) }
         def currency; end
         sig { params(_currency: String).returns(String) }
@@ -199028,12 +199357,12 @@ module Stripe
         def initialize(amount: nil, currency: nil); end
       end
       class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
-        # Attribute for param field amount
+        # The amount in the minor currency unit (for example, cents for USD).
         sig { returns(Integer) }
         def amount; end
         sig { params(_amount: Integer).returns(Integer) }
         def amount=(_amount); end
-        # Attribute for param field currency
+        # 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).
         sig { returns(String) }
         def currency; end
         sig { params(_currency: String).returns(String) }
@@ -203708,12 +204037,12 @@ module Stripe
       ); end
     end
     class SelfReportedIncome < ::Stripe::RequestParams
-      # Attribute for param field amount
+      # The amount in the minor currency unit (for example, cents for USD).
       sig { returns(Integer) }
       def amount; end
       sig { params(_amount: Integer).returns(Integer) }
       def amount=(_amount); end
-      # Attribute for param field currency
+      # 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).
       sig { returns(String) }
       def currency; end
       sig { params(_currency: String).returns(String) }
@@ -203722,12 +204051,12 @@ module Stripe
       def initialize(amount: nil, currency: nil); end
     end
     class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
-      # Attribute for param field amount
+      # The amount in the minor currency unit (for example, cents for USD).
       sig { returns(Integer) }
       def amount; end
       sig { params(_amount: Integer).returns(Integer) }
       def amount=(_amount); end
-      # Attribute for param field currency
+      # 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).
       sig { returns(String) }
       def currency; end
       sig { params(_currency: String).returns(String) }
@@ -204496,12 +204825,12 @@ module Stripe
       ); end
     end
     class SelfReportedIncome < ::Stripe::RequestParams
-      # Attribute for param field amount
+      # The amount in the minor currency unit (for example, cents for USD).
       sig { returns(Integer) }
       def amount; end
       sig { params(_amount: Integer).returns(Integer) }
       def amount=(_amount); end
-      # Attribute for param field currency
+      # 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).
       sig { returns(String) }
       def currency; end
       sig { params(_currency: String).returns(String) }
@@ -204510,12 +204839,12 @@ module Stripe
       def initialize(amount: nil, currency: nil); end
     end
     class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
-      # Attribute for param field amount
+      # The amount in the minor currency unit (for example, cents for USD).
       sig { returns(Integer) }
       def amount; end
       sig { params(_amount: Integer).returns(Integer) }
       def amount=(_amount); end
-      # Attribute for param field currency
+      # 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).
       sig { returns(String) }
       def currency; end
       sig { params(_currency: String).returns(String) }
@@ -232779,6 +233108,11 @@ module Stripe
           params(_created: T.nilable(V2::Core::EventListParams::Created)).returns(T.nilable(V2::Core::EventListParams::Created))
          }
         def created=(_created); end
+        # Additional fields to include in the response.
+        sig { returns(T.nilable(T::Array[String])) }
+        def include; end
+        sig { params(_include: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+        def include=(_include); end
         # The page size.
         sig { returns(T.nilable(Integer)) }
         def limit; end
@@ -232797,9 +233131,9 @@ module Stripe
         sig { params(_types: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
         def types=(_types); end
         sig {
-          params(created: T.nilable(V2::Core::EventListParams::Created), limit: T.nilable(Integer), object_id_: T.nilable(String), types: T.nilable(T::Array[String])).void
+          params(created: T.nilable(V2::Core::EventListParams::Created), include: T.nilable(T::Array[String]), limit: T.nilable(Integer), object_id_: T.nilable(String), types: T.nilable(T::Array[String])).void
          }
-        def initialize(created: nil, limit: nil, object_id_: nil, types: nil); end
+        def initialize(created: nil, include: nil, limit: nil, object_id_: nil, types: nil); end
       end
     end
   end
@@ -232808,7 +233142,15 @@ end
 module Stripe
   module V2
     module Core
-      class EventRetrieveParams < ::Stripe::RequestParams; end
+      class EventRetrieveParams < ::Stripe::RequestParams
+        # Additional fields to include in the response.
+        sig { returns(T.nilable(T::Array[String])) }
+        def include; end
+        sig { params(_include: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+        def include=(_include); end
+        sig { params(include: T.nilable(T::Array[String])).void }
+        def initialize(include: nil); end
+      end
     end
   end
 end