stripe 17.0.1 → 19.0.0

data/lib/stripe/params/payment_intent_confirm_params.rb

@@ -2,12 +2,221 @@
 # frozen_string_literal: true
 
 module Stripe
-  class PaymentIntentConfirmParams < Stripe::RequestParams
-    class MandateData < Stripe::RequestParams
-      class CustomerAcceptance < Stripe::RequestParams
-        class Offline < Stripe::RequestParams; end
+  class PaymentIntentConfirmParams < ::Stripe::RequestParams
+    class AmountDetails < ::Stripe::RequestParams
+      class LineItem < ::Stripe::RequestParams
+        class PaymentMethodOptions < ::Stripe::RequestParams
+          class Card < ::Stripe::RequestParams
+            # Identifier that categorizes the items being purchased using a standardized commodity scheme such as (but not limited to) UNSPSC, NAICS, NAPCS, and so on.
+            attr_accessor :commodity_code
+
+            def initialize(commodity_code: nil)
+              @commodity_code = commodity_code
+            end
+          end
+
+          class CardPresent < ::Stripe::RequestParams
+            # Identifier that categorizes the items being purchased using a standardized commodity scheme such as (but not limited to) UNSPSC, NAICS, NAPCS, and so on.
+            attr_accessor :commodity_code
+
+            def initialize(commodity_code: nil)
+              @commodity_code = commodity_code
+            end
+          end
+
+          class Klarna < ::Stripe::RequestParams
+            # URL to an image for the product. Max length, 4096 characters.
+            attr_accessor :image_url
+            # URL to the product page. Max length, 4096 characters.
+            attr_accessor :product_url
+            # Unique reference for this line item to correlate it with your system’s internal records. The field is displayed in the Klarna Consumer App if passed.
+            attr_accessor :reference
+            # Reference for the subscription this line item is for.
+            attr_accessor :subscription_reference
+
+            def initialize(
+              image_url: nil,
+              product_url: nil,
+              reference: nil,
+              subscription_reference: nil
+            )
+              @image_url = image_url
+              @product_url = product_url
+              @reference = reference
+              @subscription_reference = subscription_reference
+            end
+          end
 
-        class Online < Stripe::RequestParams
+          class Paypal < ::Stripe::RequestParams
+            # Type of the line item.
+            attr_accessor :category
+            # Description of the line item.
+            attr_accessor :description
+            # The Stripe account ID of the connected account that sells the item.
+            attr_accessor :sold_by
+
+            def initialize(category: nil, description: nil, sold_by: nil)
+              @category = category
+              @description = description
+              @sold_by = sold_by
+            end
+          end
+          # This sub-hash contains line item details that are specific to the `card` payment method.
+          attr_accessor :card
+          # This sub-hash contains line item details that are specific to the `card_present` payment method.
+          attr_accessor :card_present
+          # This sub-hash contains line item details that are specific to the `klarna` payment method.
+          attr_accessor :klarna
+          # This sub-hash contains line item details that are specific to the `paypal` payment method.
+          attr_accessor :paypal
+
+          def initialize(card: nil, card_present: nil, klarna: nil, paypal: nil)
+            @card = card
+            @card_present = card_present
+            @klarna = klarna
+            @paypal = paypal
+          end
+        end
+
+        class Tax < ::Stripe::RequestParams
+          # The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0.
+          #
+          # This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field.
+          attr_accessor :total_tax_amount
+
+          def initialize(total_tax_amount: nil)
+            @total_tax_amount = total_tax_amount
+          end
+        end
+        # The discount applied on this line item 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[discount_amount]` field.
+        attr_accessor :discount_amount
+        # Payment method-specific information for line items.
+        attr_accessor :payment_method_options
+        # The product code of the line item, such as an SKU. Required for L3 rates. At most 12 characters long.
+        attr_accessor :product_code
+        # The product name of the line item. Required for L3 rates. At most 1024 characters long.
+        #
+        # For Cards, this field is truncated to 26 alphanumeric characters before being sent to the card networks. For PayPal, this field is truncated to 127 characters.
+        attr_accessor :product_name
+        # The quantity of items. Required for L3 rates. An integer greater than 0.
+        attr_accessor :quantity
+        # Contains information about the tax on the item.
+        attr_accessor :tax
+        # The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0.
+        attr_accessor :unit_cost
+        # A unit of measure for the line item, such as gallons, feet, meters, etc.
+        attr_accessor :unit_of_measure
+
+        def initialize(
+          discount_amount: nil,
+          payment_method_options: nil,
+          product_code: nil,
+          product_name: nil,
+          quantity: nil,
+          tax: nil,
+          unit_cost: nil,
+          unit_of_measure: nil
+        )
+          @discount_amount = discount_amount
+          @payment_method_options = payment_method_options
+          @product_code = product_code
+          @product_name = product_name
+          @quantity = quantity
+          @tax = tax
+          @unit_cost = unit_cost
+          @unit_of_measure = unit_of_measure
+        end
+      end
+
+      class Shipping < ::Stripe::RequestParams
+        # 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_accessor :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_accessor :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_accessor :to_postal_code
+
+        def initialize(amount: nil, from_postal_code: nil, to_postal_code: nil)
+          @amount = amount
+          @from_postal_code = from_postal_code
+          @to_postal_code = to_postal_code
+        end
+      end
+
+      class Tax < ::Stripe::RequestParams
+        # 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_accessor :total_tax_amount
+
+        def initialize(total_tax_amount: nil)
+          @total_tax_amount = total_tax_amount
+        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_accessor :discount_amount
+      # Set to `false` to return arithmetic validation errors in the response without failing the request. Use this when you want the operation to proceed regardless of arithmetic errors in the line item data.
+      #
+      # Omit or set to `true` to immediately return a 400 error when arithmetic validation fails. Use this for strict validation that prevents processing with line item data that has arithmetic inconsistencies.
+      #
+      # For card payments, Stripe doesn't send line item data to card networks if there's an arithmetic validation error.
+      attr_accessor :enforce_arithmetic_validation
+      # A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items.
+      attr_accessor :line_items
+      # Contains information about the shipping portion of the amount.
+      attr_accessor :shipping
+      # Contains information about the tax portion of the amount.
+      attr_accessor :tax
+
+      def initialize(
+        discount_amount: nil,
+        enforce_arithmetic_validation: nil,
+        line_items: nil,
+        shipping: nil,
+        tax: nil
+      )
+        @discount_amount = discount_amount
+        @enforce_arithmetic_validation = enforce_arithmetic_validation
+        @line_items = line_items
+        @shipping = shipping
+        @tax = tax
+      end
+    end
+
+    class Hooks < ::Stripe::RequestParams
+      class Inputs < ::Stripe::RequestParams
+        class Tax < ::Stripe::RequestParams
+          # The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id
+          attr_accessor :calculation
+
+          def initialize(calculation: nil)
+            @calculation = calculation
+          end
+        end
+        # Tax arguments for automations
+        attr_accessor :tax
+
+        def initialize(tax: nil)
+          @tax = tax
+        end
+      end
+      # Arguments passed in automations
+      attr_accessor :inputs
+
+      def initialize(inputs: nil)
+        @inputs = inputs
+      end
+    end
+
+    class MandateData < ::Stripe::RequestParams
+      class CustomerAcceptance < ::Stripe::RequestParams
+        class Offline < ::Stripe::RequestParams; end
+
+        class Online < ::Stripe::RequestParams
           # The IP address from which the Mandate was accepted by the customer.
           attr_accessor :ip_address
           # The user agent of the browser from which the Mandate was accepted by the customer.
