stripe 15.1.0 → 15.2.0

data/rbi/stripe/resources/account_session.rbi

@@ -69,6 +69,28 @@ module Stripe
         sig { returns(Features) }
         attr_reader :features
       end
+      class DisputesList < Stripe::StripeObject
+        class Features < Stripe::StripeObject
+          # Whether to allow capturing and cancelling payment intents. This is `true` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :capture_payments
+          # Whether to allow connected accounts to manage destination charges that are created on behalf of them. This is `false` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :destination_on_behalf_of_charge_management
+          # Whether to allow responding to disputes, including submitting evidence and accepting disputes. This is `true` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :dispute_management
+          # Whether to allow sending refunds. This is `true` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :refund_management
+        end
+        # Whether the embedded component is enabled.
+        sig { returns(T::Boolean) }
+        attr_reader :enabled
+        # Attribute for field features
+        sig { returns(Features) }
+        attr_reader :features
+      end
       class Documents < Stripe::StripeObject
         class Features < Stripe::StripeObject; end
         # Whether the embedded component is enabled.
@@ -198,6 +220,25 @@ module Stripe
         sig { returns(Features) }
         attr_reader :features
       end
+      class PaymentDisputes < Stripe::StripeObject
+        class Features < Stripe::StripeObject
+          # Whether to allow connected accounts to manage destination charges that are created on behalf of them. This is `false` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :destination_on_behalf_of_charge_management
+          # Whether to allow responding to disputes, including submitting evidence and accepting disputes. This is `true` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :dispute_management
+          # Whether to allow sending refunds. This is `true` by default.
+          sig { returns(T::Boolean) }
+          attr_reader :refund_management
+        end
+        # Whether the embedded component is enabled.
+        sig { returns(T::Boolean) }
+        attr_reader :enabled
+        # Attribute for field features
+        sig { returns(Features) }
+        attr_reader :features
+      end
       class Payments < Stripe::StripeObject
         class Features < Stripe::StripeObject
           # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -281,6 +322,9 @@ module Stripe
       # Attribute for field balances
       sig { returns(Balances) }
       attr_reader :balances
+      # Attribute for field disputes_list
+      sig { returns(DisputesList) }
+      attr_reader :disputes_list
       # Attribute for field documents
       sig { returns(Documents) }
       attr_reader :documents
@@ -302,6 +346,9 @@ module Stripe
       # Attribute for field payment_details
       sig { returns(PaymentDetails) }
       attr_reader :payment_details
+      # Attribute for field payment_disputes
+      sig { returns(PaymentDisputes) }
+      attr_reader :payment_disputes
       # Attribute for field payments
       sig { returns(Payments) }
       attr_reader :payments
@@ -441,14 +488,49 @@ module Stripe
            }
           def initialize(enabled: nil, features: nil); end
         end
-        class Documents < Stripe::RequestParams
+        class DisputesList < Stripe::RequestParams
           class Features < Stripe::RequestParams
-
+            # Whether to allow capturing and cancelling payment intents. This is `true` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :capture_payments
+            # Whether to allow connected accounts to manage destination charges that are created on behalf of them. This is `false` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :destination_on_behalf_of_charge_management
+            # Whether to allow responding to disputes, including submitting evidence and accepting disputes. This is `true` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :dispute_management
+            # Whether to allow sending refunds. This is `true` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :refund_management
+            sig {
+              params(capture_payments: T.nilable(T::Boolean), destination_on_behalf_of_charge_management: T.nilable(T::Boolean), dispute_management: T.nilable(T::Boolean), refund_management: T.nilable(T::Boolean)).void
+             }
+            def initialize(
+              capture_payments: nil,
+              destination_on_behalf_of_charge_management: nil,
+              dispute_management: nil,
+              refund_management: nil
+            ); end
           end
           # Whether the embedded component is enabled.
           sig { returns(T::Boolean) }
           attr_accessor :enabled
           # The list of features enabled in the embedded component.
+          sig {
+            returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::DisputesList::Features))
+           }
+          attr_accessor :features
+          sig {
+            params(enabled: T::Boolean, features: T.nilable(::Stripe::AccountSession::CreateParams::Components::DisputesList::Features)).void
+           }
+          def initialize(enabled: nil, features: nil); end
+        end
+        class Documents < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          sig { returns(T::Boolean) }
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
           sig {
             returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::Documents::Features))
            }
@@ -660,6 +742,39 @@ module Stripe
            }
           def initialize(enabled: nil, features: nil); end
         end
