stripe 17.0.1 → 19.0.0

data/lib/stripe/resources/payment_intent.rb

@@ -8,14 +8,15 @@ module Stripe
   # see the history of payment attempts for a particular session.
   #
   # A PaymentIntent transitions through
-  # [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses)
+  # [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle)
   # throughout its lifetime as it interfaces with Stripe.js to perform
   # authentication flows and ultimately creates at most one successful charge.
   #
-  # Related guide: [Payment Intents API](https://stripe.com/docs/payments/payment-intents)
+  # Related guide: [Payment Intents API](https://docs.stripe.com/payments/payment-intents)
   class PaymentIntent < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::NestedResource
     extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
 
@@ -24,8 +25,57 @@ module Stripe
       "payment_intent"
     end
 
-    class AmountDetails < Stripe::StripeObject
-      class Tip < Stripe::StripeObject
+    nested_resource_class_methods :amount_details_line_item, operations: %i[list]
+
+    class AmountDetails < ::Stripe::StripeObject
+      class Error < ::Stripe::StripeObject
+        # The code of the error that occurred when validating the current amount details.
+        attr_reader :code
+        # A message providing more details about the error.
+        attr_reader :message
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Shipping < ::Stripe::StripeObject
+        # If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0.
+        attr_reader :amount
+        # If a physical good is being shipped, the postal code of where it is being shipped from. At most 10 alphanumeric characters long, hyphens are allowed.
+        attr_reader :from_postal_code
+        # If a physical good is being shipped, the postal code of where it is being shipped to. At most 10 alphanumeric characters long, hyphens are allowed.
+        attr_reader :to_postal_code
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Tax < ::Stripe::StripeObject
+        # The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0.
+        #
+        # This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field.
+        attr_reader :total_tax_amount
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Tip < ::Stripe::StripeObject
         # Portion of the amount that corresponds to a tip.
         attr_reader :amount
 
@@ -37,11 +87,23 @@ module Stripe
           @field_remappings = {}
         end
       end
+      # The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0.
+      #
+      # This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field.
+      attr_reader :discount_amount
+      # Attribute for field error
+      attr_reader :error
+      # A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items.
+      attr_reader :line_items
+      # Attribute for field shipping
+      attr_reader :shipping
+      # Attribute for field tax
+      attr_reader :tax
       # Attribute for field tip
       attr_reader :tip
 
       def self.inner_class_types
-        @inner_class_types = { tip: Tip }
+        @inner_class_types = { error: Error, shipping: Shipping, tax: Tax, tip: Tip }
       end
 
       def self.field_remappings
@@ -49,10 +111,10 @@ module Stripe
       end
     end
 
-    class AutomaticPaymentMethods < Stripe::StripeObject
+    class AutomaticPaymentMethods < ::Stripe::StripeObject
       # Controls whether this PaymentIntent will accept redirect-based payment methods.
       #
-      # Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://stripe.com/docs/api/payment_intents/confirm) this PaymentIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the payment.
+      # Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://docs.stripe.com/api/payment_intents/confirm) this PaymentIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the payment.
       attr_reader :allow_redirects
       # Automatically calculates compatible payment methods
       attr_reader :enabled
@@ -66,16 +128,53 @@ module Stripe
       end
     end
 
-    class LastPaymentError < Stripe::StripeObject
-      # For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines) if they provide one.
+    class Hooks < ::Stripe::StripeObject
+      class Inputs < ::Stripe::StripeObject
+        class Tax < ::Stripe::StripeObject
+          # The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id
+          attr_reader :calculation
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field tax
+        attr_reader :tax
+
+        def self.inner_class_types
+          @inner_class_types = { tax: Tax }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field inputs
+      attr_reader :inputs
+
+      def self.inner_class_types
+        @inner_class_types = { inputs: Inputs }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class LastPaymentError < ::Stripe::StripeObject
+      # For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one.
       attr_reader :advice_code
       # For card errors, the ID of the failed charge.
       attr_reader :charge
-      # For some errors that could be handled programmatically, a short string indicating the [error code](https://stripe.com/docs/error-codes) reported.
+      # For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.
       attr_reader :code
-      # For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://stripe.com/docs/declines#issuer-declines) if they provide one.
+      # For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one.
       attr_reader :decline_code
-      # A URL to more information about the [error code](https://stripe.com/docs/error-codes) reported.
+      # A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
       attr_reader :doc_url
       # A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
       attr_reader :message
@@ -91,17 +190,17 @@ module Stripe
       # see the history of payment attempts for a particular session.
       #
       # A PaymentIntent transitions through
-      # [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses)
+      # [multiple statuses](/payments/paymentintents/lifecycle)
       # throughout its lifetime as it interfaces with Stripe.js to perform
       # authentication flows and ultimately creates at most one successful charge.
       #
-      # Related guide: [Payment Intents API](https://stripe.com/docs/payments/payment-intents)
+      # Related guide: [Payment Intents API](https://docs.stripe.com/payments/payment-intents)
       attr_reader :payment_intent
       # PaymentMethod objects represent your customer's payment instruments.
-      # You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to
+      # You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to
       # Customer objects to store instrument details for future payments.
       #
-      # Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios).
+      # Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios).
       attr_reader :payment_method
       # If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
       attr_reader :payment_method_type
@@ -109,7 +208,7 @@ module Stripe
       attr_reader :request_log_url
       # A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments.
       # For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment.
-      # Later, you can use [PaymentIntents](https://stripe.com/docs/api#payment_intents) to drive the payment flow.
+      # Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) to drive the payment flow.
       #
       # Create a SetupIntent when you're ready to collect your customer's payment credentials.
       # Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid.
@@ -120,9 +219,9 @@ module Stripe
       # For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through
       # [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection
       # to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents).
