stripe 18.1.0.pre.alpha.4 → 18.2.0.pre.alpha.1

data/lib/stripe/resources/v2/core/account.rb

@@ -31,11 +31,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -62,11 +60,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -107,11 +103,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -138,11 +132,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -183,11 +175,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -226,11 +216,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -257,11 +245,9 @@ module Stripe
                         @field_remappings = {}
                       end
                     end
-                    # Whether the Capability has been requested.
-                    attr_reader :requested
                     # The status of the Capability.
                     attr_reader :status
-                    # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                    # Additional details about the capability's status. This value is empty when `status` is `active`.
                     attr_reader :status_details
 
                     def self.inner_class_types
@@ -318,7 +304,7 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration.
+            # Indicates whether the card_creator configuration is active. You can deactivate or reactivate the card_creator configuration by updating this property. Deactivating the configuration by setting this value to false will unrequest all capabilities within the configuration. It will not delete any of the configuration's other properties.
             attr_reader :applied
             # Capabilities that have been requested on the CardCreator Configuration.
             attr_reader :capabilities
@@ -348,13 +334,13 @@ module Stripe
                   @field_remappings = {}
                 end
               end
-              # Describes the customer's tax exemption status, which is `none`, `exempt`, or `reverse`. When set to reverse, invoice and receipt PDFs include the following text: “Reverse charge”.
+              # The customer account's tax exemption status: `none`, `exempt`, or `reverse`. When `reverse`, invoice and receipt PDFs include "Reverse charge".
               attr_reader :exempt
               # A recent IP address of the customer used for tax reporting and tax location inference.
               attr_reader :ip_address
-              # The [identified](https://docs.stripe.com/tax/customer-locations#address-hierarchy-other) tax location of the customer. Will only be rendered if the `automatic_indirect_tax` feature is requested and `active`.
+              # The customer account's identified tax location, derived from `location_source`. Only rendered if the `automatic_indirect_tax` feature is requested and `active`.
               attr_reader :location
-              # The data source used to identify the customer's tax location. Will only be used for automatic tax calculation on the customer's Invoices and Subscriptions.
+              # Data source used to identify the customer account's tax location. Defaults to `identity_address`. Used for automatic indirect tax calculation.
               attr_reader :location_source
 
               def self.inner_class_types
@@ -384,7 +370,7 @@ module Stripe
                 end
 
                 class Rendering < ::Stripe::StripeObject
-                  # How line-item prices and amounts will be displayed with respect to tax on invoice PDFs. One of exclude_tax or include_inclusive_tax. include_inclusive_tax will include inclusive tax (and exclude exclusive tax) in invoice PDF amounts. exclude_tax will exclude all tax (inclusive and exclusive alike) from invoice PDF amounts.
+                  # Indicates whether displayed line item prices and amounts on invoice PDFs include inclusive tax amounts. Must be either `include_inclusive_tax` or `exclude_tax`.
                   attr_reader :amount_tax_display
                   # ID of the invoice rendering template to use for future invoices.
                   attr_reader :template
@@ -399,13 +385,13 @@ module Stripe
                 end
                 # The list of up to 4 default custom fields to be displayed on invoices for this customer. When updating, pass an empty string to remove previously-defined fields.
                 attr_reader :custom_fields
-                # Default footer to be displayed on invoices for this customer.
+                # Default invoice footer.
                 attr_reader :footer
-                # The sequence to be used on the customer's next invoice. Defaults to 1.
+                # Sequence number to use on the customer account's next invoice. Defaults to 1.
                 attr_reader :next_sequence
-                # The prefix for the customer used to generate unique invoice numbers. Must be 3–12 uppercase letters or numbers.
+                # Prefix used to generate unique invoice numbers. Must be 3-12 uppercase letters or numbers.
                 attr_reader :prefix
-                # Default options for invoice PDF rendering for this customer.
+                # Default invoice PDF rendering options.
                 attr_reader :rendering
 
                 def self.inner_class_types
@@ -416,9 +402,9 @@ module Stripe
                   @field_remappings = {}
                 end
               end
-              # ID of a payment method that’s attached to the customer, to be used as the customer’s default payment method for invoices and subscriptions.
+              # ID of a PaymentMethod attached to the customer account to use as the default for invoices and subscriptions.
               attr_reader :default_payment_method
