stripe 13.6.0.pre.beta.1 → 14.0.0

data/lib/stripe/resources/checkout/session.rb

@@ -82,32 +82,11 @@ module Stripe
           end
           # Attribute for field address
           attr_reader :address
-          # The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
-          attr_reader :carrier
-          # Recipient name.
+          # Customer name.
           attr_reader :name
-          # Recipient phone (including extension).
-          attr_reader :phone
-          # The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
-          attr_reader :tracking_number
         end
-
-        class TaxId < Stripe::StripeObject
-          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, or `unknown`
-          attr_reader :type
-          # The value of the tax ID.
-          attr_reader :value
-        end
-        # Customer’s business name for this Checkout Session
-        attr_reader :business_name
-        # Customer’s email for this Checkout Session
-        attr_reader :email
-        # Customer’s phone number for this Checkout Session
-        attr_reader :phone
         # Shipping information for this Checkout Session.
         attr_reader :shipping_details
-        # Customer’s tax ids for this Checkout Session.
-        attr_reader :tax_ids
       end
 
       class Consent < Stripe::StripeObject
@@ -321,6 +300,23 @@ module Stripe
         attr_reader :invoice_data
       end
 
+      class OptionalItem < Stripe::StripeObject
+        class AdjustableQuantity < Stripe::StripeObject
+          # Set to true if the quantity can be adjusted to any non-negative integer.
+          attr_reader :enabled
+          # The maximum quantity of this item the customer can purchase. By default this value is 99. You can specify a value up to 999999.
+          attr_reader :maximum
+          # The minimum quantity of this item the customer must purchase, if they choose to purchase it. Because this item is optional, the customer will always be able to remove it from their order, even if the `minimum` configured here is greater than 0. By default this value is 0.
+          attr_reader :minimum
+        end
+        # Attribute for field adjustable_quantity
+        attr_reader :adjustable_quantity
+        # Attribute for field price
+        attr_reader :price
+        # Attribute for field quantity
+        attr_reader :quantity
+      end
+
       class PaymentMethodConfigurationDetails < Stripe::StripeObject
         # ID of the payment method configuration used.
         attr_reader :id
@@ -473,8 +469,6 @@ module Stripe
           # Attribute for field installments
           attr_reader :installments
           # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
-          attr_reader :request_decremental_authorization
-          # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
           attr_reader :request_extended_authorization
           # Request ability to [increment the authorization](/payments/incremental-authorization) for this CheckoutSession.
           attr_reader :request_incremental_authorization
@@ -738,37 +732,6 @@ module Stripe
           #
           # 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
-          # The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
-          attr_reader :subsellers
-        end
-
-        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.
-            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.
-            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. Defaults to retail.
-            attr_reader :purpose
-            # Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
-            attr_reader :start_date
-          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
         end
 
         class Pix < Stripe::StripeObject
@@ -832,18 +795,9 @@ module Stripe
             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
-              # The institution to use to filter for possible accounts to link.
-              attr_reader :institution
-            end
-
-            class ManualEntry < Stripe::StripeObject
-              # Settings for configuring manual entry of account details.
-              attr_reader :mode
             end
             # Attribute for field filters
             attr_reader :filters
-            # Attribute for field manual_entry
-            attr_reader :manual_entry
             # The list of permissions to request. The `payment_method` permission must be included.
             attr_reader :permissions
             # Data features requested to be retrieved upon account creation.
@@ -926,8 +880,6 @@ 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 revolut_pay
@@ -945,22 +897,12 @@ module Stripe
       end
 
       class Permissions < Stripe::StripeObject
-        class Update < Stripe::StripeObject
-          # Determines which entity is allowed to update the line items.
-          #
-          # Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
-          #
-          # When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
-          attr_reader :line_items
-          # Determines which entity is allowed to update the shipping details.
-          #
-          # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
-          #
-          # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
-          attr_reader :shipping_details
-        end
-        # Permissions for updating the Checkout Session.
-        attr_reader :update
+        # Determines which entity is allowed to update the shipping details.
+        #
+        # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
+        #
+        # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
+        attr_reader :update_shipping_details
       end
 
       class PhoneNumberCollection < Stripe::StripeObject
