stripe 17.0.1 → 19.0.0

data/lib/stripe/resources/account_session.rb

@@ -8,7 +8,7 @@ module Stripe
   # to your user. Do not save AccountSessions to your database as they expire relatively
   # quickly, and cannot be used more than once.
   #
-  # Related guide: [Connect embedded components](https://stripe.com/docs/connect/get-started-connect-embedded-components)
+  # Related guide: [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components)
   class AccountSession < APIResource
     extend Stripe::APIOperations::Create
 
@@ -17,9 +17,9 @@ module Stripe
       "account_session"
     end
 
-    class Components < Stripe::StripeObject
-      class AccountManagement < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+    class Components < ::Stripe::StripeObject
+      class AccountManagement < ::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`.
           attr_reader :disable_stripe_user_authentication
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
@@ -47,8 +47,8 @@ module Stripe
         end
       end
 
-      class AccountOnboarding < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class AccountOnboarding < ::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`.
           attr_reader :disable_stripe_user_authentication
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
@@ -76,15 +76,15 @@ module Stripe
         end
       end
 
-      class Balances < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      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`.
           attr_reader :disable_stripe_user_authentication
           # Whether to allow payout schedule to be changed. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
           attr_reader :edit_payout_schedule
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
           attr_reader :external_account_collection
-          # Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+          # Whether to allow creation of instant payouts. The default value is `enabled` when Stripe is responsible for negative account balances, and `use_dashboard_rules` otherwise.
           attr_reader :instant_payouts
           # Whether to allow creation of standard payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
           attr_reader :standard_payouts
@@ -111,8 +111,8 @@ module Stripe
         end
       end
 
-      class DisputesList < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class DisputesList < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether to allow capturing and cancelling payment intents. This is `true` by default.
           attr_reader :capture_payments
           # Whether connected accounts can manage destination charges that are created on behalf of them. This is `false` by default.
@@ -144,8 +144,8 @@ module Stripe
         end
       end
 
-      class Documents < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class Documents < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -168,8 +168,8 @@ module Stripe
         end
       end
 
-      class FinancialAccount < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class FinancialAccount < ::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`.
           attr_reader :disable_stripe_user_authentication
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
@@ -201,8 +201,8 @@ module Stripe
         end
       end
 
-      class FinancialAccountTransactions < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class FinancialAccountTransactions < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether to allow card spend dispute management features.
           attr_reader :card_spend_dispute_management
 
@@ -228,13 +228,13 @@ module Stripe
         end
       end
 
-      class InstantPayoutsPromotion < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class InstantPayoutsPromotion < ::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`.
           attr_reader :disable_stripe_user_authentication
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
           attr_reader :external_account_collection
-          # Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+          # Whether to allow creation of instant payouts. The default value is `enabled` when Stripe is responsible for negative account balances, and `use_dashboard_rules` otherwise.
           attr_reader :instant_payouts
 
           def self.inner_class_types
@@ -259,8 +259,8 @@ module Stripe
         end
       end
 
-      class IssuingCard < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class IssuingCard < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether to allow card management features.
           attr_reader :card_management
           # Whether to allow card spend dispute management features.
@@ -292,8 +292,8 @@ module Stripe
         end
       end
 
-      class IssuingCardsList < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class IssuingCardsList < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether to allow card management features.
           attr_reader :card_management
           # Whether to allow card spend dispute management features.
@@ -327,8 +327,8 @@ module Stripe
         end
       end
 
-      class NotificationBanner < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class NotificationBanner < ::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`.
           attr_reader :disable_stripe_user_authentication
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
@@ -356,8 +356,8 @@ module Stripe
         end
       end
 
-      class PaymentDetails < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class PaymentDetails < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether to allow capturing and cancelling payment intents. This is `true` by default.
           attr_reader :capture_payments
           # Whether connected accounts can manage destination charges that are created on behalf of them. This is `false` by default.
@@ -389,8 +389,8 @@ module Stripe
         end
       end
 
-      class PaymentDisputes < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class PaymentDisputes < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether connected accounts can manage destination charges that are created on behalf of them. This is `false` by default.
           attr_reader :destination_on_behalf_of_charge_management
           # Whether responding to disputes is enabled, including submitting evidence and accepting disputes. This is `true` by default.
@@ -420,8 +420,8 @@ module Stripe
         end
       end
 
-      class Payments < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class Payments < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           # Whether to allow capturing and cancelling payment intents. This is `true` by default.
           attr_reader :capture_payments
           # Whether connected accounts can manage destination charges that are created on behalf of them. This is `false` by default.