-              # Default settings used on invoices for this customer.
+              # Default invoice settings for the customer account.
               attr_reader :invoice
 
               def self.inner_class_types
@@ -446,11 +432,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -511,11 +495,11 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration.
+            # Indicates whether the customer configuration is active. You can deactivate or reactivate the customer configuration by updating this property. Deactivating the configuration by setting this value to false will unrequest all capabilities within the configuration. It will not delete any of the configuration's other properties.
             attr_reader :applied
-            # Automatic indirect tax settings to be used when automatic tax calculation is enabled on the customer's invoices, subscriptions, checkout sessions, or payment links. Surfaces if automatic tax calculation is possible given the current customer location information.
+            # Settings for automatic indirect tax calculation on the customer's invoices, subscriptions, Checkout Sessions, and Payment Links. Available when automatic tax calculation is available for the customer account's location.
             attr_reader :automatic_indirect_tax
-            # Billing settings - default settings used for this customer in Billing flows such as Invoices and Subscriptions.
+            # Default Billing settings for the customer account, used in Invoices and Subscriptions.
             attr_reader :billing
             # Capabilities that have been requested on the Customer Configuration.
             attr_reader :capabilities
@@ -540,9 +524,9 @@ module Stripe
 
           class Merchant < ::Stripe::StripeObject
             class BacsDebitPayments < ::Stripe::StripeObject
-              # Display name for Bacs debit payments.
+              # Display name for Bacs Direct Debit payments.
               attr_reader :display_name
-              # Service user number for Bacs debit payments.
+              # Service User Number (SUN) for Bacs Direct Debit payments.
               attr_reader :service_user_number
 
               def self.inner_class_types
@@ -589,11 +573,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -620,11 +602,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -651,11 +631,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -682,11 +660,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -713,11 +689,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -744,11 +718,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -775,11 +747,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -806,11 +776,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -837,11 +805,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -868,11 +834,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -899,11 +863,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -930,11 +892,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -961,11 +921,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -992,11 +950,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1023,11 +979,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1054,11 +1008,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1085,11 +1037,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1116,11 +1066,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1147,11 +1095,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1178,11 +1124,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1209,11 +1153,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1240,11 +1182,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1271,11 +1211,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1302,11 +1240,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1333,11 +1269,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1364,11 +1298,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1395,11 +1327,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1426,11 +1356,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1457,11 +1385,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1488,11 +1414,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1519,11 +1443,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1550,11 +1472,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1581,11 +1501,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1612,11 +1530,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1643,11 +1559,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1674,11 +1588,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1705,11 +1617,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1736,11 +1646,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1767,11 +1675,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1798,11 +1704,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1830,11 +1734,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -1845,7 +1747,7 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Allows the account to do payouts using their Stripe Balance (/v1/balance).
+                # Enables this Account to complete payouts from their Stripe Balance (/v1/balance).
                 attr_reader :payouts
 
                 def self.inner_class_types
@@ -1872,11 +1774,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1903,11 +1803,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1934,11 +1832,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -1965,11 +1861,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -2241,7 +2135,7 @@ module Stripe
             end
 
             class SepaDebitPayments < ::Stripe::StripeObject
-              # Creditor ID for SEPA debit payments.
+              # Creditor ID for SEPA Direct Debit payments.
               attr_reader :creditor_id
 
               def self.inner_class_types
@@ -2282,7 +2176,7 @@ module Stripe
                 attr_reader :postal_code
                 # State, county, province, or region.
                 attr_reader :state
-                # Town or cho-me.
+                # Town or district.
                 attr_reader :town
 
                 def self.inner_class_types
@@ -2310,9 +2204,9 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration.
+            # Indicates whether the merchant configuration is active. You can deactivate or reactivate the merchant configuration by updating this property. Deactivating the configuration by setting this value to false doesn't delete the configuration's properties.
             attr_reader :applied
-            # Settings used for Bacs debit payments.
+            # Settings for Bacs Direct Debit payments.
             attr_reader :bacs_debit_payments
             # Settings used to apply the merchant's branding to email receipts, invoices, Checkout, and other products.
             attr_reader :branding
@@ -2322,11 +2216,11 @@ module Stripe
             attr_reader :card_payments
             # Settings specific to Konbini payments on the account.
             attr_reader :konbini_payments