@@ -968,6 +910,13 @@ module Stripe
         attr_reader :enabled
       end
 
+      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.
+        attr_reader :presentment_currency
+      end
+
       class SavedPaymentMethodOptions < Stripe::StripeObject
         # Uses the `allow_redisplay` value of each saved payment method to filter the set presented to a returning customer. By default, only saved payment methods with ’allow_redisplay: ‘always’ are shown in Checkout.
         attr_reader :allow_redisplay_filters
@@ -1008,33 +957,6 @@ module Stripe
         attr_reader :taxes
       end
 
-      class ShippingDetails < 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)).
-          attr_reader :country
-          # Address line 1 (e.g., street, PO Box, or company name).
-          attr_reader :line1
-          # Address line 2 (e.g., apartment, suite, unit, or building).
-          attr_reader :line2
-          # ZIP or postal code.
-          attr_reader :postal_code
-          # State, county, province, or region.
-          attr_reader :state
-        end
-        # Attribute for field address
-        attr_reader :address
-        # The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
-        attr_reader :carrier
-        # Recipient name.
-        attr_reader :name
-        # Recipient phone (including extension).
-        attr_reader :phone
-        # The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
-        attr_reader :tracking_number
-      end
-
       class ShippingOption < Stripe::StripeObject
         # A non-negative integer in cents representing how much to charge.
         attr_reader :shipping_amount
@@ -1568,9 +1490,9 @@ module Stripe
             end
             # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
             attr_accessor :currency
-            # The ID of the product that this price will belong to. One of `product` or `product_data` is required.
+            # The ID of the [Product](https://docs.stripe.com/api/products) that this [Price](https://docs.stripe.com/api/prices) will belong to. One of `product` or `product_data` is required.
             attr_accessor :product
-            # Data used to generate a new product object inline. One of `product` or `product_data` is required.
+            # Data used to generate a new [Product](https://docs.stripe.com/api/products) object inline. One of `product` or `product_data` is required.
             attr_accessor :product_data
             # The recurring components of a price such as `interval` and `interval_count`.
             attr_accessor :recurring
@@ -1603,8 +1525,6 @@ module Stripe
           attr_accessor :adjustable_quantity
           # The [tax rates](https://stripe.com/docs/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU.
           attr_accessor :dynamic_tax_rates
-          # 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`.
-          attr_accessor :metadata
           # The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required.
           attr_accessor :price
           # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
@@ -1617,7 +1537,6 @@ module Stripe
           def initialize(
             adjustable_quantity: nil,
             dynamic_tax_rates: nil,
-            metadata: nil,
             price: nil,
             price_data: nil,
             quantity: nil,
@@ -1625,7 +1544,6 @@ module Stripe
           )
             @adjustable_quantity = adjustable_quantity
             @dynamic_tax_rates = dynamic_tax_rates
-            @metadata = metadata
             @price = price
             @price_data = price_data
             @quantity = quantity
@@ -1633,6 +1551,35 @@ module Stripe
           end
         end
 
+        class OptionalItem < Stripe::RequestParams
+          class AdjustableQuantity < Stripe::RequestParams
+            # Set to true if the quantity can be adjusted to any non-negative integer.
+            attr_accessor :enabled
+            # The maximum quantity of this item the customer can purchase. By default this value is 99. You can specify a value up to 999999.
+            attr_accessor :maximum
+            # The minimum quantity of this item the customer must purchase, if they choose to purchase it. Because this item is optional, the customer will always be able to remove it from their order, even if the `minimum` configured here is greater than 0. By default this value is 0.
+            attr_accessor :minimum
+
+            def initialize(enabled: nil, maximum: nil, minimum: nil)
+              @enabled = enabled
+              @maximum = maximum
+              @minimum = minimum
+            end
+          end
+          # When set, provides configuration for the customer to adjust the quantity of the line item created when a customer chooses to add this optional item to their order.
+          attr_accessor :adjustable_quantity
+          # The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object.
+          attr_accessor :price
+          # The initial quantity of the line item created when a customer chooses to add this optional item to their order.
+          attr_accessor :quantity
+
+          def initialize(adjustable_quantity: nil, price: nil, quantity: nil)
+            @adjustable_quantity = adjustable_quantity
+            @price = price
+            @quantity = quantity
+          end
+        end
+
         class PaymentIntentData < Stripe::RequestParams
           class Shipping < Stripe::RequestParams
             class Address < Stripe::RequestParams