+        class PaymentDisputes < Stripe::RequestParams
+          class Features < Stripe::RequestParams
+            # Whether to allow connected accounts to manage destination charges that are created on behalf of them. This is `false` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :destination_on_behalf_of_charge_management
+            # Whether to allow responding to disputes, including submitting evidence and accepting disputes. This is `true` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :dispute_management
+            # Whether to allow sending refunds. This is `true` by default.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :refund_management
+            sig {
+              params(destination_on_behalf_of_charge_management: T.nilable(T::Boolean), dispute_management: T.nilable(T::Boolean), refund_management: T.nilable(T::Boolean)).void
+             }
+            def initialize(
+              destination_on_behalf_of_charge_management: nil,
+              dispute_management: nil,
+              refund_management: nil
+            ); end
+          end
+          # Whether the embedded component is enabled.
+          sig { returns(T::Boolean) }
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          sig {
+            returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDisputes::Features))
+           }
+          attr_accessor :features
+          sig {
+            params(enabled: T::Boolean, features: T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDisputes::Features)).void
+           }
+          def initialize(enabled: nil, features: nil); end
+        end
         class Payments < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -739,9 +854,7 @@ module Stripe
           def initialize(enabled: nil, features: nil); end
         end
         class PayoutsList < Stripe::RequestParams
-          class Features < Stripe::RequestParams
-
-          end
+          class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           sig { returns(T::Boolean) }
           attr_accessor :enabled
@@ -756,9 +869,7 @@ module Stripe
           def initialize(enabled: nil, features: nil); end
         end
         class TaxRegistrations < Stripe::RequestParams
-          class Features < Stripe::RequestParams
-
-          end
+          class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           sig { returns(T::Boolean) }
           attr_accessor :enabled
@@ -773,9 +884,7 @@ module Stripe
           def initialize(enabled: nil, features: nil); end
         end
         class TaxSettings < Stripe::RequestParams
-          class Features < Stripe::RequestParams
-
-          end
+          class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           sig { returns(T::Boolean) }
           attr_accessor :enabled
@@ -802,6 +911,9 @@ module Stripe
         # Configuration for the balances embedded component.
         sig { returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::Balances)) }
         attr_accessor :balances
+        # Configuration for the disputes list embedded component.
+        sig { returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::DisputesList)) }
+        attr_accessor :disputes_list
         # Configuration for the documents embedded component.
         sig { returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::Documents)) }
         attr_accessor :documents
@@ -833,6 +945,11 @@ module Stripe
           returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDetails))
          }
         attr_accessor :payment_details
+        # Configuration for the payment disputes embedded component.
+        sig {
+          returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDisputes))
+         }
+        attr_accessor :payment_disputes
         # Configuration for the payments embedded component.
         sig { returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::Payments)) }
         attr_accessor :payments
