stripe 18.4.0.pre.alpha.4 → 18.4.0.pre.alpha.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cee6d32769a04217113d09025127299d31401a616faa1667f6ac44ddf8db813a
-  data.tar.gz: aa67fe0d06b16f55254c08c78c0e4b2b597c74ffa51070151ce51c1ac6cef243
+  metadata.gz: 2401c7a043ebd47ce50478f3504d47b3d4f87858b2ff59b7609ce9433b3afd79
+  data.tar.gz: 85edd7ba11d395b79b7b26391083aa1b6c5a92db930b3893535d3f7f31e3cee4
 SHA512:
-  metadata.gz: 98c1e8f78cc9c0ad8b6413151a73fd2a5888b22be4f853c8c29de4cfad6aae6fcad13cffe0c66bf72f1731f9aa108be83f657c626658569d26809592805f8408
-  data.tar.gz: 99a19e10f2ae7a0386598d950d4c5742f65df0492ef9e557702cbc256a908bf31d3c7dc2b7fdec7051fd6db639f460995ff6b2d2c4b4931163f4927aa8631f74
+  metadata.gz: a51d46f6b4d7a2fca45c0e394bd32e07dcf2e6a883341589db805d487639bccf52afafe61eb372c3abef9b3c5a182dd8d76b19b9e933cd761bae41c7f4aeca96
+  data.tar.gz: 1b1087ef84a593165062c1b8196894455637bfa6f03e864b1321cc963d90415a629d1b591267879ef7fd484b7ea5c88896ac8d2a3d1556da9235c0943dfea9b5

data/lib/stripe/params/billing/alert_create_params.rb

@@ -115,6 +115,84 @@ module Stripe
         end
       end
 
+      class SpendThreshold < ::Stripe::RequestParams
+        class Filters < ::Stripe::RequestParams
+          # Filter by billable item IDs. Maximum of 20 billable items.
+          attr_accessor :billable_items
+          # Filter by billing cadence ID.
+          attr_accessor :billing_cadence
+          # Filter by pricing plan ID.
+          attr_accessor :pricing_plan
+          # Filter by pricing plan subscription ID.
+          attr_accessor :pricing_plan_subscription
+
+          def initialize(
+            billable_items: nil,
+            billing_cadence: nil,
+            pricing_plan: nil,
+            pricing_plan_subscription: nil
+          )
+            @billable_items = billable_items
+            @billing_cadence = billing_cadence
+            @pricing_plan = pricing_plan
+            @pricing_plan_subscription = pricing_plan_subscription
+          end
+        end
+
+        class Gte < ::Stripe::RequestParams
+          class Amount < ::Stripe::RequestParams
+            # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
+            attr_accessor :currency
+            # An integer representing the amount of the threshold.
+            attr_accessor :value
+
+            def initialize(currency: nil, value: nil)
+              @currency = currency
+              @value = value
+            end
+          end
+
+          class CustomPricingUnit < ::Stripe::RequestParams
+            # The ID of the custom pricing unit.
+            attr_accessor :id
+            # A positive decimal string representing the amount of the custom pricing unit threshold.
+            attr_accessor :value
+
+            def initialize(id: nil, value: nil)
+              @id = id
+              @value = value
+            end
+          end
+          # The monetary amount. Required when type is `amount`.
+          attr_accessor :amount
+          # The custom pricing unit amount. Required when type is `custom_pricing_unit`.
+          attr_accessor :custom_pricing_unit
+          # The type of the threshold amount.
+          attr_accessor :type
+
+          def initialize(amount: nil, custom_pricing_unit: nil, type: nil)
+            @amount = amount
+            @custom_pricing_unit = custom_pricing_unit
+            @type = type
+          end
+        end
+        # Defines the period over which spend is aggregated.
+        attr_accessor :aggregation_period
+        # Filters to scope the spend calculation.
+        attr_accessor :filters
+        # Defines the granularity of spend aggregation. Defaults to `pricing_plan_subscription`.
+        attr_accessor :group_by
+        # Defines at which value the alert will fire.
+        attr_accessor :gte
+
+        def initialize(aggregation_period: nil, filters: nil, group_by: nil, gte: nil)
+          @aggregation_period = aggregation_period
+          @filters = filters
+          @group_by = group_by
+          @gte = gte
+        end
+      end
+
       class UsageThreshold < ::Stripe::RequestParams
         class Filter < ::Stripe::RequestParams
           # Limit the scope to this usage alert only to this customer.