@@ -42,8 +251,24 @@ module Stripe
       end
     end
 
-    class PaymentMethodData < Stripe::RequestParams
-      class AcssDebit < Stripe::RequestParams
+    class PaymentDetails < ::Stripe::RequestParams
+      # 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_accessor :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_accessor :order_reference
+
+      def initialize(customer_reference: nil, order_reference: nil)
+        @customer_reference = customer_reference
+        @order_reference = order_reference
+      end
+    end
+
+    class PaymentMethodData < ::Stripe::RequestParams
+      class AcssDebit < ::Stripe::RequestParams
         # Customer's bank account number.
         attr_accessor :account_number
         # Institution number of the customer's bank.
@@ -58,13 +283,13 @@ module Stripe
         end
       end
 
-      class Affirm < Stripe::RequestParams; end
-      class AfterpayClearpay < Stripe::RequestParams; end
-      class Alipay < Stripe::RequestParams; end
-      class Alma < Stripe::RequestParams; end
-      class AmazonPay < Stripe::RequestParams; end
+      class Affirm < ::Stripe::RequestParams; end
+      class AfterpayClearpay < ::Stripe::RequestParams; end
+      class Alipay < ::Stripe::RequestParams; end
+      class Alma < ::Stripe::RequestParams; end
+      class AmazonPay < ::Stripe::RequestParams; end
 
-      class AuBecsDebit < Stripe::RequestParams
+      class AuBecsDebit < ::Stripe::RequestParams
         # The account number for the bank account.
         attr_accessor :account_number
         # Bank-State-Branch number of the bank account.
@@ -76,7 +301,7 @@ module Stripe
         end
       end
 
-      class BacsDebit < Stripe::RequestParams
+      class BacsDebit < ::Stripe::RequestParams
         # Account number of the bank account that the funds will be debited from.
         attr_accessor :account_number
         # Sort code of the bank account. (e.g., `10-20-30`)
@@ -88,11 +313,11 @@ module Stripe
         end
       end
 
-      class Bancontact < Stripe::RequestParams; end
-      class Billie < Stripe::RequestParams; end
+      class Bancontact < ::Stripe::RequestParams; end
+      class Billie < ::Stripe::RequestParams; end
 