-            # The merchant category code for the merchant. MCCs are used to classify businesses based on the goods or services they provide.
+            # The Merchant Category Code (MCC) for the merchant. MCCs classify businesses based on the goods or services they provide.
             attr_reader :mcc
             # Settings for the default text that appears on statements for language variations.
             attr_reader :script_statement_descriptor
-            # Settings used for SEPA debit payments.
+            # Settings for SEPA Direct Debit payments.
             attr_reader :sepa_debit_payments
             # Statement descriptor.
             attr_reader :statement_descriptor
@@ -2355,6 +2249,35 @@ module Stripe
           class Recipient < ::Stripe::StripeObject
             class Capabilities < ::Stripe::StripeObject
               class BankAccounts < ::Stripe::StripeObject
+                class Instant < ::Stripe::StripeObject
+                  class StatusDetail < ::Stripe::StripeObject
+                    # Machine-readable code explaining the reason for the Capability to be in its current status.
+                    attr_reader :code
+                    # Machine-readable code explaining how to make the Capability active.
+                    attr_reader :resolution
+
+                    def self.inner_class_types
+                      @inner_class_types = {}
+                    end
+
+                    def self.field_remappings
+                      @field_remappings = {}
+                    end
+                  end
+                  # The status of the Capability.
+                  attr_reader :status
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
+                  attr_reader :status_details
+
+                  def self.inner_class_types
+                    @inner_class_types = { status_details: StatusDetail }
+                  end
+
+                  def self.field_remappings
+                    @field_remappings = {}
+                  end
+                end
+
                 class Local < ::Stripe::StripeObject
                   class StatusDetail < ::Stripe::StripeObject
                     # Machine-readable code explaining the reason for the Capability to be in its current status.
@@ -2370,11 +2293,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2401,11 +2322,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2416,13 +2335,15 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
+                # Enables this Account to receive OutboundPayments to linked bank accounts over real time rails.
+                attr_reader :instant
                 # Enables this Account to receive OutboundPayments to linked bank accounts over local networks.
                 attr_reader :local
                 # Enables this Account to receive OutboundPayments to linked bank accounts over wire.
                 attr_reader :wire
 
                 def self.inner_class_types
-                  @inner_class_types = { local: Local, wire: Wire }
+                  @inner_class_types = { instant: Instant, local: Local, wire: Wire }
                 end
 
                 def self.field_remappings
@@ -2445,11 +2366,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -2476,11 +2395,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Whether the Capability has been requested.
-                attr_reader :requested
                 # The status of the Capability.
                 attr_reader :status
-                # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                # Additional details about the capability's status. This value is empty when `status` is `active`.
                 attr_reader :status_details
 
                 def self.inner_class_types
@@ -2508,11 +2425,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2539,11 +2454,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2554,9 +2467,9 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Allows the account to do payouts using their Stripe Balance (/v1/balance).
+                # Enables this Account to complete payouts from their Stripe Balance (/v1/balance).
                 attr_reader :payouts
-                # Allows the account to receive /v1/transfers into their Stripe Balance (/v1/balance).
+                # Enables this Account to receive /v1/transfers into their Stripe Balance (/v1/balance).
                 attr_reader :stripe_transfers
 
                 def self.inner_class_types
@@ -2569,9 +2482,9 @@ module Stripe
               end
               # Capabilities that enable OutboundPayments to a bank account linked to this Account.
               attr_reader :bank_accounts
-              # Capability that enable OutboundPayments to a debit card linked to this Account.
+              # Enables this Account to receive OutboundPayments to a linked debit card.
               attr_reader :cards
-              # Capability that enable OutboundPayments to a crypto wallet linked to this Account.
+              # Enables this Account to receive OutboundPayments to a linked crypto wallet.
               attr_reader :crypto_wallets
               # Capabilities that enable the recipient to manage their Stripe Balance (/v1/balance).
               attr_reader :stripe_balance
@@ -2604,7 +2517,7 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration.
+            # Indicates whether the recipient configuration is active. You can deactivate or reactivate the recipient configuration by updating this property. Deactivating the configuration by setting this value to false  unrequest all capabilities within the configuration. It will not delete any of the configuration's other properties.
             attr_reader :applied
             # Capabilities that have been requested on the Recipient Configuration.
             attr_reader :capabilities