@@ -153,19 +231,23 @@ module Stripe
       attr_accessor :title
       # The configuration of the usage threshold.
       attr_accessor :usage_threshold
+      # The configuration of the spend threshold.
+      attr_accessor :spend_threshold
 
       def initialize(
         alert_type: nil,
         credit_balance_threshold: nil,
         expand: nil,
         title: nil,
-        usage_threshold: nil
+        usage_threshold: nil,
+        spend_threshold: nil
       )
         @alert_type = alert_type
         @credit_balance_threshold = credit_balance_threshold
         @expand = expand
         @title = title
         @usage_threshold = usage_threshold
+        @spend_threshold = spend_threshold
       end
     end
   end

data/lib/stripe/params/payment_method_update_params.rb

@@ -77,6 +77,18 @@ module Stripe
       end
     end
 
+    class Custom < ::Stripe::RequestParams
+      # A reference to an external payment method, such as a PayPal Billing Agreement ID.
+      attr_accessor :payment_method_reference
+      # Indicates whether the payment method supports off-session payments.
+      attr_accessor :usage
+
+      def initialize(payment_method_reference: nil, usage: nil)
+        @payment_method_reference = payment_method_reference
+        @usage = usage
+      end
+    end
+
     class Payto < ::Stripe::RequestParams
       # The account number for the bank account.
       attr_accessor :account_number
@@ -117,6 +129,8 @@ module Stripe
     attr_accessor :payto
     # If this is an `us_bank_account` PaymentMethod, this hash contains details about the US bank account payment method.
     attr_accessor :us_bank_account
+    # If this is a `custom` PaymentMethod, this hash contains details about the Custom payment method.
+    attr_accessor :custom
 
     def initialize(
       allow_redisplay: nil,
@@ -125,7 +139,8 @@ module Stripe
       expand: nil,
       metadata: nil,
       payto: nil,
-      us_bank_account: nil
+      us_bank_account: nil,
+      custom: nil
     )
       @allow_redisplay = allow_redisplay
       @billing_details = billing_details
@@ -134,6 +149,7 @@ module Stripe
       @metadata = metadata
       @payto = payto
       @us_bank_account = us_bank_account
+      @custom = custom
     end
   end
 end

data/lib/stripe/params/subscription_pause_params.rb

@@ -4,14 +4,31 @@
 module Stripe
   class SubscriptionPauseParams < ::Stripe::RequestParams
     class BillFor < ::Stripe::RequestParams
-      # Controls whether to debit for accrued metered usage in the current billing period. The default is `true`.
-      attr_accessor :outstanding_usage
-      # Controls whether to credit for licensed items in the current billing period. The default is `true`.
-      attr_accessor :unused_time
+      class OutstandingUsageThrough < ::Stripe::RequestParams
+        # When to bill metered usage in the current period.
+        attr_accessor :type
 
-      def initialize(outstanding_usage: nil, unused_time: nil)
-        @outstanding_usage = outstanding_usage
-        @unused_time = unused_time
+        def initialize(type: nil)
+          @type = type
+        end
+      end
+
+      class UnusedTimeFrom < ::Stripe::RequestParams
+        # When to credit for unused time.
+        attr_accessor :type
+
+        def initialize(type: nil)
+          @type = type
+        end
+      end
+      # Controls when to bill for metered usage in the current period. Defaults to `{ type: "now" }`.
+      attr_accessor :outstanding_usage_through
+      # Controls when to credit for unused time on licensed items. Defaults to `{ type: "now" }`.
+      attr_accessor :unused_time_from
+
+      def initialize(outstanding_usage_through: nil, unused_time_from: nil)
+        @outstanding_usage_through = outstanding_usage_through
+        @unused_time_from = unused_time_from
       end
     end
     # Controls what to bill for when pausing the subscription.

data/lib/stripe/params/subscription_resume_params.rb

@@ -11,21 +11,17 @@ module Stripe
     attr_accessor :proration_behavior
     # If set, prorations will be calculated as though the subscription was resumed at the given time. This can be used to apply exactly the same prorations that were previewed with the [create preview](https://stripe.com/docs/api/invoices/create_preview) endpoint.
     attr_accessor :proration_date
-    # Controls when the subscription transitions from `paused` to `active`. Determines how payment on the invoice affects the resumption process.The default is `pending_if_incomplete`.
-    attr_accessor :payment_behavior
 
     def initialize(
       billing_cycle_anchor: nil,
       expand: nil,
       proration_behavior: nil,
-      proration_date: nil,
-      payment_behavior: nil
+      proration_date: nil
     )
       @billing_cycle_anchor = billing_cycle_anchor
       @expand = expand
       @proration_behavior = proration_behavior
       @proration_date = proration_date
