stripe 14.0.0 → 14.1.0.pre.beta.1

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

@@ -60,6 +60,8 @@ module Stripe
         attr_reader :enabled
         # The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
         attr_reader :liability
+        # The tax provider powering automatic tax.
+        attr_reader :provider
         # The status of the most recent automated tax calculation for this session.
         attr_reader :status
       end
@@ -85,8 +87,23 @@ module Stripe
           # Customer name.
           attr_reader :name
         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
@@ -469,6 +486,8 @@ 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
@@ -732,6 +751,37 @@ 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
@@ -795,9 +845,18 @@ 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.
@@ -880,6 +939,8 @@ module Stripe
         attr_reader :paynow
         # Attribute for field paypal
         attr_reader :paypal
+        # Attribute for field payto
+        attr_reader :payto
         # Attribute for field pix
         attr_reader :pix
         # Attribute for field revolut_pay
@@ -897,6 +958,28 @@ 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 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 :update_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.
@@ -1041,6 +1124,8 @@ module Stripe
         attr_accessor :created
         # Only return the Checkout Sessions for the Customer specified.
         attr_accessor :customer
+        # Only return the Checkout Sessions for the Account specified.
+        attr_accessor :customer_account
         # Only return the Checkout Sessions for the Customer details specified.
         attr_accessor :customer_details
         # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
@@ -1063,6 +1148,7 @@ module Stripe
         def initialize(
           created: nil,
           customer: nil,
+          customer_account: nil,
           customer_details: nil,
           ending_before: nil,
           expand: nil,
@@ -1075,6 +1161,7 @@ module Stripe
         )
           @created = created
           @customer = customer
+          @customer_account = customer_account
           @customer_details = customer_details
           @ending_before = ending_before
           @expand = expand
@@ -1525,6 +1612,8 @@ 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.
@@ -1537,6 +1626,7 @@ module Stripe
           def initialize(
             adjustable_quantity: nil,
             dynamic_tax_rates: nil,
+            metadata: nil,
             price: nil,
             price_data: nil,
             quantity: nil,
@@ -1544,6 +1634,7 @@ module Stripe
           )
             @adjustable_quantity = adjustable_quantity
             @dynamic_tax_rates = dynamic_tax_rates
+            @metadata = metadata
             @price = price
             @price_data = price_data
             @quantity = quantity
@@ -1957,6 +2048,8 @@ 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
@@ -1983,6 +2076,7 @@ module Stripe
 
             def initialize(
               installments: nil,
+              request_decremental_authorization: nil,
               request_extended_authorization: nil,
               request_incremental_authorization: nil,
               request_multicapture: nil,
@@ -1994,6 +2088,7 @@ 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
@@ -2343,6 +2438,8 @@ 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.
@@ -2355,19 +2452,77 @@ 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
+              setup_future_usage: nil,
+              subsellers: 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
 
@@ -2579,6 +2734,8 @@ 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.
@@ -2628,6 +2785,7 @@ module Stripe
             payco: nil,
             paynow: nil,
             paypal: nil,
+            payto: nil,
             pix: nil,
             revolut_pay: nil,
             samsung_pay: nil,
@@ -2668,6 +2826,7 @@ module Stripe
             @payco = payco
             @paynow = paynow
             @paypal = paypal
+            @payto = payto
             @pix = pix
             @revolut_pay = revolut_pay
             @samsung_pay = samsung_pay
@@ -2680,6 +2839,33 @@ 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 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 :update_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.
@@ -2687,7 +2873,9 @@ module Stripe
           # 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_shipping_details: nil)
+          def initialize(update: nil, update_line_items: nil, update_shipping_details: nil)
+            @update = update
+            @update_line_items = update_line_items
             @update_shipping_details = update_shipping_details
           end
         end
@@ -3003,6 +3191,8 @@ module Stripe
         #
         # You can set [`payment_intent_data.setup_future_usage`](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse.
         attr_accessor :customer
+        # ID of an existing Account, if one exists. Has the same behavior as `customer`.
+        attr_accessor :customer_account
         # Configure whether a Checkout Session creates a [Customer](https://stripe.com/docs/api/customers) during Session confirmation.
         #
         # When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout
@@ -3130,6 +3320,7 @@ module Stripe
           custom_fields: nil,
           custom_text: nil,
           customer: nil,
+          customer_account: nil,
           customer_creation: nil,
           customer_email: nil,
           customer_update: nil,
@@ -3174,6 +3365,7 @@ module Stripe
           @custom_fields = custom_fields
           @custom_text = custom_text
           @customer = customer
+          @customer_account = customer_account
           @customer_creation = customer_creation
           @customer_email = customer_email
           @customer_update = customer_update
@@ -3259,6 +3451,51 @@ 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
@@ -3368,6 +3605,20 @@ 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`.
+        #
+        # 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.
@@ -3376,11 +3627,13 @@ 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
@@ -3432,7 +3685,8 @@ 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 your Checkout Session. Applies to Checkout Sessions with `ui_mode: embedded`. Client secret to be used when initializing Stripe.js embedded checkout.
+      # The client secret of your Checkout Session. Applies to Checkout Sessions with `ui_mode: embedded` or `ui_mode: custom`. For `ui_mode: embedded`, the client secret is to be used when initializing Stripe.js embedded checkout.
+      #  For `ui_mode: custom`, use the client secret with [initCheckout](https://stripe.com/docs/js/custom_checkout/init) on your front end.
       attr_reader :client_secret
       # Information about the customer collected within the Checkout Session.
       attr_reader :collected_information
@@ -3456,6 +3710,8 @@ module Stripe
       # during the payment flow unless an existing customer was provided when
       # the Session was created.
       attr_reader :customer
+      # The ID of the account for this Session.
+      attr_reader :customer_account
       # Configure whether a Checkout Session creates a Customer when the Checkout Session completes.
       attr_reader :customer_creation
       # The customer details including the customer's tax exempt status and the customer's tax IDs. Customer's address details are not present on Sessions in `setup` mode.
@@ -3518,7 +3774,7 @@ module Stripe
       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`. 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` 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.
       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