@@ -2641,11 +2554,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2672,11 +2583,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2717,11 +2626,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2748,11 +2655,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2779,11 +2684,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2810,11 +2713,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2859,11 +2760,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2874,7 +2773,7 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Can pull funds from an external bank account, owned by yourself, to a FinancialAccount.
+                # Can pull funds into a FinancialAccount from an external bank account owned by the user.
                 attr_reader :bank_accounts
 
                 def self.inner_class_types
@@ -2902,11 +2801,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2933,11 +2830,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2964,11 +2859,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -2995,11 +2888,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -3010,13 +2901,13 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Can send funds from a FinancialAccount to a bank account, owned by someone else.
+                # Can send funds from a FinancialAccount to a bank account owned by a different entity.
                 attr_reader :bank_accounts
-                # Can send funds from a FinancialAccount to a debit card, owned by someone else.
+                # Can send funds from a FinancialAccount to a debit card owned by a different entity.
                 attr_reader :cards
-                # Can send funds from a FinancialAccount to a crypto wallet, owned by someone else.
+                # Can send funds from a FinancialAccount to a crypto wallet owned by a different entity.
                 attr_reader :crypto_wallets
-                # Can send funds from a FinancialAccount to another FinancialAccount, owned by someone else.
+                # Can send funds from a FinancialAccount to a FinancialAccount owned by a different entity.
                 attr_reader :financial_accounts
 
                 def self.inner_class_types
@@ -3049,11 +2940,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -3080,11 +2969,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -3111,11 +2998,9 @@ module Stripe
                       @field_remappings = {}
                     end
                   end
-                  # Whether the Capability has been requested.
-                  attr_reader :requested
                   # The status of the Capability.
                   attr_reader :status
-                  # Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`.
+                  # Additional details about the capability's status. This value is empty when `status` is `active`.
                   attr_reader :status_details
 
                   def self.inner_class_types
@@ -3126,11 +3011,11 @@ module Stripe
                     @field_remappings = {}
                   end
                 end
-                # Can send funds from a FinancialAccount, to a bank account, owned by yourself.
+                # Can send funds from a FinancialAccount to a bank account belonging to the same user.
                 attr_reader :bank_accounts
-                # Can send funds from a FinancialAccount to a crypto wallet, owned by yourself.
+                # Can send funds from a FinancialAccount to a crypto wallet belonging to the same user.
                 attr_reader :crypto_wallets
-                # Can send funds from a FinancialAccount to another FinancialAccount, owned by yourself.
+                # Can send funds from a FinancialAccount to another FinancialAccount belonging to the same user.
                 attr_reader :financial_accounts
 
                 def self.inner_class_types
@@ -3149,11 +3034,11 @@ module Stripe
               attr_reader :financial_addresses
               # Can hold storage-type funds on Stripe.
               attr_reader :holds_currencies
-              # Can pull funds from an external source, owned by yourself, to a FinancialAccount.
+              # Hash containing capabilities related to InboundTransfers.
               attr_reader :inbound_transfers
-              # Can send funds from a FinancialAccount to a destination owned by someone else.
+              # Hash containing capabilities related to [OutboundPayments](/api/treasury/outbound_payments?api-version=preview).
               attr_reader :outbound_payments
-              # Can send funds from a FinancialAccount to a destination owned by yourself.
+              # Hash containing capabilities related to [OutboundTransfers](/api/treasury/outbound_transfers?api-version=preview).
               attr_reader :outbound_transfers
 
               def self.inner_class_types
@@ -3189,17 +3074,17 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration.
+            # Indicates whether the storer configuration is active. You cannot deactivate (or reactivate) the storer configuration by updating this property.
             attr_reader :applied
             # Capabilities that have been requested on the Storer Configuration.
             attr_reader :capabilities
             # List of high-risk activities the business is involved in.
             attr_reader :high_risk_activities
-            # An explanation of the high risk activities that the business performs.
+            # Description of the high-risk activities the business offers.
             attr_reader :high_risk_activities_description
             # Description of the money services offered by the business.
             attr_reader :money_services_description
-            # Does the business operate in any prohibited countries.
+            # Indicates whether the business operates in any prohibited countries.
             attr_reader :operates_in_prohibited_countries
             # Does the business participate in any regulated activity.
             attr_reader :participates_in_regulated_activity
@@ -3229,9 +3114,9 @@ module Stripe
           attr_reader :card_creator
           # The Customer Configuration allows the Account to be used in inbound payment flows.
           attr_reader :customer
