stripe 15.0.0 → 15.3.0

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

@@ -16,7 +16,7 @@ module Stripe
     # Create sessions on-demand when customers intend to manage their subscriptions
     # and billing details.
     #
-    # Related guide: [Customer management](https://stripe.com/customer-management)
+    # Related guide: [Customer management](https://docs.stripe.com/customer-management)
     class Session < APIResource
       extend Stripe::APIOperations::Create
 
@@ -82,7 +82,7 @@ module Stripe
             # [Quantity](https://stripe.com/docs/subscriptions/quantities) for this item that the customer should subscribe to through this flow.
             attr_reader :quantity
           end
-          # The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
+          # The coupon or promotion code to apply to this subscription update.
           attr_reader :discounts
           # The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
           attr_reader :items
@@ -202,7 +202,7 @@ module Stripe
                 @quantity = quantity
               end
             end
-            # The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
+            # The coupon or promotion code to apply to this subscription update.
             attr_accessor :discounts
             # The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
             attr_accessor :items

data/lib/stripe/resources/capability.rb

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

data/lib/stripe/resources/charge.rb

@@ -43,6 +43,8 @@ module Stripe
       attr_reader :name
       # Billing phone number (including extension).
       attr_reader :phone
+      # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+      attr_reader :tax_id
     end
 
     class FraudDetails < Stripe::StripeObject
@@ -155,6 +157,10 @@ module Stripe
       end
 
       class Affirm < Stripe::StripeObject
+        # ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+        attr_reader :location
+        # ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+        attr_reader :reader
         # The Affirm transaction ID associated with this payment.
         attr_reader :transaction_id
       end
@@ -284,7 +290,7 @@ module Stripe
             # For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card.
             # One of `month`.
             attr_reader :interval
-            # Type of installment plan, one of `fixed_count`.
+            # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
             attr_reader :type
           end
           # Installment plan selected for the payment.
@@ -468,7 +474,7 @@ module Stripe
         attr_reader :iin
         # Attribute for field incremental_authorization
         attr_reader :incremental_authorization
-        # Installment details for this payment (Mexico only).
+        # Installment details for this payment.
         #
         # For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
         attr_reader :installments
@@ -509,9 +515,9 @@ module Stripe
         class Receipt < Stripe::StripeObject
           # The type of account being debited or credited
           attr_reader :account_type
-          # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+          # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
           attr_reader :application_cryptogram
-          # Mnenomic of the Application Identifier.
+          # The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
           attr_reader :application_preferred_name
           # Identifier for this transaction.
           attr_reader :authorization_code
@@ -519,11 +525,11 @@ module Stripe
           attr_reader :authorization_response_code
           # Describes the method used by the cardholder to verify ownership of the card. One of the following: `approval`, `failure`, `none`, `offline_pin`, `offline_pin_and_signature`, `online_pin`, or `signature`.
           attr_reader :cardholder_verification_method
-          # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+          # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
           attr_reader :dedicated_file_name
-          # The outcome of a series of EMV functions performed by the card reader.
+          # A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
           attr_reader :terminal_verification_results
-          # An indication of various EMV functions performed during the transaction.
+          # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
           attr_reader :transaction_status_information
         end
 
@@ -575,7 +581,7 @@ module Stripe
         attr_reader :offline
         # Defines whether the authorized amount can be over-captured or not
         attr_reader :overcapture_supported
-        # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+        # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
         attr_reader :preferred_locales
         # How card details were read in this transaction.
         attr_reader :read_method
@@ -592,6 +598,17 @@ module Stripe
         attr_reader :cashtag
       end
 
+      class Crypto < Stripe::StripeObject
+        # The wallet address of the customer.
+        attr_reader :buyer_address
+        # The blockchain network that the transaction was sent on.
+        attr_reader :network
+        # The token currency that the transaction was sent with.
+        attr_reader :token_currency
+        # The blockchain transaction hash of the crypto payment.
+        attr_reader :transaction_hash
+      end
+
       class CustomerBalance < Stripe::StripeObject; end
 
       class Eps < Stripe::StripeObject
@@ -631,7 +648,7 @@ module Stripe
       end
 
       class Ideal < Stripe::StripeObject
-        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+        # The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
         attr_reader :bank
         # The Bank Identifier Code of the customer's bank.
         attr_reader :bic
@@ -650,9 +667,9 @@ module Stripe
         class Receipt < Stripe::StripeObject
           # The type of account being debited or credited
           attr_reader :account_type