-      # If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer),
+      # If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer),
       # it automatically attaches the resulting payment method to that Customer after successful setup.
-      # We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on
+      # We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) on
       # PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
       #
       # By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
@@ -143,8 +242,8 @@ module Stripe
       end
     end
 
-    class NextAction < Stripe::StripeObject
-      class AlipayHandleRedirect < Stripe::StripeObject
+    class NextAction < ::Stripe::StripeObject
+      class AlipayHandleRedirect < ::Stripe::StripeObject
         # The native data to be used with Alipay SDK you must redirect your customer to in order to authenticate the payment in an Android App.
         attr_reader :native_data
         # The native URL you must redirect your customer to in order to authenticate the payment in an iOS App.
@@ -163,7 +262,7 @@ module Stripe
         end
       end
 
-      class BoletoDisplayDetails < Stripe::StripeObject
+      class BoletoDisplayDetails < ::Stripe::StripeObject
         # The timestamp after which the boleto expires.
         attr_reader :expires_at
         # The URL to the hosted boleto voucher page, which allows customers to view the boleto voucher.
@@ -182,7 +281,7 @@ module Stripe
         end
       end
 
-      class CardAwaitNotification < Stripe::StripeObject
+      class CardAwaitNotification < ::Stripe::StripeObject
         # The time that payment will be attempted. If customer approval is required, they need to provide approval before this time.
         attr_reader :charge_attempt_at
         # For payments greater than INR 15000, the customer must provide explicit approval of the payment with their bank. For payments of lower amount, no customer action is required.
@@ -197,8 +296,8 @@ module Stripe
         end
       end
 
-      class CashappHandleRedirectOrDisplayQrCode < Stripe::StripeObject
-        class QrCode < Stripe::StripeObject
+      class CashappHandleRedirectOrDisplayQrCode < ::Stripe::StripeObject
+        class QrCode < ::Stripe::StripeObject
           # The date (unix timestamp) when the QR code expires.
           attr_reader :expires_at
           # The image_url_png string used to render QR code
@@ -230,10 +329,10 @@ module Stripe
         end
       end
 
-      class DisplayBankTransferInstructions < Stripe::StripeObject
-        class FinancialAddress < Stripe::StripeObject
-          class Aba < Stripe::StripeObject
-            class AccountHolderAddress < Stripe::StripeObject
+      class DisplayBankTransferInstructions < ::Stripe::StripeObject
+        class FinancialAddress < ::Stripe::StripeObject
+          class Aba < ::Stripe::StripeObject
+            class AccountHolderAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -244,7 +343,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -256,7 +355,7 @@ module Stripe
               end
             end
 
-            class BankAddress < Stripe::StripeObject
+            class BankAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -267,7 +366,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -305,8 +404,8 @@ module Stripe
             end
           end
 
-          class Iban < Stripe::StripeObject
-            class AccountHolderAddress < Stripe::StripeObject
+          class Iban < ::Stripe::StripeObject
+            class AccountHolderAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -317,7 +416,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -329,7 +428,7 @@ module Stripe
               end
             end
 
-            class BankAddress < Stripe::StripeObject
+            class BankAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -340,7 +439,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -376,8 +475,8 @@ module Stripe
             end
           end
 
-          class SortCode < Stripe::StripeObject
-            class AccountHolderAddress < Stripe::StripeObject
+          class SortCode < ::Stripe::StripeObject
+            class AccountHolderAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -388,7 +487,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -400,7 +499,7 @@ module Stripe
               end
             end
 
-            class BankAddress < Stripe::StripeObject
+            class BankAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -411,7 +510,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -445,8 +544,8 @@ module Stripe
             end
           end
 
-          class Spei < Stripe::StripeObject
-            class AccountHolderAddress < Stripe::StripeObject
+          class Spei < ::Stripe::StripeObject
+            class AccountHolderAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -457,7 +556,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -469,7 +568,7 @@ module Stripe
               end
             end
 
-            class BankAddress < Stripe::StripeObject
+            class BankAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -480,7 +579,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -516,8 +615,8 @@ module Stripe
             end
           end
 
-          class Swift < Stripe::StripeObject
-            class AccountHolderAddress < Stripe::StripeObject
+          class Swift < ::Stripe::StripeObject
+            class AccountHolderAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -528,7 +627,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -540,7 +639,7 @@ module Stripe
               end
             end
 
-            class BankAddress < Stripe::StripeObject
+            class BankAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -551,7 +650,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -589,8 +688,8 @@ module Stripe
             end
           end
 
-          class Zengin < Stripe::StripeObject
-            class AccountHolderAddress < Stripe::StripeObject
+          class Zengin < ::Stripe::StripeObject
+            class AccountHolderAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -601,7 +700,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -613,7 +712,7 @@ module Stripe
               end
             end
 
-            class BankAddress < Stripe::StripeObject
+            class BankAddress < ::Stripe::StripeObject
               # City, district, suburb, town, or village.
               attr_reader :city
               # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -624,7 +723,7 @@ module Stripe
               attr_reader :line2
               # ZIP or postal code.
               attr_reader :postal_code
-              # State, county, province, or region.
+              # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
               attr_reader :state
 
               def self.inner_class_types
@@ -719,9 +818,9 @@ module Stripe
         end
       end
 
-      class KonbiniDisplayDetails < Stripe::StripeObject
-        class Stores < Stripe::StripeObject
-          class Familymart < Stripe::StripeObject
+      class KonbiniDisplayDetails < ::Stripe::StripeObject
+        class Stores < ::Stripe::StripeObject
+          class Familymart < ::Stripe::StripeObject
             # The confirmation number.
             attr_reader :confirmation_number
             # The payment code.
