stripe 13.5.0 → 14.0.0

data/lib/stripe/services/billing/meter_event_summary_service.rb

@@ -4,6 +4,45 @@
 module Stripe
   module Billing
     class MeterEventSummaryService < StripeService
+      class ListParams < Stripe::RequestParams
+        # The customer for which to fetch event summaries.
+        attr_accessor :customer
+        # The timestamp from when to stop aggregating meter events (exclusive). Must be aligned with minute boundaries.
+        attr_accessor :end_time
+        # 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.
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        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.
+        attr_accessor :limit
+        # The timestamp from when to start aggregating meter events (inclusive). Must be aligned with minute boundaries.
+        attr_accessor :start_time
+        # 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
+        # Specifies what granularity to use when generating event summaries. If not specified, a single event summary would be returned for the specified time range. For hourly granularity, start and end times must align with hour boundaries (e.g., 00:00, 01:00, ..., 23:00). For daily granularity, start and end times must align with UTC day boundaries (00:00 UTC).
+        attr_accessor :value_grouping_window
+
+        def initialize(
+          customer: nil,
+          end_time: nil,
+          ending_before: nil,
+          expand: nil,
+          limit: nil,
+          start_time: nil,
+          starting_after: nil,
+          value_grouping_window: nil
+        )
+          @customer = customer
+          @end_time = end_time
+          @ending_before = ending_before
+          @expand = expand
+          @limit = limit
+          @start_time = start_time
+          @starting_after = starting_after
+          @value_grouping_window = value_grouping_window
+        end
+      end
+
       # Retrieve a list of billing meter event summaries.
       def list(id, params = {}, opts = {})
         request(

data/lib/stripe/services/billing/meter_service.rb

@@ -11,6 +11,136 @@ module Stripe
         @event_summaries = Stripe::Billing::MeterEventSummaryService.new(@requestor)
       end
 
+      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.
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        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.
+        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.
+        attr_accessor :starting_after
+        # Filter results to only include meters with the given status.
+        attr_accessor :status
+
+        def initialize(
+          ending_before: nil,
+          expand: nil,
+          limit: nil,
+          starting_after: nil,
+          status: nil
+        )
+          @ending_before = ending_before
+          @expand = expand
+          @limit = limit
+          @starting_after = starting_after
+          @status = status
+        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.
+          attr_accessor :event_payload_key
+          # The method for mapping a meter event to a customer. Must be `by_id`.
+          attr_accessor :type
+
+          def initialize(event_payload_key: nil, type: nil)
+            @event_payload_key = event_payload_key
+            @type = type
+          end
+        end
+
+        class DefaultAggregation < Stripe::RequestParams
+          # Specifies how events are aggregated. Allowed values are `count` to count the number of events, `sum` to sum each event's value and `last` to take the last event's value in the window.
+          attr_accessor :formula
+
+          def initialize(formula: nil)
+            @formula = formula
+          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".
+          attr_accessor :event_payload_key
+
+          def initialize(event_payload_key: nil)
+            @event_payload_key = event_payload_key
+          end
+        end
+        # Fields that specify how to map a meter event to a customer.
+        attr_accessor :customer_mapping
+        # The default settings to aggregate a meter's events with.
+        attr_accessor :default_aggregation
+        # The meter’s name. Not visible to the customer.
+        attr_accessor :display_name
+        # The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
+        attr_accessor :event_name
+        # The time window to pre-aggregate meter events for, if any.
+        attr_accessor :event_time_window
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+        # Fields that specify how to calculate a meter event's value.
+        attr_accessor :value_settings
+
+        def initialize(
+          customer_mapping: nil,
+          default_aggregation: nil,
+          display_name: nil,
+          event_name: nil,
+          event_time_window: nil,
+          expand: nil,
+          value_settings: nil
+        )
+          @customer_mapping = customer_mapping
+          @default_aggregation = default_aggregation
+          @display_name = display_name
+          @event_name = event_name
+          @event_time_window = event_time_window
+          @expand = expand
+          @value_settings = value_settings
+        end
+      end
+
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+
+        def initialize(expand: nil)
+          @expand = expand
+        end
+      end
+
+      class UpdateParams < Stripe::RequestParams
+        # The meter’s name. Not visible to the customer.
+        attr_accessor :display_name
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+
+        def initialize(display_name: nil, expand: nil)
+          @display_name = display_name
+          @expand = expand
+        end
+      end
+
+      class DeactivateParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+
+        def initialize(expand: nil)
+          @expand = expand
+        end
+      end
+
+      class ReactivateParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+
+        def initialize(expand: nil)
+          @expand = expand
+        end
+      end
+
       # Creates a billing meter.
       def create(params = {}, opts = {})
         request(

data/lib/stripe/services/billing_portal/configuration_service.rb

@@ -4,6 +4,450 @@
 module Stripe
   module BillingPortal
     class ConfigurationService < StripeService
+      class ListParams < Stripe::RequestParams
+        # Only return configurations that are active or inactive (e.g., pass `true` to only list active configurations).
+        attr_accessor :active
+        # 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.
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+        # Only return the default or non-default configurations (e.g., pass `true` to only list the default configuration).
+        attr_accessor :is_default
+        # 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
+        # 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
+
+        def initialize(
+          active: nil,
+          ending_before: nil,
+          expand: nil,
+          is_default: nil,
+          limit: nil,
+          starting_after: nil
+        )
+          @active = active
+          @ending_before = ending_before
+          @expand = expand
+          @is_default = is_default
+          @limit = limit
+          @starting_after = starting_after
+        end
+      end
+
+      class CreateParams < Stripe::RequestParams
+        class BusinessProfile < Stripe::RequestParams
+          # The messaging shown to customers in the portal.
+          attr_accessor :headline
+          # A link to the business’s publicly available privacy policy.
+          attr_accessor :privacy_policy_url
+          # A link to the business’s publicly available terms of service.
+          attr_accessor :terms_of_service_url
+
+          def initialize(headline: nil, privacy_policy_url: nil, terms_of_service_url: nil)
+            @headline = headline
+            @privacy_policy_url = privacy_policy_url
+            @terms_of_service_url = terms_of_service_url
+          end
+        end
+
+        class Features < Stripe::RequestParams
+          class CustomerUpdate < Stripe::RequestParams
+            # The types of customer updates that are supported. When empty, customers are not updateable.
+            attr_accessor :allowed_updates
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+
+            def initialize(allowed_updates: nil, enabled: nil)
+              @allowed_updates = allowed_updates
+              @enabled = enabled
+            end
+          end
+
+          class InvoiceHistory < Stripe::RequestParams
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+
+            def initialize(enabled: nil)
+              @enabled = enabled
+            end
+          end
+
+          class PaymentMethodUpdate < Stripe::RequestParams
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+
+            def initialize(enabled: nil)
+              @enabled = enabled
+            end
+          end
+
+          class SubscriptionCancel < Stripe::RequestParams
+            class CancellationReason < Stripe::RequestParams
+              # Whether the feature is enabled.
+              attr_accessor :enabled
+              # Which cancellation reasons will be given as options to the customer.
+              attr_accessor :options
+
+              def initialize(enabled: nil, options: nil)
+                @enabled = enabled
+                @options = options
+              end
+            end
+            # Whether the cancellation reasons will be collected in the portal and which options are exposed to the customer
+            attr_accessor :cancellation_reason
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+            # Whether to cancel subscriptions immediately or at the end of the billing period.
+            attr_accessor :mode
+            # Whether to create prorations when canceling subscriptions. Possible values are `none` and `create_prorations`, which is only compatible with `mode=immediately`. Passing `always_invoice` will result in an error. No prorations are generated when canceling a subscription at the end of its natural billing period.
+            attr_accessor :proration_behavior
+
+            def initialize(
+              cancellation_reason: nil,
+              enabled: nil,
+              mode: nil,
+              proration_behavior: nil
+            )
+              @cancellation_reason = cancellation_reason
+              @enabled = enabled
+              @mode = mode
+              @proration_behavior = proration_behavior
+            end
+          end
+
+          class SubscriptionUpdate < Stripe::RequestParams
+            class Product < Stripe::RequestParams
+              # The list of price IDs for the product that a subscription can be updated to.
+              attr_accessor :prices
+              # The product id.
+              attr_accessor :product
+
+              def initialize(prices: nil, product: nil)
+                @prices = prices
+                @product = product
+              end
+            end
+
+            class ScheduleAtPeriodEnd < Stripe::RequestParams
+              class Condition < Stripe::RequestParams
+                # The type of condition.
+                attr_accessor :type
+
+                def initialize(type: nil)
+                  @type = type
+                end
+              end
+              # List of conditions. When any condition is true, the update will be scheduled at the end of the current period.
+              attr_accessor :conditions
+
+              def initialize(conditions: nil)
+                @conditions = conditions
+              end
+            end
+            # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
+            attr_accessor :default_allowed_updates
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+            # The list of up to 10 products that support subscription updates.
+            attr_accessor :products
+            # Determines how to handle prorations resulting from subscription updates. Valid values are `none`, `create_prorations`, and `always_invoice`.
+            attr_accessor :proration_behavior
+            # Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
+            attr_accessor :schedule_at_period_end
+
+            def initialize(
+              default_allowed_updates: nil,
+              enabled: nil,
+              products: nil,
+              proration_behavior: nil,
+              schedule_at_period_end: nil
+            )
+              @default_allowed_updates = default_allowed_updates
+              @enabled = enabled
+              @products = products
+              @proration_behavior = proration_behavior
+              @schedule_at_period_end = schedule_at_period_end
+            end
+          end
+          # Information about updating the customer details in the portal.
+          attr_accessor :customer_update
+          # Information about showing the billing history in the portal.
+          attr_accessor :invoice_history
+          # Information about updating payment methods in the portal.
+          attr_accessor :payment_method_update
+          # Information about canceling subscriptions in the portal.
+          attr_accessor :subscription_cancel
+          # Information about updating subscriptions in the portal.
+          attr_accessor :subscription_update
+
+          def initialize(
+            customer_update: nil,
+            invoice_history: nil,
+            payment_method_update: nil,
+            subscription_cancel: nil,
+            subscription_update: nil
+          )
+            @customer_update = customer_update
+            @invoice_history = invoice_history
+            @payment_method_update = payment_method_update
+            @subscription_cancel = subscription_cancel
+            @subscription_update = subscription_update
+          end
+        end
+
+        class LoginPage < Stripe::RequestParams
+          # Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal.
+          attr_accessor :enabled
+
+          def initialize(enabled: nil)
+            @enabled = enabled
+          end
+        end
+        # The business information shown to customers in the portal.
+        attr_accessor :business_profile
+        # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
+        attr_accessor :default_return_url
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+        # Information about the features available in the portal.
+        attr_accessor :features
+        # The hosted login page for this configuration. Learn more about the portal login page in our [integration docs](https://stripe.com/docs/billing/subscriptions/integrating-customer-portal#share).
+        attr_accessor :login_page
+        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+        attr_accessor :metadata
+
+        def initialize(
+          business_profile: nil,
+          default_return_url: nil,
+          expand: nil,
+          features: nil,
+          login_page: nil,
+          metadata: nil
+        )
+          @business_profile = business_profile
+          @default_return_url = default_return_url
+          @expand = expand
+          @features = features
+          @login_page = login_page
+          @metadata = metadata
+        end
+      end
+
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+
+        def initialize(expand: nil)
+          @expand = expand
+        end
+      end
+
+      class UpdateParams < Stripe::RequestParams
+        class BusinessProfile < Stripe::RequestParams
+          # The messaging shown to customers in the portal.
+          attr_accessor :headline
+          # A link to the business’s publicly available privacy policy.
+          attr_accessor :privacy_policy_url
+          # A link to the business’s publicly available terms of service.
+          attr_accessor :terms_of_service_url
+
+          def initialize(headline: nil, privacy_policy_url: nil, terms_of_service_url: nil)
+            @headline = headline
+            @privacy_policy_url = privacy_policy_url
+            @terms_of_service_url = terms_of_service_url
+          end
+        end
+
+        class Features < Stripe::RequestParams
+          class CustomerUpdate < Stripe::RequestParams
+            # The types of customer updates that are supported. When empty, customers are not updateable.
+            attr_accessor :allowed_updates
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+
+            def initialize(allowed_updates: nil, enabled: nil)
+              @allowed_updates = allowed_updates
+              @enabled = enabled
+            end
+          end
+
+          class InvoiceHistory < Stripe::RequestParams
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+
+            def initialize(enabled: nil)
+              @enabled = enabled
+            end
+          end
+
+          class PaymentMethodUpdate < Stripe::RequestParams
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+
+            def initialize(enabled: nil)
+              @enabled = enabled
+            end
+          end
+
+          class SubscriptionCancel < Stripe::RequestParams
+            class CancellationReason < Stripe::RequestParams
+              # Whether the feature is enabled.
+              attr_accessor :enabled
+              # Which cancellation reasons will be given as options to the customer.
+              attr_accessor :options
+
+              def initialize(enabled: nil, options: nil)
+                @enabled = enabled
+                @options = options
+              end
+            end
+            # Whether the cancellation reasons will be collected in the portal and which options are exposed to the customer
+            attr_accessor :cancellation_reason
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+            # Whether to cancel subscriptions immediately or at the end of the billing period.
+            attr_accessor :mode
+            # Whether to create prorations when canceling subscriptions. Possible values are `none` and `create_prorations`, which is only compatible with `mode=immediately`. Passing `always_invoice` will result in an error. No prorations are generated when canceling a subscription at the end of its natural billing period.
+            attr_accessor :proration_behavior
+
+            def initialize(
+              cancellation_reason: nil,
+              enabled: nil,
+              mode: nil,
+              proration_behavior: nil
+            )
+              @cancellation_reason = cancellation_reason
+              @enabled = enabled
+              @mode = mode
+              @proration_behavior = proration_behavior
+            end
+          end
+
+          class SubscriptionUpdate < Stripe::RequestParams
+            class Product < Stripe::RequestParams
+              # The list of price IDs for the product that a subscription can be updated to.
+              attr_accessor :prices
+              # The product id.
+              attr_accessor :product
+
+              def initialize(prices: nil, product: nil)
+                @prices = prices
+                @product = product
+              end
+            end
+
+            class ScheduleAtPeriodEnd < Stripe::RequestParams
+              class Condition < Stripe::RequestParams
+                # The type of condition.
+                attr_accessor :type
+
+                def initialize(type: nil)
+                  @type = type
+                end
+              end
+              # List of conditions. When any condition is true, the update will be scheduled at the end of the current period.
+              attr_accessor :conditions
+
+              def initialize(conditions: nil)
+                @conditions = conditions
+              end
+            end
+            # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
+            attr_accessor :default_allowed_updates
+            # Whether the feature is enabled.
+            attr_accessor :enabled
+            # The list of up to 10 products that support subscription updates.
+            attr_accessor :products
+            # Determines how to handle prorations resulting from subscription updates. Valid values are `none`, `create_prorations`, and `always_invoice`.
+            attr_accessor :proration_behavior
+            # Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
+            attr_accessor :schedule_at_period_end
+
+            def initialize(
+              default_allowed_updates: nil,
+              enabled: nil,
+              products: nil,
+              proration_behavior: nil,
+              schedule_at_period_end: nil
+            )
+              @default_allowed_updates = default_allowed_updates
+              @enabled = enabled
+              @products = products
+              @proration_behavior = proration_behavior
+              @schedule_at_period_end = schedule_at_period_end
+            end
+          end
+          # Information about updating the customer details in the portal.
+          attr_accessor :customer_update
+          # Information about showing the billing history in the portal.
+          attr_accessor :invoice_history
+          # Information about updating payment methods in the portal.
+          attr_accessor :payment_method_update
+          # Information about canceling subscriptions in the portal.
+          attr_accessor :subscription_cancel
+          # Information about updating subscriptions in the portal.
+          attr_accessor :subscription_update
+
+          def initialize(
+            customer_update: nil,
+            invoice_history: nil,
+            payment_method_update: nil,
+            subscription_cancel: nil,
+            subscription_update: nil
+          )
+            @customer_update = customer_update
+            @invoice_history = invoice_history
+            @payment_method_update = payment_method_update
+            @subscription_cancel = subscription_cancel
+            @subscription_update = subscription_update
+          end
+        end
+
+        class LoginPage < Stripe::RequestParams
+          # Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal.
+          #
+          # Set to `false` to deactivate the `login_page.url`.
+          attr_accessor :enabled
+
+          def initialize(enabled: nil)
+            @enabled = enabled
+          end
+        end
+        # Whether the configuration is active and can be used to create portal sessions.
+        attr_accessor :active
+        # The business information shown to customers in the portal.
+        attr_accessor :business_profile
+        # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
+        attr_accessor :default_return_url
+        # Specifies which fields in the response should be expanded.
+        attr_accessor :expand
+        # Information about the features available in the portal.
+        attr_accessor :features
+        # The hosted login page for this configuration. Learn more about the portal login page in our [integration docs](https://stripe.com/docs/billing/subscriptions/integrating-customer-portal#share).
+        attr_accessor :login_page
+        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+        attr_accessor :metadata
+
+        def initialize(
+          active: nil,
+          business_profile: nil,
+          default_return_url: nil,
+          expand: nil,
+          features: nil,
+          login_page: nil,
+          metadata: nil
+        )
+          @active = active
+          @business_profile = business_profile
+          @default_return_url = default_return_url
+          @expand = expand
+          @features = features
+          @login_page = login_page
+          @metadata = metadata
+        end
+      end
+
       # Creates a configuration that describes the functionality and behavior of a PortalSession
       def create(params = {}, opts = {})
         request(