-          # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+          # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
           attr_reader :application_cryptogram
-          # Mnenomic of the Application Identifier.
+          # The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
           attr_reader :application_preferred_name
           # Identifier for this transaction.
           attr_reader :authorization_code
@@ -660,11 +677,11 @@ module Stripe
           attr_reader :authorization_response_code
           # Describes the method used by the cardholder to verify ownership of the card. One of the following: `approval`, `failure`, `none`, `offline_pin`, `offline_pin_and_signature`, `online_pin`, or `signature`.
           attr_reader :cardholder_verification_method
-          # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+          # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
           attr_reader :dedicated_file_name
-          # The outcome of a series of EMV functions performed by the card reader.
+          # A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
           attr_reader :terminal_verification_results
-          # An indication of various EMV functions performed during the transaction.
+          # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
           attr_reader :transaction_status_information
         end
         # Card brand. Can be `interac`, `mastercard` or `visa`.
@@ -699,7 +716,7 @@ module Stripe
         attr_reader :network
         # This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
         attr_reader :network_transaction_id
-        # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+        # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
         attr_reader :preferred_locales
         # How card details were read in this transaction.
         attr_reader :read_method
@@ -976,6 +993,10 @@ module Stripe
       class WechatPay < Stripe::StripeObject
         # Uniquely identifies this particular WeChat Pay account. You can use this attribute to check whether two WeChat accounts are the same.
         attr_reader :fingerprint
+        # ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+        attr_reader :location
+        # ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+        attr_reader :reader
         # Transaction ID of this particular WeChat Pay transaction.
         attr_reader :transaction_id
       end
@@ -1015,6 +1036,8 @@ module Stripe
       attr_reader :card_present
       # Attribute for field cashapp
       attr_reader :cashapp
+      # Attribute for field crypto
+      attr_reader :crypto
       # Attribute for field customer_balance
       attr_reader :customer_balance
       # Attribute for field eps