-          # The Merchant configuration allows the Account to act as a connected account and collect payments facilitated by a Connect platform. You can add this configuration to your connected accounts only if you’ve completed onboarding as a Connect platform.
+          # Enables the Account to act as a connected account and collect payments facilitated by a Connect platform. You must onboard your platform to Connect before you can add this configuration to your connected accounts. Utilize this configuration when the Account will be the Merchant of Record, like with Direct charges or Destination Charges with on_behalf_of set.
           attr_reader :merchant
-          # The Recipient Configuration allows the Account to receive funds.
+          # The Recipient Configuration allows the Account to receive funds. Utilize this configuration if the Account will not be the Merchant of Record, like with Separate Charges & Transfers, or Destination Charges without on_behalf_of set.
           attr_reader :recipient
           # The Storer Configuration allows the Account to store and move funds using stored-value FinancialAccounts.
           attr_reader :storer
@@ -3255,7 +3140,7 @@ module Stripe
           class Profile < ::Stripe::StripeObject
             # The business's publicly-available website.
             attr_reader :business_url
-            # The company’s legal name.
+            # The customer-facing business name.
             attr_reader :doing_business_as
             # Internal-only description of the product sold or service provided by the business. It's used by Stripe for risk and underwriting purposes.
             attr_reader :product_description
@@ -3270,9 +3155,9 @@ module Stripe
           end
 
           class Responsibilities < ::Stripe::StripeObject
-            # A value indicating the responsible payer of a bundle of Stripe fees for pricing-control eligible products on this Account.
+            # Indicates whether the platform or connected account is responsible for paying Stripe fees for pricing-control-eligible products.
             attr_reader :fees_collector
-            # A value indicating who is responsible for losses when this Account can’t pay back negative balances from payments.
+            # A value indicating responsibility for collecting requirements on this account.
             attr_reader :losses_collector
             # A value indicating responsibility for collecting requirements on this account.
             attr_reader :requirements_collector
@@ -3404,7 +3289,7 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Whether the responsibility is with the integrator or with Stripe (to review info, to wait for some condition, etc.) to action the requirement.
+            # Indicates whether the platform or Stripe is currently responsible for taking action on the requirement. Value can be `user` or `stripe`.
             attr_reader :awaiting_action_from
             # Machine-readable string describing the requirement.
             attr_reader :description
@@ -4161,7 +4046,7 @@ module Stripe
               attr_reader :postal_code
               # State, county, province, or region.
               attr_reader :state
-              # Town or cho-me.
+              # Town or district.
               attr_reader :town
 
               def self.inner_class_types
@@ -4188,7 +4073,7 @@ module Stripe
                   @field_remappings = {}
                 end
               end
-              # A non-negative integer representing the amount in the smallest currency unit.
+              # Annual revenue amount in minor currency units (for example, '123' for 1.23 USD).
               attr_reader :amount
               # The close-out date of the preceding fiscal year in ISO 8601 format. E.g. 2023-12-31 for the 31st of December, 2023.
               attr_reader :fiscal_year_end
@@ -4437,7 +4322,7 @@ module Stripe
                   @field_remappings = {}
                 end
               end
-              # A non-negative integer representing the amount in the smallest currency unit.
+              # Estimated monthly revenue amount in minor currency units (for example, '123' for 1.23 USD).
               attr_reader :amount
 
               def self.inner_class_types
@@ -4463,7 +4348,7 @@ module Stripe
                 attr_reader :postal_code
                 # State, county, province, or region.
                 attr_reader :state
-                # Town or cho-me.
+                # Town or district.
                 attr_reader :town
 
                 def self.inner_class_types
@@ -4488,7 +4373,7 @@ module Stripe
                 attr_reader :postal_code
                 # State, county, province, or region.
                 attr_reader :state
-                # Town or cho-me.
+                # Town or district.
                 attr_reader :town
 
                 def self.inner_class_types
@@ -4560,11 +4445,11 @@ module Stripe
             attr_reader :compliance_screening_description
             # Documents that may be submitted to satisfy various informational requests.
             attr_reader :documents
-            # An estimated upper bound of employees, contractors, vendors, etc. currently working for the business.
+            # Estimated maximum number of workers currently engaged by the business (including employees, contractors, and vendors).
             attr_reader :estimated_worker_count
             # The provided ID numbers of a business entity.
             attr_reader :id_numbers