-      @payment_behavior = payment_behavior
     end
   end
 end

data/lib/stripe/request_params.rb

@@ -5,11 +5,46 @@ module Stripe
   # For internal use only. Does not provide a stable API and may be broken
   # with future non-major changes.
   class RequestParams
+    class << self
+      # Override the object instantiation flow in Ruby in order to track explicitly set keys
+      # V2 APIs accept null values on the backend. However, we do not want to set a key to nil
+      # if the user has not explicitly set them to nil
+      # TODO(major): https://go/j/DEVSDK-2990
+      def new(**kwargs)
+        instance = allocate
+        # Track explicitly set keys for V2 classes only
+        instance.instance_variable_set(:@_explicitly_set_keys, kwargs.keys.to_set) if name&.start_with?("Stripe::V2::")
+        instance.send(:initialize, **kwargs)
+        instance
+      end
+
+      # Override attr_accessor to create setters that track explicitly set keys for V2 classes
+      def attr_accessor(*names)
+        names.each do |name|
+          # Define getter
+          define_method(name) { instance_variable_get("@#{name}") }
+
+          # Define setter that tracks the key as explicitly set
+          define_method("#{name}=") do |value|
+            @_explicitly_set_keys&.add(name)
+            instance_variable_set("@#{name}", value)
+          end
+        end
+      end
+    end
+
     def to_h
       instance_variables.each_with_object({}) do |var, hash|
+        # _explicitly_set_keys is set as an instance variable.
+        # Ignore the var if it is _explicitly_set_keys itself.
+        next if var == :@_explicitly_set_keys
+
         key = var.to_s.delete("@").to_sym
         value = instance_variable_get(var)
 
+        # For V2 classes, only include keys that were explicitly set
+        next if @_explicitly_set_keys && !@_explicitly_set_keys.include?(key)
+
         hash[key] = if value.is_a?(RequestParams)
                       value.to_h
                     # Check if value is an array and contains RequestParams objects

data/lib/stripe/resources/billing/alert.rb

@@ -144,6 +144,113 @@ module Stripe
           @field_remappings = {}
         end
       end
+
+      class SpendThreshold < ::Stripe::StripeObject
+        class Filters < ::Stripe::StripeObject
+          # Filter by billable item IDs.
+          attr_reader :billable_items
+          # Filter by billing cadence ID.
+          attr_reader :billing_cadence
+          # Filter by pricing plan ID.
+          attr_reader :pricing_plan
+          # Filter by pricing plan subscription ID.
+          attr_reader :pricing_plan_subscription
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Gte < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+            attr_reader :currency
+            # A positive integer representing the amount.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class CustomPricingUnit < ::Stripe::StripeObject
+            class CustomPricingUnitDetails < ::Stripe::StripeObject
+              # Time at which the object was created. Measured in seconds since the Unix epoch.
+              attr_reader :created
+              # The name of the custom pricing unit.
+              attr_reader :display_name
+              # Unique identifier for the object.
+              attr_reader :id
+              # A lookup key for the custom pricing unit.
+              attr_reader :lookup_key
+              # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+              attr_reader :metadata
+              # The status of the custom pricing unit.
+              attr_reader :status
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The custom pricing unit object.
+            attr_reader :custom_pricing_unit_details
+            # Unique identifier for the object.
+            attr_reader :id
+            # A positive decimal string representing the amount.
+            attr_reader :value
+
+            def self.inner_class_types
+              @inner_class_types = { custom_pricing_unit_details: CustomPricingUnitDetails }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The monetary amount. Present when type is `amount`.
+          attr_reader :amount
+          # The custom pricing unit amount. Present when type is `custom_pricing_unit`.
+          attr_reader :custom_pricing_unit
+          # The type of the threshold amount.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = { amount: Amount, custom_pricing_unit: CustomPricingUnit }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Defines the period over which spend is aggregated.
+        attr_reader :aggregation_period
+        # Filters to scope the spend calculation.
+        attr_reader :filters
+        # Defines the granularity of spend aggregation.
+        attr_reader :group_by
+        # The threshold value configuration for a spend threshold alert.
+        attr_reader :gte
+
+        def self.inner_class_types
+          @inner_class_types = { filters: Filters, gte: Gte }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       # Defines the type of the alert.
       attr_reader :alert_type
       # Encapsulates configuration of the alert to monitor billing credit balance.