@@ -736,7 +835,7 @@ module Stripe
             end
           end
 
-          class Lawson < Stripe::StripeObject
+          class Lawson < ::Stripe::StripeObject
             # The confirmation number.
             attr_reader :confirmation_number
             # The payment code.
@@ -751,7 +850,7 @@ module Stripe
             end
           end
 
-          class Ministop < Stripe::StripeObject
+          class Ministop < ::Stripe::StripeObject
             # The confirmation number.
             attr_reader :confirmation_number
             # The payment code.
@@ -766,7 +865,7 @@ module Stripe
             end
           end
 
-          class Seicomart < Stripe::StripeObject
+          class Seicomart < ::Stripe::StripeObject
             # The confirmation number.
             attr_reader :confirmation_number
             # The payment code.
@@ -818,7 +917,7 @@ module Stripe
         end
       end
 
-      class MultibancoDisplayDetails < Stripe::StripeObject
+      class MultibancoDisplayDetails < ::Stripe::StripeObject
         # Entity number associated with this Multibanco payment.
         attr_reader :entity
         # The timestamp at which the Multibanco voucher expires.
@@ -837,7 +936,7 @@ module Stripe
         end
       end
 
-      class OxxoDisplayDetails < Stripe::StripeObject
+      class OxxoDisplayDetails < ::Stripe::StripeObject
         # The timestamp after which the OXXO voucher expires.
         attr_reader :expires_after
         # The URL for the hosted OXXO voucher page, which allows customers to view and print an OXXO voucher.
@@ -854,7 +953,7 @@ module Stripe
         end
       end
 
-      class PaynowDisplayQrCode < Stripe::StripeObject
+      class PaynowDisplayQrCode < ::Stripe::StripeObject
         # The raw data string used to generate QR code, it should be used together with QR code library.
         attr_reader :data
         # The URL to the hosted PayNow instructions page, which allows customers to view the PayNow QR code.
@@ -873,7 +972,7 @@ module Stripe
         end
       end
 
-      class PixDisplayQrCode < Stripe::StripeObject
+      class PixDisplayQrCode < ::Stripe::StripeObject
         # The raw data string used to generate QR code, it should be used together with QR code library.
         attr_reader :data
         # The date (unix timestamp) when the PIX expires.
@@ -894,7 +993,7 @@ module Stripe
         end
       end
 
-      class PromptpayDisplayQrCode < Stripe::StripeObject
+      class PromptpayDisplayQrCode < ::Stripe::StripeObject
         # The raw data string used to generate QR code, it should be used together with QR code library.
         attr_reader :data
         # The URL to the hosted PromptPay instructions page, which allows customers to view the PromptPay QR code.
@@ -913,7 +1012,7 @@ module Stripe
         end
       end
 
-      class RedirectToUrl < Stripe::StripeObject
+      class RedirectToUrl < ::Stripe::StripeObject
         # If the customer does not exit their browser while authenticating, they will be redirected to this specified URL after completion.
         attr_reader :return_url
         # The URL you must redirect your customer to in order to authenticate the payment.
@@ -928,8 +1027,8 @@ module Stripe
         end
       end
 
-      class SwishHandleRedirectOrDisplayQrCode < Stripe::StripeObject
-        class QrCode < Stripe::StripeObject
+      class SwishHandleRedirectOrDisplayQrCode < ::Stripe::StripeObject
+        class QrCode < ::Stripe::StripeObject
           # The raw data string used to generate QR code, it should be used together with QR code library.
           attr_reader :data
           # The image_url_png string used to render QR code
@@ -961,7 +1060,38 @@ module Stripe
         end
       end
 
-      class VerifyWithMicrodeposits < Stripe::StripeObject
+      class UpiHandleRedirectOrDisplayQrCode < ::Stripe::StripeObject
+        class QrCode < ::Stripe::StripeObject
+          # The date (unix timestamp) when the QR code expires.
+          attr_reader :expires_at
+          # The image_url_png string used to render QR code
+          attr_reader :image_url_png
+          # The image_url_svg string used to render QR code
+          attr_reader :image_url_svg
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The URL to the hosted UPI instructions page, which allows customers to view the QR code.
+        attr_reader :hosted_instructions_url
+        # Attribute for field qr_code
+        attr_reader :qr_code
+
+        def self.inner_class_types
+          @inner_class_types = { qr_code: QrCode }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class VerifyWithMicrodeposits < ::Stripe::StripeObject
         # The timestamp when the microdeposits are expected to land.
         attr_reader :arrival_date
         # The URL for the hosted verification page, which allows customers to verify their bank account.
@@ -978,7 +1108,7 @@ module Stripe
         end
       end
 
-      class WechatPayDisplayQrCode < Stripe::StripeObject
+      class WechatPayDisplayQrCode < ::Stripe::StripeObject
         # The data being used to generate QR code
         attr_reader :data
         # The URL to the hosted WeChat Pay instructions page, which allows customers to view the WeChat Pay QR code.
@@ -999,7 +1129,7 @@ module Stripe
         end
       end
 
-      class WechatPayRedirectToAndroidApp < Stripe::StripeObject
+      class WechatPayRedirectToAndroidApp < ::Stripe::StripeObject
         # app_id is the APP ID registered on WeChat open platform
         attr_reader :app_id
         # nonce_str is a random string
@@ -1024,7 +1154,7 @@ module Stripe
         end
       end
 
-      class WechatPayRedirectToIosApp < Stripe::StripeObject
+      class WechatPayRedirectToIosApp < ::Stripe::StripeObject
         # An universal link that redirect to WeChat Pay app
         attr_reader :native_url
 
