stripe 20.1.0.pre.alpha.1 → 20.1.0.pre.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d85e877767374dc3d8dc123a6b8230f1c224d607777f0482d94c67a8f73c0404
-  data.tar.gz: 0153a6e8aa6b824af826f32abfb49df296b0015a3042e18df90f248d32ff2682
+  metadata.gz: 46373e53926671934bb55ac696fde661e2c3a5a746237207e6192bcf7204fac7
+  data.tar.gz: 8122ca92668b2753bd9cfa0178e5dfe9227fe8b38f192cefc9b8958ffa818d45
 SHA512:
-  metadata.gz: ca243816421e74616e11960c1bd36c88af3822978b26df2a88b19c0431695df23f4b66e9de910b3569deac668250528a383486f622158e583294c718ea0b998e
-  data.tar.gz: 17710f432e71c83536b38e72a10bbbd0a1fda9abb622b4bd65f27c793f73ddbe6ffc149c6f4f6923b1479ba831c3482387ab42ff16b8848c026c16a8a2c796dc
+  metadata.gz: 00a6aed992407f9643b2b3b131d7ae913836de9855e29d2a11f4c636121903049f168efad19680cfba7d68a800679672c3c9a2d163999a520d7a50ad30f6d3a0
+  data.tar.gz: a5ee0238a58417d360dd388245dbc923fd73a4bc9c4a4a6bf9dc7757def057731b272b16421de9d1258a632e3a46424ac6e3aa714c53f1fa1a965473ba40bd65

data/lib/stripe/api_version.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2026-09-30.preview"
+    CURRENT = "2026-10-07.preview"
     CURRENT_MAJOR = ""
   end
 end

data/lib/stripe/event_types.rb

@@ -595,6 +595,16 @@ module Stripe
         Events::V2MoneyManagementInboundTransferBankDebitReturnedEvent,
         Events::V2MoneyManagementInboundTransferBankDebitSucceededEvent.lookup_type =>
         Events::V2MoneyManagementInboundTransferBankDebitSucceededEvent,
+        Events::V2MoneyManagementInboundTransferMandateActivatedEvent.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateActivatedEvent,
+        Events::V2MoneyManagementInboundTransferMandateCreatedEvent.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateCreatedEvent,
+        Events::V2MoneyManagementInboundTransferMandateExpiredEvent.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateExpiredEvent,
+        Events::V2MoneyManagementInboundTransferMandateRefusedEvent.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateRefusedEvent,
+        Events::V2MoneyManagementInboundTransferMandateRevokedEvent.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateRevokedEvent,
         Events::V2MoneyManagementOutboundPaymentCanceledEvent.lookup_type =>
         Events::V2MoneyManagementOutboundPaymentCanceledEvent,
         Events::V2MoneyManagementOutboundPaymentCreatedEvent.lookup_type =>
@@ -1485,6 +1495,16 @@ module Stripe
         Events::V2MoneyManagementInboundTransferBankDebitReturnedEventNotification,
         Events::V2MoneyManagementInboundTransferBankDebitSucceededEventNotification.lookup_type =>
         Events::V2MoneyManagementInboundTransferBankDebitSucceededEventNotification,
+        Events::V2MoneyManagementInboundTransferMandateActivatedEventNotification.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateActivatedEventNotification,
+        Events::V2MoneyManagementInboundTransferMandateCreatedEventNotification.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateCreatedEventNotification,
+        Events::V2MoneyManagementInboundTransferMandateExpiredEventNotification.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateExpiredEventNotification,
+        Events::V2MoneyManagementInboundTransferMandateRefusedEventNotification.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateRefusedEventNotification,
+        Events::V2MoneyManagementInboundTransferMandateRevokedEventNotification.lookup_type =>
+        Events::V2MoneyManagementInboundTransferMandateRevokedEventNotification,
         Events::V2MoneyManagementOutboundPaymentCanceledEventNotification.lookup_type =>
         Events::V2MoneyManagementOutboundPaymentCanceledEventNotification,
         Events::V2MoneyManagementOutboundPaymentCreatedEventNotification.lookup_type =>

data/lib/stripe/events/v1_invoice_upcoming_event.rb

@@ -8,6 +8,26 @@ module Stripe
       def self.lookup_type
         "v1.invoice.upcoming"
       end
