[pull] master from stripe:master

API_VERSION

@@ -1 +1 @@
-2025-07-30.basil
+2025-08-27.basil

OPENAPI_VERSION

@@ -1 +1 @@
-v1868
+v1932

lib/stripe/api_version.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-07-30.basil"
+    CURRENT = "2025-08-27.basil"
     CURRENT_MAJOR = "basil"
   end
 end

lib/stripe/resources/account.rb

@@ -291,13 +291,13 @@ class RegistrationDate < Stripe::StripeObject
 
       class Verification < Stripe::StripeObject
         class Document < Stripe::StripeObject
-          # The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`.
+          # The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](/file-upload#uploading-a-file).
           attr_reader :back
           # A user-displayable string describing the verification state of this document.
           attr_reader :details
           # One of `document_corrupt`, `document_expired`, `document_failed_copy`, `document_failed_greyscale`, `document_failed_other`, `document_failed_test_mode`, `document_fraudulent`, `document_incomplete`, `document_invalid`, `document_manipulated`, `document_not_readable`, `document_not_uploaded`, `document_type_not_supported`, or `document_too_large`. A machine-readable code specifying the verification state for this document.
           attr_reader :details_code
-          # The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`.
+          # The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](/file-upload#uploading-a-file).
           attr_reader :front
         end
         # Attribute for field document

lib/stripe/resources/account_session.rb

@@ -44,6 +44,14 @@ class Features < Stripe::StripeObject
         attr_reader :features
       end
 
+      class BalanceReport < Stripe::StripeObject
+        class Features < Stripe::StripeObject; end
+        # Whether the embedded component is enabled.
+        attr_reader :enabled
+        # Attribute for field features
+        attr_reader :features
+      end
+
       class Balances < Stripe::StripeObject
         class Features < Stripe::StripeObject
           # Whether Stripe user authentication is disabled. This value can only be `true` for accounts where `controller.requirement_collection` is `application` for the account. The default value is the opposite of the `external_account_collection` value. For example, if you don't set `external_account_collection`, it defaults to `true` and `disable_stripe_user_authentication` defaults to `false`.
@@ -229,6 +237,22 @@ class Features < Stripe::StripeObject
         attr_reader :features
       end
 
+      class PayoutDetails < Stripe::StripeObject
+        class Features < Stripe::StripeObject; end
+        # Whether the embedded component is enabled.
+        attr_reader :enabled
+        # Attribute for field features
+        attr_reader :features
+      end
+
+      class PayoutReconciliationReport < Stripe::StripeObject
+        class Features < Stripe::StripeObject; end
+        # Whether the embedded component is enabled.
+        attr_reader :enabled
+        # Attribute for field features
+        attr_reader :features
+      end
+
       class Payouts < Stripe::StripeObject
         class Features < Stripe::StripeObject
           # Whether Stripe user authentication is disabled. This value can only be `true` for accounts where `controller.requirement_collection` is `application` for the account. The default value is the opposite of the `external_account_collection` value. For example, if you don't set `external_account_collection`, it defaults to `true` and `disable_stripe_user_authentication` defaults to `false`.
@@ -275,6 +299,8 @@ class Features < Stripe::StripeObject; end
       attr_reader :account_management
       # Attribute for field account_onboarding
       attr_reader :account_onboarding
+      # Attribute for field balance_report
+      attr_reader :balance_report
       # Attribute for field balances
       attr_reader :balances
       # Attribute for field disputes_list
@@ -299,6 +325,10 @@ class Features < Stripe::StripeObject; end
       attr_reader :payment_disputes
       # Attribute for field payments
       attr_reader :payments
+      # Attribute for field payout_details
+      attr_reader :payout_details
+      # Attribute for field payout_reconciliation_report
+      attr_reader :payout_reconciliation_report
       # Attribute for field payouts
       attr_reader :payouts
       # Attribute for field payouts_list