@@ -1064,6 +1194,8 @@ module Stripe
       attr_reader :swish_handle_redirect_or_display_qr_code
       # Type of the next action to perform. Refer to the other child attributes under `next_action` for available values. Examples include: `redirect_to_url`, `use_stripe_sdk`, `alipay_handle_redirect`, `oxxo_display_details`, or `verify_with_microdeposits`.
       attr_reader :type
+      # Attribute for field upi_handle_redirect_or_display_qr_code
+      attr_reader :upi_handle_redirect_or_display_qr_code
       # When confirming a PaymentIntent with Stripe.js, Stripe.js depends on the contents of this dictionary to invoke authentication flows. The shape of the contents is subject to change and is only intended to be used by Stripe.js.
       attr_reader :use_stripe_sdk
       # Attribute for field verify_with_microdeposits
@@ -1090,6 +1222,7 @@ module Stripe
           promptpay_display_qr_code: PromptpayDisplayQrCode,
           redirect_to_url: RedirectToUrl,
           swish_handle_redirect_or_display_qr_code: SwishHandleRedirectOrDisplayQrCode,
+          upi_handle_redirect_or_display_qr_code: UpiHandleRedirectOrDisplayQrCode,
           verify_with_microdeposits: VerifyWithMicrodeposits,
           wechat_pay_display_qr_code: WechatPayDisplayQrCode,
           wechat_pay_redirect_to_android_app: WechatPayRedirectToAndroidApp,
@@ -1102,7 +1235,26 @@ module Stripe
       end
     end
 
-    class PaymentMethodConfigurationDetails < Stripe::StripeObject
+    class PaymentDetails < ::Stripe::StripeObject
+      # A unique value to identify the customer. This field is available only for card payments.
+      #
+      # This field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks.
+      attr_reader :customer_reference
+      # A unique value assigned by the business to identify the transaction. Required for L2 and L3 rates.
+      #
+      # For Cards, this field is truncated to 25 alphanumeric characters, excluding spaces, before being sent to card networks. For Klarna, this field is truncated to 255 characters and is visible to customers when they view the order in the Klarna app.
+      attr_reader :order_reference
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class PaymentMethodConfigurationDetails < ::Stripe::StripeObject
       # ID of the payment method configuration used.
       attr_reader :id
       # ID of the parent payment method configuration used.
@@ -1117,9 +1269,9 @@ module Stripe
       end
     end
 
-    class PaymentMethodOptions < Stripe::StripeObject
-      class AcssDebit < Stripe::StripeObject
-        class MandateOptions < Stripe::StripeObject
+    class PaymentMethodOptions < ::Stripe::StripeObject
+      class AcssDebit < ::Stripe::StripeObject
+        class MandateOptions < ::Stripe::StripeObject
           # A URL for custom mandate text
           attr_reader :custom_mandate_url
           # Description of the interval. Only required if the 'payment_schedule' parameter is 'interval' or 'combined'.
@@ -1149,7 +1301,7 @@ module Stripe
         attr_reader :setup_future_usage
         # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
         attr_reader :target_date
-        # Bank account verification method.
+        # Bank account verification method. The default value is `automatic`.
         attr_reader :verification_method
 
         def self.inner_class_types
@@ -1161,7 +1313,7 @@ module Stripe
         end
       end
 
-      class Affirm < Stripe::StripeObject
+      class Affirm < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Preferred language of the Affirm authorization page that the customer is redirected to.
@@ -1184,7 +1336,7 @@ module Stripe
         end
       end
 
-      class AfterpayClearpay < Stripe::StripeObject
+      class AfterpayClearpay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # An internal identifier or reference that this payment corresponds to. You must limit the identifier to 128 characters, and it can only contain letters, numbers, underscores, backslashes, and dashes.
@@ -1208,7 +1360,7 @@ module Stripe
         end
       end
 
-      class Alipay < Stripe::StripeObject
+      class Alipay < ::Stripe::StripeObject
         # 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.
@@ -1227,7 +1379,7 @@ module Stripe
         end
       end
 
-      class Alma < Stripe::StripeObject
+      class Alma < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
 
@@ -1240,7 +1392,7 @@ module Stripe
         end
       end
 
-      class AmazonPay < Stripe::StripeObject
+      class AmazonPay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1261,7 +1413,7 @@ module Stripe
         end
       end
 
-      class AuBecsDebit < Stripe::StripeObject
+      class AuBecsDebit < ::Stripe::StripeObject
         # 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.
@@ -1282,8 +1434,8 @@ module Stripe
         end
       end
 
-      class BacsDebit < Stripe::StripeObject
-        class MandateOptions < Stripe::StripeObject
+      class BacsDebit < ::Stripe::StripeObject
+        class MandateOptions < ::Stripe::StripeObject
           # Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
           attr_reader :reference_prefix
 
@@ -1317,7 +1469,7 @@ module Stripe
         end
       end
 
-      class Bancontact < Stripe::StripeObject
+      class Bancontact < ::Stripe::StripeObject
         # Preferred language of the Bancontact authorization page that the customer is redirected to.
         attr_reader :preferred_language
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1338,7 +1490,7 @@ module Stripe
         end
       end
 
-      class Billie < Stripe::StripeObject
+      class Billie < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
 
@@ -1351,7 +1503,7 @@ module Stripe
         end
       end
 
-      class Blik < Stripe::StripeObject
+      class Blik < ::Stripe::StripeObject
         # 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.
@@ -1370,7 +1522,7 @@ module Stripe
         end
       end
 
-      class Boleto < Stripe::StripeObject
+      class Boleto < ::Stripe::StripeObject
         # The number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days to 2, the Boleto voucher will expire on Wednesday at 23:59 America/Sao_Paulo time.
         attr_reader :expires_after_days
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1391,9 +1543,9 @@ module Stripe
         end
       end
 