@@ -1699,7 +1646,7 @@ module Stripe
               @destination = destination
             end
           end
-          # 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 payment amount. 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://stripe.com/docs/payments/connected-accounts).
           attr_accessor :application_fee_amount
           # Controls when the funds will be captured from the customer's account.
           attr_accessor :capture_method
@@ -2010,8 +1957,6 @@ module Stripe
             # Installment options for card payments
             attr_accessor :installments
             # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
-            attr_accessor :request_decremental_authorization
-            # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
             attr_accessor :request_extended_authorization
             # Request ability to [increment the authorization](/payments/incremental-authorization) for this CheckoutSession.
             attr_accessor :request_incremental_authorization
@@ -2038,7 +1983,6 @@ module Stripe
 
             def initialize(
               installments: nil,
-              request_decremental_authorization: nil,
               request_extended_authorization: nil,
               request_incremental_authorization: nil,
               request_multicapture: nil,
@@ -2050,7 +1994,6 @@ module Stripe
               statement_descriptor_suffix_kanji: nil
             )
               @installments = installments
-              @request_decremental_authorization = request_decremental_authorization
               @request_extended_authorization = request_extended_authorization
               @request_incremental_authorization = request_incremental_authorization
               @request_multicapture = request_multicapture
@@ -2400,8 +2343,6 @@ module Stripe
             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
-            # 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_id
             # The risk correlation ID for an on-session payment using a saved PayPal payment method.
             attr_accessor :risk_correlation_id
             # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -2414,77 +2355,19 @@ module Stripe
             #
             # 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
-            # The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
-            attr_accessor :subsellers
 
             def initialize(
               capture_method: nil,
               preferred_locale: nil,
               reference: nil,
-              reference_id: nil,
               risk_correlation_id: nil,
-              setup_future_usage: nil,
-              subsellers: nil
+              setup_future_usage: nil
             )
               @capture_method = capture_method
               @preferred_locale = preferred_locale
               @reference = reference
-              @reference_id = reference_id
               @risk_correlation_id = risk_correlation_id
               @setup_future_usage = setup_future_usage
-              @subsellers = subsellers
-            end
-          end
-
-          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.
-              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.
-              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. Defaults to retail.
-              attr_accessor :purpose
-              # Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
-              attr_accessor :start_date
-
-              def initialize(
-                amount: nil,
-                amount_type: nil,
-                end_date: nil,
-                payment_schedule: nil,
-                payments_per_period: nil,
-                purpose: nil,
-                start_date: nil
-              )
-                @amount = amount
-                @amount_type = amount_type
-                @end_date = end_date
-                @payment_schedule = payment_schedule
-                @payments_per_period = payments_per_period
-                @purpose = purpose
-                @start_date = start_date
-              end
-            end
-            # Additional fields for Mandate creation
-            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).
-            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
 
@@ -2696,8 +2579,6 @@ module Stripe
           attr_accessor :paynow
           # contains details about the PayPal payment method options.
           attr_accessor :paypal
-          # contains details about the PayTo payment method options.
-          attr_accessor :payto
           # contains details about the Pix payment method options.
           attr_accessor :pix
           # contains details about the RevolutPay payment method options.
@@ -2747,7 +2628,6 @@ module Stripe
             payco: nil,
             paynow: nil,
             paypal: nil,
-            payto: nil,
             pix: nil,
             revolut_pay: nil,
             samsung_pay: nil,