-      class BillingDetails < Stripe::RequestParams
-        class Address < Stripe::RequestParams
+      class BillingDetails < ::Stripe::RequestParams
+        class Address < ::Stripe::RequestParams
           # City, district, suburb, town, or village.
           attr_accessor :city
           # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -103,7 +328,7 @@ module Stripe
           attr_accessor :line2
           # ZIP or postal code.
           attr_accessor :postal_code
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           attr_accessor :state
 
           def initialize(
@@ -142,9 +367,9 @@ module Stripe
         end
       end
 
-      class Blik < Stripe::RequestParams; end
+      class Blik < ::Stripe::RequestParams; end
 
-      class Boleto < Stripe::RequestParams
+      class Boleto < ::Stripe::RequestParams
         # The tax ID of the customer (CPF for individual consumers or CNPJ for businesses consumers)
         attr_accessor :tax_id
 
@@ -153,11 +378,11 @@ module Stripe
         end
       end
 
-      class Cashapp < Stripe::RequestParams; end
-      class Crypto < Stripe::RequestParams; end
-      class CustomerBalance < Stripe::RequestParams; end
+      class Cashapp < ::Stripe::RequestParams; end
+      class Crypto < ::Stripe::RequestParams; end
+      class CustomerBalance < ::Stripe::RequestParams; end
 
-      class Eps < Stripe::RequestParams
+      class Eps < ::Stripe::RequestParams
         # The customer's bank.
         attr_accessor :bank
 
@@ -166,7 +391,7 @@ module Stripe
         end
       end
 
-      class Fpx < Stripe::RequestParams
+      class Fpx < ::Stripe::RequestParams
         # Account holder type for FPX transaction
         attr_accessor :account_holder_type
         # The customer's bank.
@@ -178,10 +403,10 @@ module Stripe
         end
       end
 
-      class Giropay < Stripe::RequestParams; end
-      class Grabpay < Stripe::RequestParams; end
+      class Giropay < ::Stripe::RequestParams; end
+      class Grabpay < ::Stripe::RequestParams; end
 
-      class Ideal < Stripe::RequestParams
+      class Ideal < ::Stripe::RequestParams
         # The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
         attr_accessor :bank
 
@@ -190,11 +415,11 @@ module Stripe
         end
       end
 
-      class InteracPresent < Stripe::RequestParams; end
-      class KakaoPay < Stripe::RequestParams; end
+      class InteracPresent < ::Stripe::RequestParams; end
+      class KakaoPay < ::Stripe::RequestParams; end
 
-      class Klarna < Stripe::RequestParams
-        class Dob < Stripe::RequestParams
+      class Klarna < ::Stripe::RequestParams
+        class Dob < ::Stripe::RequestParams
           # The day of birth, between 1 and 31.
           attr_accessor :day
           # The month of birth, between 1 and 12.
@@ -216,14 +441,14 @@ module Stripe
         end
       end
 
-      class Konbini < Stripe::RequestParams; end
-      class KrCard < Stripe::RequestParams; end
-      class Link < Stripe::RequestParams; end
-      class MbWay < Stripe::RequestParams; end
-      class Mobilepay < Stripe::RequestParams; end
-      class Multibanco < Stripe::RequestParams; end
+      class Konbini < ::Stripe::RequestParams; end
+      class KrCard < ::Stripe::RequestParams; end
+      class Link < ::Stripe::RequestParams; end
+      class MbWay < ::Stripe::RequestParams; end
+      class Mobilepay < ::Stripe::RequestParams; end
+      class Multibanco < ::Stripe::RequestParams; end
 
-      class NaverPay < Stripe::RequestParams
+      class NaverPay < ::Stripe::RequestParams
         # Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
         attr_accessor :funding
 
@@ -232,7 +457,7 @@ module Stripe
         end
       end
 
-      class NzBankAccount < Stripe::RequestParams
+      class NzBankAccount < ::Stripe::RequestParams
         # The name on the bank account. Only required if the account holder name is different from the name of the authorized signatory collected in the PaymentMethod’s billing details.
         attr_accessor :account_holder_name
         # The account number for the bank account.
@@ -263,9 +488,9 @@ module Stripe
         end
       end
 
-      class Oxxo < Stripe::RequestParams; end
+      class Oxxo < ::Stripe::RequestParams; end
 
-      class P24 < Stripe::RequestParams
+      class P24 < ::Stripe::RequestParams
         # The customer's bank.
         attr_accessor :bank
 
@@ -274,15 +499,31 @@ module Stripe
         end
       end
 
-      class PayByBank < Stripe::RequestParams; end
-      class Payco < Stripe::RequestParams; end
-      class Paynow < Stripe::RequestParams; end
-      class Paypal < Stripe::RequestParams; end
-      class Pix < Stripe::RequestParams; end
-      class Promptpay < Stripe::RequestParams; end
+      class PayByBank < ::Stripe::RequestParams; end
+      class Payco < ::Stripe::RequestParams; end
+      class Paynow < ::Stripe::RequestParams; end
+      class Paypal < ::Stripe::RequestParams; end
+
+      class Payto < ::Stripe::RequestParams
+        # The account number for the bank account.
+        attr_accessor :account_number
+        # Bank-State-Branch number of the bank account.
+        attr_accessor :bsb_number
+        # The PayID alias for the bank account.
+        attr_accessor :pay_id
+
+        def initialize(account_number: nil, bsb_number: nil, pay_id: nil)
+          @account_number = account_number
+          @bsb_number = bsb_number
+          @pay_id = pay_id
+        end
+      end
+
+      class Pix < ::Stripe::RequestParams; end
+      class Promptpay < ::Stripe::RequestParams; end
 
-      class RadarOptions < Stripe::RequestParams
-        # A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
+      class RadarOptions < ::Stripe::RequestParams
+        # A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
         attr_accessor :session
 
         def initialize(session: nil)
@@ -290,11 +531,11 @@ module Stripe
         end
       end
 
-      class RevolutPay < Stripe::RequestParams; end
-      class SamsungPay < Stripe::RequestParams; end
-      class Satispay < Stripe::RequestParams; end
+      class RevolutPay < ::Stripe::RequestParams; end
+      class SamsungPay < ::Stripe::RequestParams; end
+      class Satispay < ::Stripe::RequestParams; end
 
-      class SepaDebit < Stripe::RequestParams
+      class SepaDebit < ::Stripe::RequestParams
         # IBAN of the bank account.
         attr_accessor :iban
 
@@ -303,7 +544,7 @@ module Stripe
         end
       end
 
-      class Sofort < Stripe::RequestParams
+      class Sofort < ::Stripe::RequestParams
         # Two-letter ISO code representing the country the bank account is located in.
         attr_accessor :country
 
@@ -312,10 +553,36 @@ module Stripe
         end
       end
 
-      class Swish < Stripe::RequestParams; end
-      class Twint < Stripe::RequestParams; end
+      class Swish < ::Stripe::RequestParams; end
+      class Twint < ::Stripe::RequestParams; end
+
+      class Upi < ::Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
+          # Amount to be charged for future payments.
+          attr_accessor :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_accessor :amount_type
+          # A description of the mandate or subscription that is meant to be displayed to the customer.
+          attr_accessor :description
+          # End date of the mandate or subscription.
+          attr_accessor :end_date
+
+          def initialize(amount: nil, amount_type: nil, description: nil, end_date: nil)
+            @amount = amount
+            @amount_type = amount_type
+            @description = description
+            @end_date = end_date
+          end
+        end
+        # Configuration options for setting up an eMandate
+        attr_accessor :mandate_options
+
+        def initialize(mandate_options: nil)
+          @mandate_options = mandate_options
+        end
+      end
 
-      class UsBankAccount < Stripe::RequestParams
+      class UsBankAccount < ::Stripe::RequestParams
         # Account holder type: individual or company.
         attr_accessor :account_holder_type
         # Account number of the bank account.
@@ -342,8 +609,8 @@ module Stripe
         end
       end
 
-      class WechatPay < Stripe::RequestParams; end
-      class Zip < Stripe::RequestParams; end
+      class WechatPay < ::Stripe::RequestParams; end
+      class Zip < ::Stripe::RequestParams; end
       # If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
       attr_accessor :acss_debit
       # If this is an `affirm` PaymentMethod, this hash contains details about the Affirm payment method.
@@ -402,7 +669,7 @@ module Stripe
       attr_accessor :link
       # If this is a MB WAY PaymentMethod, this hash contains details about the MB WAY payment method.
       attr_accessor :mb_way
-      # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
       attr_accessor :metadata
       # If this is a `mobilepay` PaymentMethod, this hash contains details about the MobilePay payment method.
       attr_accessor :mobilepay
@@ -424,11 +691,13 @@ module Stripe
       attr_accessor :paynow
       # If this is a `paypal` PaymentMethod, this hash contains details about the PayPal payment method.
       attr_accessor :paypal
+      # If this is a `payto` PaymentMethod, this hash contains details about the PayTo payment method.
+      attr_accessor :payto
       # If this is a `pix` PaymentMethod, this hash contains details about the Pix payment method.
       attr_accessor :pix
       # If this is a `promptpay` PaymentMethod, this hash contains details about the PromptPay payment method.
       attr_accessor :promptpay
-      # Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information.
+      # Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information.
       attr_accessor :radar_options
       # If this is a `revolut_pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
       attr_accessor :revolut_pay
@@ -446,6 +715,8 @@ module Stripe
       attr_accessor :twint
       # The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.
       attr_accessor :type
+      # If this is a `upi` PaymentMethod, this hash contains details about the UPI payment method.
+      attr_accessor :upi
       # If this is an `us_bank_account` PaymentMethod, this hash contains details about the US bank account payment method.
       attr_accessor :us_bank_account
       # If this is an `wechat_pay` PaymentMethod, this hash contains details about the wechat_pay payment method.
@@ -494,6 +765,7 @@ module Stripe
         payco: nil,
         paynow: nil,
         paypal: nil,
+        payto: nil,
         pix: nil,
         promptpay: nil,
         radar_options: nil,
@@ -505,6 +777,7 @@ module Stripe
         swish: nil,
         twint: nil,
         type: nil,
+        upi: nil,
         us_bank_account: nil,
         wechat_pay: nil,
         zip: nil
@@ -549,6 +822,7 @@ module Stripe
         @payco = payco
         @paynow = paynow
         @paypal = paypal
+        @payto = payto
         @pix = pix
         @promptpay = promptpay
         @radar_options = radar_options
@@ -560,15 +834,16 @@ module Stripe
         @swish = swish
         @twint = twint
         @type = type
+        @upi = upi
         @us_bank_account = us_bank_account
         @wechat_pay = wechat_pay
         @zip = zip
       end
     end
 
-    class PaymentMethodOptions < Stripe::RequestParams
-      class AcssDebit < Stripe::RequestParams
-        class MandateOptions < Stripe::RequestParams
+    class PaymentMethodOptions < ::Stripe::RequestParams
+      class AcssDebit < ::Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
           # A URL for custom mandate text to render during confirmation step.
           # The URL will be rendered with additional GET parameters `payment_intent` and `payment_intent_client_secret` when confirming a Payment Intent,
           # or `setup_intent` and `setup_intent_client_secret` when confirming a Setup Intent.
@@ -606,7 +881,7 @@ module Stripe
         attr_accessor :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_accessor :target_date
-        # Bank account verification method.
+        # Bank account verification method. The default value is `automatic`.
         attr_accessor :verification_method
 
         def initialize(
@@ -622,7 +897,7 @@ module Stripe
         end
       end
 
-      class Affirm < Stripe::RequestParams
+      class Affirm < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -649,7 +924,7 @@ module Stripe
         end
       end
 
-      class AfterpayClearpay < Stripe::RequestParams
+      class AfterpayClearpay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -677,7 +952,7 @@ module Stripe
         end
       end
 
-      class Alipay < Stripe::RequestParams
+      class Alipay < ::Stripe::RequestParams
         # 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.
@@ -694,7 +969,7 @@ module Stripe
         end
       end
 
-      class Alma < Stripe::RequestParams
+      class Alma < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -707,7 +982,7 @@ module Stripe
         end
       end
 
-      class AmazonPay < Stripe::RequestParams
+      class AmazonPay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -729,7 +1004,7 @@ module Stripe
         end
       end
 
-      class AuBecsDebit < Stripe::RequestParams
+      class AuBecsDebit < ::Stripe::RequestParams
         # 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.
@@ -749,8 +1024,8 @@ module Stripe
         end
       end
 
-      class BacsDebit < Stripe::RequestParams
-        class MandateOptions < Stripe::RequestParams
+      class BacsDebit < ::Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
           # 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_accessor :reference_prefix
 
@@ -780,7 +1055,7 @@ module Stripe
         end
       end
 
-      class Bancontact < Stripe::RequestParams
+      class Bancontact < ::Stripe::RequestParams
         # Preferred language of the Bancontact authorization page that the customer is redirected to.
         attr_accessor :preferred_language
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -800,7 +1075,7 @@ module Stripe
         end
       end
 
-      class Billie < Stripe::RequestParams
+      class Billie < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -813,7 +1088,7 @@ module Stripe
         end
       end
 
-      class Blik < Stripe::RequestParams
+      class Blik < ::Stripe::RequestParams
         # The 6-digit BLIK code that a customer has generated using their banking application. Can only be set on confirmation.
         attr_accessor :code
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -833,7 +1108,7 @@ module Stripe
         end
       end
 
-      class Boleto < Stripe::RequestParams
+      class Boleto < ::Stripe::RequestParams
         # 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 invoice will expire on Wednesday at 23:59 America/Sao_Paulo time.
         attr_accessor :expires_after_days
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -853,9 +1128,9 @@ module Stripe
         end
       end
 
-      class Card < Stripe::RequestParams
-        class Installments < Stripe::RequestParams
-          class Plan < Stripe::RequestParams
+      class Card < ::Stripe::RequestParams
+        class Installments < ::Stripe::RequestParams
+          class Plan < ::Stripe::RequestParams
             # For `fixed_count` installment plans, this is required. It represents the number of installment payments your customer will make to their credit card.
             attr_accessor :count
             # For `fixed_count` installment plans, this is required. It represents the interval between installment payments your customer will make to their credit card.
@@ -884,8 +1159,8 @@ module Stripe
           end
         end
 
-        class MandateOptions < Stripe::RequestParams
-          # Amount to be charged for future payments.
+        class MandateOptions < ::Stripe::RequestParams
+          # Amount to be charged for future payments, specified in the presentment currency.
           attr_accessor :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_accessor :amount_type
@@ -927,9 +1202,9 @@ module Stripe
           end
         end
 
-        class ThreeDSecure < Stripe::RequestParams
-          class NetworkOptions < Stripe::RequestParams
-            class CartesBancaires < Stripe::RequestParams
+        class ThreeDSecure < ::Stripe::RequestParams
+          class NetworkOptions < ::Stripe::RequestParams
+            class CartesBancaires < ::Stripe::RequestParams
               # The cryptogram calculation algorithm used by the card Issuer's ACS
               # to calculate the Authentication cryptogram. Also known as `cavvAlgorithm`.
               # messageExtension: CB-AVALGO
@@ -1011,7 +1286,7 @@ module Stripe
         attr_accessor :cvc_token
         # Installment configuration for payments attempted on this PaymentIntent.
         #
-        # 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_accessor :installments
         # Configuration options for setting up an eMandate for cards issued in India.
         attr_accessor :mandate_options
@@ -1021,15 +1296,15 @@ module Stripe
         attr_accessor :moto
         # Selected network to process this PaymentIntent on. Depends on the available networks of the card attached to the PaymentIntent. Can be only set confirm-time.
         attr_accessor :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_accessor :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_accessor :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_accessor :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_accessor :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_accessor :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_accessor :require_cvc_recollection
@@ -1088,8 +1363,8 @@ module Stripe
         end
       end
 
-      class CardPresent < Stripe::RequestParams
-        class Routing < Stripe::RequestParams
+      class CardPresent < ::Stripe::RequestParams
+        class Routing < ::Stripe::RequestParams
           # Routing requested priority
           attr_accessor :requested_priority
 
@@ -1097,25 +1372,33 @@ module Stripe
             @requested_priority = requested_priority
           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 are captured from the customer's account.
+        #
+        # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
+        #
+        # If `capture_method` is already set on the PaymentIntent, providing an empty value for this parameter unsets the stored value for this payment method type.
+        attr_accessor :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_accessor :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_accessor :request_incremental_authorization_support
         # Network routing priority on co-branded EMV cards supporting domestic debit and international card schemes.
         attr_accessor :routing
 
         def initialize(
+          capture_method: nil,
           request_extended_authorization: nil,
           request_incremental_authorization_support: nil,
           routing: nil
         )
+          @capture_method = capture_method
           @request_extended_authorization = request_extended_authorization
           @request_incremental_authorization_support = request_incremental_authorization_support
           @routing = routing
         end
       end
 
-      class Cashapp < Stripe::RequestParams
+      class Cashapp < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1139,7 +1422,7 @@ module Stripe
         end
       end
 
-      class Crypto < Stripe::RequestParams
+      class Crypto < ::Stripe::RequestParams
         # 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.
@@ -1156,10 +1439,10 @@ module Stripe
         end
       end
 
-      class CustomerBalance < Stripe::RequestParams
-        class BankTransfer < Stripe::RequestParams
-          class EuBankTransfer < Stripe::RequestParams
-            # The desired country code of the bank account information. Permitted values include: `BE`, `DE`, `ES`, `FR`, `IE`, or `NL`.
+      class CustomerBalance < ::Stripe::RequestParams
+        class BankTransfer < ::Stripe::RequestParams
+          class EuBankTransfer < ::Stripe::RequestParams
+            # The desired country code of the bank account information. Permitted values include: `DE`, `FR`, `IE`, or `NL`.
             attr_accessor :country
 
             def initialize(country: nil)
@@ -1203,7 +1486,7 @@ module Stripe
         end
       end
 
-      class Eps < Stripe::RequestParams
+      class Eps < ::Stripe::RequestParams
         # 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.
@@ -1220,7 +1503,7 @@ module Stripe
         end
       end
 
-      class Fpx < Stripe::RequestParams
+      class Fpx < ::Stripe::RequestParams
         # 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.
@@ -1237,7 +1520,7 @@ module Stripe
         end
       end
 
-      class Giropay < Stripe::RequestParams
+      class Giropay < ::Stripe::RequestParams
         # 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.
@@ -1254,7 +1537,7 @@ module Stripe
         end
       end
 
-      class Grabpay < Stripe::RequestParams
+      class Grabpay < ::Stripe::RequestParams
         # 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.
@@ -1271,7 +1554,7 @@ module Stripe
         end
       end
 
-      class Ideal < Stripe::RequestParams
+      class Ideal < ::Stripe::RequestParams
         # 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.
@@ -1288,9 +1571,9 @@ module Stripe
         end
       end
 
-      class InteracPresent < Stripe::RequestParams; end
+      class InteracPresent < ::Stripe::RequestParams; end
 
-      class KakaoPay < Stripe::RequestParams
+      class KakaoPay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1312,8 +1595,8 @@ module Stripe
         end
       end
 
-      class Klarna < Stripe::RequestParams
-        class OnDemand < Stripe::RequestParams
+      class Klarna < ::Stripe::RequestParams
+        class OnDemand < ::Stripe::RequestParams
           # Your average amount value. You can use a value across your customer base, or segment based on customer type, country, etc.
           attr_accessor :average_amount
           # The maximum value you may charge a customer per purchase. You can use a value across your customer base, or segment based on customer type, country, etc.
@@ -1340,8 +1623,8 @@ module Stripe
           end
         end
 
-        class Subscription < Stripe::RequestParams
-          class NextBilling < Stripe::RequestParams
+        class Subscription < ::Stripe::RequestParams
+          class NextBilling < ::Stripe::RequestParams
             # The amount of the next charge for the subscription.
             attr_accessor :amount
             # The date of the next charge for the subscription in YYYY-MM-DD format.
@@ -1415,7 +1698,7 @@ module Stripe
         end
       end
 
-      class Konbini < Stripe::RequestParams
+      class Konbini < ::Stripe::RequestParams
         # An optional 10 to 11 digit numeric-only string determining the confirmation code at applicable convenience stores. Must not consist of only zeroes and could be rejected in case of insufficient uniqueness. We recommend to use the customer's phone number.
         attr_accessor :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. Defaults to 3 days.
@@ -1450,7 +1733,7 @@ module Stripe
         end
       end
 
-      class KrCard < Stripe::RequestParams
+      class KrCard < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1472,7 +1755,7 @@ module Stripe
         end
       end
 
-      class Link < Stripe::RequestParams
+      class Link < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1499,7 +1782,7 @@ module Stripe
         end
       end
 
-      class MbWay < Stripe::RequestParams
+      class MbWay < ::Stripe::RequestParams
         # 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.
@@ -1516,7 +1799,7 @@ module Stripe
         end
       end
 
-      class Mobilepay < Stripe::RequestParams
+      class Mobilepay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1540,7 +1823,7 @@ module Stripe
         end
       end
 
-      class Multibanco < Stripe::RequestParams
+      class Multibanco < ::Stripe::RequestParams
         # 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.
@@ -1557,7 +1840,7 @@ module Stripe
         end
       end
 
-      class NaverPay < Stripe::RequestParams
+      class NaverPay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1579,7 +1862,7 @@ module Stripe
         end
       end
 
-      class NzBankAccount < Stripe::RequestParams
+      class NzBankAccount < ::Stripe::RequestParams
         # 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.
@@ -1599,7 +1882,7 @@ module Stripe
         end
       end
 
-      class Oxxo < Stripe::RequestParams
+      class Oxxo < ::Stripe::RequestParams
         # The number of calendar days before an OXXO voucher expires. For example, if you create an OXXO voucher 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_accessor :expires_after_days
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1619,7 +1902,7 @@ module Stripe
         end
       end
 
-      class P24 < Stripe::RequestParams
+      class P24 < ::Stripe::RequestParams
         # 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.
@@ -1639,9 +1922,9 @@ module Stripe
         end
       end
 
-      class PayByBank < Stripe::RequestParams; end
+      class PayByBank < ::Stripe::RequestParams; end
 
-      class Payco < Stripe::RequestParams
+      class Payco < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1654,7 +1937,7 @@ module Stripe
         end
       end
 
-      class Paynow < Stripe::RequestParams
+      class Paynow < ::Stripe::RequestParams
         # 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.
@@ -1671,10 +1954,10 @@ module Stripe
         end
       end
 
-      class Paypal < Stripe::RequestParams
+      class Paypal < ::Stripe::RequestParams
         # Controls when the funds will be captured from the customer's account.
         attr_accessor :capture_method
-        # [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to.
+        # [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to.
         attr_accessor :preferred_locale
         # A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
         attr_accessor :reference
@@ -1706,7 +1989,57 @@ module Stripe
         end
       end
 
-      class Pix < Stripe::RequestParams
+      class Payto < ::Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
+          # Amount that will be collected. It is required when `amount_type` is `fixed`.
+          attr_accessor :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_accessor :amount_type
+          # Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
+          attr_accessor :end_date
+          # The periodicity at which payments will be collected. Defaults to `adhoc`.
+          attr_accessor :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_accessor :payments_per_period
+          # The purpose for which payments are made. Has a default value based on your merchant category code.
+          attr_accessor :purpose
+
+          def initialize(
+            amount: nil,
+            amount_type: nil,
+            end_date: nil,
+            payment_schedule: nil,
+            payments_per_period: nil,
+            purpose: nil
+          )
+            @amount = amount
+            @amount_type = amount_type
+            @end_date = end_date
+            @payment_schedule = payment_schedule
+            @payments_per_period = payments_per_period
+            @purpose = purpose
+          end
+        end
+        # Additional fields for Mandate creation. Only `purpose` field is configurable for PayTo PaymentIntent with `setup_future_usage=none`. Other fields are only applicable to PayTo PaymentIntent with `setup_future_usage=off_session`
+        attr_accessor :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).
+        #
+        # If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
+        attr_accessor :setup_future_usage
+
+        def initialize(mandate_options: nil, setup_future_usage: nil)
+          @mandate_options = mandate_options
+          @setup_future_usage = setup_future_usage
+        end
+      end
+
+      class Pix < ::Stripe::RequestParams
         # Determines if the amount includes the IOF tax. Defaults to `never`.
         attr_accessor :amount_includes_iof
         # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
@@ -1737,7 +2070,7 @@ module Stripe
         end
       end
 
-      class Promptpay < Stripe::RequestParams
+      class Promptpay < ::Stripe::RequestParams
         # 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.
@@ -1754,7 +2087,7 @@ module Stripe
         end
       end
 
-      class RevolutPay < Stripe::RequestParams
+      class RevolutPay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1776,7 +2109,7 @@ module Stripe
         end
       end
 
-      class SamsungPay < Stripe::RequestParams
+      class SamsungPay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1789,7 +2122,7 @@ module Stripe
         end
       end
 
-      class Satispay < Stripe::RequestParams
+      class Satispay < ::Stripe::RequestParams
         # Controls when the funds are captured from the customer's account.
         #
         # If provided, this parameter overrides the behavior of the top-level [capture_method](/api/payment_intents/update#update_payment_intent-capture_method) for this payment method type when finalizing the payment with this payment method type.
@@ -1802,8 +2135,8 @@ module Stripe
         end
       end
 
-      class SepaDebit < Stripe::RequestParams
-        class MandateOptions < Stripe::RequestParams
+      class SepaDebit < ::Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
           # 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_accessor :reference_prefix
 
@@ -1833,7 +2166,7 @@ module Stripe
         end
       end
 
-      class Sofort < Stripe::RequestParams
+      class Sofort < ::Stripe::RequestParams
         # Language shown to the payer on redirect.
         attr_accessor :preferred_language
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1853,7 +2186,7 @@ module Stripe
         end
       end
 
-      class Swish < Stripe::RequestParams
+      class Swish < ::Stripe::RequestParams
         # A reference for this payment to be displayed in the Swish app.
         attr_accessor :reference
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1873,7 +2206,7 @@ module Stripe
         end
       end
 
-      class Twint < Stripe::RequestParams
+      class Twint < ::Stripe::RequestParams
         # 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.
@@ -1890,9 +2223,38 @@ module Stripe
         end
       end
 
-      class UsBankAccount < Stripe::RequestParams
-        class FinancialConnections < Stripe::RequestParams
-          class Filters < Stripe::RequestParams
+      class Upi < ::Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
+          # Amount to be charged for future payments.
+          attr_accessor :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_accessor :amount_type
+          # A description of the mandate or subscription that is meant to be displayed to the customer.
+          attr_accessor :description
+          # End date of the mandate or subscription.
+          attr_accessor :end_date
+
+          def initialize(amount: nil, amount_type: nil, description: nil, end_date: nil)
+            @amount = amount
+            @amount_type = amount_type
+            @description = description
+            @end_date = end_date
+          end
+        end
+        # Configuration options for setting up an eMandate
+        attr_accessor :mandate_options
+        # Attribute for param field setup_future_usage
+        attr_accessor :setup_future_usage
+
+        def initialize(mandate_options: nil, setup_future_usage: nil)
+          @mandate_options = mandate_options
+          @setup_future_usage = setup_future_usage
+        end
+      end
+
+      class UsBankAccount < ::Stripe::RequestParams
+        class FinancialConnections < ::Stripe::RequestParams
+          class Filters < ::Stripe::RequestParams
             # The account subcategories to use to filter for selectable accounts. Valid subcategories are `checking` and `savings`.
             attr_accessor :account_subcategories
 
@@ -1917,7 +2279,7 @@ module Stripe
           end
         end
 
-        class MandateOptions < Stripe::RequestParams
+        class MandateOptions < ::Stripe::RequestParams
           # The method used to collect offline mandate customer acceptance.
           attr_accessor :collection_method
 
@@ -1926,7 +2288,7 @@ module Stripe
           end
         end
 
-        class Networks < Stripe::RequestParams
+        class Networks < ::Stripe::RequestParams
           # Triggers validations to run across the selected networks
           attr_accessor :requested
 
@@ -1940,8 +2302,6 @@ module Stripe
         attr_accessor :mandate_options
         # Additional fields for network related functions
         attr_accessor :networks
-        # Preferred transaction settlement speed
-        attr_accessor :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.
@@ -1954,29 +2314,31 @@ module Stripe
         attr_accessor :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_accessor :target_date
-        # Bank account verification method.
+        # The purpose of the transaction.
+        attr_accessor :transaction_purpose
+        # Bank account verification method. The default value is `automatic`.
         attr_accessor :verification_method
 
         def initialize(
           financial_connections: nil,
           mandate_options: nil,
           networks: nil,
-          preferred_settlement_speed: nil,
           setup_future_usage: nil,
           target_date: nil,
+          transaction_purpose: nil,
           verification_method: nil
         )
           @financial_connections = financial_connections
           @mandate_options = mandate_options
           @networks = networks
-          @preferred_settlement_speed = preferred_settlement_speed
           @setup_future_usage = setup_future_usage
           @target_date = target_date
+          @transaction_purpose = transaction_purpose
           @verification_method = verification_method
         end
       end
 
-      class WechatPay < Stripe::RequestParams
+      class WechatPay < ::Stripe::RequestParams
         # The app ID registered with WeChat Pay. Only required when client is ios or android.
         attr_accessor :app_id
         # The client type that the end customer will pay from
@@ -1999,7 +2361,7 @@ module Stripe
         end
       end
 
-      class Zip < Stripe::RequestParams
+      class Zip < ::Stripe::RequestParams
         # 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.
@@ -2093,6 +2455,8 @@ module Stripe
       attr_accessor :paynow
       # If this is a `paypal` PaymentMethod, this sub-hash contains details about the PayPal payment method options.
       attr_accessor :paypal
+      # If this is a `payto` PaymentMethod, this sub-hash contains details about the PayTo payment method options.
+      attr_accessor :payto
       # If this is a `pix` PaymentMethod, this sub-hash contains details about the Pix payment method options.
       attr_accessor :pix
       # If this is a `promptpay` PaymentMethod, this sub-hash contains details about the PromptPay payment method options.
@@ -2111,6 +2475,8 @@ module Stripe
       attr_accessor :swish
       # If this is a `twint` PaymentMethod, this sub-hash contains details about the TWINT payment method options.
       attr_accessor :twint
+      # If this is a `upi` PaymentIntent, this sub-hash contains details about the UPI payment method options.
+      attr_accessor :upi
       # If this is a `us_bank_account` PaymentMethod, this sub-hash contains details about the US bank account payment method options.
       attr_accessor :us_bank_account
       # If this is a `wechat_pay` PaymentMethod, this sub-hash contains details about the WeChat Pay payment method options.
@@ -2158,6 +2524,7 @@ module Stripe
         payco: nil,
         paynow: nil,
         paypal: nil,
+        payto: nil,
         pix: nil,
         promptpay: nil,
         revolut_pay: nil,
@@ -2167,6 +2534,7 @@ module Stripe
         sofort: nil,
         swish: nil,
         twint: nil,
+        upi: nil,
         us_bank_account: nil,
         wechat_pay: nil,
         zip: nil
@@ -2210,6 +2578,7 @@ module Stripe
         @payco = payco
         @paynow = paynow
         @paypal = paypal
+        @payto = payto
         @pix = pix
         @promptpay = promptpay
         @revolut_pay = revolut_pay
@@ -2219,14 +2588,15 @@ module Stripe
         @sofort = sofort
         @swish = swish
         @twint = twint
+        @upi = upi
         @us_bank_account = us_bank_account
         @wechat_pay = wechat_pay
         @zip = zip
       end
     end
 
-    class RadarOptions < Stripe::RequestParams
-      # A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
+    class RadarOptions < ::Stripe::RequestParams
+      # A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
       attr_accessor :session
 
       def initialize(session: nil)
@@ -2234,8 +2604,8 @@ module Stripe
       end
     end
 
-    class Shipping < Stripe::RequestParams
-      class Address < Stripe::RequestParams
+    class Shipping < ::Stripe::RequestParams
+      class Address < ::Stripe::RequestParams
         # City, district, suburb, town, or village.
         attr_accessor :city
         # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -2246,7 +2616,7 @@ module Stripe
         attr_accessor :line2
         # ZIP or postal code.
         attr_accessor :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_accessor :state
 
         def initialize(
@@ -2284,36 +2654,42 @@ module Stripe
         @tracking_number = tracking_number
       end
     end
+    # Provides industry-specific information about the amount.
+    attr_accessor :amount_details
     # Controls when the funds will be captured from the customer's account.
     attr_accessor :capture_method
     # ID of the ConfirmationToken used to confirm this PaymentIntent.
     #
     # If the provided ConfirmationToken contains properties that are also being provided in this request, such as `payment_method`, then the values in this request will take precedence.
     attr_accessor :confirmation_token
-    # Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. This parameter is intended for simpler integrations that do not handle customer actions, like [saving cards without authentication](https://stripe.com/docs/payments/save-card-without-authentication).
+    # Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. This parameter is intended for simpler integrations that do not handle customer actions, like [saving cards without authentication](https://docs.stripe.com/payments/save-card-without-authentication).
     attr_accessor :error_on_requires_action
     # The list of payment method types to exclude from use with this payment.
     attr_accessor :excluded_payment_method_types
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
+    # Automations to be run during the PaymentIntent lifecycle
+    attr_accessor :hooks
     # ID of the mandate that's used for this payment.
     attr_accessor :mandate
     # Attribute for param field mandate_data
     attr_accessor :mandate_data
-    # Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://stripe.com/docs/payments/cards/charging-saved-cards).
+    # Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://docs.stripe.com/payments/cards/charging-saved-cards).
     attr_accessor :off_session
-    # ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://stripe.com/docs/payments/payment-methods/transitioning#compatibility) object) to attach to this PaymentIntent.
-    # If the payment method is attached to a Customer, it must match the [customer](https://stripe.com/docs/api#create_payment_intent-customer) that is set on this PaymentIntent.
+    # Provides industry-specific information about the charge.
+    attr_accessor :payment_details
+    # ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://docs.stripe.com/payments/payment-methods/transitioning#compatibility) object) to attach to this PaymentIntent.
+    # If the payment method is attached to a Customer, it must match the [customer](https://api.stripe.com#create_payment_intent-customer) that is set on this PaymentIntent.
     attr_accessor :payment_method
     # If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear
-    # in the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method)
+    # in the [payment_method](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-payment_method)
     # property on the PaymentIntent.
     attr_accessor :payment_method_data
     # Payment method-specific configuration for this PaymentIntent.
     attr_accessor :payment_method_options
     # The list of payment method types (for example, a card) that this PaymentIntent can use. Use `automatic_payment_methods` to manage payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). A list of valid payment method types can be found [here](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type).
     attr_accessor :payment_method_types
-    # Options to configure Radar. Learn more about [Radar Sessions](https://stripe.com/docs/radar/radar-session).
+    # Options to configure Radar. Learn more about [Radar Sessions](https://docs.stripe.com/radar/radar-session).
     attr_accessor :radar_options
     # Email address that the receipt for the resulting payment will be sent to. If `receipt_email` is specified for a payment in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
     attr_accessor :receipt_email
@@ -2337,14 +2713,17 @@ module Stripe
     attr_accessor :use_stripe_sdk
 
     def initialize(
+      amount_details: nil,
       capture_method: nil,
       confirmation_token: nil,
       error_on_requires_action: nil,
       excluded_payment_method_types: nil,
       expand: nil,
+      hooks: nil,
       mandate: nil,
       mandate_data: nil,
       off_session: nil,
+      payment_details: nil,
       payment_method: nil,
       payment_method_data: nil,
       payment_method_options: nil,
@@ -2356,14 +2735,17 @@ module Stripe
       shipping: nil,
       use_stripe_sdk: nil
     )
+      @amount_details = amount_details
       @capture_method = capture_method
       @confirmation_token = confirmation_token
       @error_on_requires_action = error_on_requires_action
       @excluded_payment_method_types = excluded_payment_method_types
       @expand = expand
+      @hooks = hooks
       @mandate = mandate
       @mandate_data = mandate_data
       @off_session = off_session
+      @payment_details = payment_details
       @payment_method = payment_method
       @payment_method_data = payment_method_data
       @payment_method_options = payment_method_options