@@ -851,12 +968,13 @@ module Stripe
         sig { returns(T.nilable(::Stripe::AccountSession::CreateParams::Components::TaxSettings)) }
         attr_accessor :tax_settings
         sig {
-          params(account_management: T.nilable(::Stripe::AccountSession::CreateParams::Components::AccountManagement), account_onboarding: T.nilable(::Stripe::AccountSession::CreateParams::Components::AccountOnboarding), balances: T.nilable(::Stripe::AccountSession::CreateParams::Components::Balances), documents: T.nilable(::Stripe::AccountSession::CreateParams::Components::Documents), financial_account: T.nilable(::Stripe::AccountSession::CreateParams::Components::FinancialAccount), financial_account_transactions: T.nilable(::Stripe::AccountSession::CreateParams::Components::FinancialAccountTransactions), issuing_card: T.nilable(::Stripe::AccountSession::CreateParams::Components::IssuingCard), issuing_cards_list: T.nilable(::Stripe::AccountSession::CreateParams::Components::IssuingCardsList), notification_banner: T.nilable(::Stripe::AccountSession::CreateParams::Components::NotificationBanner), payment_details: T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDetails), payments: T.nilable(::Stripe::AccountSession::CreateParams::Components::Payments), payouts: T.nilable(::Stripe::AccountSession::CreateParams::Components::Payouts), payouts_list: T.nilable(::Stripe::AccountSession::CreateParams::Components::PayoutsList), tax_registrations: T.nilable(::Stripe::AccountSession::CreateParams::Components::TaxRegistrations), tax_settings: T.nilable(::Stripe::AccountSession::CreateParams::Components::TaxSettings)).void
+          params(account_management: T.nilable(::Stripe::AccountSession::CreateParams::Components::AccountManagement), account_onboarding: T.nilable(::Stripe::AccountSession::CreateParams::Components::AccountOnboarding), balances: T.nilable(::Stripe::AccountSession::CreateParams::Components::Balances), disputes_list: T.nilable(::Stripe::AccountSession::CreateParams::Components::DisputesList), documents: T.nilable(::Stripe::AccountSession::CreateParams::Components::Documents), financial_account: T.nilable(::Stripe::AccountSession::CreateParams::Components::FinancialAccount), financial_account_transactions: T.nilable(::Stripe::AccountSession::CreateParams::Components::FinancialAccountTransactions), issuing_card: T.nilable(::Stripe::AccountSession::CreateParams::Components::IssuingCard), issuing_cards_list: T.nilable(::Stripe::AccountSession::CreateParams::Components::IssuingCardsList), notification_banner: T.nilable(::Stripe::AccountSession::CreateParams::Components::NotificationBanner), payment_details: T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDetails), payment_disputes: T.nilable(::Stripe::AccountSession::CreateParams::Components::PaymentDisputes), payments: T.nilable(::Stripe::AccountSession::CreateParams::Components::Payments), payouts: T.nilable(::Stripe::AccountSession::CreateParams::Components::Payouts), payouts_list: T.nilable(::Stripe::AccountSession::CreateParams::Components::PayoutsList), tax_registrations: T.nilable(::Stripe::AccountSession::CreateParams::Components::TaxRegistrations), tax_settings: T.nilable(::Stripe::AccountSession::CreateParams::Components::TaxSettings)).void
          }
         def initialize(
           account_management: nil,
           account_onboarding: nil,
           balances: nil,
+          disputes_list: nil,
           documents: nil,
           financial_account: nil,
           financial_account_transactions: nil,
@@ -864,6 +982,7 @@ module Stripe
           issuing_cards_list: nil,
           notification_banner: nil,
           payment_details: nil,
+          payment_disputes: nil,
           payments: nil,
           payouts: nil,
           payouts_list: nil,

data/rbi/stripe/resources/apple_pay_domain.rbi

@@ -23,9 +23,7 @@ module Stripe
     # Always true for a deleted object
     sig { returns(T::Boolean) }
     attr_reader :deleted
-    class DeleteParams < Stripe::RequestParams
-
-    end
+    class DeleteParams < Stripe::RequestParams; end
     class ListParams < Stripe::RequestParams
       # Attribute for param field domain_name
       sig { returns(T.nilable(String)) }

data/rbi/stripe/resources/balance.rbi

@@ -155,6 +155,58 @@ module Stripe
       sig { returns(SourceTypes) }
       attr_reader :source_types
     end
+    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).
+          sig { returns(Integer) }
+          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).
+          sig { returns(Integer) }
+          attr_reader :card
+          # Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
+          sig { returns(Integer) }
+          attr_reader :fpx
+        end
+        # Balance amount.
+        sig { returns(Integer) }
+        attr_reader :amount
+        # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+        sig { returns(String) }
+        attr_reader :currency
+        # Attribute for field source_types
+        sig { returns(SourceTypes) }
+        attr_reader :source_types
+      end
+      class Pending < Stripe::StripeObject
+        class SourceTypes < Stripe::StripeObject
+          # Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
+          sig { returns(Integer) }
+          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).
+          sig { returns(Integer) }
+          attr_reader :card
+          # Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
+          sig { returns(Integer) }
+          attr_reader :fpx
+        end
+        # Balance amount.
+        sig { returns(Integer) }
+        attr_reader :amount
+        # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+        sig { returns(String) }
+        attr_reader :currency
+        # Attribute for field source_types
+        sig { returns(SourceTypes) }
+        attr_reader :source_types
+      end
+      # Funds that are available for use.
+      sig { returns(T::Array[Available]) }
+      attr_reader :available
+      # Funds that are pending
+      sig { returns(T::Array[Pending]) }
+      attr_reader :pending
+    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.
     sig { returns(T::Array[Available]) }
     attr_reader :available
@@ -176,5 +228,8 @@ module Stripe
     # Funds that aren't available in the balance yet. You can find the pending balance for each currency and each payment type in the `source_types` property.
     sig { returns(T::Array[Pending]) }
     attr_reader :pending