@@ -2788,7 +2668,6 @@ module Stripe
             @payco = payco
             @paynow = paynow
             @paypal = paypal
-            @payto = payto
             @pix = pix
             @revolut_pay = revolut_pay
             @samsung_pay = samsung_pay
@@ -2801,30 +2680,15 @@ module Stripe
         end
 
         class Permissions < Stripe::RequestParams
-          class Update < Stripe::RequestParams
-            # Determines which entity is allowed to update the line items.
-            #
-            # Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
-            #
-            # When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
-            attr_accessor :line_items
-            # Determines which entity is allowed to update the shipping details.
-            #
-            # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
-            #
-            # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
-            attr_accessor :shipping_details
-
-            def initialize(line_items: nil, shipping_details: nil)
-              @line_items = line_items
-              @shipping_details = shipping_details
-            end
-          end
-          # Permissions for updating the Checkout Session.
-          attr_accessor :update
+          # Determines which entity is allowed to update the shipping details.
+          #
+          # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
+          #
+          # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
+          attr_accessor :update_shipping_details
 
-          def initialize(update: nil)
-            @update = update
+          def initialize(update_shipping_details: nil)
+            @update_shipping_details = update_shipping_details
           end
         end
 
@@ -3177,6 +3041,14 @@ module Stripe
         attr_accessor :metadata
         # The mode of the Checkout Session. Pass `subscription` if the Checkout Session includes at least one recurring item.
         attr_accessor :mode
+        # A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
+        #
+        # There is a maximum of 10 optional items allowed on a Checkout Session, and the existing limits on the number of line items allowed on a Checkout Session apply to the combined number of line items and optional items.
+        #
+        # For `payment` mode, there is a maximum of 100 combined line items and optional items, however it is recommended to consolidate items if there are more than a few dozen.
+        #
+        # For `subscription` mode, there is a maximum of 20 line items and optional items with recurring Prices and 20 line items and optional items with one-time Prices.
+        attr_accessor :optional_items
         # A subset of parameters to be passed to PaymentIntent creation for Checkout Sessions in `payment` mode.
         attr_accessor :payment_intent_data
         # Specify whether Checkout should collect a payment method. When set to `if_required`, Checkout will not collect a payment method when the total due for the session is 0.
@@ -3227,9 +3099,10 @@ module Stripe
         attr_accessor :shipping_address_collection
         # The shipping rate options to apply to this Session. Up to a maximum of 5.
         attr_accessor :shipping_options
-        # Describes the type of transaction being performed by Checkout in order to customize
-        # relevant text on the page, such as the submit button. `submit_type` can only be
-        # specified on Checkout Sessions in `payment` mode. If blank or `auto`, `pay` is used.
+        # Describes the type of transaction being performed by Checkout in order
+        # to customize relevant text on the page, such as the submit button.
+        #  `submit_type` can only be specified on Checkout Sessions in
+        # `payment` or `subscription` mode. If blank or `auto`, `pay` is used.
         attr_accessor :submit_type
         # A subset of parameters to be passed to subscription creation for Checkout Sessions in `subscription` mode.
         attr_accessor :subscription_data
@@ -3268,6 +3141,7 @@ module Stripe
           locale: nil,
           metadata: nil,
           mode: nil,
+          optional_items: nil,
           payment_intent_data: nil,
           payment_method_collection: nil,
           payment_method_configuration: nil,
@@ -3311,6 +3185,7 @@ module Stripe
           @locale = locale
           @metadata = metadata
           @mode = mode
+          @optional_items = optional_items
           @payment_intent_data = payment_intent_data
           @payment_method_collection = payment_method_collection
           @payment_method_configuration = payment_method_configuration
@@ -3333,15 +3208,6 @@ module Stripe
         end
       end
 
-      class RetrieveParams < Stripe::RequestParams
-        # Specifies which fields in the response should be expanded.
-        attr_accessor :expand
-
-        def initialize(expand: nil)
-          @expand = expand
-        end
-      end
-
       class UpdateParams < Stripe::RequestParams
         class CollectedInformation < Stripe::RequestParams
           class ShippingDetails < Stripe::RequestParams
