stripe 15.5.0.pre.beta.2 → 15.6.0.pre.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a152f385752eefb0d7a94429161a6641eb295905f3c40a93cd99ac3f88cb78ed
-  data.tar.gz: da140b779d516fa432d03948af45a6d2d0c7300f357d3716c5571a96c43bf241
+  metadata.gz: 1c642c066b3f649ba0a4cd905b78f1fb16c737f95092bc59cdf5d50608ae1621
+  data.tar.gz: 6ce6093b6470fa5bb6db669f01680bedc62a0775d65353f5913588b9b1aec474
 SHA512:
-  metadata.gz: 6354ef47fbdf0229a18203e45d003003b9e2c18d4a557a8de5c9dc1593c3e8fab8b15b6d4305ff3e99ad81b7f969e1c10d49225e4cbabeb60dca0f6cb9c35850
-  data.tar.gz: 36c751d6de8f2d8b8ca8b2db6608e62dec9d309cdb5584f747f6fdb1603e1efd91368b0090db06ada0cc1936b20ac50b59eccdb2f93b0bb0992c1a6677dbe725
+  metadata.gz: 58eae5852e9a3836700a1657d4e85b9526d001e4ba2bb2de45ff5c23dc2d22b6e641e6e70af100d5671ea42aba4798a9ef98a60a2dc96f502ba29ceb2e5171f4
+  data.tar.gz: 83f07337b4cea16ce37a7d16f87694c188a0457d3932436ea3609667db80c3d6bb70373acae8de67b37157d9e76a06d537bdc93c49d2556770aa496f61148323