@@ -453,8 +453,8 @@ module Stripe
         end
       end
 
-      class PayoutDetails < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class PayoutDetails < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -477,15 +477,15 @@ module Stripe
         end
       end
 
-      class Payouts < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      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`.
           attr_reader :disable_stripe_user_authentication
           # Whether to allow payout schedule to be changed. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
           attr_reader :edit_payout_schedule
           # Whether external account collection is enabled. This feature can only be `false` for accounts where you’re responsible for collecting updated information when requirements are due or change, like Custom accounts. The default value for this feature is `true`.
           attr_reader :external_account_collection
-          # Whether to allow creation of instant payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
+          # Whether to allow creation of instant payouts. The default value is `enabled` when Stripe is responsible for negative account balances, and `use_dashboard_rules` otherwise.
           attr_reader :instant_payouts
           # Whether to allow creation of standard payouts. Defaults to `true` when `controller.losses.payments` is set to `stripe` for the account, otherwise `false`.
           attr_reader :standard_payouts
@@ -512,8 +512,8 @@ module Stripe
         end
       end
 
-      class PayoutsList < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class PayoutsList < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -536,8 +536,8 @@ module Stripe
         end
       end
 
-      class TaxRegistrations < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class TaxRegistrations < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -560,8 +560,8 @@ module Stripe
         end
       end
 
-      class TaxSettings < Stripe::StripeObject
-        class Features < Stripe::StripeObject
+      class TaxSettings < ::Stripe::StripeObject
+        class Features < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -656,13 +656,13 @@ module Stripe
     #
     # The client secret can be used to provide access to `account` from your frontend. It should not be stored, logged, or exposed to anyone other than the connected account. Make sure that you have TLS enabled on any page that includes the client secret.
     #
-    # Refer to our docs to [setup Connect embedded components](https://stripe.com/docs/connect/get-started-connect-embedded-components) and learn about how `client_secret` should be handled.
+    # Refer to our docs to [setup Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components) and learn about how `client_secret` should be handled.
     attr_reader :client_secret
     # Attribute for field components
     attr_reader :components
     # The timestamp at which this AccountSession will expire.
     attr_reader :expires_at
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/apple_pay_domain.rb

@@ -19,7 +19,7 @@ module Stripe
     attr_reader :domain_name
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/application_fee.rb

@@ -13,7 +13,7 @@ module Stripe
 
     nested_resource_class_methods :refund, operations: %i[create retrieve update list]
 
-    class FeeSource < Stripe::StripeObject
+    class FeeSource < ::Stripe::StripeObject
       # Charge ID that created this application fee.
       attr_reader :charge
       # Payout ID that created this application fee.
@@ -49,7 +49,7 @@ module Stripe
     attr_reader :fee_source
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/application_fee_refund.rb

@@ -6,7 +6,7 @@ module Stripe
   # has previously been created but not yet refunded. Funds will be refunded to
   # the Stripe account from which the fee was originally collected.
   #
-  # Related guide: [Refunding application fees](https://stripe.com/docs/connect/destination-charges#refunding-app-fee)
+  # Related guide: [Refunding application fees](https://docs.stripe.com/connect/destination-charges#refunding-app-fee)
   class ApplicationFeeRefund < APIResource
     include Stripe::APIOperations::Save
 
@@ -27,7 +27,7 @@ module Stripe
     attr_reader :fee
     # Unique identifier for the object.
     attr_reader :id
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/apps/secret.rb

@@ -11,7 +11,7 @@ module Stripe
     #
     # A `user` scoped secret is accessible by the app backend and one specific Dashboard user. Use the `user` scope for per-user secrets like per-user OAuth tokens, where different users might have different permissions.
     #
-    # Related guide: [Store data between page reloads](https://stripe.com/docs/stripe-apps/store-auth-data-custom-objects)
+    # Related guide: [Store data between page reloads](https://docs.stripe.com/stripe-apps/store-auth-data-custom-objects)
     class Secret < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
@@ -21,7 +21,7 @@ module Stripe
         "apps.secret"
       end
 
-      class Scope < Stripe::StripeObject
+      class Scope < ::Stripe::StripeObject
         # The secret scope type.
         attr_reader :type
         # The user ID, if type is set to "user"
@@ -43,7 +43,7 @@ module Stripe
       attr_reader :expires_at
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # A name for the secret that's unique within the scope.
       attr_reader :name

data/lib/stripe/resources/balance.rb

@@ -7,15 +7,15 @@ module Stripe
   #
   # The top-level `available` and `pending` comprise your "payments balance."
   #
-  # Related guide: [Balances and settlement time](https://stripe.com/docs/payments/balances), [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances)
+  # Related guide: [Balances and settlement time](https://docs.stripe.com/payments/balances), [Understanding Connect account balances](https://docs.stripe.com/connect/account-balances)
   class Balance < SingletonAPIResource
     OBJECT_NAME = "balance"
     def self.object_name
       "balance"
     end
 
-    class Available < Stripe::StripeObject
-      class SourceTypes < Stripe::StripeObject
+    class Available < ::Stripe::StripeObject
+      class SourceTypes < ::Stripe::StripeObject
         # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
         attr_reader :bank_account
         # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -47,8 +47,8 @@ module Stripe
       end
     end
 
-    class ConnectReserved < Stripe::StripeObject
-      class SourceTypes < Stripe::StripeObject
+    class ConnectReserved < ::Stripe::StripeObject
+      class SourceTypes < ::Stripe::StripeObject
         # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
         attr_reader :bank_account
         # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -80,9 +80,9 @@ module Stripe
       end
     end
 
-    class InstantAvailable < Stripe::StripeObject
-      class NetAvailable < Stripe::StripeObject
-        class SourceTypes < Stripe::StripeObject
+    class InstantAvailable < ::Stripe::StripeObject
+      class NetAvailable < ::Stripe::StripeObject
+        class SourceTypes < ::Stripe::StripeObject
           # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
           attr_reader :bank_account
           # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -114,7 +114,7 @@ module Stripe
         end
       end
 
-      class SourceTypes < Stripe::StripeObject
+      class SourceTypes < ::Stripe::StripeObject
         # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
         attr_reader :bank_account
         # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -148,9 +148,9 @@ module Stripe
       end
     end
 
-    class Issuing < Stripe::StripeObject
-      class Available < Stripe::StripeObject
-        class SourceTypes < Stripe::StripeObject
+    class Issuing < ::Stripe::StripeObject
+      class Available < ::Stripe::StripeObject
+        class SourceTypes < ::Stripe::StripeObject
           # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
           attr_reader :bank_account
           # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -193,8 +193,8 @@ module Stripe
       end
     end
 
-    class Pending < Stripe::StripeObject
-      class SourceTypes < Stripe::StripeObject
+    class Pending < ::Stripe::StripeObject
+      class SourceTypes < ::Stripe::StripeObject
         # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
         attr_reader :bank_account
         # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -226,9 +226,9 @@ module Stripe
       end
     end
 
-    class RefundAndDisputePrefunding < Stripe::StripeObject
-      class Available < Stripe::StripeObject
-        class SourceTypes < Stripe::StripeObject
+    class RefundAndDisputePrefunding < ::Stripe::StripeObject
+      class Available < ::Stripe::StripeObject
+        class SourceTypes < ::Stripe::StripeObject
           # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
           attr_reader :bank_account
           # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -260,8 +260,8 @@ module Stripe
         end
       end
 
-      class Pending < Stripe::StripeObject
-        class SourceTypes < Stripe::StripeObject
+      class Pending < ::Stripe::StripeObject
+        class SourceTypes < ::Stripe::StripeObject
           # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
           attr_reader :bank_account
           # Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
@@ -305,7 +305,7 @@ module Stripe
         @field_remappings = {}
       end
     end
-    # Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://stripe.com/docs/api#transfers) or [Payouts API](https://stripe.com/docs/api#payouts). You can find the available balance for each currency and payment type in the `source_types` property.
+    # Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://api.stripe.com#transfers) or [Payouts API](https://api.stripe.com#payouts). You can find the available balance for each currency and payment type in the `source_types` property.
     attr_reader :available
     # Funds held due to negative balances on connected accounts where [account.controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts. You can find the connect reserve balance for each currency and payment type in the `source_types` property.
     attr_reader :connect_reserved
@@ -313,7 +313,7 @@ module Stripe
     attr_reader :instant_available
     # Attribute for field issuing
     attr_reader :issuing
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/balance_settings.rb

@@ -11,9 +11,9 @@ module Stripe
       "balance_settings"
     end
 
-    class Payments < Stripe::StripeObject
-      class Payouts < Stripe::StripeObject
-        class Schedule < Stripe::StripeObject
+    class Payments < ::Stripe::StripeObject
+      class Payouts < ::Stripe::StripeObject
+        class Schedule < ::Stripe::StripeObject
           # How frequently funds will be paid out. One of `manual` (payouts only created via API call), `daily`, `weekly`, or `monthly`.
           attr_reader :interval
           # The day of the month funds will be paid out. Only shown if `interval` is monthly. Payouts scheduled between the 29th and 31st of the month are sent on the last day of shorter months.
@@ -31,7 +31,7 @@ module Stripe
         end
         # The minimum balance amount to retain per currency after automatic payouts. Only funds that exceed these amounts are paid out. Learn more about the [minimum balances for automatic payouts](/payouts/minimum-balances-for-automatic-payouts).
         attr_reader :minimum_balance_by_currency
-        # Details on when funds from charges are available, and when they are paid out to an external account. See our [Setting Bank and Debit Card Payouts](https://stripe.com/docs/connect/bank-transfers#payout-information) documentation for details.
+        # Details on when funds from charges are available, and when they are paid out to an external account. See our [Setting Bank and Debit Card Payouts](https://docs.stripe.com/connect/bank-transfers#payout-information) documentation for details.
         attr_reader :schedule
         # The text that appears on the bank account statement for payouts. If not set, this defaults to the platform's bank descriptor as set in the Dashboard.
         attr_reader :statement_descriptor
@@ -47,7 +47,7 @@ module Stripe
         end
       end
 
-      class SettlementTiming < Stripe::StripeObject
+      class SettlementTiming < ::Stripe::StripeObject
         # The number of days charge funds are held before becoming available.
         attr_reader :delay_days
         # The number of days charge funds are held before becoming available. If present, overrides the default, or minimum available, for the account.

data/lib/stripe/resources/balance_transaction.rb

@@ -5,7 +5,7 @@ module Stripe
   # Balance transactions represent funds moving through your Stripe account.
   # Stripe creates them for every type of transaction that enters or leaves your Stripe account balance.
   #
-  # Related guide: [Balance transaction types](https://stripe.com/docs/reports/balance-transaction-types)
+  # Related guide: [Balance transaction types](https://docs.stripe.com/reports/balance-transaction-types)
   class BalanceTransaction < APIResource
     extend Stripe::APIOperations::List
 
@@ -14,7 +14,7 @@ module Stripe
       "balance_transaction"
     end
 
-    class FeeDetail < Stripe::StripeObject
+    class FeeDetail < ::Stripe::StripeObject
       # Amount of the fee, in cents.
       attr_reader :amount
       # ID of the Connect application that earned the fee.
@@ -64,7 +64,7 @@ module Stripe
     attr_reader :source
     # The transaction's net funds status in the Stripe balance, which are either `available` or `pending`.
     attr_reader :status
-    # Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `stripe_balance_payment_debit`, `stripe_balance_payment_debit_reversal`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
+    # Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `reserve_hold`, `reserve_release`, `stripe_fee`, `stripe_fx_fee`, `stripe_balance_payment_debit`, `stripe_balance_payment_debit_reversal`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
     attr_reader :type
 
     # Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.

data/lib/stripe/resources/bank_account.rb

@@ -19,8 +19,8 @@ module Stripe
       "bank_account"
     end
 
-    class FutureRequirements < Stripe::StripeObject
-      class Error < Stripe::StripeObject
+    class FutureRequirements < ::Stripe::StripeObject
+      class Error < ::Stripe::StripeObject
         # The code for the type of error.
         attr_reader :code
         # An informative message that indicates the error type and provides additional details about the error.
@@ -36,13 +36,13 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Fields that need to be collected to keep the external account enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the account is disabled.
+      # Fields that need to be resolved to keep the external account enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled.
       attr_reader :currently_due
-      # Fields that are `currently_due` and need to be collected again because validation or verification failed.
+      # Details about validation and verification failures for `due` requirements that must be resolved.
       attr_reader :errors
-      # Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the external account.
+      # Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the external account.
       attr_reader :past_due
-      # Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
+      # Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending.
       attr_reader :pending_verification
 
       def self.inner_class_types
@@ -54,8 +54,8 @@ module Stripe
       end
     end
 
-    class Requirements < Stripe::StripeObject
-      class Error < Stripe::StripeObject
+    class Requirements < ::Stripe::StripeObject
+      class Error < ::Stripe::StripeObject
         # The code for the type of error.
         attr_reader :code
         # An informative message that indicates the error type and provides additional details about the error.
@@ -71,13 +71,13 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Fields that need to be collected to keep the external account enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the account is disabled.
+      # Fields that need to be resolved to keep the external account enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled.
       attr_reader :currently_due
-      # Fields that are `currently_due` and need to be collected again because validation or verification failed.
+      # Details about validation and verification failures for `due` requirements that must be resolved.
       attr_reader :errors
-      # Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the external account.
+      # Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the external account.
       attr_reader :past_due
-      # Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
+      # Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending.
       attr_reader :pending_verification
 
       def self.inner_class_types
@@ -110,13 +110,13 @@ module Stripe
     attr_reader :default_for_currency
     # Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
     attr_reader :fingerprint
-    # Information about the [upcoming new requirements for the bank account](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when.
+    # Information about the [upcoming new requirements for the bank account](https://docs.stripe.com/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when.
     attr_reader :future_requirements
     # Unique identifier for the object.
     attr_reader :id
     # The last four digits of the bank account number.
     attr_reader :last4
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
@@ -124,9 +124,9 @@ module Stripe
     attr_reader :requirements
     # The routing transit number for the bank account.
     attr_reader :routing_number
-    # For bank accounts, possible values are `new`, `validated`, `verified`, `verification_failed`, or `errored`. A bank account that hasn't had any activity or validation performed is `new`. If Stripe can determine that the bank account exists, its status will be `validated`. Note that there often isn’t enough information to know (e.g., for smaller credit unions), and the validation is not always run. If customer bank account verification has succeeded, the bank account status will be `verified`. If the verification failed for any reason, such as microdeposit failure, the status will be `verification_failed`. If a payout sent to this bank account fails, we'll set the status to `errored` and will not continue to send [scheduled payouts](https://stripe.com/docs/payouts#payout-schedule) until the bank details are updated.
+    # For bank accounts, possible values are `new`, `validated`, `verified`, `verification_failed`, `tokenized_account_number_deactivated` or `errored`. A bank account that hasn't had any activity or validation performed is `new`. If Stripe can determine that the bank account exists, its status will be `validated`. Note that there often isn’t enough information to know (e.g., for smaller credit unions), and the validation is not always run. If customer bank account verification has succeeded, the bank account status will be `verified`. If the verification failed for any reason, such as microdeposit failure, the status will be `verification_failed`. If the status is `tokenized_account_number_deactivated`, the account utilizes a tokenized account number which has been deactivated due to expiration or revocation. This account will need to be reverified to continue using it for money movement. If a payout sent to this bank account fails, we'll set the status to `errored` and will not continue to send [scheduled payouts](https://stripe.com/docs/payouts#payout-schedule) until the bank details are updated.
     #
-    # For external accounts, possible values are `new`, `errored` and `verification_failed`. If a payout fails, the status is set to `errored` and scheduled payouts are stopped until account details are updated. In the US and India, if we can't [verify the owner of the bank account](https://support.stripe.com/questions/bank-account-ownership-verification), we'll set the status to `verification_failed`. Other validations aren't run against external accounts because they're only used for payouts. This means the other statuses don't apply.
+    # For external accounts, possible values are `new`, `errored`, `verification_failed`, and `tokenized_account_number_deactivated`. If a payout fails, the status is set to `errored` and scheduled payouts are stopped until account details are updated. In the US and India, if we can't [verify the owner of the bank account](https://support.stripe.com/questions/bank-account-ownership-verification), we'll set the status to `verification_failed`. Other validations aren't run against external accounts because they're only used for payouts. This means the other statuses don't apply.
     attr_reader :status
     # Always true for a deleted object
     attr_reader :deleted

data/lib/stripe/resources/billing/alert.rb

@@ -13,8 +13,8 @@ module Stripe
         "billing.alert"
       end
 
-      class UsageThreshold < Stripe::StripeObject
-        class Filter < Stripe::StripeObject
+      class UsageThreshold < ::Stripe::StripeObject
+        class Filter < ::Stripe::StripeObject
           # Limit the scope of the alert to this customer ID
           attr_reader :customer
           # Attribute for field type
@@ -49,7 +49,7 @@ module Stripe
       attr_reader :alert_type
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
@@ -57,7 +57,7 @@ module Stripe
       attr_reader :status
       # Title of the alert.
       attr_reader :title
-      # Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://stripe.com/docs/api/billing/meter).
+      # Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://docs.stripe.com/api/billing/meter).
       attr_reader :usage_threshold
 
       # Reactivates this alert, allowing it to trigger again.