+
+      class V1InvoiceUpcomingEventData < ::Stripe::StripeObject
+        # The ID of the customer this upcoming invoice is associated with.
+        attr_reader :customer
+        # The ID of the subscription, if any.
+        attr_reader :subscription
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { data: V1InvoiceUpcomingEventData }
+      end
+      attr_reader :data
     end
 
     # Occurs X number of days before a subscription is scheduled to create an invoice that is automatically charged&mdash;where X is determined by your [subscriptions settings](https://dashboard.stripe.com/account/billing/automatic). Note: The received `Invoice` object will not have an invoice ID.

data/lib/stripe/events/v2_money_management_inbound_transfer_mandate_activated_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when an InboundTransferMandate is activated by its banking network.
+    class V2MoneyManagementInboundTransferMandateActivatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.activated"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when an InboundTransferMandate is activated by its banking network.
+    class V2MoneyManagementInboundTransferMandateActivatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.activated"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the InboundTransferMandate related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_money_management_inbound_transfer_mandate_created_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when an InboundTransferMandate is created.
+    class V2MoneyManagementInboundTransferMandateCreatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.created"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when an InboundTransferMandate is created.
+    class V2MoneyManagementInboundTransferMandateCreatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.created"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the InboundTransferMandate related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_money_management_inbound_transfer_mandate_expired_event.rb

@@ -0,0 +1,46 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when an active InboundTransferMandate expires because its banking network did not
+    # complete it within the allowed window.
+    class V2MoneyManagementInboundTransferMandateExpiredEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.expired"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when an active InboundTransferMandate expires because its banking network did not
+    # complete it within the allowed window.
+    class V2MoneyManagementInboundTransferMandateExpiredEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.expired"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the InboundTransferMandate related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_money_management_inbound_transfer_mandate_refused_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a boarding request for an InboundTransferMandate is refused by its banking network.
+    class V2MoneyManagementInboundTransferMandateRefusedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.refused"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when a boarding request for an InboundTransferMandate is refused by its banking network.
+    class V2MoneyManagementInboundTransferMandateRefusedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.refused"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the InboundTransferMandate related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_money_management_inbound_transfer_mandate_revoked_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when an InboundTransferMandate is revoked by its banking network.
+    class V2MoneyManagementInboundTransferMandateRevokedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.revoked"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when an InboundTransferMandate is revoked by its banking network.
+    class V2MoneyManagementInboundTransferMandateRevokedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.money_management.inbound_transfer_mandate.revoked"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the InboundTransferMandate related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_payments_off_session_payment_requires_capture_event.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module Events
-    # Sent when the off-session payment becomes available for capture.
+    # Deprecated. Sent when the off-session payment becomes available for capture.
     class V2PaymentsOffSessionPaymentRequiresCaptureEvent < Stripe::V2::Core::Event
       def self.lookup_type
         "v2.payments.off_session_payment.requires_capture"
@@ -21,7 +21,7 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Sent when the off-session payment becomes available for capture.
+    # Deprecated. Sent when the off-session payment becomes available for capture.
     class V2PaymentsOffSessionPaymentRequiresCaptureEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
         "v2.payments.off_session_payment.requires_capture"

data/lib/stripe/object_types.rb

@@ -160,6 +160,7 @@ module Stripe
         Radar::EarlyFraudWarning.object_name => Radar::EarlyFraudWarning,
         Radar::IssuingAuthorizationEvaluation.object_name => Radar::IssuingAuthorizationEvaluation,
         Radar::PaymentEvaluation.object_name => Radar::PaymentEvaluation,
+        Radar::Rule.object_name => Radar::Rule,
         Radar::ValueList.object_name => Radar::ValueList,
         Radar::ValueListItem.object_name => Radar::ValueListItem,
         Refund.object_name => Refund,
@@ -313,7 +314,10 @@ module Stripe
         V2::MoneyManagement::FinancialAddressDebitSimulation,
         V2::MoneyManagement::FinancialAddressGeneratedMicrodeposits.object_name =>
         V2::MoneyManagement::FinancialAddressGeneratedMicrodeposits,
+        V2::MoneyManagement::FundingSession.object_name => V2::MoneyManagement::FundingSession,
         V2::MoneyManagement::InboundTransfer.object_name => V2::MoneyManagement::InboundTransfer,