@@ -160,6 +267,8 @@ module Stripe
       attr_reader :title
       # Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://docs.stripe.com/api/billing/meter).
       attr_reader :usage_threshold
+      # Encapsulates the alert's configuration to monitor spend on pricing plan subscriptions.
+      attr_reader :spend_threshold
 
       # Reactivates this alert, allowing it to trigger again.
       def activate(params = {}, opts = {})
@@ -235,6 +344,7 @@ module Stripe
         @inner_class_types = {
           credit_balance_threshold: CreditBalanceThreshold,
           usage_threshold: UsageThreshold,
+          spend_threshold: SpendThreshold,
         }
       end
 

data/lib/stripe/resources/invoice_line_item.rb

@@ -132,11 +132,45 @@ module Stripe
       end
 
       class ScheduleDetails < ::Stripe::StripeObject
-        # The subscription schedule that generated this line item
+        class ProrationDetails < ::Stripe::StripeObject
+          class CreditedItems < ::Stripe::StripeObject
+            # Invoice containing the credited invoice line items
+            attr_reader :invoice
+            # Credited invoice line items
+            attr_reader :invoice_line_items
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # For a credit proration `line_item`, the original debit line_items to which the credit proration applies.
+          attr_reader :credited_items
+
+          def self.inner_class_types
+            @inner_class_types = { credited_items: CreditedItems }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The subscription schedule that generated this line item.
         attr_reader :schedule
+        # The invoice item that generated this line item.
+        attr_reader :invoice_item
+        # Whether this is a proration.
+        attr_reader :proration
+        # Additional details for proration line items.
+        attr_reader :proration_details
+        # The subscription that the schedule belongs to.
+        attr_reader :subscription
 
         def self.inner_class_types
-          @inner_class_types = {}
+          @inner_class_types = { proration_details: ProrationDetails }
         end
 
         def self.field_remappings

data/lib/stripe/resources/payment_method.rb

@@ -829,6 +829,10 @@ module Stripe
       attr_reader :logo
       # ID of the Dashboard-only CustomPaymentMethodType. Not expandable.
       attr_reader :type
+      # A reference to an external payment method, such as a PayPal Billing Agreement ID.
+      attr_reader :payment_method_reference
+      # Indicates whether the payment method supports off-session payments.
+      attr_reader :usage
 
       def self.inner_class_types
         @inner_class_types = { logo: Logo }

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "18.4.0-alpha.4"
+  VERSION = "18.4.0-alpha.6"
 end

data/rbi/stripe.rbi

@@ -7085,6 +7085,120 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class SpendThreshold < ::Stripe::StripeObject
+        class Filters < ::Stripe::StripeObject
+          # Filter by billable item IDs.
+          sig { returns(T.nilable(T::Array[String])) }
+          def billable_items; end
+          # Filter by billing cadence ID.
+          sig { returns(T.nilable(String)) }
+          def billing_cadence; end
+          # Filter by pricing plan ID.
+          sig { returns(T.nilable(String)) }
+          def pricing_plan; end
+          # Filter by pricing plan subscription ID.
+          sig { returns(T.nilable(String)) }
+          def pricing_plan_subscription; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class Gte < ::Stripe::StripeObject
+          class Amount < ::Stripe::StripeObject
+            # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+            sig { returns(String) }
+            def currency; end
+            # A positive integer representing the amount.
+            sig { returns(Integer) }
+            def value; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class CustomPricingUnit < ::Stripe::StripeObject
+            class CustomPricingUnitDetails < ::Stripe::StripeObject
+              # Time at which the object was created. Measured in seconds since the Unix epoch.
+              sig { returns(Integer) }
+              def created; end
+              # The name of the custom pricing unit.
+              sig { returns(String) }
+              def display_name; end
+              # Unique identifier for the object.
+              sig { returns(String) }
+              def id; end
+              # A lookup key for the custom pricing unit.
+              sig { returns(T.nilable(String)) }
+              def lookup_key; end
+              # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+              sig { returns(T::Hash[String, String]) }
+              def metadata; end
+              # The status of the custom pricing unit.
+              sig { returns(String) }
+              def status; end
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # The custom pricing unit object.
+            sig { returns(T.nilable(CustomPricingUnitDetails)) }
+            def custom_pricing_unit_details; end
+            # Unique identifier for the object.
+            sig { returns(String) }
+            def id; end
+            # A positive decimal string representing the amount.
+            sig { returns(String) }
+            def value; end
+            def self.inner_class_types
+              @inner_class_types = {custom_pricing_unit_details: CustomPricingUnitDetails}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The monetary amount. Present when type is `amount`.
+          sig { returns(T.nilable(Amount)) }
+          def amount; end
+          # The custom pricing unit amount. Present when type is `custom_pricing_unit`.
+          sig { returns(T.nilable(CustomPricingUnit)) }
+          def custom_pricing_unit; end
+          # The type of the threshold amount.
+          sig { returns(String) }
+          def type; end
+          def self.inner_class_types
+            @inner_class_types = {amount: Amount, custom_pricing_unit: CustomPricingUnit}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Defines the period over which spend is aggregated.
+        sig { returns(String) }
+        def aggregation_period; end
+        # Filters to scope the spend calculation.
+        sig { returns(T.nilable(Filters)) }
+        def filters; end
+        # Defines the granularity of spend aggregation.
+        sig { returns(T.nilable(String)) }
+        def group_by; end
+        # The threshold value configuration for a spend threshold alert.
+        sig { returns(Gte) }
+        def gte; end
+        def self.inner_class_types
+          @inner_class_types = {filters: Filters, gte: Gte}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       # Defines the type of the alert.
       sig { returns(String) }
       def alert_type; end
