stripe 15.2.1 → 15.3.0

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

@@ -2179,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.
@@ -2187,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
 
@@ -2872,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`.
@@ -2924,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.
@@ -2942,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
@@ -2955,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,
@@ -2968,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
@@ -3071,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.
         #

data/lib/stripe/resources/confirmation_token.rb

@@ -41,7 +41,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
           # Attribute for field plan
@@ -154,9 +154,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
@@ -164,11 +164,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
 
@@ -220,7 +220,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
@@ -447,7 +447,7 @@ module Stripe
         attr_reader :networks
         # Details about payment methods collected offline.
         attr_reader :offline
-        # 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
@@ -462,6 +462,7 @@ module Stripe
         attr_reader :cashtag
       end
 
+      class Crypto < Stripe::StripeObject; end
       class CustomerBalance < Stripe::StripeObject; end
 
       class Eps < Stripe::StripeObject
@@ -480,7 +481,7 @@ module Stripe
       class Grabpay < Stripe::StripeObject; end
 
       class Ideal < Stripe::StripeObject
-        # The customer's bank, if provided. 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, if provided. 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, if the bank was provided.
         attr_reader :bic
@@ -519,7 +520,7 @@ module Stripe
         attr_reader :last4
         # Contains information about card networks that can be used to process the payment.
         attr_reader :networks
-        # 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
@@ -711,6 +712,8 @@ module Stripe
       attr_reader :card_present
       # Attribute for field cashapp
       attr_reader :cashapp
+      # Attribute for field crypto
+      attr_reader :crypto
       # The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
       attr_reader :customer
       # Attribute for field customer_balance
@@ -921,6 +924,7 @@ module Stripe
         end
 
         class Cashapp < Stripe::RequestParams; end
+        class Crypto < Stripe::RequestParams; end
         class CustomerBalance < Stripe::RequestParams; end
 
         class Eps < Stripe::RequestParams
@@ -1139,6 +1143,8 @@ module Stripe
         attr_accessor :boleto
         # If this is a `cashapp` PaymentMethod, this hash contains details about the Cash App Pay payment method.
         attr_accessor :cashapp
+        # If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
+        attr_accessor :crypto
         # If this is a `customer_balance` PaymentMethod, this hash contains details about the CustomerBalance payment method.
         attr_accessor :customer_balance
         # If this is an `eps` PaymentMethod, this hash contains details about the EPS payment method.
@@ -1230,6 +1236,7 @@ module Stripe
           blik: nil,
           boleto: nil,
           cashapp: nil,
+          crypto: nil,
           customer_balance: nil,
           eps: nil,
           fpx: nil,
@@ -1283,6 +1290,7 @@ module Stripe
           @blik = blik
           @boleto = boleto
           @cashapp = cashapp
+          @crypto = crypto
           @customer_balance = customer_balance
           @eps = eps
           @fpx = fpx
@@ -1332,7 +1340,7 @@ module Stripe
               # For `fixed_count` installment plans, this is required. It represents the interval between installment payments your customer will make to their credit card.
               # One of `month`.
               attr_accessor :interval
-              # Type of installment plan, one of `fixed_count`.
+              # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
               attr_accessor :type
 
               def initialize(count: nil, interval: nil, type: nil)

data/lib/stripe/resources/credit_note.rb

@@ -214,7 +214,7 @@ module Stripe
           @shipping_rate = shipping_rate
         end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
       attr_accessor :credit_amount
@@ -226,7 +226,7 @@ module Stripe
       attr_accessor :expand
       # ID of the invoice.
       attr_accessor :invoice
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
       attr_accessor :memo
@@ -240,7 +240,7 @@ module Stripe
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :shipping_cost
 
       def initialize(
@@ -369,7 +369,7 @@ module Stripe
           @shipping_rate = shipping_rate
         end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
       attr_accessor :credit_amount
@@ -381,7 +381,7 @@ module Stripe
       attr_accessor :expand
       # ID of the invoice.
       attr_accessor :invoice
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
       attr_accessor :memo
@@ -395,7 +395,7 @@ module Stripe
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :shipping_cost
 
       def initialize(
@@ -509,7 +509,7 @@ module Stripe
           @shipping_rate = shipping_rate
         end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
       attr_accessor :credit_amount
@@ -525,7 +525,7 @@ module Stripe
       attr_accessor :invoice
       # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
       attr_accessor :limit
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
       attr_accessor :memo
@@ -539,7 +539,7 @@ module Stripe
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :shipping_cost
       # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
       attr_accessor :starting_after

data/lib/stripe/resources/customer_session.rb

@@ -30,7 +30,7 @@ module Stripe
           attr_reader :payment_method_allow_redisplay_filters
           # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
           attr_reader :payment_method_redisplay
-          # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
+          # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`. The maximum redisplay limit is `10`.
           attr_reader :payment_method_redisplay_limit
           # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
           #