+        V2::MoneyManagement::InboundTransferMandate.object_name =>
+        V2::MoneyManagement::InboundTransferMandate,
         V2::MoneyManagement::OutboundPayment.object_name => V2::MoneyManagement::OutboundPayment,
         V2::MoneyManagement::OutboundPaymentQuote.object_name => V2::MoneyManagement::OutboundPaymentQuote,
         V2::MoneyManagement::OutboundSetupIntent.object_name => V2::MoneyManagement::OutboundSetupIntent,

data/lib/stripe/params/account_update_params.rb

@@ -2265,12 +2265,19 @@ module Stripe
       end
 
       class Capital < ::Stripe::RequestParams
+        # The payout destinations excluded from Capital financing payouts.
+        attr_accessor :excluded_payout_destinations
         # Per-currency mapping of user-selected destination accounts used to pay out loans.
         attr_accessor :payout_destination
         # Per-currency mapping of all destination accounts eligible to receive Capital financing payouts.
         attr_accessor :payout_destination_selector
 
-        def initialize(payout_destination: nil, payout_destination_selector: nil)
+        def initialize(
+          excluded_payout_destinations: nil,
+          payout_destination: nil,
+          payout_destination_selector: nil
+        )
+          @excluded_payout_destinations = excluded_payout_destinations
           @payout_destination = payout_destination
           @payout_destination_selector = payout_destination_selector
         end

data/lib/stripe/params/charge_capture_params.rb

@@ -1760,7 +1760,7 @@ module Stripe
     attr_accessor :expand
     # Provides industry-specific information about the charge.
     attr_accessor :payment_details
-    # The email address to send this charge's receipt to. This will override the previously-specified email address for this charge, if one was set. Receipts will not be sent in test mode.
+    # The email address to send this charge's receipt to. This will override the previously-specified email address for this charge, if one was set. Receipts are only sent for payments in live mode.
     attr_accessor :receipt_email
     # For a non-card charge, text that appears on the customer's statement as the statement descriptor. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
     #

data/lib/stripe/params/charge_create_params.rb

@@ -113,7 +113,7 @@ module Stripe
     attr_accessor :on_behalf_of
     # Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information.
     attr_accessor :radar_options
-    # The email address to which this charge's [receipt](https://docs.stripe.com/dashboard/receipts) will be sent. The receipt will not be sent until the charge is paid, and no receipts will be sent for test mode charges. If this charge is for a [Customer](https://docs.stripe.com/api/customers/object), the email address specified here will override the customer's email address. If `receipt_email` is specified for a charge in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
+    # The email address to which this charge's [receipt](https://docs.stripe.com/dashboard/receipts) will be sent. The receipt will not be sent until the charge is paid, and receipts are only sent for payments in live mode. If this charge is for a [Customer](https://docs.stripe.com/api/customers/object), the email address specified here will override the customer's email address. If `receipt_email` is specified for a charge in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
     attr_accessor :receipt_email
     # Shipping information for the charge. Helps prevent fraud on charges for physical goods.
     attr_accessor :shipping

data/lib/stripe/params/checkout/session_create_params.rb

@@ -2112,7 +2112,7 @@ module Stripe
           end
           # Determines if the amount includes the IOF tax. Defaults to `never`.
           attr_accessor :amount_includes_iof
-          # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
+          # The number of seconds after PaymentIntent confirmation when the Pix expires (between 60 and 1209600, inclusive). If unspecified, defaults to 14400 seconds (4 hours).
           attr_accessor :expires_after_seconds
           # Additional fields for mandate creation.
           attr_accessor :mandate_options
@@ -2590,6 +2590,129 @@ module Stripe
         end
       end
 