@@ -3393,51 +3259,6 @@ module Stripe
           end
         end
 
-        class LineItem < Stripe::RequestParams
-          class AdjustableQuantity < Stripe::RequestParams
-            # Set to true if the quantity can be adjusted to any positive integer. Setting to false will remove any previously specified constraints on quantity.
-            attr_accessor :enabled
-            # The maximum quantity the customer can purchase for the Checkout Session. By default this value is 99. You can specify a value up to 999999.
-            attr_accessor :maximum
-            # The minimum quantity the customer must purchase for the Checkout Session. By default this value is 0.
-            attr_accessor :minimum
-
-            def initialize(enabled: nil, maximum: nil, minimum: nil)
-              @enabled = enabled
-              @maximum = maximum
-              @minimum = minimum
-            end
-          end
-          # When set, provides configuration for this item’s quantity to be adjusted by the customer during Checkout.
-          attr_accessor :adjustable_quantity
-          # ID of an existing line item.
-          attr_accessor :id
-          # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. 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
-          # The ID of the [Price](https://stripe.com/docs/api/prices).
-          attr_accessor :price
-          # The quantity of the line item being purchased.
-          attr_accessor :quantity
-          # The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item.
-          attr_accessor :tax_rates
-
-          def initialize(
-            adjustable_quantity: nil,
-            id: nil,
-            metadata: nil,
-            price: nil,
-            quantity: nil,
-            tax_rates: nil
-          )
-            @adjustable_quantity = adjustable_quantity
-            @id = id
-            @metadata = metadata
-            @price = price
-            @quantity = quantity
-            @tax_rates = tax_rates
-          end
-        end
-
         class ShippingOption < Stripe::RequestParams
           class ShippingRateData < Stripe::RequestParams
             class DeliveryEstimate < Stripe::RequestParams
@@ -3547,20 +3368,6 @@ module Stripe
         attr_accessor :collected_information
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand
-        # A list of items the customer is purchasing.
-        #
-        # When updating line items, you must retransmit the entire array of line items.
-        #
-        # To retain an existing line item, specify its `id`.
-        #
-        # To update an existing line item, specify its `id` along with the new values of the fields to update.
-        #
-        # To add a new line item, specify a `price` and `quantity`. We don't currently support recurring prices.
-        #
-        # To remove an existing line item, omit the line item's ID from the retransmitted array.
-        #
-        # To reorder a line item, specify it at the desired position in the retransmitted array.
-        attr_accessor :line_items
         # 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`.
         attr_accessor :metadata
         # The shipping rate options to apply to this Session. Up to a maximum of 5.
@@ -3569,13 +3376,11 @@ module Stripe
         def initialize(
           collected_information: nil,
           expand: nil,
-          line_items: nil,
           metadata: nil,
           shipping_options: nil
         )
           @collected_information = collected_information
           @expand = expand
-          @line_items = line_items
           @metadata = metadata
           @shipping_options = shipping_options
         end
@@ -3627,7 +3432,7 @@ module Stripe
       # customer ID, a cart ID, or similar, and can be used to reconcile the
       # Session with your internal systems.
       attr_reader :client_reference_id
-      # The client secret of the Session. Use this with [initCheckout](https://stripe.com/docs/js/custom_checkout/init) on your front end.
+      # The client secret of your Checkout Session. Applies to Checkout Sessions with `ui_mode: embedded`. Client secret to be used when initializing Stripe.js embedded checkout.
       attr_reader :client_secret
       # Information about the customer collected within the Checkout Session.
       attr_reader :collected_information
@@ -3639,7 +3444,7 @@ module Stripe
       attr_reader :created
       # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
       attr_reader :currency