@@ -7109,6 +7223,9 @@ module Stripe
       # Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://docs.stripe.com/api/billing/meter).
       sig { returns(T.nilable(UsageThreshold)) }
       def usage_threshold; end
+      # Encapsulates the alert's configuration to monitor spend on pricing plan subscriptions.
+      sig { returns(T.nilable(SpendThreshold)) }
+      def spend_threshold; end
       # Reactivates this alert, allowing it to trigger again.
       sig {
         params(params: T.any(::Stripe::Billing::AlertActivateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::Billing::Alert)
@@ -23823,11 +23940,48 @@ module Stripe
         end
       end
       class ScheduleDetails < ::Stripe::StripeObject
-        # The subscription schedule that generated this line item
+        class ProrationDetails < ::Stripe::StripeObject
+          class CreditedItems < ::Stripe::StripeObject
+            # Invoice containing the credited invoice line items
+            sig { returns(String) }
+            def invoice; end
+            # Credited invoice line items
+            sig { returns(T::Array[String]) }
+            def invoice_line_items; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # For a credit proration `line_item`, the original debit line_items to which the credit proration applies.
+          sig { returns(T.nilable(CreditedItems)) }
+          def credited_items; end
+          def self.inner_class_types
+            @inner_class_types = {credited_items: CreditedItems}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The subscription schedule that generated this line item.
         sig { returns(String) }
         def schedule; end
+        # The invoice item that generated this line item.
+        sig { returns(T.nilable(String)) }
+        def invoice_item; end
+        # Whether this is a proration.
+        sig { returns(T::Boolean) }
+        def proration; end
+        # Additional details for proration line items.
+        sig { returns(T.nilable(ProrationDetails)) }
+        def proration_details; end
+        # The subscription that the schedule belongs to.
+        sig { returns(T.nilable(String)) }
+        def subscription; end
         def self.inner_class_types
-          @inner_class_types = {}
+          @inner_class_types = {proration_details: ProrationDetails}
         end
         def self.field_remappings
           @field_remappings = {}
@@ -39582,6 +39736,12 @@ module Stripe
       # ID of the Dashboard-only CustomPaymentMethodType. Not expandable.
       sig { returns(String) }
       def type; end
+      # A reference to an external payment method, such as a PayPal Billing Agreement ID.
+      sig { returns(T.nilable(String)) }
+      def payment_method_reference; end
+      # Indicates whether the payment method supports off-session payments.
+      sig { returns(T.nilable(String)) }
+      def usage; end
       def self.inner_class_types
         @inner_class_types = {logo: Logo}
       end
@@ -94122,6 +94282,126 @@ module Stripe
          }
         def initialize(filters: nil, lte: nil); end
       end
+      class SpendThreshold < ::Stripe::RequestParams
+        class Filters < ::Stripe::RequestParams
+          # Filter by billable item IDs. Maximum of 20 billable items.
+          sig { returns(T.nilable(T::Array[String])) }
+          def billable_items; end
+          sig {
+            params(_billable_items: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String]))
+           }
+          def billable_items=(_billable_items); end
+          # Filter by billing cadence ID.
+          sig { returns(T.nilable(String)) }
+          def billing_cadence; end
+          sig { params(_billing_cadence: T.nilable(String)).returns(T.nilable(String)) }
+          def billing_cadence=(_billing_cadence); end
+          # Filter by pricing plan ID.
+          sig { returns(T.nilable(String)) }
+          def pricing_plan; end
+          sig { params(_pricing_plan: T.nilable(String)).returns(T.nilable(String)) }
+          def pricing_plan=(_pricing_plan); end
+          # Filter by pricing plan subscription ID.
+          sig { returns(T.nilable(String)) }
+          def pricing_plan_subscription; end
+          sig { params(_pricing_plan_subscription: T.nilable(String)).returns(T.nilable(String)) }
+          def pricing_plan_subscription=(_pricing_plan_subscription); end
+          sig {
+            params(billable_items: T.nilable(T::Array[String]), billing_cadence: T.nilable(String), pricing_plan: T.nilable(String), pricing_plan_subscription: T.nilable(String)).void
+           }
+          def initialize(
+            billable_items: nil,
+            billing_cadence: nil,
+            pricing_plan: nil,
+            pricing_plan_subscription: nil
+          ); end
+        end
+        class Gte < ::Stripe::RequestParams
+          class Amount < ::Stripe::RequestParams
+            # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
+            sig { returns(String) }
+            def currency; end
+            sig { params(_currency: String).returns(String) }
+            def currency=(_currency); end
+            # An integer representing the amount of the threshold.
+            sig { returns(Integer) }
+            def value; end
+            sig { params(_value: Integer).returns(Integer) }
+            def value=(_value); end
+            sig { params(currency: String, value: Integer).void }
+            def initialize(currency: nil, value: nil); end
+          end
+          class CustomPricingUnit < ::Stripe::RequestParams
+            # The ID of the custom pricing unit.
+            sig { returns(String) }
+            def id; end
+            sig { params(_id: String).returns(String) }
+            def id=(_id); end
+            # A positive decimal string representing the amount of the custom pricing unit threshold.
+            sig { returns(String) }
+            def value; end
+            sig { params(_value: String).returns(String) }
+            def value=(_value); end
+            sig { params(id: String, value: String).void }
+            def initialize(id: nil, value: nil); end
+          end
+          # The monetary amount. Required when type is `amount`.
+          sig {
+            returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::Amount))
+           }
+          def amount; end
+          sig {
+            params(_amount: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::Amount)).returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::Amount))
+           }
+          def amount=(_amount); end
+          # The custom pricing unit amount. Required when type is `custom_pricing_unit`.
+          sig {
+            returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::CustomPricingUnit))
+           }
+          def custom_pricing_unit; end
+          sig {
+            params(_custom_pricing_unit: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::CustomPricingUnit)).returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::CustomPricingUnit))
+           }
+          def custom_pricing_unit=(_custom_pricing_unit); end
+          # The type of the threshold amount.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(amount: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::Amount), custom_pricing_unit: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte::CustomPricingUnit), type: String).void
+           }
+          def initialize(amount: nil, custom_pricing_unit: nil, type: nil); end
+        end
+        # Defines the period over which spend is aggregated.
+        sig { returns(String) }
+        def aggregation_period; end
+        sig { params(_aggregation_period: String).returns(String) }
+        def aggregation_period=(_aggregation_period); end
+        # Filters to scope the spend calculation.
+        sig { returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Filters)) }
+        def filters; end
+        sig {
+          params(_filters: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Filters)).returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Filters))
+         }
+        def filters=(_filters); end
+        # Defines the granularity of spend aggregation. Defaults to `pricing_plan_subscription`.
+        sig { returns(T.nilable(String)) }
+        def group_by; end
+        sig { params(_group_by: T.nilable(String)).returns(T.nilable(String)) }
+        def group_by=(_group_by); end
+        # Defines at which value the alert will fire.
+        sig { returns(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte) }
+        def gte; end
+        sig {
+          params(_gte: ::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte).returns(::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte)
+         }
+        def gte=(_gte); end
+        sig {
+          params(aggregation_period: String, filters: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold::Filters), group_by: T.nilable(String), gte: ::Stripe::Billing::AlertCreateParams::SpendThreshold::Gte).void
+         }
+        def initialize(aggregation_period: nil, filters: nil, group_by: nil, gte: nil); end
+      end
       class UsageThreshold < ::Stripe::RequestParams
         class Filter < ::Stripe::RequestParams
           # Limit the scope to this usage alert only to this customer.