-            # An estimate of the monthly revenue of the business.
+            # An estimate of the monthly revenue of the business. Only accepted for accounts in Brazil and India.
             attr_reader :monthly_estimated_revenue
             # The company’s phone number (used for verification).
             attr_reader :phone
@@ -4610,7 +4495,7 @@ module Stripe
               attr_reader :purpose
               # State, county, province, or region.
               attr_reader :state
-              # Town or cho-me.
+              # Town or district.
               attr_reader :town
 
               def self.inner_class_types
@@ -4683,7 +4568,7 @@ module Stripe
               attr_reader :postal_code
               # State, county, province, or region.
               attr_reader :state
-              # Town or cho-me.
+              # Town or district.
               attr_reader :town
 
               def self.inner_class_types
@@ -4855,17 +4740,17 @@ module Stripe
             end
 
             class Relationship < ::Stripe::StripeObject
-              # Whether the individual is an authorizer of the Account’s legal entity.
+              # Whether the individual is an authorizer of the Account's identity.
               attr_reader :authorizer
-              # Whether the individual is a director of the Account’s legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
+              # Whether the individual is a director of the Account's identity. Directors are typically members of the governing board of the company or are responsible for making sure that the company meets its regulatory obligations.
               attr_reader :director
               # Whether the individual has significant responsibility to control, manage, or direct the organization.
               attr_reader :executive
-              # Whether the individual is the legal guardian of the Account’s representative.
+              # Whether the individual is the legal guardian of the Account's representative.
               attr_reader :legal_guardian
-              # Whether the individual is an owner of the Account’s legal entity.
+              # Whether the individual is an owner of the Account's identity.
               attr_reader :owner
-              # The percent owned by the individual of the Account’s legal entity.
+              # The percentage of the Account's identity that the individual owns.
               attr_reader :percent_ownership
               # Whether the individual is authorized as the primary representative of the Account. This is the person nominated by the business to provide information about themselves, and general information about the account. There can only be one representative at any given time. At the time the account is created, this person should be set to the person responsible for opening the account.
               attr_reader :representative
@@ -4895,7 +4780,7 @@ module Stripe
                 attr_reader :postal_code
                 # State, county, province, or region.
                 attr_reader :state
-                # Town or cho-me.
+                # Town or district.
                 attr_reader :town
 
                 def self.inner_class_types
@@ -4920,7 +4805,7 @@ module Stripe
                 attr_reader :postal_code
                 # State, county, province, or region.
                 attr_reader :state
-                # Town or cho-me.
+                # Town or district.
                 attr_reader :town
 
                 def self.inner_class_types
@@ -5179,7 +5064,7 @@ module Stripe
                 @field_remappings = {}
               end
             end
-            # Whether the responsibility is with the integrator or with Stripe (to review info, to wait for some condition, etc.) to action the requirement.
+            # Indicates whether the platform or Stripe is currently responsible for taking action on the requirement. Value can be `user` or `stripe`.
             attr_reader :awaiting_action_from
             # Machine-readable string describing the requirement.
             attr_reader :description
@@ -5248,11 +5133,11 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # Filter only accounts that have all of the configurations specified. If omitted, returns all accounts regardless of which configurations they have.
+        # The configurations that have been applied to this account.
         attr_reader :applied_configurations
-        # A value indicating if the Account has been closed.
+        # Indicates whether the account has been closed.
         attr_reader :closed
-        # An Account Configuration which allows the Account to take on a key persona across Stripe products.
+        # An Account represents a company, individual, or other entity that a user interacts with. Accounts store identity information and one or more configurations that enable product-specific capabilities. You can assign configurations at creation or add them later.
         attr_reader :configuration
         # The default contact email address for the Account. Required when configuring the account as a merchant or recipient.
         attr_reader :contact_email
@@ -5260,7 +5145,7 @@ module Stripe
         attr_reader :created
         # A value indicating the Stripe dashboard this Account has access to. This will depend on which configurations are enabled for this account.
         attr_reader :dashboard
-        # Default values to be used on Account Configurations.
+        # Default values for settings shared across Account configurations.
         attr_reader :defaults
         # A descriptive name for the Account. This name will be surfaced in the Stripe Dashboard and on any invoices sent to the Account.
         attr_reader :display_name