-      class Card < Stripe::StripeObject
-        class Installments < Stripe::StripeObject
-          class AvailablePlan < Stripe::StripeObject
+      class Card < ::Stripe::StripeObject
+        class Installments < ::Stripe::StripeObject
+          class AvailablePlan < ::Stripe::StripeObject
             # For `fixed_count` installment plans, this is the number of installment payments your customer will make to their credit card.
             attr_reader :count
             # For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card.
@@ -1411,7 +1563,7 @@ module Stripe
             end
           end
 
-          class Plan < Stripe::StripeObject
+          class Plan < ::Stripe::StripeObject
             # For `fixed_count` installment plans, this is the number of installment payments your customer will make to their credit card.
             attr_reader :count
             # For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card.
@@ -1444,8 +1596,8 @@ module Stripe
           end
         end
 
-        class MandateOptions < Stripe::StripeObject
-          # Amount to be charged for future payments.
+        class MandateOptions < ::Stripe::StripeObject
+          # Amount to be charged for future payments, specified in the presentment currency.
           attr_reader :amount
           # One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
           attr_reader :amount_type
@@ -1476,21 +1628,21 @@ module Stripe
         attr_reader :capture_method
         # Installment details for this payment.
         #
-        # For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
+        # For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments).
         attr_reader :installments
         # Configuration options for setting up an eMandate for cards issued in India.
         attr_reader :mandate_options
         # Selected network to process this payment intent on. Depends on the available networks of the card attached to the payment intent. Can be only set confirm-time.
         attr_reader :network
-        # Request ability to [capture beyond the standard authorization validity window](https://stripe.com/docs/payments/extended-authorization) for this PaymentIntent.
+        # Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this PaymentIntent.
         attr_reader :request_extended_authorization
-        # Request ability to [increment the authorization](https://stripe.com/docs/payments/incremental-authorization) for this PaymentIntent.
+        # Request ability to [increment the authorization](https://docs.stripe.com/payments/incremental-authorization) for this PaymentIntent.
         attr_reader :request_incremental_authorization
-        # Request ability to make [multiple captures](https://stripe.com/docs/payments/multicapture) for this PaymentIntent.
+        # Request ability to make [multiple captures](https://docs.stripe.com/payments/multicapture) for this PaymentIntent.
         attr_reader :request_multicapture
-        # Request ability to [overcapture](https://stripe.com/docs/payments/overcapture) for this PaymentIntent.
+        # Request ability to [overcapture](https://docs.stripe.com/payments/overcapture) for this PaymentIntent.
         attr_reader :request_overcapture
-        # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
+        # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
         attr_reader :request_three_d_secure
         # When enabled, using a card that is attached to a customer will require the CVC to be provided again (i.e. using the cvc_token parameter).
         attr_reader :require_cvc_recollection
@@ -1516,8 +1668,8 @@ module Stripe
         end
       end
 
-      class CardPresent < Stripe::StripeObject
-        class Routing < Stripe::StripeObject
+      class CardPresent < ::Stripe::StripeObject
+        class Routing < ::Stripe::StripeObject
           # Requested routing priority
           attr_reader :requested_priority
 
@@ -1529,9 +1681,11 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity)
+        # Controls when the funds will be captured from the customer's account.
+        attr_reader :capture_method
+        # Request ability to capture this payment beyond the standard [authorization validity window](https://docs.stripe.com/terminal/features/extended-authorizations#authorization-validity)
         attr_reader :request_extended_authorization
-        # Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support.
+        # Request ability to [increment](https://docs.stripe.com/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://docs.stripe.com/api/payment_intents/confirm) response to verify support.
         attr_reader :request_incremental_authorization_support
         # Attribute for field routing
         attr_reader :routing
@@ -1545,7 +1699,7 @@ module Stripe
         end
       end
 
-      class Cashapp < Stripe::StripeObject
+      class Cashapp < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1566,7 +1720,7 @@ module Stripe
         end
       end
 
-      class Crypto < Stripe::StripeObject
+      class Crypto < ::Stripe::StripeObject
         # 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.
@@ -1585,10 +1739,10 @@ module Stripe
         end
       end
 
-      class CustomerBalance < Stripe::StripeObject
-        class BankTransfer < Stripe::StripeObject
-          class EuBankTransfer < Stripe::StripeObject
-            # The desired country code of the bank account information. Permitted values include: `BE`, `DE`, `ES`, `FR`, `IE`, or `NL`.
+      class CustomerBalance < ::Stripe::StripeObject
+        class BankTransfer < ::Stripe::StripeObject
+          class EuBankTransfer < ::Stripe::StripeObject
+            # The desired country code of the bank account information. Permitted values include: `DE`, `FR`, `IE`, or `NL`.
             attr_reader :country
 
             def self.inner_class_types
@@ -1638,7 +1792,7 @@ module Stripe
         end
       end
 
-      class Eps < Stripe::StripeObject
+      class Eps < ::Stripe::StripeObject
         # 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.
@@ -1657,7 +1811,7 @@ module Stripe
         end
       end
 
-      class Fpx < Stripe::StripeObject
+      class Fpx < ::Stripe::StripeObject
         # 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.
@@ -1676,7 +1830,7 @@ module Stripe
         end
       end
 
-      class Giropay < Stripe::StripeObject
+      class Giropay < ::Stripe::StripeObject
         # 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.
@@ -1695,7 +1849,7 @@ module Stripe
         end
       end
 
-      class Grabpay < Stripe::StripeObject
+      class Grabpay < ::Stripe::StripeObject
         # 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.
@@ -1714,7 +1868,7 @@ module Stripe
         end
       end
 
-      class Ideal < Stripe::StripeObject
+      class Ideal < ::Stripe::StripeObject
         # 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.