@@ -363,6 +393,19 @@ def initialize(enabled: nil, features: nil)
           end
         end
 
+        class BalanceReport < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # An empty list, because this embedded component has no features.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class Balances < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Whether Stripe user authentication is disabled. This value can only be `true` for accounts where `controller.requirement_collection` is `application` for the account. The default value is the opposite of the `external_account_collection` value. For example, if you don't set `external_account_collection`, it defaults to `true` and `disable_stripe_user_authentication` defaults to `false`.
@@ -439,7 +482,7 @@ class Documents < Stripe::RequestParams
           class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
-          # The list of features enabled in the embedded component.
+          # An empty list, because this embedded component has no features.
           attr_accessor :features
 
           def initialize(enabled: nil, features: nil)
@@ -728,6 +771,32 @@ def initialize(enabled: nil, features: nil)
           end
         end
 
+        class PayoutDetails < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # An empty list, because this embedded component has no features.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class PayoutReconciliationReport < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # An empty list, because this embedded component has no features.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class Payouts < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Whether Stripe user authentication is disabled. This value can only be `true` for accounts where `controller.requirement_collection` is `application` for the account. The default value is the opposite of the `external_account_collection` value. For example, if you don't set `external_account_collection`, it defaults to `true` and `disable_stripe_user_authentication` defaults to `false`.
@@ -770,7 +839,7 @@ class PayoutsList < Stripe::RequestParams
           class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
-          # The list of features enabled in the embedded component.
+          # An empty list, because this embedded component has no features.
           attr_accessor :features
 
           def initialize(enabled: nil, features: nil)
@@ -783,7 +852,7 @@ class TaxRegistrations < Stripe::RequestParams
           class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
-          # The list of features enabled in the embedded component.
+          # An empty list, because this embedded component has no features.
           attr_accessor :features
 
           def initialize(enabled: nil, features: nil)
@@ -796,7 +865,7 @@ class TaxSettings < Stripe::RequestParams
           class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
-          # The list of features enabled in the embedded component.
+          # An empty list, because this embedded component has no features.
           attr_accessor :features
 
           def initialize(enabled: nil, features: nil)
@@ -808,6 +877,8 @@ def initialize(enabled: nil, features: nil)
         attr_accessor :account_management
         # Configuration for the [account onboarding](/connect/supported-embedded-components/account-onboarding/) embedded component.
         attr_accessor :account_onboarding
+        # Configuration for the [balance report](/connect/supported-embedded-components/financial-reports#balance-report) embedded component.
+        attr_accessor :balance_report
         # Configuration for the [balances](/connect/supported-embedded-components/balances/) embedded component.
         attr_accessor :balances
         # Configuration for the [disputes list](/connect/supported-embedded-components/disputes-list/) embedded component.
@@ -832,6 +903,10 @@ def initialize(enabled: nil, features: nil)
         attr_accessor :payment_disputes
         # Configuration for the [payments](/connect/supported-embedded-components/payments/) embedded component.
         attr_accessor :payments
+        # Configuration for the [payout details](/connect/supported-embedded-components/payout-details/) embedded component.
+        attr_accessor :payout_details
+        # Configuration for the [payout reconciliation report](/connect/supported-embedded-components/financial-reports#payout-reconciliation-report) embedded component.
+        attr_accessor :payout_reconciliation_report
         # Configuration for the [payouts](/connect/supported-embedded-components/payouts/) embedded component.
         attr_accessor :payouts
         # Configuration for the [payouts list](/connect/supported-embedded-components/payouts-list/) embedded component.
