stripe 13.4.0 → 13.5.0.pre.beta.1

data/rbi/stripe/resources/billing/credit_balance_transaction.rbi

@@ -0,0 +1,154 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Billing
+    # A credit balance transaction is a resource representing a transaction (either a credit or a debit) against an existing credit grant.
+    class CreditBalanceTransaction < APIResource
+      class Credit < Stripe::StripeObject
+        class Amount < Stripe::StripeObject
+          class Monetary < 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) }
+            attr_reader :currency
+            # A positive integer representing the amount.
+            sig { returns(Integer) }
+            attr_reader :value
+          end
+          # The monetary amount.
+          sig { returns(T.nilable(Monetary)) }
+          attr_reader :monetary
+          # The type of this amount. We currently only support `monetary` billing credits.
+          sig { returns(String) }
+          attr_reader :type
+        end
+        class CreditsApplicationInvoiceVoided < Stripe::StripeObject
+          # The invoice to which the reinstated billing credits were originally applied.
+          sig { returns(T.any(String, Stripe::Invoice)) }
+          attr_reader :invoice
+          # The invoice line item to which the reinstated billing credits were originally applied.
+          sig { returns(String) }
+          attr_reader :invoice_line_item
+        end
+        # Attribute for field amount
+        sig { returns(Amount) }
+        attr_reader :amount
+        # Details of the invoice to which the reinstated credits were originally applied. Only present if `type` is `credits_application_invoice_voided`.
+        sig { returns(T.nilable(CreditsApplicationInvoiceVoided)) }
+        attr_reader :credits_application_invoice_voided
+        # The type of credit transaction.
+        sig { returns(String) }
+        attr_reader :type
+      end
+      class Debit < Stripe::StripeObject
+        class Amount < Stripe::StripeObject
+          class Monetary < 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) }
+            attr_reader :currency
+            # A positive integer representing the amount.
+            sig { returns(Integer) }
+            attr_reader :value
+          end
+          # The monetary amount.
+          sig { returns(T.nilable(Monetary)) }
+          attr_reader :monetary
+          # The type of this amount. We currently only support `monetary` billing credits.
+          sig { returns(String) }
+          attr_reader :type
+        end
+        class CreditsApplied < Stripe::StripeObject
+          # The invoice to which the billing credits were applied.
+          sig { returns(T.any(String, Stripe::Invoice)) }
+          attr_reader :invoice
+          # The invoice line item to which the billing credits were applied.
+          sig { returns(String) }
+          attr_reader :invoice_line_item
+        end
+        # Attribute for field amount
+        sig { returns(Amount) }
+        attr_reader :amount
+        # Details of how the billing credits were applied to an invoice. Only present if `type` is `credits_applied`.
+        sig { returns(T.nilable(CreditsApplied)) }
+        attr_reader :credits_applied
+        # The type of debit transaction.
+        sig { returns(String) }
+        attr_reader :type
+      end
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :created
+      # Credit details for this credit balance transaction. Only present if type is `credit`.
+      sig { returns(T.nilable(Credit)) }
+      attr_reader :credit
+      # The credit grant associated with this credit balance transaction.
+      sig { returns(T.any(String, Stripe::Billing::CreditGrant)) }
+      attr_reader :credit_grant
+      # Debit details for this credit balance transaction. Only present if type is `debit`.
+      sig { returns(T.nilable(Debit)) }
+      attr_reader :debit
+      # The effective time of this credit balance transaction.
+      sig { returns(Integer) }
+      attr_reader :effective_at
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_reader :id
+      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      sig { returns(T::Boolean) }
+      attr_reader :livemode
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      attr_reader :object
+      # ID of the test clock this credit balance transaction belongs to.
+      sig { returns(T.nilable(T.any(String, Stripe::TestHelpers::TestClock))) }
+      attr_reader :test_clock
+      # The type of credit balance transaction (credit or debit).
+      sig { returns(T.nilable(String)) }
+      attr_reader :type
+      class ListParams < Stripe::RequestParams
+        # The credit grant for which to fetch credit balance transactions.
+        sig { returns(String) }
+        attr_accessor :credit_grant
+        # The customer for which to fetch credit balance transactions.
+        sig { returns(String) }
+        attr_accessor :customer
+        # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
+        sig { returns(String) }
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+        sig { returns(Integer) }
+        attr_accessor :limit
+        # 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.
+        sig { returns(String) }
+        attr_accessor :starting_after
+        sig {
+          params(credit_grant: String, customer: String, ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+         }
+        def initialize(
+          credit_grant: nil,
+          customer: nil,
+          ending_before: nil,
+          expand: nil,
+          limit: nil,
+          starting_after: nil
+        ); end
+      end
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      # Retrieve a list of credit balance transactions.
+      sig {
+        params(params: T.any(::Stripe::Billing::CreditBalanceTransaction::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+    end
+  end
+end

data/rbi/stripe/resources/billing/credit_grant.rbi

@@ -0,0 +1,291 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Billing
+    # A credit grant is an API resource that documents the allocation of some billing credits to a customer.
+    #
+    # Related guide: [Billing credits](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits)
+    class CreditGrant < APIResource
+      class Amount < Stripe::StripeObject
+        class Monetary < 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) }
+          attr_reader :currency
+          # A positive integer representing the amount.
+          sig { returns(Integer) }
+          attr_reader :value
+        end
+        # The monetary amount.
+        sig { returns(T.nilable(Monetary)) }
+        attr_reader :monetary
+        # The type of this amount. We currently only support `monetary` billing credits.
+        sig { returns(String) }
+        attr_reader :type
+      end
+      class ApplicabilityConfig < Stripe::StripeObject
+        class Scope < Stripe::StripeObject
+          class Price < Stripe::StripeObject
+            # Unique identifier for the object.
+            sig { returns(T.nilable(String)) }
+            attr_reader :id
+          end
+          # The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+          sig { returns(String) }
+          attr_reader :price_type
+          # The prices that credit grants can apply to. We currently only support `metered` prices. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+          sig { returns(T::Array[Price]) }
+          attr_reader :prices
+        end
+        # Attribute for field scope
+        sig { returns(Scope) }
+        attr_reader :scope
+      end
+      # Attribute for field amount
+      sig { returns(Amount) }
+      attr_reader :amount
+      # Attribute for field applicability_config
+      sig { returns(ApplicabilityConfig) }
+      attr_reader :applicability_config
+      # The category of this credit grant. This is for tracking purposes and isn't displayed to the customer.
+      sig { returns(String) }
+      attr_reader :category
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :created
+      # ID of the customer receiving the billing credits.
+      sig { returns(T.any(String, Stripe::Customer)) }
+      attr_reader :customer
+      # The time when the billing credits become effective-when they're eligible for use.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :effective_at
+      # The time when the billing credits expire. If not present, the billing credits don't expire.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :expires_at
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_reader :id
+      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      sig { returns(T::Boolean) }
+      attr_reader :livemode
+      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+      sig { returns(T::Hash[String, String]) }
+      attr_reader :metadata
+      # A descriptive name shown in dashboard.
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      attr_reader :object
+      # ID of the test clock this credit grant belongs to.
+      sig { returns(T.nilable(T.any(String, Stripe::TestHelpers::TestClock))) }
+      attr_reader :test_clock
+      # Time at which the object was last updated. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :updated
+      # The time when this credit grant was voided. If not present, the credit grant hasn't been voided.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :voided_at
+      class ListParams < Stripe::RequestParams
+        # Only return credit grants for this customer.
+        sig { returns(String) }
+        attr_accessor :customer
+        # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
+        sig { returns(String) }
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+        sig { returns(Integer) }
+        attr_accessor :limit
+        # 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.
+        sig { returns(String) }
+        attr_accessor :starting_after
+        sig {
+          params(customer: String, ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+         }
+        def initialize(
+          customer: nil,
+          ending_before: nil,
+          expand: nil,
+          limit: nil,
+          starting_after: nil
+        ); end
+      end
+      class CreateParams < Stripe::RequestParams
+        class Amount < Stripe::RequestParams
+          class Monetary < Stripe::RequestParams
+            # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
+            sig { returns(String) }
+            attr_accessor :currency
+            # A positive integer representing the amount of the credit grant.
+            sig { returns(Integer) }
+            attr_accessor :value
+            sig { params(currency: String, value: Integer).void }
+            def initialize(currency: nil, value: nil); end
+          end
+          # The monetary amount.
+          sig { returns(::Stripe::Billing::CreditGrant::CreateParams::Amount::Monetary) }
+          attr_accessor :monetary
+          # Specify the type of this amount. We currently only support `monetary` billing credits.
+          sig { returns(String) }
+          attr_accessor :type
+          sig {
+            params(monetary: ::Stripe::Billing::CreditGrant::CreateParams::Amount::Monetary, type: String).void
+           }
+          def initialize(monetary: nil, type: nil); end
+        end
+        class ApplicabilityConfig < Stripe::RequestParams
+          class Scope < Stripe::RequestParams
+            class Price < Stripe::RequestParams
+              # The price ID this credit grant should apply to.
+              sig { returns(String) }
+              attr_accessor :id
+              sig { params(id: String).void }
+              def initialize(id: nil); end
+            end
+            # The price type that credit grants can apply to. We currently only support the `metered` price type.
+            sig { returns(String) }
+            attr_accessor :price_type
+            # A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+            sig {
+              returns(T::Array[::Stripe::Billing::CreditGrant::CreateParams::ApplicabilityConfig::Scope::Price])
+             }
+            attr_accessor :prices
+            sig {
+              params(price_type: String, prices: T::Array[::Stripe::Billing::CreditGrant::CreateParams::ApplicabilityConfig::Scope::Price]).void
+             }
+            def initialize(price_type: nil, prices: nil); end
+          end
+          # Specify the scope of this applicability config.
+          sig { returns(::Stripe::Billing::CreditGrant::CreateParams::ApplicabilityConfig::Scope) }
+          attr_accessor :scope
+          sig {
+            params(scope: ::Stripe::Billing::CreditGrant::CreateParams::ApplicabilityConfig::Scope).void
+           }
+          def initialize(scope: nil); end
+        end
+        # Amount of this credit grant.
+        sig { returns(::Stripe::Billing::CreditGrant::CreateParams::Amount) }
+        attr_accessor :amount
+        # Configuration specifying what this credit grant applies to.
+        sig { returns(::Stripe::Billing::CreditGrant::CreateParams::ApplicabilityConfig) }
+        attr_accessor :applicability_config
+        # The category of this credit grant.
+        sig { returns(String) }
+        attr_accessor :category
+        # ID of the customer to receive the billing credits.
+        sig { returns(String) }
+        attr_accessor :customer
+        # The time when the billing credits become effective-when they're eligible for use. It defaults to the current timestamp if not specified.
+        sig { returns(Integer) }
+        attr_accessor :effective_at
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The time when the billing credits expire. If not specified, the billing credits don't expire.
+        sig { returns(Integer) }
+        attr_accessor :expires_at
+        # Set of key-value pairs that you can attach to an object. You can use this to store additional information about the object (for example, cost basis) in a structured format.
+        sig { returns(T::Hash[String, String]) }
+        attr_accessor :metadata
+        # A descriptive name shown in the Dashboard.
+        sig { returns(String) }
+        attr_accessor :name
+        sig {
+          params(amount: ::Stripe::Billing::CreditGrant::CreateParams::Amount, applicability_config: ::Stripe::Billing::CreditGrant::CreateParams::ApplicabilityConfig, category: String, customer: String, effective_at: Integer, expand: T::Array[String], expires_at: Integer, metadata: T::Hash[String, String], name: String).void
+         }
+        def initialize(
+          amount: nil,
+          applicability_config: nil,
+          category: nil,
+          customer: nil,
+          effective_at: nil,
+          expand: nil,
+          expires_at: nil,
+          metadata: nil,
+          name: nil
+        ); end
+      end
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class UpdateParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The time when the billing credits created by this credit grant expire. If set to empty, the billing credits never expire.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :expires_at
+        # Set of key-value pairs you can attach to an object. You can use this to store additional information about the object (for example, cost basis) in a structured format.
+        sig { returns(T::Hash[String, String]) }
+        attr_accessor :metadata
+        sig {
+          params(expand: T::Array[String], expires_at: T.nilable(Integer), metadata: T::Hash[String, String]).void
+         }
+        def initialize(expand: nil, expires_at: nil, metadata: nil); end
+      end
+      class ExpireParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class VoidGrantParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      # Creates a credit grant.
+      sig {
+        params(params: T.any(::Stripe::Billing::CreditGrant::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::CreditGrant)
+       }
+      def self.create(params = {}, opts = {}); end
+
+      # Expires a credit grant.
+      sig {
+        params(params: T.any(::Stripe::Billing::CreditGrant::ExpireParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::CreditGrant)
+       }
+      def expire(params = {}, opts = {}); end
+
+      # Expires a credit grant.
+      sig {
+        params(id: String, params: T.any(::Stripe::Billing::CreditGrant::ExpireParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::CreditGrant)
+       }
+      def self.expire(id, params = {}, opts = {}); end
+
+      # Retrieve a list of credit grants.
+      sig {
+        params(params: T.any(::Stripe::Billing::CreditGrant::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+
+      # Updates a credit grant.
+      sig {
+        params(id: String, params: T.any(::Stripe::Billing::CreditGrant::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::CreditGrant)
+       }
+      def self.update(id, params = {}, opts = {}); end
+
+      # Voids a credit grant.
+      sig {
+        params(params: T.any(::Stripe::Billing::CreditGrant::VoidGrantParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::CreditGrant)
+       }
+      def void_grant(params = {}, opts = {}); end
+
+      # Voids a credit grant.
+      sig {
+        params(id: String, params: T.any(::Stripe::Billing::CreditGrant::VoidGrantParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::CreditGrant)
+       }
+      def self.void_grant(id, params = {}, opts = {}); end
+    end
+  end
+end

data/rbi/stripe/resources/billing/meter.rbi

@@ -0,0 +1,233 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Billing
+    # Meters specify how to aggregate meter events over a billing period. Meter events represent the actions that customers take in your system. Meters attach to prices and form the basis of the bill.
+    #
+    # Related guide: [Usage based billing](https://docs.stripe.com/billing/subscriptions/usage-based)
+    class Meter < APIResource
+      class CustomerMapping < Stripe::StripeObject
+        # The key in the meter event payload to use for mapping the event to a customer.
+        sig { returns(String) }
+        attr_reader :event_payload_key
+        # The method for mapping a meter event to a customer.
+        sig { returns(String) }
+        attr_reader :type
+      end
+      class DefaultAggregation < Stripe::StripeObject
+        # Specifies how events are aggregated.
+        sig { returns(String) }
+        attr_reader :formula
+      end
+      class StatusTransitions < Stripe::StripeObject
+        # The time the meter was deactivated, if any. Measured in seconds since Unix epoch.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :deactivated_at
+      end
+      class ValueSettings < Stripe::StripeObject
+        # The key in the meter event payload to use as the value for this meter.
+        sig { returns(String) }
+        attr_reader :event_payload_key
+      end
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :created
+      # Attribute for field customer_mapping
+      sig { returns(CustomerMapping) }
+      attr_reader :customer_mapping
+      # Attribute for field default_aggregation
+      sig { returns(DefaultAggregation) }
+      attr_reader :default_aggregation
+      # The meter's name.
+      sig { returns(String) }
+      attr_reader :display_name
+      # The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
+      sig { returns(String) }
+      attr_reader :event_name
+      # The time window to pre-aggregate meter events for, if any.
+      sig { returns(T.nilable(String)) }
+      attr_reader :event_time_window
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_reader :id
+      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      sig { returns(T::Boolean) }
+      attr_reader :livemode
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      attr_reader :object
+      # The meter's status.
+      sig { returns(String) }
+      attr_reader :status
+      # Attribute for field status_transitions
+      sig { returns(StatusTransitions) }
+      attr_reader :status_transitions
+      # Time at which the object was last updated. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :updated
+      # Attribute for field value_settings
+      sig { returns(ValueSettings) }
+      attr_reader :value_settings
+      class ListParams < Stripe::RequestParams
+        # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
+        sig { returns(String) }
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+        sig { returns(Integer) }
+        attr_accessor :limit
+        # 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.
+        sig { returns(String) }
+        attr_accessor :starting_after
+        # Filter results to only include meters with the given status.
+        sig { returns(String) }
+        attr_accessor :status
+        sig {
+          params(ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String, status: String).void
+         }
+        def initialize(
+          ending_before: nil,
+          expand: nil,
+          limit: nil,
+          starting_after: nil,
+          status: nil
+        ); end
+      end
+      class CreateParams < Stripe::RequestParams
+        class CustomerMapping < Stripe::RequestParams
+          # The key in the meter event payload to use for mapping the event to a customer.
+          sig { returns(String) }
+          attr_accessor :event_payload_key
+          # The method for mapping a meter event to a customer. Must be `by_id`.
+          sig { returns(String) }
+          attr_accessor :type
+          sig { params(event_payload_key: String, type: String).void }
+          def initialize(event_payload_key: nil, type: nil); end
+        end
+        class DefaultAggregation < Stripe::RequestParams
+          # Specifies how events are aggregated. Allowed values are `count` to count the number of events and `sum` to sum each event's value.
+          sig { returns(String) }
+          attr_accessor :formula
+          sig { params(formula: String).void }
+          def initialize(formula: nil); end
+        end
+        class ValueSettings < Stripe::RequestParams
+          # The key in the usage event payload to use as the value for this meter. For example, if the event payload contains usage on a `bytes_used` field, then set the event_payload_key to "bytes_used".
+          sig { returns(String) }
+          attr_accessor :event_payload_key
+          sig { params(event_payload_key: String).void }
+          def initialize(event_payload_key: nil); end
+        end
+        # Fields that specify how to map a meter event to a customer.
+        sig { returns(::Stripe::Billing::Meter::CreateParams::CustomerMapping) }
+        attr_accessor :customer_mapping
+        # The default settings to aggregate a meter's events with.
+        sig { returns(::Stripe::Billing::Meter::CreateParams::DefaultAggregation) }
+        attr_accessor :default_aggregation
+        # The meter’s name. Not visible to the customer.
+        sig { returns(String) }
+        attr_accessor :display_name
+        # The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
+        sig { returns(String) }
+        attr_accessor :event_name
+        # The time window to pre-aggregate meter events for, if any.
+        sig { returns(String) }
+        attr_accessor :event_time_window
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # Fields that specify how to calculate a meter event's value.
+        sig { returns(::Stripe::Billing::Meter::CreateParams::ValueSettings) }
+        attr_accessor :value_settings
+        sig {
+          params(customer_mapping: ::Stripe::Billing::Meter::CreateParams::CustomerMapping, default_aggregation: ::Stripe::Billing::Meter::CreateParams::DefaultAggregation, display_name: String, event_name: String, event_time_window: String, expand: T::Array[String], value_settings: ::Stripe::Billing::Meter::CreateParams::ValueSettings).void
+         }
+        def initialize(
+          customer_mapping: nil,
+          default_aggregation: nil,
+          display_name: nil,
+          event_name: nil,
+          event_time_window: nil,
+          expand: nil,
+          value_settings: nil
+        ); end
+      end
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class UpdateParams < Stripe::RequestParams
+        # The meter’s name. Not visible to the customer.
+        sig { returns(String) }
+        attr_accessor :display_name
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(display_name: String, expand: T::Array[String]).void }
+        def initialize(display_name: nil, expand: nil); end
+      end
+      class DeactivateParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class ReactivateParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      # Creates a billing meter.
+      sig {
+        params(params: T.any(::Stripe::Billing::Meter::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::Meter)
+       }
+      def self.create(params = {}, opts = {}); end
+
+      # When a meter is deactivated, no more meter events will be accepted for this meter. You can't attach a deactivated meter to a price.
+      sig {
+        params(params: T.any(::Stripe::Billing::Meter::DeactivateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::Meter)
+       }
+      def deactivate(params = {}, opts = {}); end
+
+      # When a meter is deactivated, no more meter events will be accepted for this meter. You can't attach a deactivated meter to a price.
+      sig {
+        params(id: String, params: T.any(::Stripe::Billing::Meter::DeactivateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::Meter)
+       }
+      def self.deactivate(id, params = {}, opts = {}); end
+
+      # Retrieve a list of billing meters.
+      sig {
+        params(params: T.any(::Stripe::Billing::Meter::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+
+      # When a meter is reactivated, events for this meter can be accepted and you can attach the meter to a price.
+      sig {
+        params(params: T.any(::Stripe::Billing::Meter::ReactivateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::Meter)
+       }
+      def reactivate(params = {}, opts = {}); end
+
+      # When a meter is reactivated, events for this meter can be accepted and you can attach the meter to a price.
+      sig {
+        params(id: String, params: T.any(::Stripe::Billing::Meter::ReactivateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::Meter)
+       }
+      def self.reactivate(id, params = {}, opts = {}); end
+
+      # Updates a billing meter.
+      sig {
+        params(id: String, params: T.any(::Stripe::Billing::Meter::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Billing::Meter)
+       }
+      def self.update(id, params = {}, opts = {}); end
+    end
+  end
+end