@@ -1733,7 +1887,7 @@ module Stripe
         end
       end
 
-      class InteracPresent < Stripe::StripeObject
+      class InteracPresent < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -1743,7 +1897,7 @@ module Stripe
         end
       end
 
-      class KakaoPay < Stripe::StripeObject
+      class KakaoPay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1764,7 +1918,7 @@ module Stripe
         end
       end
 
-      class Klarna < Stripe::StripeObject
+      class Klarna < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Preferred locale of the Klarna checkout page that the customer is redirected to.
@@ -1787,7 +1941,7 @@ module Stripe
         end
       end
 
-      class Konbini < Stripe::StripeObject
+      class Konbini < ::Stripe::StripeObject
         # An optional 10 to 11 digit numeric-only string determining the confirmation code at applicable convenience stores.
         attr_reader :confirmation_number
         # The number of calendar days (between 1 and 60) after which Konbini payment instructions will expire. For example, if a PaymentIntent is confirmed with Konbini and `expires_after_days` set to 2 on Monday JST, the instructions will expire on Wednesday 23:59:59 JST.
@@ -1814,7 +1968,7 @@ module Stripe
         end
       end
 
-      class KrCard < Stripe::StripeObject
+      class KrCard < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1835,7 +1989,7 @@ module Stripe
         end
       end
 
-      class Link < Stripe::StripeObject
+      class Link < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # [Deprecated] This is a legacy parameter that no longer has any function.
@@ -1858,7 +2012,7 @@ module Stripe
         end
       end
 
-      class MbWay < Stripe::StripeObject
+      class MbWay < ::Stripe::StripeObject
         # 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.
@@ -1877,7 +2031,7 @@ module Stripe
         end
       end
 
-      class Mobilepay < Stripe::StripeObject
+      class Mobilepay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1898,7 +2052,7 @@ module Stripe
         end
       end
 
-      class Multibanco < Stripe::StripeObject
+      class Multibanco < ::Stripe::StripeObject
         # 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.
@@ -1917,7 +2071,7 @@ module Stripe
         end
       end
 
-      class NaverPay < Stripe::StripeObject
+      class NaverPay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1938,7 +2092,7 @@ module Stripe
         end
       end
 
-      class NzBankAccount < Stripe::StripeObject
+      class NzBankAccount < ::Stripe::StripeObject
         # 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.
@@ -1959,7 +2113,7 @@ module Stripe
         end
       end
 
-      class Oxxo < Stripe::StripeObject
+      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.
         attr_reader :expires_after_days
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1980,7 +2134,7 @@ module Stripe
         end
       end
 
-      class P24 < Stripe::StripeObject
+      class P24 < ::Stripe::StripeObject
         # 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.
@@ -1999,7 +2153,7 @@ module Stripe
         end
       end
 
-      class PayByBank < Stripe::StripeObject
+      class PayByBank < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -2009,7 +2163,7 @@ module Stripe
         end
       end
 
-      class Payco < Stripe::StripeObject
+      class Payco < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
 
@@ -2022,7 +2176,7 @@ module Stripe
         end
       end
 
-      class Paynow < Stripe::StripeObject
+      class Paynow < ::Stripe::StripeObject
         # 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.
@@ -2041,7 +2195,7 @@ module Stripe
         end
       end
 
-      class Paypal < Stripe::StripeObject
+      class Paypal < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Preferred locale of the PayPal checkout page that the customer is redirected to.
@@ -2066,7 +2220,50 @@ module Stripe
         end
       end
 
-      class Pix < Stripe::StripeObject
+      class Payto < ::Stripe::StripeObject
+        class MandateOptions < ::Stripe::StripeObject
+          # Amount that will be collected. It is required when `amount_type` is `fixed`.
+          attr_reader :amount
+          # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`.
+          attr_reader :amount_type
+          # Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
+          attr_reader :end_date
+          # The periodicity at which payments will be collected. Defaults to `adhoc`.
+          attr_reader :payment_schedule
+          # The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
+          attr_reader :payments_per_period
+          # The purpose for which payments are made. Has a default value based on your merchant category code.
+          attr_reader :purpose
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field mandate_options
+        attr_reader :mandate_options
+        # 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).
+        attr_reader :setup_future_usage
+
+        def self.inner_class_types
+          @inner_class_types = { mandate_options: MandateOptions }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Pix < ::Stripe::StripeObject
         # Determines if the amount includes the IOF tax.
         attr_reader :amount_includes_iof
         # The number of seconds (between 10 and 1209600) after which Pix payment will expire.
@@ -2091,7 +2288,7 @@ module Stripe
         end
       end
 
-      class Promptpay < Stripe::StripeObject
+      class Promptpay < ::Stripe::StripeObject
         # 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.
@@ -2110,7 +2307,7 @@ module Stripe
         end
       end
 
-      class RevolutPay < Stripe::StripeObject
+      class RevolutPay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -2131,7 +2328,7 @@ module Stripe
         end
       end
 
-      class SamsungPay < Stripe::StripeObject
+      class SamsungPay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
 
@@ -2144,7 +2341,7 @@ module Stripe
         end
       end
 
-      class Satispay < Stripe::StripeObject
+      class Satispay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
 
@@ -2157,8 +2354,8 @@ module Stripe
         end
       end
 
-      class SepaDebit < Stripe::StripeObject
-        class MandateOptions < Stripe::StripeObject
+      class SepaDebit < ::Stripe::StripeObject
+        class MandateOptions < ::Stripe::StripeObject
           # Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
           attr_reader :reference_prefix
 
@@ -2192,7 +2389,7 @@ module Stripe
         end
       end
 