+    # Attribute for field refund_and_dispute_prefunding
+    sig { returns(RefundAndDisputePrefunding) }
+    attr_reader :refund_and_dispute_prefunding
   end
 end

data/rbi/stripe/resources/balance_transaction.rbi

@@ -31,6 +31,9 @@ module Stripe
     # The date that the transaction's net funds become available in the Stripe balance.
     sig { returns(Integer) }
     attr_reader :available_on
+    # The balance that this transaction impacts.
+    sig { returns(String) }
+    attr_reader :balance_type
     # Time at which the object was created. Measured in seconds since the Unix epoch.
     sig { returns(Integer) }
     attr_reader :created

data/rbi/stripe/resources/bank_account.rbi

@@ -5,11 +5,11 @@
 module Stripe
   # These bank accounts are payment methods on `Customer` objects.
   #
-  # On the other hand [External Accounts](https://stripe.com/api#external_accounts) are transfer
+  # On the other hand [External Accounts](https://docs.stripe.com/api#external_accounts) are transfer
   # destinations on `Account` objects for connected accounts.
   # They can be bank accounts or debit cards as well, and are documented in the links above.
   #
-  # Related guide: [Bank debits and transfers](https://stripe.com/payments/bank-debits-transfers)
+  # Related guide: [Bank debits and transfers](https://docs.stripe.com/payments/bank-debits-transfers)
   class BankAccount < APIResource
     class FutureRequirements < Stripe::StripeObject
       class Error < Stripe::StripeObject

data/rbi/stripe/resources/billing/alert.rbi

@@ -101,13 +101,13 @@ module Stripe
           sig { returns(Integer) }
           attr_accessor :gte
           # The [Billing Meter](/api/billing/meter) ID whose usage is monitored.
-          sig { returns(T.nilable(String)) }
+          sig { returns(String) }
           attr_accessor :meter
           # Whether the alert should only fire only once, or once per billing cycle.
           sig { returns(String) }
           attr_accessor :recurrence
           sig {
-            params(filters: T.nilable(T::Array[::Stripe::Billing::Alert::CreateParams::UsageThreshold::Filter]), gte: Integer, meter: T.nilable(String), recurrence: String).void
+            params(filters: T.nilable(T::Array[::Stripe::Billing::Alert::CreateParams::UsageThreshold::Filter]), gte: Integer, meter: String, recurrence: String).void
            }
           def initialize(filters: nil, gte: nil, meter: nil, recurrence: nil); end
         end

data/rbi/stripe/resources/billing_portal/session.rbi

@@ -17,7 +17,7 @@ module Stripe
     # Create sessions on-demand when customers intend to manage their subscriptions
     # and billing details.
     #
-    # Related guide: [Customer management](https://stripe.com/customer-management)
+    # Related guide: [Customer management](https://docs.stripe.com/customer-management)
     class Session < APIResource
       class Flow < Stripe::StripeObject
         class AfterCompletion < Stripe::StripeObject

data/rbi/stripe/resources/capability.rbi

@@ -75,7 +75,7 @@ module Stripe
       # Fields that are due and can be satisfied by providing the corresponding alternative fields instead.
       sig { returns(T.nilable(T::Array[Alternative])) }
       attr_reader :alternatives
-      # Date by which the fields in `currently_due` must be collected to keep the capability enabled for the account. These fields may disable the capability sooner if the next threshold is reached before they are collected.
+      # The date by which all required account information must be both submitted and verified. This includes fields listed in `currently_due` as well as those in `pending_verification`. If any required information is missing or unverified by this date, the account may be disabled. Note that `current_deadline` may change if additional `currently_due` requirements are requested.
       sig { returns(T.nilable(Integer)) }
       attr_reader :current_deadline
       # Fields that need to be collected to keep the capability enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the capability is disabled.

data/rbi/stripe/resources/charge.rbi

@@ -192,6 +192,12 @@ module Stripe
         attr_reader :transit_number
       end
       class Affirm < Stripe::StripeObject
+        # ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+        sig { returns(String) }
+        attr_reader :location
+        # ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+        sig { returns(String) }
+        attr_reader :reader
         # The Affirm transaction ID associated with this payment.
         sig { returns(T.nilable(String)) }
         attr_reader :transaction_id
@@ -1236,6 +1242,12 @@ module Stripe
         # Uniquely identifies this particular WeChat Pay account. You can use this attribute to check whether two WeChat accounts are the same.
         sig { returns(T.nilable(String)) }
         attr_reader :fingerprint