@@ -82,7 +82,7 @@ module Stripe
             attr_accessor :payment_method_allow_redisplay_filters
             # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
             attr_accessor :payment_method_redisplay
-            # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
+            # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`. The maximum redisplay limit is `10`.
             attr_accessor :payment_method_redisplay_limit
             # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
             #

data/lib/stripe/resources/event.rb

@@ -111,7 +111,7 @@ module Stripe
     end
     # The connected account that originates the event.
     attr_reader :account
-    # The Stripe API version used to render `data`. This property is populated only for events on or after October 31, 2014.
+    # The Stripe API version used to render `data` when the event was created. The contents of `data` never change, so this value remains static regardless of the API version currently in use. This property is populated only for events created on or after October 31, 2014.
     attr_reader :api_version
     # Authentication context needed to fetch the event or related object.
     attr_reader :context

data/lib/stripe/resources/identity/verification_session.rb

@@ -50,6 +50,13 @@ module Stripe
 
         class IdNumber < Stripe::StripeObject; end
 
+        class Matching < Stripe::StripeObject
+          # Strictness of the DOB matching policy to apply.
+          attr_reader :dob
+          # Strictness of the name matching policy to apply.
+          attr_reader :name
+        end
+
         class Phone < Stripe::StripeObject
           # Request one time password verification of `provided_details.phone`.
           attr_reader :require_verification
@@ -60,6 +67,8 @@ module Stripe
         attr_reader :email
         # Attribute for field id_number
         attr_reader :id_number
+        # Attribute for field matching
+        attr_reader :matching
         # Attribute for field phone
         attr_reader :phone
       end
@@ -76,6 +85,13 @@ module Stripe
         attr_reader :status
       end
 
+      class RelatedPerson < Stripe::StripeObject
+        # Token referencing the associated Account of the related Person resource.
+        attr_reader :account
+        # Token referencing the related Person resource.
+        attr_reader :person
+      end
+
       class VerifiedOutputs < Stripe::StripeObject
         class Address < Stripe::StripeObject
           # City, district, suburb, town, or village.
@@ -223,6 +239,18 @@ module Stripe
             @phone = phone
           end
         end
+
+        class RelatedPerson < Stripe::RequestParams
+          # A token representing a connected account. If provided, the person parameter is also required and must be associated with the account.
+          attr_accessor :account
+          # A token referencing a Person resource that this verification is being used to verify.
+          attr_accessor :person
+
+          def initialize(account: nil, person: nil)
+            @account = account
+            @person = person
+          end
+        end
         # A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
         attr_accessor :client_reference_id
         # Specifies which fields in the response should be expanded.
@@ -235,6 +263,8 @@ module Stripe
         attr_accessor :provided_details
         # Customer ID
         attr_accessor :related_customer
+        # Tokens referencing a Person resource and it's associated account.
+        attr_accessor :related_person
         # The URL that the user will be redirected to upon completing the verification flow.
         attr_accessor :return_url
         # The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`.
@@ -249,6 +279,7 @@ module Stripe
           options: nil,
           provided_details: nil,
           related_customer: nil,
+          related_person: nil,
           return_url: nil,
           type: nil,
           verification_flow: nil
@@ -259,6 +290,7 @@ module Stripe
           @options = options
           @provided_details = provided_details
           @related_customer = related_customer
+          @related_person = related_person
           @return_url = return_url
           @type = type
           @verification_flow = verification_flow
@@ -371,6 +403,8 @@ module Stripe
       attr_reader :redaction
       # Customer ID
       attr_reader :related_customer
+      # Attribute for field related_person
+      attr_reader :related_person
       # Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
       attr_reader :status
       # The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed.

data/lib/stripe/resources/invoice.rb

@@ -559,7 +559,7 @@ module Stripe
                 # For `fixed_count` installment plans, this is required. It represents the interval between installment payments your customer will make to their credit card.
                 # One of `month`.
                 attr_accessor :interval
-                # Type of installment plan, one of `fixed_count`.
+                # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
                 attr_accessor :type
 
                 def initialize(count: nil, interval: nil, type: nil)
@@ -1206,7 +1206,7 @@ module Stripe
                 # For `fixed_count` installment plans, this is required. It represents the interval between installment payments your customer will make to their credit card.
                 # One of `month`.
                 attr_accessor :interval
-                # Type of installment plan, one of `fixed_count`.
+                # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
                 attr_accessor :type
 
                 def initialize(count: nil, interval: nil, type: nil)
@@ -2546,6 +2546,15 @@ module Stripe
       end
 
       class ScheduleDetails < Stripe::RequestParams