@@ -94195,15 +94475,23 @@ module Stripe
         params(_usage_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::UsageThreshold)).returns(T.nilable(::Stripe::Billing::AlertCreateParams::UsageThreshold))
        }
       def usage_threshold=(_usage_threshold); end
+      # The configuration of the spend threshold.
+      sig { returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold)) }
+      def spend_threshold; end
       sig {
-        params(alert_type: String, credit_balance_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::CreditBalanceThreshold), expand: T.nilable(T::Array[String]), title: String, usage_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::UsageThreshold)).void
+        params(_spend_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold)).returns(T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold))
+       }
+      def spend_threshold=(_spend_threshold); end
+      sig {
+        params(alert_type: String, credit_balance_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::CreditBalanceThreshold), expand: T.nilable(T::Array[String]), title: String, usage_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::UsageThreshold), spend_threshold: T.nilable(::Stripe::Billing::AlertCreateParams::SpendThreshold)).void
        }
       def initialize(
         alert_type: nil,
         credit_balance_threshold: nil,
         expand: nil,
         title: nil,
-        usage_threshold: nil
+        usage_threshold: nil,
+        spend_threshold: nil
       ); end
     end
   end
@@ -173789,6 +174077,20 @@ module Stripe
        }
       def initialize(exp_month: nil, exp_year: nil, networks: nil); end
     end