+      class PaymentSettings < ::Stripe::RequestParams
+        class ApplicationFeeData < ::Stripe::RequestParams
+          # The amount of the application fee, in the currency's smallest unit, to apply to the initial payment and transfer to the application owner's Stripe account. The application fee is capped at the total amount captured.
+          attr_accessor :initial_amount
+          # A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of each payment total that will be transferred to the application owner's Stripe account.
+          attr_accessor :percentage_decimal
+
+          def initialize(initial_amount: nil, percentage_decimal: nil)
+            @initial_amount = initial_amount
+            @percentage_decimal = percentage_decimal
+          end
+
+          def self.field_encodings
+            @field_encodings = { percentage_decimal: :decimal_string }
+          end
+        end
+
+        class TransferData < ::Stripe::RequestParams
+          class TransferAmount < ::Stripe::RequestParams
+            # The amount, in the currency's smallest unit, that will be transferred to the destination account when the initial payment succeeds.
+            attr_accessor :initial_amount
+            # A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of each payment total that will be transferred to the destination account.
+            attr_accessor :percentage_decimal
+
+            def initialize(initial_amount: nil, percentage_decimal: nil)
+              @initial_amount = initial_amount
+              @percentage_decimal = percentage_decimal
+            end
+
+            def self.field_encodings
+              @field_encodings = { percentage_decimal: :decimal_string }
+            end
+          end
+          # If specified, successful charges will be attributed to the destination
+          # account for tax reporting, and the funds from charges will be transferred
+          # to the destination account. The ID of the resulting transfer will be
+          # returned on the successful charge's `transfer` field.
+          attr_accessor :destination
+          # Configures how much of each payment is transferred to the destination account. If omitted, the entire amount is transferred.
+          attr_accessor :transfer_amount
+
+          def initialize(destination: nil, transfer_amount: nil)
+            @destination = destination
+            @transfer_amount = transfer_amount
+          end
+
+          def self.field_encodings
+            @field_encodings = {
+              transfer_amount: { kind: :object, fields: { percentage_decimal: :decimal_string } },
+            }
+          end
+        end
+        # Configures an application fee transferred to the application owner's Stripe account.
+        attr_accessor :application_fee_data
+        # Controls when the funds will be captured from the customer's account.
+        attr_accessor :capture_method
+        # An arbitrary string attached to the object. Often useful for displaying to users.
+        attr_accessor :description
+        # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+        attr_accessor :metadata
+        # Indicates that you intend to [make future payments](https://docs.stripe.com/payments/payment-intents#future-usage) with the payment
+        # method collected by this Checkout Session.
+        #
+        # When setting this to `on_session`, Checkout will show a notice to the
+        # customer that their payment details will be saved.
+        #
+        # When setting this to `off_session`, Checkout will show a notice to the
+        # customer that their payment details will be saved and used for future
+        # payments.
+        #
+        # If a Customer has been provided or Checkout creates a new Customer,
+        # Checkout will attach the payment method to the Customer.
+        #
+        # If Checkout does not create a Customer, the payment method is not attached
+        # to a Customer. To reuse the payment method, you can retrieve it from the
+        # Checkout Session's PaymentIntent.
+        #
+        # When processing card payments, Checkout also uses `setup_future_usage`
+        # to dynamically optimize your payment flow and comply with regional
+        # legislation and network rules, such as SCA.
+        attr_accessor :setup_future_usage
+        # Text that appears on the customer's statement as the statement descriptor for a non-card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
+        #
+        # Setting this value for a card charge returns an error. For card charges, set the [statement_descriptor_suffix](https://docs.stripe.com/get-started/account/statement-descriptors#dynamic) instead.
+        attr_accessor :statement_descriptor
+        # Configures automatic transfers to a connected account when payments succeed.
+        attr_accessor :transfer_data
+        # A string that identifies the initial payment as part of a group.
+        attr_accessor :transfer_group
+
+        def initialize(
+          application_fee_data: nil,
+          capture_method: nil,
+          description: nil,
+          metadata: nil,
+          setup_future_usage: nil,
+          statement_descriptor: nil,
+          transfer_data: nil,
+          transfer_group: nil
+        )
+          @application_fee_data = application_fee_data
+          @capture_method = capture_method
+          @description = description
+          @metadata = metadata
+          @setup_future_usage = setup_future_usage
+          @statement_descriptor = statement_descriptor
+          @transfer_data = transfer_data
+          @transfer_group = transfer_group
+        end
+
+        def self.field_encodings
+          @field_encodings = {
+            application_fee_data: { kind: :object, fields: { percentage_decimal: :decimal_string } },
+            transfer_data: {
+              kind: :object,
+              fields: {
+                transfer_amount: { kind: :object, fields: { percentage_decimal: :decimal_string } },
+              },
+            },
+          }
+        end
+      end
+
       class Permissions < ::Stripe::RequestParams
         class Update < ::Stripe::RequestParams
           # Determines which entity is allowed to update the line items.
@@ -3029,7 +3152,7 @@ module Stripe
       #
       # Default is `auto`, when the customer's attempt to pay is approved automatically with no action required on your server.
       #
-      # When set to `manual`, you must approve the customer's attempt to pay by calling [approve](api/checkout/sessions/approve) from your server.
+      # When set to `manual`, you must approve the customer's attempt to pay by calling [approve](/api/checkout/sessions/approve) from your server.
       attr_accessor :approval_method
       # Settings for automatic surcharge calculation for this session.
       attr_accessor :automatic_surcharge