-      class Sofort < Stripe::StripeObject
+      class Sofort < ::Stripe::StripeObject
         # Preferred language of the SOFORT authorization page that the customer is redirected to.
         attr_reader :preferred_language
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -2213,7 +2410,7 @@ module Stripe
         end
       end
 
-      class Swish < Stripe::StripeObject
+      class Swish < ::Stripe::StripeObject
         # A reference for this payment to be displayed in the Swish app.
         attr_reader :reference
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -2234,7 +2431,26 @@ module Stripe
         end
       end
 
-      class Twint < Stripe::StripeObject
+      class Twint < ::Stripe::StripeObject
+        # 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).
+        attr_reader :setup_future_usage
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Upi < ::Stripe::StripeObject
         # 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.
@@ -2253,9 +2469,9 @@ module Stripe
         end
       end
 
-      class UsBankAccount < Stripe::StripeObject
-        class FinancialConnections < Stripe::StripeObject
-          class Filters < Stripe::StripeObject
+      class UsBankAccount < ::Stripe::StripeObject
+        class FinancialConnections < ::Stripe::StripeObject
+          class Filters < ::Stripe::StripeObject
             # The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
             attr_reader :account_subcategories
 
@@ -2285,7 +2501,7 @@ module Stripe
           end
         end
 
-        class MandateOptions < Stripe::StripeObject
+        class MandateOptions < ::Stripe::StripeObject
           # Mandate collection method
           attr_reader :collection_method
 
@@ -2301,8 +2517,6 @@ module Stripe
         attr_reader :financial_connections
         # Attribute for field mandate_options
         attr_reader :mandate_options
-        # Preferred transaction settlement speed
-        attr_reader :preferred_settlement_speed
         # 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.
@@ -2313,7 +2527,9 @@ module Stripe
         attr_reader :setup_future_usage
         # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
         attr_reader :target_date
-        # Bank account verification method.
+        # The purpose of the transaction.
+        attr_reader :transaction_purpose
+        # Bank account verification method. The default value is `automatic`.
         attr_reader :verification_method
 
         def self.inner_class_types
@@ -2328,7 +2544,7 @@ module Stripe
         end
       end
 
-      class WechatPay < Stripe::StripeObject
+      class WechatPay < ::Stripe::StripeObject
         # The app ID registered with WeChat Pay. Only required when client is ios or android.
         attr_reader :app_id
         # The client type that the end customer will pay from
@@ -2351,7 +2567,7 @@ module Stripe
         end
       end
 
-      class Zip < Stripe::StripeObject
+      class Zip < ::Stripe::StripeObject
         # 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.
@@ -2447,6 +2663,8 @@ module Stripe
       attr_reader :paynow
       # Attribute for field paypal
       attr_reader :paypal
+      # Attribute for field payto
+      attr_reader :payto
       # Attribute for field pix
       attr_reader :pix
       # Attribute for field promptpay
@@ -2465,6 +2683,8 @@ module Stripe
       attr_reader :swish
       # Attribute for field twint
       attr_reader :twint
+      # Attribute for field upi
+      attr_reader :upi
       # Attribute for field us_bank_account
       attr_reader :us_bank_account
       # Attribute for field wechat_pay
@@ -2513,6 +2733,7 @@ module Stripe
           payco: Payco,
           paynow: Paynow,
           paypal: Paypal,
+          payto: Payto,
           pix: Pix,
           promptpay: Promptpay,
           revolut_pay: RevolutPay,
@@ -2522,6 +2743,7 @@ module Stripe
           sofort: Sofort,
           swish: Swish,
           twint: Twint,
+          upi: Upi,
           us_bank_account: UsBankAccount,
           wechat_pay: WechatPay,
           zip: Zip,
@@ -2533,7 +2755,7 @@ module Stripe
       end
     end
 
-    class PresentmentDetails < Stripe::StripeObject
+    class PresentmentDetails < ::Stripe::StripeObject
       # Amount intended to be collected by this payment, denominated in `presentment_currency`.
       attr_reader :presentment_amount
       # Currency presented to the customer during payment.
@@ -2548,9 +2770,9 @@ module Stripe
       end
     end
 
-    class Processing < Stripe::StripeObject
-      class Card < Stripe::StripeObject
-        class CustomerNotification < Stripe::StripeObject
+    class Processing < ::Stripe::StripeObject
+      class Card < ::Stripe::StripeObject
+        class CustomerNotification < ::Stripe::StripeObject
           # Whether customer approval has been requested for this payment. For payments greater than INR 15000 or mandate amount, the customer must provide explicit approval of the payment with their bank.
           attr_reader :approval_requested
           # If customer approval is required, they need to provide approval before this time.
@@ -2589,8 +2811,8 @@ module Stripe
       end
     end
 
-    class Shipping < Stripe::StripeObject
-      class Address < Stripe::StripeObject
+    class Shipping < ::Stripe::StripeObject
+      class Address < ::Stripe::StripeObject
         # City, district, suburb, town, or village.
         attr_reader :city
         # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -2601,7 +2823,7 @@ module Stripe
         attr_reader :line2
         # ZIP or postal code.
         attr_reader :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_reader :state
 
         def self.inner_class_types
@@ -2632,9 +2854,9 @@ module Stripe
       end
     end
 
-    class TransferData < Stripe::StripeObject
+    class TransferData < ::Stripe::StripeObject
       # The amount transferred to the destination account. This transfer will occur automatically after the payment succeeds. If no amount is specified, by default the entire payment amount is transferred to the destination account.
-      #  The amount must be less than or equal to the [amount](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-amount), and must be a positive integer
+      #  The amount must be less than or equal to the [amount](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-amount), and must be a positive integer
       #  representing how much to transfer in the smallest currency unit (e.g., 100 cents to charge $1.00).
       attr_reader :amount
       # The account (if any) that the payment is attributed to for tax reporting, and where funds from the payment are transferred to after payment success.