+    class Custom < ::Stripe::RequestParams
+      # A reference to an external payment method, such as a PayPal Billing Agreement ID.
+      sig { returns(T.nilable(String)) }
+      def payment_method_reference; end
+      sig { params(_payment_method_reference: T.nilable(String)).returns(T.nilable(String)) }
+      def payment_method_reference=(_payment_method_reference); end
+      # Indicates whether the payment method supports off-session payments.
+      sig { returns(T.nilable(String)) }
+      def usage; end
+      sig { params(_usage: T.nilable(String)).returns(T.nilable(String)) }
+      def usage=(_usage); end
+      sig { params(payment_method_reference: T.nilable(String), usage: T.nilable(String)).void }
+      def initialize(payment_method_reference: nil, usage: nil); end
+    end
     class Payto < ::Stripe::RequestParams
       # The account number for the bank account.
       sig { returns(T.nilable(String)) }
@@ -173869,8 +174171,15 @@ module Stripe
       params(_us_bank_account: T.nilable(::Stripe::PaymentMethodUpdateParams::UsBankAccount)).returns(T.nilable(::Stripe::PaymentMethodUpdateParams::UsBankAccount))
      }
     def us_bank_account=(_us_bank_account); end
+    # If this is a `custom` PaymentMethod, this hash contains details about the Custom payment method.
+    sig { returns(T.nilable(::Stripe::PaymentMethodUpdateParams::Custom)) }
+    def custom; end
+    sig {
+      params(_custom: T.nilable(::Stripe::PaymentMethodUpdateParams::Custom)).returns(T.nilable(::Stripe::PaymentMethodUpdateParams::Custom))
+     }
+    def custom=(_custom); end
     sig {
-      params(allow_redisplay: T.nilable(String), billing_details: T.nilable(::Stripe::PaymentMethodUpdateParams::BillingDetails), card: T.nilable(::Stripe::PaymentMethodUpdateParams::Card), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.any(String, T::Hash[String, String])), payto: T.nilable(::Stripe::PaymentMethodUpdateParams::Payto), us_bank_account: T.nilable(::Stripe::PaymentMethodUpdateParams::UsBankAccount)).void
+      params(allow_redisplay: T.nilable(String), billing_details: T.nilable(::Stripe::PaymentMethodUpdateParams::BillingDetails), card: T.nilable(::Stripe::PaymentMethodUpdateParams::Card), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.any(String, T::Hash[String, String])), payto: T.nilable(::Stripe::PaymentMethodUpdateParams::Payto), us_bank_account: T.nilable(::Stripe::PaymentMethodUpdateParams::UsBankAccount), custom: T.nilable(::Stripe::PaymentMethodUpdateParams::Custom)).void
      }
     def initialize(
       allow_redisplay: nil,
@@ -173879,7 +174188,8 @@ module Stripe
       expand: nil,
       metadata: nil,
       payto: nil,
-      us_bank_account: nil
+      us_bank_account: nil,
+      custom: nil
     ); end
   end
 end