@@ -844,6 +919,7 @@ def initialize(enabled: nil, features: nil)
         def initialize(
           account_management: nil,
           account_onboarding: nil,
+          balance_report: nil,
           balances: nil,
           disputes_list: nil,
           documents: nil,
@@ -856,13 +932,16 @@ def initialize(
           payment_details: nil,
           payment_disputes: nil,
           payments: nil,
+          payout_details: nil,
+          payout_reconciliation_report: nil,
           payouts: nil,
           payouts_list: nil,
           tax_registrations: nil,
           tax_settings: nil
         )
           @account_management = account_management
           @account_onboarding = account_onboarding
+          @balance_report = balance_report
           @balances = balances
           @disputes_list = disputes_list
           @documents = documents
@@ -875,6 +954,8 @@ def initialize(
           @payment_details = payment_details
           @payment_disputes = payment_disputes
           @payments = payments
+          @payout_details = payout_details
+          @payout_reconciliation_report = payout_reconciliation_report
           @payouts = payouts
           @payouts_list = payouts_list
           @tax_registrations = tax_registrations

lib/stripe/resources/balance.rb

@@ -5,14 +5,9 @@ module Stripe
   # This is an object representing your Stripe balance. You can retrieve it to see
   # the balance currently on your Stripe account.
   #
-  # You can also retrieve the balance history, which contains a list of
-  # [transactions](https://stripe.com/docs/reporting/balance-transaction-types) that contributed to the balance
-  # (charges, payouts, and so forth).
+  # The top-level `available` and `pending` comprise your "payments balance."
   #
-  # The available and pending amounts for each currency are broken down further by
-  # payment source types.
-  #
-  # Related guide: [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances)
+  # Related guide: [Balances and settlement time](https://stripe.com/docs/payments/balances), [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances)
   class Balance < SingletonAPIResource
     OBJECT_NAME = "balance"
     def self.object_name

lib/stripe/resources/billing/meter.rb

@@ -108,7 +108,7 @@ def initialize(event_payload_key: nil)
         attr_accessor :display_name
         # The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
         attr_accessor :event_name
-        # The time window to pre-aggregate meter events for, if any.
+        # The time window which meter events have been pre-aggregated for, if any.
         attr_accessor :event_time_window
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand
@@ -173,7 +173,7 @@ def initialize(expand: nil)
       attr_reader :display_name
       # The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
       attr_reader :event_name
-      # The time window to pre-aggregate meter events for, if any.
+      # The time window which meter events have been pre-aggregated for, if any.
       attr_reader :event_time_window
       # Unique identifier for the object.
       attr_reader :id

lib/stripe/resources/billing_portal/configuration.rb

@@ -345,21 +345,25 @@ def initialize(enabled: nil)
         attr_accessor :login_page
         # Set of [key-value pairs](https://stripe.com/docs/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
+        # The name of the configuration.
+        attr_accessor :name
 
         def initialize(
           business_profile: nil,
           default_return_url: nil,
           expand: nil,
           features: nil,
           login_page: nil,
-          metadata: nil
+          metadata: nil,
+          name: nil
         )
           @business_profile = business_profile
           @default_return_url = default_return_url
           @expand = expand
           @features = features
           @login_page = login_page
           @metadata = metadata
+          @name = name
         end
       end
 
@@ -565,6 +569,8 @@ def initialize(enabled: nil)
         attr_accessor :login_page
         # Set of [key-value pairs](https://stripe.com/docs/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
+        # The name of the configuration.
+        attr_accessor :name
 
         def initialize(
           active: nil,
@@ -573,7 +579,8 @@ def initialize(
           expand: nil,
           features: nil,
           login_page: nil,
-          metadata: nil
+          metadata: nil,
+          name: nil
         )
           @active = active
           @business_profile = business_profile
@@ -582,6 +589,7 @@ def initialize(
           @features = features
           @login_page = login_page
           @metadata = metadata
+          @name = name
         end
       end
       # Whether the configuration is active and can be used to create portal sessions.
@@ -606,6 +614,8 @@ def initialize(
       attr_reader :login_page
       # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
       attr_reader :metadata
+      # The name of the configuration.
+      attr_reader :name
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
       # Time at which the object was last updated. Measured in seconds since the Unix epoch.