data/API_VERSION

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

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 15.6.0-beta.1 - 2025-08-27
+This release changes the pinned API version to `2025-08-27.preview`.
+
+* [#1629](https://github.com/stripe/stripe-ruby/pull/1629) Update generated code for beta
+  * Add support for `list` and `retrieve` methods on resource `InvoicePayment`
+  * Add support for `list` method on resource `Mandate`
+  * Add support for `applied` on `V2::Core::Account::Configuration::Customer`, `V2::Core::Account::Configuration::Merchant`, `V2::Core::Account::Configuration::Recipient`, `V2::Core::Account::Configuration::Storer`, `V2::Core::Account::UpdateParams::Configuration::Customer`, `V2::Core::Account::UpdateParams::Configuration::Merchant`, `V2::Core::Account::UpdateParams::Configuration::Recipient`, and `V2::Core::Account::UpdateParams::Configuration::Storer`
+  * Change type of `Billing::AlertTriggered.value` from `longInteger` to `decimal_string`
+  * Add support for `display_name` on `V2::MoneyManagement::FinancialAccount::CreateParams` and `V2::MoneyManagement::FinancialAccount`
+  * Add support for `currency_conversion` on `V2::MoneyManagement::Transaction::Flow` and `V2::MoneyManagement::TransactionEntry::TransactionDetail::Flow`
+  * Add support for `payments` on `BalanceSettings::UpdateParams` and `BalanceSettings`
+  * Remove support for `debit_negative_balances`, `payouts`, and `settlement_timing` on `BalanceSettings::UpdateParams` and `BalanceSettings`
+  * Add support for `mandate` on `Charge::PaymentMethodDetail::Pix`, `PaymentAttemptRecord::PaymentMethodDetail::Pix`, and `PaymentRecord::PaymentMethodDetail::Pix`
+  * Add support for `coupon_data` on `Checkout::Session::CreateParams::Discount`
+  * Add support for `mandate_options` on `Checkout::Session::CreateParams::PaymentMethodOption::Pix`, `Checkout::Session::PaymentMethodOption::Pix`, `PaymentIntent::ConfirmParams::PaymentMethodOption::Pix`, `PaymentIntent::CreateParams::PaymentMethodOption::Pix`, `PaymentIntent::PaymentMethodOption::Pix`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Pix`
+  * Change type of `Checkout::Session::CreateParams::PaymentMethodOption::Pix.setup_future_usage`, `Checkout::Session::PaymentMethodOption::Pix.setup_future_usage`, `PaymentIntent::ConfirmParams::PaymentMethodOption::Pix.setup_future_usage`, `PaymentIntent::CreateParams::PaymentMethodOption::Pix.setup_future_usage`, `PaymentIntent::PaymentMethodOption::Pix.setup_future_usage`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Pix.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+  * Add support for `amount` on `Mandate::MultiUse`, `PaymentAttemptRecord`, and `PaymentRecord`
+  * Add support for `currency` on `Mandate::MultiUse`
+  * Add support for `pix` on `Mandate::PaymentMethodDetail`, `SetupAttempt::PaymentMethodDetail`, `SetupIntent::ConfirmParams::PaymentMethodOption`, `SetupIntent::CreateParams::PaymentMethodOption`, `SetupIntent::PaymentMethodOption`, and `SetupIntent::UpdateParams::PaymentMethodOption`
+  * Add support for `limit` on `PaymentAttemptRecord::ListParams`
+  * Add support for `amount_authorized`, `amount_refunded`, and `application` on `PaymentAttemptRecord` and `PaymentRecord`
+  * Add support for `processor_details` on `PaymentAttemptRecord`, `PaymentRecord::ReportPaymentParams`, and `PaymentRecord`
+  * Remove support for `payment_reference` on `PaymentAttemptRecord`, `PaymentRecord::ReportPaymentParams`, and `PaymentRecord`
+  * Add support for `installments` on `PaymentAttemptRecord::PaymentMethodDetail::Alma` and `PaymentRecord::PaymentMethodDetail::Alma`
+  * Add support for `transaction_id` on `PaymentAttemptRecord::PaymentMethodDetail::Alma`, `PaymentAttemptRecord::PaymentMethodDetail::AmazonPay`, `PaymentAttemptRecord::PaymentMethodDetail::Billie`, `PaymentAttemptRecord::PaymentMethodDetail::KakaoPay`, `PaymentAttemptRecord::PaymentMethodDetail::KrCard`, `PaymentAttemptRecord::PaymentMethodDetail::NaverPay`, `PaymentAttemptRecord::PaymentMethodDetail::Payco`, `PaymentAttemptRecord::PaymentMethodDetail::RevolutPay`, `PaymentAttemptRecord::PaymentMethodDetail::SamsungPay`, `PaymentAttemptRecord::PaymentMethodDetail::Satispay`, `PaymentRecord::PaymentMethodDetail::Alma`, `PaymentRecord::PaymentMethodDetail::AmazonPay`, `PaymentRecord::PaymentMethodDetail::Billie`, `PaymentRecord::PaymentMethodDetail::KakaoPay`, `PaymentRecord::PaymentMethodDetail::KrCard`, `PaymentRecord::PaymentMethodDetail::NaverPay`, `PaymentRecord::PaymentMethodDetail::Payco`, `PaymentRecord::PaymentMethodDetail::RevolutPay`, `PaymentRecord::PaymentMethodDetail::SamsungPay`, and `PaymentRecord::PaymentMethodDetail::Satispay`
+  * Add support for `location` and `reader` on `PaymentAttemptRecord::PaymentMethodDetail::Paynow` and `PaymentRecord::PaymentMethodDetail::Paynow`
+  * Add support for `latest_active_mandate` on `PaymentMethod`
+  * Change `Payout.payout_method` to be required
+  * Add support for `metadata` and `period` on `QuotePreviewSubscriptionSchedule::Phase::AddInvoiceItem`
+  * Add support for `pix_display_qr_code` on `SetupIntent::NextAction`
+  * Add support for `reader_security` on `Terminal::Configuration::CreateParams`, `Terminal::Configuration::UpdateParams`, and `Terminal::Configuration`
+
 ## 15.5.0-beta.2 - 2025-08-08
 * [#1632](https://github.com/stripe/stripe-ruby/pull/1632) Bring back invoice payments APIs that were missing in the public preview SDKs
     * Add support for new resource `InvoicePayment`
@@ -32,6 +64,25 @@ This release changes the pinned API version to `2025-07-30.preview`.
   * Remove support for thin event `V2CoreAccountLinkCompletedEvent`
   * Remove support for thin event `V2OffSessionPaymentRequiresCaptureEvent` with related object `V2::Payments::OffSessionPayment`
 
+## 15.4.0 - 2025-07-30
+This release changes the pinned API version to `2025-07-30.basil`.
+
+* [#1627](https://github.com/stripe/stripe-ruby/pull/1627) Update generated code
+  * Add support for `instant_payouts_promotion` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
+  * Add support for `adjustable_quantity` on `BillingPortal::Configuration::CreateParams::Feature::SubscriptionUpdate::Product`, `BillingPortal::Configuration::Feature::SubscriptionUpdate::Product`, and `BillingPortal::Configuration::UpdateParams::Feature::SubscriptionUpdate::Product`
+  * Add support for `transaction_id` on `Charge::PaymentMethodDetail::Cashapp`
+  * Add support for `origin_context` on `Checkout::Session::CreateParams` and `Checkout::Session`
+  * Add support for `template` on `Checkout::Session::CreateParams::InvoiceCreation::InvoiceDatum::RenderingOption`, `Checkout::Session::InvoiceCreation::InvoiceDatum::RenderingOption`, `PaymentLink::CreateParams::InvoiceCreation::InvoiceDatum::RenderingOption`, `PaymentLink::InvoiceCreation::InvoiceDatum::RenderingOption`, and `PaymentLink::UpdateParams::InvoiceCreation::InvoiceDatum::RenderingOption`
+  * Add support for `setup_future_usage` on `Checkout::Session::CreateParams::PaymentMethodOption::Pix` and `Checkout::Session::PaymentMethodOption::Pix`
+  * Change `Identity::VerificationSession::RelatedPerson.account` to be required
+  * Change `Identity::VerificationSession::RelatedPerson.person` to be required
+  * Add support for `duration` on `Invoice::CreatePreviewParams::ScheduleDetail::Phase`, `SubscriptionSchedule::CreateParams::Phase`, and `SubscriptionSchedule::UpdateParams::Phase`
+  * Change type of `Invoice::CreatePreviewParams::SubscriptionDetail.cancel_at`, `Subscription::CreateParams.cancel_at`, and `Subscription::UpdateParams.cancel_at` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
+  * Add support for `price_data` on `PaymentLink::CreateParams::LineItem`
+  * Change `PaymentLink::CreateParams::LineItem.price` to be optional
+  * Add support for `standard` on `Tax::Registration::CountryOption::Ae`, `Tax::Registration::CountryOption::Au`, `Tax::Registration::CountryOption::Ch`, `Tax::Registration::CountryOption::Gb`, `Tax::Registration::CountryOption::Jp`, `Tax::Registration::CountryOption::No`, `Tax::Registration::CountryOption::Nz`, `Tax::Registration::CountryOption::Sg`, `Tax::Registration::CreateParams::CountryOption::Ae`, `Tax::Registration::CreateParams::CountryOption::Al`, `Tax::Registration::CreateParams::CountryOption::Ao`, `Tax::Registration::CreateParams::CountryOption::Au`, `Tax::Registration::CreateParams::CountryOption::Aw`, `Tax::Registration::CreateParams::CountryOption::B`, `Tax::Registration::CreateParams::CountryOption::Ba`, `Tax::Registration::CreateParams::CountryOption::Bb`, `Tax::Registration::CreateParams::CountryOption::Bd`, `Tax::Registration::CreateParams::CountryOption::Bf`, `Tax::Registration::CreateParams::CountryOption::Bh`, `Tax::Registration::CreateParams::CountryOption::Cd`, `Tax::Registration::CreateParams::CountryOption::Ch`, `Tax::Registration::CreateParams::CountryOption::Et`, `Tax::Registration::CreateParams::CountryOption::Gb`, `Tax::Registration::CreateParams::CountryOption::Gn`, `Tax::Registration::CreateParams::CountryOption::Is`, `Tax::Registration::CreateParams::CountryOption::Jp`, `Tax::Registration::CreateParams::CountryOption::Me`, `Tax::Registration::CreateParams::CountryOption::Mk`, `Tax::Registration::CreateParams::CountryOption::Mr`, `Tax::Registration::CreateParams::CountryOption::No`, `Tax::Registration::CreateParams::CountryOption::Nz`, `Tax::Registration::CreateParams::CountryOption::Om`, `Tax::Registration::CreateParams::CountryOption::R`, `Tax::Registration::CreateParams::CountryOption::Sg`, `Tax::Registration::CreateParams::CountryOption::Sr`, `Tax::Registration::CreateParams::CountryOption::Uy`, `Tax::Registration::CreateParams::CountryOption::Za`, and `Tax::Registration::CreateParams::CountryOption::Zw`
+  * Add support for `aed`, `bgn`, `huf`, and `ron` on `Terminal::Configuration::CreateParams::Tipping`, `Terminal::Configuration::Tipping`, and `Terminal::Configuration::UpdateParams::Tipping`
+
 ## 15.4.0-beta.2 - 2025-07-09
 * [#1625](https://github.com/stripe/stripe-ruby/pull/1625) Pull in V2 FinancialAccount changes for June release
   * Add support for `close` and `create` methods on resource `V2::MoneyManagement::FinancialAccount`
@@ -66,6 +117,8 @@ This release changes the pinned API version to `2025-06-30.preview`.
   * Change `V2::Payments::OffSessionPayment::CreateParams::TransferDatum.amount` to be optional
 
 ## 15.3.0 - 2025-07-01
+This release changes the pinned API version to `2025-06-30.basil`.
+
 * [#1618](https://github.com/stripe/stripe-ruby/pull/1618) Update generated code
   * Add support for `migrate` method on resource `Subscription`
   * Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `Terminal::Reader`
@@ -89,7 +142,6 @@ This release changes the pinned API version to `2025-06-30.preview`.
   * Add support for `status` on `Treasury::FinancialAccount::ListParams`
 * [#1615](https://github.com/stripe/stripe-ruby/pull/1615) Update README to mention that APIResource.request was removed
 * [#1619](https://github.com/stripe/stripe-ruby/pull/1619) Updated StripeClient snippets in README
-* [#1621](https://github.com/stripe/stripe-ruby/pull/1621) Disable flaky test in jruby/truffleruby
 * [#1620](https://github.com/stripe/stripe-ruby/pull/1620) Fix `raw_request` example in README
 
 ## 15.3.0-beta.2 - 2025-06-26

data/OPENAPI_VERSION

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

data/VERSION

@@ -1 +1 @@
-15.5.0-beta.2
+15.6.0-beta.1

data/lib/stripe/api_requestor.rb

@@ -850,32 +850,20 @@ module Stripe
       when "idempotency_error"
         IdempotencyError.new(error_data[:message], **opts)
       # switch cases: The beginning of the section generated from our OpenAPI spec
-      when "temporary_session_expired"
-        TemporarySessionExpiredError.new(error_data[:message], **opts)
-      when "non_zero_balance"
-        NonZeroBalanceError.new(error_data[:message], **opts)
+      when "already_canceled"
+        AlreadyCanceledError.new(error_data[:message], **opts)
       when "already_exists"
         AlreadyExistsError.new(error_data[:message], **opts)
+      when "blocked_by_stripe"
+        BlockedByStripeError.new(error_data[:message], **opts)
+      when "controlled_by_dashboard"
+        ControlledByDashboardError.new(error_data[:message], **opts)
       when "feature_not_enabled"
         FeatureNotEnabledError.new(error_data[:message], **opts)
       when "financial_account_not_open"
         FinancialAccountNotOpenError.new(error_data[:message], **opts)
-      when "blocked_by_stripe"
-        BlockedByStripeError.new(error_data[:message], **opts)
-      when "already_canceled"
-        AlreadyCanceledError.new(error_data[:message], **opts)
-      when "not_cancelable"
-        NotCancelableError.new(error_data[:message], **opts)
       when "insufficient_funds"
         InsufficientFundsError.new(error_data[:message], **opts)
-      when "quota_exceeded"
-        QuotaExceededError.new(error_data[:message], **opts)
-      when "recipient_not_notifiable"
-        RecipientNotNotifiableError.new(error_data[:message], **opts)
-      when "invalid_payout_method"
-        InvalidPayoutMethodError.new(error_data[:message], **opts)
-      when "controlled_by_dashboard"
-        ControlledByDashboardError.new(error_data[:message], **opts)
       when "invalid_payment_method"
 
         InvalidPaymentMethodError.new(
@@ -884,6 +872,18 @@ module Stripe
           invalid_param: error_data[:invalid_param]
         )
 
+      when "invalid_payout_method"
+        InvalidPayoutMethodError.new(error_data[:message], **opts)
+      when "non_zero_balance"
+        NonZeroBalanceError.new(error_data[:message], **opts)
+      when "not_cancelable"
+        NotCancelableError.new(error_data[:message], **opts)
+      when "quota_exceeded"
+        QuotaExceededError.new(error_data[:message], **opts)
+      when "recipient_not_notifiable"
+        RecipientNotNotifiableError.new(error_data[:message], **opts)
+      when "temporary_session_expired"
+        TemporarySessionExpiredError.new(error_data[:message], **opts)
       # switch cases: The end of the section generated from our OpenAPI spec
       else
         specific_api_error(resp, error_data, context)

data/lib/stripe/api_version.rb

@@ -3,6 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-07-30.preview"
+    CURRENT = "2025-08-27.preview"
   end
 end

data/lib/stripe/errors.rb

@@ -162,43 +162,25 @@ module Stripe
   end
 
   # class definitions: The beginning of the section generated from our OpenAPI spec
-  class TemporarySessionExpiredError < StripeError
-  end
-
-  class NonZeroBalanceError < StripeError
+  class AlreadyCanceledError < StripeError
   end
 
   class AlreadyExistsError < StripeError
   end
 
-  class FeatureNotEnabledError < StripeError
-  end
-
-  class FinancialAccountNotOpenError < StripeError
-  end
-
   class BlockedByStripeError < StripeError
   end
 
-  class AlreadyCanceledError < StripeError
-  end
-
-  class NotCancelableError < StripeError
-  end
-
-  class InsufficientFundsError < StripeError
-  end
-
-  class QuotaExceededError < StripeError
+  class ControlledByDashboardError < StripeError
   end
 
-  class RecipientNotNotifiableError < StripeError
+  class FeatureNotEnabledError < StripeError
   end
 
-  class InvalidPayoutMethodError < StripeError
+  class FinancialAccountNotOpenError < StripeError
   end
 
-  class ControlledByDashboardError < StripeError
+  class InsufficientFundsError < StripeError
   end
 
   class InvalidPaymentMethodError < StripeError
@@ -224,5 +206,23 @@ module Stripe
       @invalid_param = invalid_param
     end
   end
+
+  class InvalidPayoutMethodError < StripeError
+  end
+
+  class NonZeroBalanceError < StripeError
+  end
+
+  class NotCancelableError < StripeError
+  end
+
+  class QuotaExceededError < StripeError
+  end
+
+  class RecipientNotNotifiableError < StripeError
+  end
+
+  class TemporarySessionExpiredError < StripeError
+  end
   # class definitions: The end of the section generated from our OpenAPI spec
 end

data/lib/stripe/resources/account.rb

@@ -319,13 +319,13 @@ module Stripe
 
       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

data/lib/stripe/resources/account_session.rb

@@ -44,6 +44,14 @@ module Stripe
         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`.
@@ -253,6 +261,22 @@ module Stripe
         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`.
@@ -299,6 +323,8 @@ module Stripe
       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 capital_financing
@@ -329,6 +355,10 @@ module Stripe
       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
@@ -433,6 +463,19 @@ module Stripe
           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`.
@@ -475,7 +518,7 @@ module Stripe
           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)