@@ -200918,20 +201228,44 @@ end
 module Stripe
   class SubscriptionPauseParams < ::Stripe::RequestParams
     class BillFor < ::Stripe::RequestParams
-      # Controls whether to debit for accrued metered usage in the current billing period. The default is `true`.
-      sig { returns(T.nilable(T::Boolean)) }
-      def outstanding_usage; end
-      sig { params(_outstanding_usage: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
-      def outstanding_usage=(_outstanding_usage); end
-      # Controls whether to credit for licensed items in the current billing period. The default is `true`.
-      sig { returns(T.nilable(T::Boolean)) }
-      def unused_time; end
-      sig { params(_unused_time: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
-      def unused_time=(_unused_time); end
+      class OutstandingUsageThrough < ::Stripe::RequestParams
+        # When to bill metered usage in the current period.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig { params(type: String).void }
+        def initialize(type: nil); end
+      end
+      class UnusedTimeFrom < ::Stripe::RequestParams
+        # When to credit for unused time.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig { params(type: String).void }
+        def initialize(type: nil); end
+      end
+      # Controls when to bill for metered usage in the current period. Defaults to `{ type: "now" }`.
+      sig {
+        returns(T.nilable(::Stripe::SubscriptionPauseParams::BillFor::OutstandingUsageThrough))
+       }
+      def outstanding_usage_through; end
+      sig {
+        params(_outstanding_usage_through: T.nilable(::Stripe::SubscriptionPauseParams::BillFor::OutstandingUsageThrough)).returns(T.nilable(::Stripe::SubscriptionPauseParams::BillFor::OutstandingUsageThrough))
+       }
+      def outstanding_usage_through=(_outstanding_usage_through); end
+      # Controls when to credit for unused time on licensed items. Defaults to `{ type: "now" }`.
+      sig { returns(T.nilable(::Stripe::SubscriptionPauseParams::BillFor::UnusedTimeFrom)) }
+      def unused_time_from; end
       sig {
-        params(outstanding_usage: T.nilable(T::Boolean), unused_time: T.nilable(T::Boolean)).void
+        params(_unused_time_from: T.nilable(::Stripe::SubscriptionPauseParams::BillFor::UnusedTimeFrom)).returns(T.nilable(::Stripe::SubscriptionPauseParams::BillFor::UnusedTimeFrom))
        }
-      def initialize(outstanding_usage: nil, unused_time: nil); end
+      def unused_time_from=(_unused_time_from); end
+      sig {
+        params(outstanding_usage_through: T.nilable(::Stripe::SubscriptionPauseParams::BillFor::OutstandingUsageThrough), unused_time_from: T.nilable(::Stripe::SubscriptionPauseParams::BillFor::UnusedTimeFrom)).void
+       }
+      def initialize(outstanding_usage_through: nil, unused_time_from: nil); end
     end
     # Controls what to bill for when pausing the subscription.
     sig { returns(T.nilable(::Stripe::SubscriptionPauseParams::BillFor)) }
@@ -200984,20 +201318,14 @@ module Stripe
     def proration_date; end
     sig { params(_proration_date: T.nilable(Integer)).returns(T.nilable(Integer)) }
     def proration_date=(_proration_date); end
-    # Controls when the subscription transitions from `paused` to `active`. Determines how payment on the invoice affects the resumption process.The default is `pending_if_incomplete`.
-    sig { returns(T.nilable(String)) }
-    def payment_behavior; end
-    sig { params(_payment_behavior: T.nilable(String)).returns(T.nilable(String)) }
-    def payment_behavior=(_payment_behavior); end
     sig {
-      params(billing_cycle_anchor: T.nilable(String), expand: T.nilable(T::Array[String]), proration_behavior: T.nilable(String), proration_date: T.nilable(Integer), payment_behavior: T.nilable(String)).void
+      params(billing_cycle_anchor: T.nilable(String), expand: T.nilable(T::Array[String]), proration_behavior: T.nilable(String), proration_date: T.nilable(Integer)).void
      }
     def initialize(
       billing_cycle_anchor: nil,
       expand: nil,
       proration_behavior: nil,
-      proration_date: nil,
-      payment_behavior: nil
+      proration_date: nil
     ); end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 18.4.0.pre.alpha.4
+  version: 18.4.0.pre.alpha.6
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-02-17 00:00:00.000000000 Z
+date: 2026-02-23 00:00:00.000000000 Z
 dependencies: []
 description: Stripe is the easiest way to accept payments online.  See https://stripe.com
   for details.