+        class BillingMode < Stripe::RequestParams
+          # Attribute for param field type
+          attr_accessor :type
+
+          def initialize(type: nil)
+            @type = type
+          end
+        end
+
         class Phase < Stripe::RequestParams
           class AddInvoiceItem < Stripe::RequestParams
             class Discount < Stripe::RequestParams
@@ -2899,6 +2908,8 @@ module Stripe
             @trial_end = trial_end
           end
         end
+        # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+        attr_accessor :billing_mode
         # Behavior of the subscription schedule and underlying subscription when it ends. Possible values are `release` or `cancel` with the default being `release`. `release` will end the subscription schedule and keep the underlying subscription running. `cancel` will end the subscription schedule and cancel the underlying subscription.
         attr_accessor :end_behavior
         # List representing phases of the subscription schedule. Each phase can be customized to have different durations, plans, and coupons. If there are multiple phases, the `end_date` of one phase will always equal the `start_date` of the next phase.
@@ -2906,7 +2917,8 @@ module Stripe
         # In cases where the `schedule_details` params update the currently active phase, specifies if and how to prorate at the time of the request.
         attr_accessor :proration_behavior
 
-        def initialize(end_behavior: nil, phases: nil, proration_behavior: nil)
+        def initialize(billing_mode: nil, end_behavior: nil, phases: nil, proration_behavior: nil)
+          @billing_mode = billing_mode
           @end_behavior = end_behavior
           @phases = phases
           @proration_behavior = proration_behavior
@@ -2914,6 +2926,15 @@ module Stripe
       end
 
       class SubscriptionDetails < Stripe::RequestParams
+        class BillingMode < Stripe::RequestParams
+          # Attribute for param field type
+          attr_accessor :type
+
+          def initialize(type: nil)
+            @type = type
+          end
+        end
+
         class Item < Stripe::RequestParams
           class BillingThresholds < Stripe::RequestParams
             # Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
@@ -3031,9 +3052,11 @@ module Stripe
         end
         # For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`.
         attr_accessor :billing_cycle_anchor
+        # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
+        attr_accessor :billing_mode
         # A timestamp at which the subscription should cancel. If set to a date before the current period ends, this will cause a proration if prorations have been enabled using `proration_behavior`. If set during a future period, this will always cause a proration for that period.
         attr_accessor :cancel_at
-        # Indicate whether this subscription should cancel at the end of the current period (`current_period_end`). Defaults to `false`. This param will be removed in a future API version. Please use `cancel_at` instead.
+        # Indicate whether this subscription should cancel at the end of the current period (`current_period_end`). Defaults to `false`.
         attr_accessor :cancel_at_period_end
         # This simulates the subscription being canceled or expired immediately.
         attr_accessor :cancel_now
@@ -3054,6 +3077,7 @@ module Stripe
 
         def initialize(
           billing_cycle_anchor: nil,
+          billing_mode: nil,
           cancel_at: nil,
           cancel_at_period_end: nil,
           cancel_now: nil,
@@ -3066,6 +3090,7 @@ module Stripe
           trial_end: nil
         )
           @billing_cycle_anchor = billing_cycle_anchor
+          @billing_mode = billing_mode
           @cancel_at = cancel_at
           @cancel_at_period_end = cancel_at_period_end
           @cancel_now = cancel_now

data/lib/stripe/resources/invoice_item.rb

@@ -2,10 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). An invoice item is added to an
-  # invoice by creating or updating it with an `invoice` field, at which point it will be included as
-  # [an invoice line item](https://stripe.com/docs/api/invoices/line_item) within
-  # [invoice.lines](https://stripe.com/docs/api/invoices/object#invoice_object-lines).
+  # Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). When you create an invoice item with an `invoice` field, it is attached to the specified invoice and included as [an invoice line item](https://stripe.com/docs/api/invoices/line_item) within [invoice.lines](https://stripe.com/docs/api/invoices/object#invoice_object-lines).
   #
   # Invoice Items can be created before you are ready to actually send the invoice. This can be particularly useful when combined
   # with a [subscription](https://stripe.com/docs/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge

data/lib/stripe/resources/mandate.rb

@@ -63,6 +63,7 @@ module Stripe
       class Card < Stripe::StripeObject; end
       class Cashapp < Stripe::StripeObject; end
       class KakaoPay < Stripe::StripeObject; end
+      class Klarna < Stripe::StripeObject; end
       class KrCard < Stripe::StripeObject; end
       class Link < Stripe::StripeObject; end
       class NaverPay < Stripe::StripeObject; end
@@ -102,6 +103,8 @@ module Stripe
       attr_reader :cashapp
       # Attribute for field kakao_pay
       attr_reader :kakao_pay
+      # Attribute for field klarna
+      attr_reader :klarna
       # Attribute for field kr_card
       attr_reader :kr_card
       # Attribute for field link