@@ -1634,9 +1657,9 @@ module Stripe
 
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     def capture(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -1648,9 +1671,9 @@ module Stripe
 
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     def self.capture(charge, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -1660,7 +1683,7 @@ module Stripe
       )
     end
 
-    # This method is no longer recommended—use the [Payment Intents API](https://stripe.com/docs/api/payment_intents)
+    # This method is no longer recommended—use the [Payment Intents API](https://docs.stripe.com/docs/api/payment_intents)
     # to initiate a new payment instead. Confirmation of the PaymentIntent creates the Charge
     # object used to request payment.
     def self.create(params = {}, opts = {})

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
@@ -232,7 +234,7 @@ module Stripe
         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`
+          # 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`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
           attr_reader :type
           # The value of the tax ID.
           attr_reader :value
@@ -675,6 +677,14 @@ module Stripe
         class NaverPay < Stripe::StripeObject
           # Controls when the funds will be captured from the customer's account.
           attr_reader :capture_method
+          # Indicates that you intend to make future payments with this PaymentIntent's payment method.
+          #
+          # 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 Oxxo < Stripe::StripeObject
@@ -1010,6 +1020,15 @@ module Stripe
         attr_reader :breakdown
       end
 
+      class WalletOptions < Stripe::StripeObject
+        class Link < Stripe::StripeObject
+          # Describes whether Checkout should display Link. Defaults to `auto`.
+          attr_reader :display
+        end
+        # Attribute for field link
+        attr_reader :link
+      end
+
       class ListParams < Stripe::RequestParams
         class Created < Stripe::RequestParams
           # Minimum value to filter by (exclusive)
@@ -2160,6 +2179,43 @@ module Stripe
           end
 
           class Klarna < 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.
+                attr_accessor :date
+
+                def initialize(amount: nil, date: nil)
+                  @amount = amount
+                  @date = date
+                end
+              end
+              # Unit of time between subscription charges.
+              attr_accessor :interval
+              # The number of intervals (specified in the `interval` attribute) between subscription charges. For example, `interval=month` and `interval_count=3` charges every 3 months.
+              attr_accessor :interval_count
+              # Name for subscription.
+              attr_accessor :name
+              # Describes the upcoming charge for this subscription.
+              attr_accessor :next_billing
+              # A non-customer-facing reference to correlate subscription charges in the Klarna app. Use a value that persists across subscription charges.
+              attr_accessor :reference
+
+              def initialize(
+                interval: nil,
+                interval_count: nil,
+                name: nil,
+                next_billing: nil,
+                reference: nil
+              )
+                @interval = interval
+                @interval_count = interval_count
+                @name = name
+                @next_billing = next_billing
+                @reference = reference
+              end
+            end
             # 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.
@@ -2168,9 +2224,12 @@ 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_accessor :setup_future_usage
+            # Subscription details if the Checkout Session sets up a future subscription.
+            attr_accessor :subscriptions
 
-            def initialize(setup_future_usage: nil)
+            def initialize(setup_future_usage: nil, subscriptions: nil)
               @setup_future_usage = setup_future_usage
+              @subscriptions = subscriptions
             end
           end
 
@@ -2309,8 +2368,7 @@ module Stripe
             end
           end
 
-          class PayByBank < Stripe::RequestParams
-          end
+          class PayByBank < Stripe::RequestParams; end
 
           class Payco < Stripe::RequestParams
             # Controls when the funds will be captured from the customer's account.
@@ -2706,11 +2764,18 @@ module Stripe
         class SavedPaymentMethodOptions < Stripe::RequestParams
           # 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_accessor :allow_redisplay_filters
+          # Enable customers to choose if they wish to remove their saved payment methods. Disabled by default.
+          attr_accessor :payment_method_remove
           # Enable customers to choose if they wish to save their payment method for future use. Disabled by default.
           attr_accessor :payment_method_save
 
-          def initialize(allow_redisplay_filters: nil, payment_method_save: nil)
+          def initialize(
+            allow_redisplay_filters: nil,
+            payment_method_remove: nil,
+            payment_method_save: nil
+          )
             @allow_redisplay_filters = allow_redisplay_filters
+            @payment_method_remove = payment_method_remove
             @payment_method_save = payment_method_save
           end
         end
@@ -2847,6 +2912,15 @@ module Stripe
         end
 
         class SubscriptionData < Stripe::RequestParams
+          class BillingMode < Stripe::RequestParams
+            # Attribute for param field type
+            attr_accessor :type
+
+            def initialize(type: nil)
+              @type = type
+            end
+          end
+
           class InvoiceSettings < Stripe::RequestParams
             class Issuer < Stripe::RequestParams
               # The connected account being referenced when `type` is `account`.
@@ -2899,6 +2973,8 @@ module Stripe
           attr_accessor :application_fee_percent
           # A future timestamp to anchor the subscription's billing cycle for new subscriptions.
           attr_accessor :billing_cycle_anchor
+          # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+          attr_accessor :billing_mode
           # The tax rates that will apply to any subscription item that does not have
           # `tax_rates` set. Invoices created will have their `default_tax_rates` populated
           # from the subscription.
@@ -2917,12 +2993,9 @@ module Stripe
           attr_accessor :proration_behavior
           # If specified, the funds from the subscription's invoices will be transferred to the destination and the ID of the resulting transfers will be found on the resulting charges.
           attr_accessor :transfer_data
-          # Unix timestamp representing the end of the trial period the customer
-          # will get before being charged for the first time. Has to be at least
-          # 48 hours in the future.
+          # Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. Has to be at least 48 hours in the future.
           attr_accessor :trial_end
-          # Integer representing the number of trial period days before the
-          # customer is charged for the first time. Has to be at least 1.
+          # Integer representing the number of trial period days before the customer is charged for the first time. Has to be at least 1.
           attr_accessor :trial_period_days
           # Settings related to subscription trials.
           attr_accessor :trial_settings
@@ -2930,6 +3003,7 @@ module Stripe
           def initialize(
             application_fee_percent: nil,
             billing_cycle_anchor: nil,
+            billing_mode: nil,
             default_tax_rates: nil,
             description: nil,
             invoice_settings: nil,
@@ -2943,6 +3017,7 @@ module Stripe
           )
             @application_fee_percent = application_fee_percent
             @billing_cycle_anchor = billing_cycle_anchor
+            @billing_mode = billing_mode
             @default_tax_rates = default_tax_rates
             @description = description
             @invoice_settings = invoice_settings
@@ -2967,6 +3042,23 @@ module Stripe
             @required = required
           end
         end
+
+        class WalletOptions < Stripe::RequestParams
+          class Link < Stripe::RequestParams
+            # Specifies whether Checkout should display Link as a payment option. By default, Checkout will display all the supported wallets that the Checkout Session was created with. This is the `auto` behavior, and it is the default choice.
+            attr_accessor :display
+
+            def initialize(display: nil)
+              @display = display
+            end
+          end
+          # contains details about the Link wallet options.
+          attr_accessor :link
+
+          def initialize(link: nil)
+            @link = link
+          end
+        end
         # Settings for price localization with [Adaptive Pricing](https://docs.stripe.com/payments/checkout/adaptive-pricing).
         attr_accessor :adaptive_pricing
         # Configure actions after a Checkout Session has expired.
@@ -3029,7 +3121,7 @@ module Stripe
         attr_accessor :expires_at
         # Generate a post-purchase Invoice for one-time payments.
         attr_accessor :invoice_creation
-        # A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
+        # A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices). The parameter is required for `payment` and `subscription` mode.
         #
         # For `payment` mode, there is a maximum of 100 line items, however it is recommended to consolidate line items if there are more than a few dozen.
         #
@@ -3076,9 +3168,9 @@ module Stripe
         # prioritize the most relevant payment methods based on the customer's location and
         # other characteristics.
         attr_accessor :payment_method_types
-        # This property is used to set up permissions for various actions (e.g., update) on the CheckoutSession object.
+        # This property is used to set up permissions for various actions (e.g., update) on the CheckoutSession object. Can only be set when creating `embedded` or `custom` sessions.
         #
-        # For specific permissions, please refer to their dedicated subsections, such as `permissions.update.shipping_details`.
+        # For specific permissions, please refer to their dedicated subsections, such as `permissions.update_shipping_details`.
         attr_accessor :permissions
         # Controls phone number collection settings for the session.
         #
@@ -3116,6 +3208,8 @@ module Stripe
         attr_accessor :tax_id_collection
         # The UI mode of the Session. Defaults to `hosted`.
         attr_accessor :ui_mode
+        # Wallet-specific configuration.
+        attr_accessor :wallet_options
 
         def initialize(
           adaptive_pricing: nil,
@@ -3160,7 +3254,8 @@ module Stripe
           subscription_data: nil,
           success_url: nil,
           tax_id_collection: nil,
-          ui_mode: nil
+          ui_mode: nil,
+          wallet_options: nil
         )
           @adaptive_pricing = adaptive_pricing
           @after_expiration = after_expiration
@@ -3205,6 +3300,7 @@ module Stripe
           @success_url = success_url
           @tax_id_collection = tax_id_collection
           @ui_mode = ui_mode
+          @wallet_options = wallet_options
         end
       end
 
@@ -3364,7 +3460,7 @@ module Stripe
             @shipping_rate_data = shipping_rate_data
           end
         end
-        # Information about the customer collected within the Checkout Session.
+        # Information about the customer collected within the Checkout Session. Can only be set when updating `embedded` or `custom` sessions.
         attr_accessor :collected_information
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand
@@ -3432,7 +3528,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
@@ -3508,7 +3605,7 @@ module Stripe
       attr_reader :payment_status
       # This property is used to set up permissions for various actions (e.g., update) on the CheckoutSession object.
       #
-      # For specific permissions, please refer to their dedicated subsections, such as `permissions.update.shipping_details`.
+      # For specific permissions, please refer to their dedicated subsections, such as `permissions.update_shipping_details`.
       attr_reader :permissions
       # Attribute for field phone_number_collection
       attr_reader :phone_number_collection
@@ -3518,7 +3615,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
@@ -3536,7 +3633,7 @@ module Stripe
       # 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.
       attr_reader :submit_type
-      # The ID of the subscription for Checkout Sessions in `subscription` mode.
+      # The ID of the [Subscription](https://stripe.com/docs/api/subscriptions) for Checkout Sessions in `subscription` mode.
       attr_reader :subscription
       # The URL the customer will be directed to after the payment or
       # subscription creation is successful.
@@ -3550,6 +3647,8 @@ module Stripe
       # 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
+      # Wallet-specific configuration for this Checkout Session.
+      attr_reader :wallet_options
 
       # Creates a Checkout Session object.
       def self.create(params = {}, opts = {})
@@ -3616,6 +3715,8 @@ module Stripe
       end
 
       # Updates a Checkout Session object.
+      #
+      # Related guide: [Dynamically update Checkout](https://docs.stripe.com/payments/checkout/dynamic-updates)
       def self.update(session, params = {}, opts = {})
         request_stripe_object(
           method: :post,