@@ -488,7 +531,7 @@ module Stripe
           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)
@@ -501,7 +544,7 @@ module Stripe
           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)
@@ -514,7 +557,7 @@ module Stripe
           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)
@@ -561,7 +604,7 @@ module Stripe
           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)
@@ -574,7 +617,7 @@ module Stripe
           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)
@@ -833,7 +876,7 @@ module Stripe
           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)
@@ -876,6 +919,32 @@ module Stripe
           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`.
@@ -918,7 +987,7 @@ module Stripe
           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)
@@ -931,7 +1000,7 @@ module Stripe
           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)
@@ -964,7 +1033,7 @@ module Stripe
           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)
@@ -977,7 +1046,7 @@ module Stripe
           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)
@@ -990,7 +1059,7 @@ module Stripe
           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)
@@ -1003,7 +1072,7 @@ module Stripe
           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)
@@ -1019,6 +1088,8 @@ module Stripe
         attr_accessor :app_install
         # Configuration for the [app viewport](/connect/supported-embedded-components/app-viewport/) embedded component.
         attr_accessor :app_viewport
+        # 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 [Capital financing](/connect/supported-embedded-components/capital-financing/) embedded component.
@@ -1055,6 +1126,10 @@ module Stripe
         attr_accessor :payment_method_settings
         # 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.
@@ -1077,6 +1152,7 @@ module Stripe
           account_onboarding: nil,
           app_install: nil,
           app_viewport: nil,
+          balance_report: nil,
           balances: nil,
           capital_financing: nil,
           capital_financing_application: nil,
@@ -1095,6 +1171,8 @@ module Stripe
           payment_disputes: nil,
           payment_method_settings: nil,
           payments: nil,
+          payout_details: nil,
+          payout_reconciliation_report: nil,
           payouts: nil,
           payouts_list: nil,
           product_tax_code_selector: nil,
@@ -1108,6 +1186,7 @@ module Stripe
           @account_onboarding = account_onboarding
           @app_install = app_install
           @app_viewport = app_viewport
+          @balance_report = balance_report
           @balances = balances
           @capital_financing = capital_financing
           @capital_financing_application = capital_financing_application
@@ -1126,6 +1205,8 @@ module Stripe
           @payment_disputes = payment_disputes
           @payment_method_settings = payment_method_settings
           @payments = payments
+          @payout_details = payout_details
+          @payout_reconciliation_report = payout_reconciliation_report
           @payouts = payouts
           @payouts_list = payouts_list
           @product_tax_code_selector = product_tax_code_selector

data/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