-      # Currency conversion details for [Adaptive Pricing](https://docs.stripe.com/payments/checkout/adaptive-pricing) sessions
+      # Currency conversion details for [Adaptive Pricing](https://docs.stripe.com/payments/checkout/adaptive-pricing) sessions created before 2025-03-31.
       attr_reader :currency_conversion
       # Collect additional information from your customer using custom fields. Up to 3 fields are supported.
       attr_reader :custom_fields
@@ -3683,6 +3488,8 @@ module Stripe
       attr_reader :mode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
+      # The optional items presented to the customer at checkout.
+      attr_reader :optional_items
       # The ID of the PaymentIntent for Checkout Sessions in `payment` mode. You can't confirm or cancel the PaymentIntent for a Checkout Session. To cancel, [expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead.
       attr_reader :payment_intent
       # The ID of the Payment Link that created this Session.
@@ -3705,11 +3512,13 @@ module Stripe
       attr_reader :permissions
       # Attribute for field phone_number_collection
       attr_reader :phone_number_collection
+      # Attribute for field presentment_details
+      attr_reader :presentment_details
       # The ID of the original expired Checkout Session that triggered the recovery flow.
       attr_reader :recovered_from
       # This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://stripe.com/docs/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`.
       attr_reader :redirect_on_completion
-      # Applies to Checkout Sessions with `ui_mode: embedded` or `ui_mode: custom`. The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site.
+      # Applies to Checkout Sessions with `ui_mode: embedded`. The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site.
       attr_reader :return_url
       # Controls saved payment method settings for the session. Only available in `payment` and `subscription` mode.
       attr_reader :saved_payment_method_options
@@ -3719,8 +3528,6 @@ module Stripe
       attr_reader :shipping_address_collection
       # The details of the customer cost of shipping, including the customer chosen ShippingRate.
       attr_reader :shipping_cost
-      # Shipping information for this Checkout Session.
-      attr_reader :shipping_details
       # The shipping rate options applied to this Session.
       attr_reader :shipping_options
       # The status of the Checkout Session, one of `open`, `complete`, or `expired`.
@@ -3740,11 +3547,11 @@ module Stripe
       attr_reader :total_details
       # The UI mode of the Session. Defaults to `hosted`.
       attr_reader :ui_mode
-      # The URL to the Checkout Session. Redirect customers to this URL to take them to Checkout. If you’re using [Custom Domains](https://stripe.com/docs/payments/checkout/custom-domains), the URL will use your subdomain. Otherwise, it’ll use `checkout.stripe.com.`
+      # The URL to the Checkout Session. Applies to Checkout Sessions with `ui_mode: hosted`. Redirect customers to this URL to take them to Checkout. If you’re using [Custom Domains](https://stripe.com/docs/payments/checkout/custom-domains), the URL will use your subdomain. Otherwise, it’ll use `checkout.stripe.com.`
       # This value is only present when the session is active.
       attr_reader :url
 
-      # Creates a Session object.
+      # Creates a Checkout Session object.
       def self.create(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -3754,9 +3561,9 @@ module Stripe
         )
       end
 
-      # A Session can be expired when it is in one of these statuses: open
+      # A Checkout Session can be expired when it is in one of these statuses: open
       #
-      # After it expires, a customer can't complete a Session and customers loading the Session see a message saying the Session is expired.
+      # After it expires, a customer can't complete a Checkout Session and customers loading the Checkout Session see a message saying the Checkout Session is expired.
       def expire(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -3766,9 +3573,9 @@ module Stripe
         )
       end
 
-      # A Session can be expired when it is in one of these statuses: open
+      # A Checkout Session can be expired when it is in one of these statuses: open
       #
-      # After it expires, a customer can't complete a Session and customers loading the Session see a message saying the Session is expired.
+      # After it expires, a customer can't complete a Checkout Session and customers loading the Checkout Session see a message saying the Checkout Session is expired.
       def self.expire(session, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -3808,7 +3615,7 @@ module Stripe
         )
       end
 
-      # Updates a Session object.
+      # Updates a Checkout Session object.
       def self.update(session, params = {}, opts = {})
         request_stripe_object(
           method: :post,