@@ -2648,7 +2870,7 @@ module Stripe
         @field_remappings = {}
       end
     end
-    # Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
+    # Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
     attr_reader :amount
     # Amount that can be captured from this PaymentIntent.
     attr_reader :amount_capturable
@@ -2658,7 +2880,7 @@ module Stripe
     attr_reader :amount_received
     # ID of the Connect application that created the PaymentIntent.
     attr_reader :application
-    # The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
+    # The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts).
     attr_reader :application_fee_amount
     # Settings to configure compatible payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods)
     attr_reader :automatic_payment_methods
@@ -2672,7 +2894,7 @@ module Stripe
     #
     # The client secret can be used to complete a payment from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.
     #
-    # Refer to our docs to [accept a payment](https://stripe.com/docs/payments/accept-a-payment?ui=elements) and learn about how `client_secret` should be handled.
+    # Refer to our docs to [accept a payment](https://docs.stripe.com/payments/accept-a-payment?ui=elements) and learn about how `client_secret` should be handled.
     attr_reader :client_secret
     # Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment.
     attr_reader :confirmation_method
@@ -2684,31 +2906,42 @@ module Stripe
     #
     # Payment methods attached to other Customers cannot be used with this PaymentIntent.
     #
-    # If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead.
+    # If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead.
     attr_reader :customer
+    # ID of the Account representing the customer that this PaymentIntent belongs to, if one exists.
+    #
+    # Payment methods attached to other Accounts cannot be used with this PaymentIntent.
+    #
+    # If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead.
+    attr_reader :customer_account
     # An arbitrary string attached to the object. Often useful for displaying to users.
     attr_reader :description
     # The list of payment method types to exclude from use with this payment.
     attr_reader :excluded_payment_method_types
+    # Attribute for field hooks
+    attr_reader :hooks
     # Unique identifier for the object.
     attr_reader :id
     # The payment error encountered in the previous PaymentIntent confirmation. It will be cleared if the PaymentIntent is later updated for any reason.
     attr_reader :last_payment_error
-    # ID of the latest [Charge object](https://stripe.com/docs/api/charges) created by this PaymentIntent. This property is `null` until PaymentIntent confirmation is attempted.
+    # ID of the latest [Charge object](https://docs.stripe.com/api/charges) created by this PaymentIntent. This property is `null` until PaymentIntent confirmation is attempted.
     attr_reader :latest_charge
-    # 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
-    # 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. Learn more about [storing information in metadata](https://stripe.com/docs/payments/payment-intents/creating-payment-intents#storing-information-in-metadata).
+    # 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. Learn more about [storing information in metadata](https://docs.stripe.com/payments/payment-intents/creating-payment-intents#storing-information-in-metadata).
     attr_reader :metadata
     # If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source.
     attr_reader :next_action
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # The account (if any) for which the funds of the PaymentIntent are intended. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts) for details.
+    # You can specify the settlement merchant as the
+    # connected account using the `on_behalf_of` attribute on the charge. See the PaymentIntents [use case for connected accounts](/payments/connected-accounts) for details.
     attr_reader :on_behalf_of
+    # Attribute for field payment_details
+    attr_reader :payment_details
     # ID of the payment method used in this PaymentIntent.
     attr_reader :payment_method
-    # Information about the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) used for this PaymentIntent.
+    # Information about the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) used for this PaymentIntent.
     attr_reader :payment_method_configuration_details
     # Payment-method-specific configuration for this PaymentIntent.
     attr_reader :payment_method_options
@@ -2740,11 +2973,11 @@ module Stripe
     attr_reader :statement_descriptor
     # Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement.
     attr_reader :statement_descriptor_suffix
-    # Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. Read more about each PaymentIntent [status](https://stripe.com/docs/payments/intents#intent-statuses).
+    # Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. Read more about each PaymentIntent [status](https://docs.stripe.com/payments/intents#intent-statuses).
     attr_reader :status
-    # The data that automatically creates a Transfer after the payment finalizes. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
+    # The data that automatically creates a Transfer after the payment finalizes. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts).
     attr_reader :transfer_data
-    # A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers).
+    # A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers).
     attr_reader :transfer_group
 
     # Manually reconcile the remaining amount for a customer_balance PaymentIntent.
@@ -2771,7 +3004,7 @@ module Stripe
     #
     # After it's canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a status of requires_capture, the remaining amount_capturable is automatically refunded.
     #
-    # You can't cancel the PaymentIntent for a Checkout Session. [Expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire) instead.
+    # You can directly cancel the PaymentIntent for a Checkout Session only when the PaymentIntent has a status of requires_capture. Otherwise, you must [expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire).
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -2785,7 +3018,7 @@ module Stripe
     #
     # After it's canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a status of requires_capture, the remaining amount_capturable is automatically refunded.
     #
-    # You can't cancel the PaymentIntent for a Checkout Session. [Expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire) instead.
+    # You can directly cancel the PaymentIntent for a Checkout Session only when the PaymentIntent has a status of requires_capture. Otherwise, you must [expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire).
     def self.cancel(intent, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -3039,8 +3272,10 @@ module Stripe
       @inner_class_types = {
         amount_details: AmountDetails,
         automatic_payment_methods: AutomaticPaymentMethods,
+        hooks: Hooks,
         last_payment_error: LastPaymentError,
         next_action: NextAction,
+        payment_details: PaymentDetails,
         payment_method_configuration_details: PaymentMethodConfigurationDetails,
         payment_method_options: PaymentMethodOptions,
         presentment_details: PresentmentDetails,