+        # ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+        sig { returns(String) }
+        attr_reader :location
+        # ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+        sig { returns(String) }
+        attr_reader :reader
         # Transaction ID of this particular WeChat Pay transaction.
         sig { returns(T.nilable(String)) }
         attr_reader :transaction_id
@@ -2006,9 +2018,9 @@ module Stripe
     end
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     sig {
       params(params: T.any(::Stripe::Charge::CaptureParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Charge)
      }
@@ -2016,15 +2028,15 @@ module Stripe
 
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     sig {
       params(charge: String, params: T.any(::Stripe::Charge::CaptureParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Charge)
      }
     def self.capture(charge, params = {}, opts = {}); end
 
-    # This method is no longer recommended—use the [Payment Intents API](https://stripe.com/docs/api/payment_intents)
+    # This method is no longer recommended—use the [Payment Intents API](https://docs.stripe.com/docs/api/payment_intents)
     # to initiate a new payment instead. Confirmation of the PaymentIntent creates the Charge
     # object used to request payment.
     sig {

data/rbi/stripe/resources/checkout/session.rbi

@@ -779,6 +779,15 @@ module Stripe
           # Controls when the funds will be captured from the customer's account.
           sig { returns(String) }
           attr_reader :capture_method
+          # Indicates that you intend to make future payments with this PaymentIntent's payment method.
+          #
+          # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+          #
+          # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+          #
+          # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
+          sig { returns(String) }
+          attr_reader :setup_future_usage
         end
         class Oxxo < Stripe::StripeObject
           # The number of calendar days before an OXXO invoice expires. For example, if you create an OXXO invoice on Monday and you set expires_after_days to 2, the OXXO invoice will expire on Wednesday at 23:59 America/Mexico_City time.
@@ -1377,7 +1386,7 @@ module Stripe
       # specified on Checkout Sessions in `payment` mode. If blank or `auto`, `pay` is used.
       sig { returns(T.nilable(String)) }
       attr_reader :submit_type
-      # The ID of the subscription for Checkout Sessions in `subscription` mode.
+      # The ID of the [Subscription](https://stripe.com/docs/api/subscriptions) for Checkout Sessions in `subscription` mode.
       sig { returns(T.nilable(T.any(String, Stripe::Subscription))) }
       attr_reader :subscription
       # The URL the customer will be directed to after the payment or
@@ -2710,9 +2719,7 @@ module Stripe
              }
             def initialize(setup_future_usage: nil, tos_shown_and_accepted: nil); end
           end
-          class PayByBank < Stripe::RequestParams
-
-          end
+          class PayByBank < Stripe::RequestParams; end
           class Payco < Stripe::RequestParams
             # Controls when the funds will be captured from the customer's account.
             sig { returns(T.nilable(String)) }
@@ -3173,13 +3180,20 @@ module Stripe
           # Uses the `allow_redisplay` value of each saved payment method to filter the set presented to a returning customer. By default, only saved payment methods with ’allow_redisplay: ‘always’ are shown in Checkout.
           sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allow_redisplay_filters
+          # Enable customers to choose if they wish to remove their saved payment methods. Disabled by default.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :payment_method_remove
           # Enable customers to choose if they wish to save their payment method for future use. Disabled by default.
           sig { returns(T.nilable(String)) }
           attr_accessor :payment_method_save
           sig {
-            params(allow_redisplay_filters: T.nilable(T::Array[String]), payment_method_save: T.nilable(String)).void
+            params(allow_redisplay_filters: T.nilable(T::Array[String]), payment_method_remove: T.nilable(String), payment_method_save: T.nilable(String)).void
            }
-          def initialize(allow_redisplay_filters: nil, payment_method_save: nil); end
+          def initialize(
+            allow_redisplay_filters: nil,
+            payment_method_remove: nil,
+            payment_method_save: nil
+          ); end
         end
         class SetupIntentData < Stripe::RequestParams
           # An arbitrary string attached to the object. Often useful for displaying to users.
@@ -3979,6 +3993,8 @@ module Stripe
       def self.list_line_items(session, params = {}, opts = {}); end
 
       # Updates a Checkout Session object.
+      #
+      # Related guide: [Dynamically update Checkout](https://docs.stripe.com/payments/checkout/dynamic-updates)
       sig {
         params(session: String, params: T.any(::Stripe::Checkout::Session::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Checkout::Session)
        }