@@ -3154,6 +3277,8 @@ module Stripe
       attr_accessor :payment_method_data
       # Payment-method-specific configuration.
       attr_accessor :payment_method_options
+      # A subset of parameters to configure the payment for this Checkout Session.
+      attr_accessor :payment_settings
       # This property is used to set up permissions for various actions (for example, update) on the CheckoutSession object. Can only be set when creating `embedded_page` or `elements` sessions.
       #
       # For specific permissions, please refer to their dedicated subsections, such as `permissions.update_shipping_details`.
@@ -3243,6 +3368,7 @@ module Stripe
         payment_method_configuration: nil,
         payment_method_data: nil,
         payment_method_options: nil,
+        payment_settings: nil,
         permissions: nil,
         phone_number_collection: nil,
         redirect_on_completion: nil,
@@ -3301,6 +3427,7 @@ module Stripe
         @payment_method_configuration = payment_method_configuration
         @payment_method_data = payment_method_data
         @payment_method_options = payment_method_options
+        @payment_settings = payment_settings
         @permissions = permissions
         @phone_number_collection = phone_number_collection
         @redirect_on_completion = redirect_on_completion
@@ -3352,6 +3479,18 @@ module Stripe
               fields: { price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } } },
             },
           },
+          payment_settings: {
+            kind: :object,
+            fields: {
+              application_fee_data: { kind: :object, fields: { percentage_decimal: :decimal_string } },
+              transfer_data: {
+                kind: :object,
+                fields: {
+                  transfer_amount: { kind: :object, fields: { percentage_decimal: :decimal_string } },
+                },
+              },
+            },
+          },
         }
       end
     end

data/lib/stripe/params/checkout/session_update_params.rb

@@ -314,6 +314,7 @@ module Stripe
         #
         # When processing card payments, Checkout also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as SCA.
         #
+        # You must wrap any Checkout Session update that mutates `setup_future_usage` in [`runServerUpdate`](/js/custom_checkout/run_server_update) and await it before continuing with the payment.
         # Pass an empty string to remove a previously supplied configuration.
         attr_accessor :setup_future_usage
         # Text that appears on the customer's statement as the statement descriptor for a non-card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).

data/lib/stripe/params/invoice_create_params.rb

@@ -346,7 +346,7 @@ module Stripe
         class Pix < ::Stripe::RequestParams
           # Determines if the amount includes the IOF tax. Defaults to `never`.
           attr_accessor :amount_includes_iof
-          # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
+          # The number of seconds after PaymentIntent confirmation when the Pix expires (between 60 and 1209600, inclusive). If unspecified, defaults to 14400 seconds (4 hours).
           attr_accessor :expires_after_seconds
 
           def initialize(amount_includes_iof: nil, expires_after_seconds: nil)

data/lib/stripe/params/invoice_update_params.rb

@@ -325,7 +325,7 @@ module Stripe
         class Pix < ::Stripe::RequestParams
           # Determines if the amount includes the IOF tax. Defaults to `never`.
           attr_accessor :amount_includes_iof
-          # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
+          # The number of seconds after PaymentIntent confirmation when the Pix expires (between 60 and 1209600, inclusive). If unspecified, defaults to 14400 seconds (4 hours).
           attr_accessor :expires_after_seconds
 
           def initialize(amount_includes_iof: nil, expires_after_seconds: nil)

data/lib/stripe/params/payment_attempt_record_report_failed_params.rb

@@ -29,14 +29,26 @@ module Stripe
           @network_decline_code = network_decline_code
         end
       end
+
+      class UsBankAccount < ::Stripe::RequestParams
+        # NACHA ACH return code for a failed US bank account payment.
+        attr_accessor :return_code
+
+        def initialize(return_code: nil)
+          @return_code = return_code
+        end
+      end
       # Information about the card payment method used to make this payment.
       attr_accessor :card
       # The type of the payment method details. An additional hash is included on the payment_method_details with a name matching this value. It contains additional information specific to the type.
       attr_accessor :type
+      # Details about the US bank account payment method.
+      attr_accessor :us_bank_account
 
-      def initialize(card: nil, type: nil)
+      def initialize(card: nil, type: nil, us_bank_account: nil)
         @card = card
         @type = type
+        @us_bank_account = us_bank_account
       end
     end