stripe 18.1.0.pre.beta.1 → 18.2.0.pre.alpha.1

data/lib/stripe/params/balance_transfer_create_params.rb

@@ -0,0 +1,66 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class BalanceTransferCreateParams < ::Stripe::RequestParams
+    class DestinationBalance < ::Stripe::RequestParams
+      # Destination balance type to push funds into for the Balance Transfer.
+      attr_accessor :type
+
+      def initialize(type: nil)
+        @type = type
+      end
+    end
+
+    class SourceBalance < ::Stripe::RequestParams
+      class AllocatedFunds < ::Stripe::RequestParams
+        # The charge ID that the funds are originally sourced from. Required if `type` is `charge`.
+        attr_accessor :charge
+        # The type of object that the funds are originally sourced from. One of `charge`.
+        attr_accessor :type
+
+        def initialize(charge: nil, type: nil)
+          @charge = charge
+          @type = type
+        end
+      end
+      # Attribute for param field allocated_funds
+      attr_accessor :allocated_funds
+      # Source balance type to pull funds from for the Balance Transfer.
+      attr_accessor :type
+
+      def initialize(allocated_funds: nil, type: nil)
+        @allocated_funds = allocated_funds
+        @type = type
+      end
+    end
+    # A positive integer representing how much to transfer in the smallest currency unit.
+    attr_accessor :amount
+    # 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_accessor :currency
+    # The balance to which funds are transferred.
+    attr_accessor :destination_balance
+    # Specifies which fields in the response should be expanded.
+    attr_accessor :expand
+    # 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. 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
+    # The balance from which funds are transferred, including details specific to the balance you choose.
+    attr_accessor :source_balance
+
+    def initialize(
+      amount: nil,
+      currency: nil,
+      destination_balance: nil,
+      expand: nil,
+      metadata: nil,
+      source_balance: nil
+    )
+      @amount = amount
+      @currency = currency
+      @destination_balance = destination_balance
+      @expand = expand
+      @metadata = metadata
+      @source_balance = source_balance
+    end
+  end
+end

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

@@ -4,6 +4,117 @@
 module Stripe
   module Billing
     class AlertCreateParams < ::Stripe::RequestParams
+      class CreditBalanceThreshold < ::Stripe::RequestParams
+        class Filter < ::Stripe::RequestParams
+          class CreditGrants < ::Stripe::RequestParams
+            class ApplicabilityConfig < ::Stripe::RequestParams
+              class Scope < ::Stripe::RequestParams
+                class BillableItem < ::Stripe::RequestParams
+                  # The billable item ID this credit grant should apply to.
+                  attr_accessor :id
+
+                  def initialize(id: nil)
+                    @id = id
+                  end
+                end
+
+                class Price < ::Stripe::RequestParams
+                  # The price ID this credit grant should apply to.
+                  attr_accessor :id
+
+                  def initialize(id: nil)
+                    @id = id
+                  end
+                end
+                # A list of billable items that the credit grant can apply to. We currently only support metered billable items. Cannot be used in combination with `price_type` or `prices`.
+                attr_accessor :billable_items
+                # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
+                attr_accessor :price_type
+                # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
+                attr_accessor :prices
+
+                def initialize(billable_items: nil, price_type: nil, prices: nil)
+                  @billable_items = billable_items
+                  @price_type = price_type
+                  @prices = prices
+                end
+              end
+              # Specify the scope of this applicability config.
+              attr_accessor :scope
+
+              def initialize(scope: nil)
+                @scope = scope
+              end
+            end
+            # The applicability configuration for this credit grants filter.
+            attr_accessor :applicability_config
+
+            def initialize(applicability_config: nil)
+              @applicability_config = applicability_config
+            end
+          end
+          # The credit grants for which to configure the credit balance alert.
+          attr_accessor :credit_grants
+          # Limit the scope to this credit balance alert only to this customer.
+          attr_accessor :customer
+          # What type of filter is being applied to this credit balance alert.
+          attr_accessor :type
+
+          def initialize(credit_grants: nil, customer: nil, type: nil)
+            @credit_grants = credit_grants
+            @customer = customer
+            @type = type
+          end
+        end
+
+        class Lte < ::Stripe::RequestParams
+          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
+
+          class Monetary < ::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
+          # Specify the type of this balance. We currently only support `monetary` billing credits.
+          attr_accessor :balance_type
+          # The custom pricing unit amount.
+          attr_accessor :custom_pricing_unit
+          # The monetary amount.
+          attr_accessor :monetary
+
+          def initialize(balance_type: nil, custom_pricing_unit: nil, monetary: nil)
+            @balance_type = balance_type
+            @custom_pricing_unit = custom_pricing_unit
+            @monetary = monetary
+          end
+        end
+        # The filters allows limiting the scope of this credit balance alert. You must specify a customer filter at this time.
+        attr_accessor :filters
+        # Defines at which value the alert will fire.
+        attr_accessor :lte
+
+        def initialize(filters: nil, lte: nil)
+          @filters = filters
+          @lte = lte
+        end
+      end
+
       class UsageThreshold < ::Stripe::RequestParams
         class Filter < ::Stripe::RequestParams
           # Limit the scope to this usage alert only to this customer.
@@ -34,6 +145,8 @@ module Stripe
       end
       # The type of alert to create.
       attr_accessor :alert_type
+      # The configuration of the credit balance threshold.
+      attr_accessor :credit_balance_threshold
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
       # The title of the alert.
@@ -41,8 +154,15 @@ module Stripe
       # The configuration of the usage threshold.
       attr_accessor :usage_threshold
 
-      def initialize(alert_type: nil, expand: nil, title: nil, usage_threshold: nil)
+      def initialize(
+        alert_type: nil,
+        credit_balance_threshold: nil,
+        expand: nil,
+        title: nil,
+        usage_threshold: nil
+      )
         @alert_type = alert_type
+        @credit_balance_threshold = credit_balance_threshold
         @expand = expand
         @title = title
         @usage_threshold = usage_threshold

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

@@ -6,6 +6,8 @@ module Stripe
     class AlertListParams < ::Stripe::RequestParams
       # Filter results to only include this type of alert.
       attr_accessor :alert_type
+      # Filter results to only include alerts for the given customer.
+      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.
       attr_accessor :ending_before
       # Specifies which fields in the response should be expanded.
@@ -19,6 +21,7 @@ module Stripe
 
       def initialize(
         alert_type: nil,
+        customer: nil,
         ending_before: nil,
         expand: nil,
         limit: nil,
@@ -26,6 +29,7 @@ module Stripe
         starting_after: nil
       )
         @alert_type = alert_type
+        @customer = customer
         @ending_before = ending_before
         @expand = expand
         @limit = limit

data/lib/stripe/params/billing/analytics/meter_usage_retrieve_params.rb

@@ -14,17 +14,21 @@ module Stripe
           attr_accessor :meter
           # Key-value pairs used to filter usage events by high cardinality tenant dimension values. Each value is an array that can include multiple values for the key. If specified, usage is filtered for matching usage events.
           attr_accessor :tenant_filters
+          # List of high cardinality tenant dimension keys to group by. If specified, usage events will be grouped by the given tenant dimension key's values.
+          attr_accessor :tenant_group_by_keys
 
           def initialize(
             dimension_filters: nil,
             dimension_group_by_keys: nil,
             meter: nil,
-            tenant_filters: nil
+            tenant_filters: nil,
+            tenant_group_by_keys: nil
           )
             @dimension_filters = dimension_filters
             @dimension_group_by_keys = dimension_group_by_keys
             @meter = meter
             @tenant_filters = tenant_filters
+            @tenant_group_by_keys = tenant_group_by_keys
           end
         end
         # The customer id to fetch meter usage data for.

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

@@ -6,6 +6,15 @@ module Stripe
     class CreditBalanceSummaryRetrieveParams < ::Stripe::RequestParams
       class Filter < ::Stripe::RequestParams
         class ApplicabilityScope < ::Stripe::RequestParams
+          class BillableItem < ::Stripe::RequestParams
+            # The billable item ID this credit grant should apply to.
+            attr_accessor :id
+
+            def initialize(id: nil)
+              @id = id
+            end
+          end
+
           class Price < ::Stripe::RequestParams
             # The price ID this credit grant should apply to.
             attr_accessor :id
@@ -14,12 +23,15 @@ module Stripe
               @id = id
             end
           end
+          # A list of billable items that the credit grant can apply to. We currently only support metered billable items. Cannot be used in combination with `price_type` or `prices`.
+          attr_accessor :billable_items
           # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
           attr_accessor :price_type
           # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
           attr_accessor :prices
 
-          def initialize(price_type: nil, prices: nil)
+          def initialize(billable_items: nil, price_type: nil, prices: nil)
+            @billable_items = billable_items
             @price_type = price_type
             @prices = prices
           end
@@ -37,9 +49,9 @@ module Stripe
           @type = type
         end
       end
-      # The customer for which to fetch credit balance summary.
+      # The customer whose credit balance summary you're retrieving.
       attr_accessor :customer
-      # The account for which to fetch credit balance summary.
+      # The account representing the customer whose credit balance summary you're retrieving.
       attr_accessor :customer_account
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand

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

@@ -6,9 +6,9 @@ module Stripe
     class CreditBalanceTransactionListParams < ::Stripe::RequestParams
       # The credit grant for which to fetch credit balance transactions.
       attr_accessor :credit_grant
-      # The customer for which to fetch credit balance transactions.
+      # The customer whose credit balance transactions you're retrieving.
       attr_accessor :customer
-      # The account for which to fetch credit balance transactions.
+      # The account representing the customer whose credit balance transactions you're retrieving.
       attr_accessor :customer_account
       # 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

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

@@ -5,6 +5,18 @@ module Stripe
   module Billing
     class CreditGrantCreateParams < ::Stripe::RequestParams
       class Amount < ::Stripe::RequestParams
+        class CustomPricingUnit < ::Stripe::RequestParams
+          # The ID of the custom pricing unit.
+          attr_accessor :id
+          # A positive integer representing the amount of the credit grant.
+          attr_accessor :value
+
+          def initialize(id: nil, value: nil)
+            @id = id
+            @value = value
+          end
+        end
+
         class Monetary < ::Stripe::RequestParams
           # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the `value` parameter.
           attr_accessor :currency
@@ -16,12 +28,15 @@ module Stripe
             @value = value
           end
         end
+        # The custom pricing unit amount.
+        attr_accessor :custom_pricing_unit
         # The monetary amount.
         attr_accessor :monetary
         # The type of this amount. We currently only support `monetary` billing credits.
         attr_accessor :type
 
-        def initialize(monetary: nil, type: nil)
+        def initialize(custom_pricing_unit: nil, monetary: nil, type: nil)
+          @custom_pricing_unit = custom_pricing_unit
           @monetary = monetary
           @type = type
         end
@@ -29,6 +44,15 @@ module Stripe
 
       class ApplicabilityConfig < ::Stripe::RequestParams
         class Scope < ::Stripe::RequestParams
+          class BillableItem < ::Stripe::RequestParams
+            # The billable item ID this credit grant should apply to.
+            attr_accessor :id
+
+            def initialize(id: nil)
+              @id = id
+            end
+          end
+
           class Price < ::Stripe::RequestParams
             # The price ID this credit grant should apply to.
             attr_accessor :id
@@ -37,12 +61,15 @@ module Stripe
               @id = id
             end
           end
+          # A list of billable items that the credit grant can apply to. We currently only support metered billable items. Cannot be used in combination with `price_type` or `prices`.
+          attr_accessor :billable_items
           # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
           attr_accessor :price_type
           # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
           attr_accessor :prices
 
-          def initialize(price_type: nil, prices: nil)
+          def initialize(billable_items: nil, price_type: nil, prices: nil)
+            @billable_items = billable_items
             @price_type = price_type
             @prices = prices
           end
@@ -60,9 +87,9 @@ module Stripe
       attr_accessor :applicability_config
       # The category of this credit grant. It defaults to `paid` if not specified.
       attr_accessor :category
-      # ID of the customer to receive the billing credits.
+      # ID of the customer receiving the billing credits.
       attr_accessor :customer
-      # ID of the account to receive the billing credits.
+      # ID of the account representing the customer receiving the billing credits.
       attr_accessor :customer_account
       # The time when the billing credits become effective-when they're eligible for use. It defaults to the current timestamp if not specified.
       attr_accessor :effective_at

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

@@ -6,7 +6,7 @@ module Stripe
     class CreditGrantListParams < ::Stripe::RequestParams
       # Only return credit grants for this customer.
       attr_accessor :customer
-      # Only return credit grants for this account.
+      # Only return credit grants for this account representing the customer.
       attr_accessor :customer_account
       # 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

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

@@ -37,6 +37,8 @@ module Stripe
       attr_accessor :customer_mapping
       # The default settings to aggregate a meter's events with.
       attr_accessor :default_aggregation
+      # Set of keys that will be used to group meter events by. Each key must be present in the event payload.
+      attr_accessor :dimension_payload_keys
       # 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.
@@ -51,6 +53,7 @@ module Stripe
       def initialize(
         customer_mapping: nil,
         default_aggregation: nil,
+        dimension_payload_keys: nil,
         display_name: nil,
         event_name: nil,
         event_time_window: nil,
@@ -59,6 +62,7 @@ module Stripe
       )
         @customer_mapping = customer_mapping
         @default_aggregation = default_aggregation
+        @dimension_payload_keys = dimension_payload_keys
         @display_name = display_name
         @event_name = event_name
         @event_time_window = event_time_window

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

@@ -10,7 +10,7 @@ module Stripe
       attr_accessor :expand
       # A unique identifier for the event. If not provided, one is generated. We recommend using UUID-like identifiers. We will enforce uniqueness within a rolling period of at least 24 hours. The enforcement of uniqueness primarily addresses issues arising from accidental retries or other problems occurring within extremely brief time intervals. This approach helps prevent duplicate entries and ensures data integrity in high-frequency operations.
       attr_accessor :identifier
-      # The payload of the event. This must contain the fields corresponding to a meter's `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage#payload-key-overrides).
+      # The payload of the event. This must contain the fields corresponding to a meter's `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure#meter-configuration-attributes).
       attr_accessor :payload
       # The time of the event. Measured in seconds since the Unix epoch. Must be within the past 35 calendar days or up to 5 minutes in the future. Defaults to current timestamp if not specified.
       attr_accessor :timestamp

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

@@ -6,6 +6,10 @@ module Stripe
     class MeterEventSummaryListParams < ::Stripe::RequestParams
       # The customer for which to fetch event summaries.
       attr_accessor :customer
+      # Key-value pairs used to filter meter events by dimension values. If specified, event summaries will be generated with only matching meter events.
+      attr_accessor :dimension_filters
+      # List of dimension payload keys to group by. If specified, event summaries will be grouped by the given dimension payload key values.
+      attr_accessor :dimension_group_by_keys
       # 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.
@@ -23,6 +27,8 @@ module Stripe
 
       def initialize(
         customer: nil,
+        dimension_filters: nil,
+        dimension_group_by_keys: nil,
         end_time: nil,
         ending_before: nil,
         expand: nil,
@@ -32,6 +38,8 @@ module Stripe
         value_grouping_window: nil
       )
         @customer = customer
+        @dimension_filters = dimension_filters
+        @dimension_group_by_keys = dimension_group_by_keys
         @end_time = end_time
         @ending_before = ending_before
         @expand = expand

data/lib/stripe/params/billing_portal/configuration_create_params.rb

@@ -128,6 +128,8 @@ module Stripe
               @conditions = conditions
             end
           end
+          # Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
+          attr_accessor :billing_cycle_anchor
           # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
           attr_accessor :default_allowed_updates
           # Whether the feature is enabled.
@@ -142,6 +144,7 @@ module Stripe
           attr_accessor :trial_update_behavior
 
           def initialize(
+            billing_cycle_anchor: nil,
             default_allowed_updates: nil,
             enabled: nil,
             products: nil,
@@ -149,6 +152,7 @@ module Stripe
             schedule_at_period_end: nil,
             trial_update_behavior: nil
           )
+            @billing_cycle_anchor = billing_cycle_anchor
             @default_allowed_updates = default_allowed_updates
             @enabled = enabled
             @products = products
@@ -184,7 +188,7 @@ module Stripe
       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 `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/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)
@@ -193,7 +197,7 @@ module Stripe
       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.
+      # 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://docs.stripe.com/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
@@ -201,7 +205,7 @@ module Stripe
       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`.
+      # 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. 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
       # The name of the configuration.
       attr_accessor :name

data/lib/stripe/params/billing_portal/configuration_update_params.rb

@@ -128,6 +128,8 @@ module Stripe
               @conditions = conditions
             end
           end
+          # Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
+          attr_accessor :billing_cycle_anchor
           # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
           attr_accessor :default_allowed_updates
           # Whether the feature is enabled.
@@ -142,6 +144,7 @@ module Stripe
           attr_accessor :trial_update_behavior
 
           def initialize(
+            billing_cycle_anchor: nil,
             default_allowed_updates: nil,
             enabled: nil,
             products: nil,
@@ -149,6 +152,7 @@ module Stripe
             schedule_at_period_end: nil,
             trial_update_behavior: nil
           )
+            @billing_cycle_anchor = billing_cycle_anchor
             @default_allowed_updates = default_allowed_updates
             @enabled = enabled
             @products = products
@@ -184,7 +188,7 @@ module Stripe
       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 `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/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
@@ -197,7 +201,7 @@ module Stripe
       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.
+      # 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://docs.stripe.com/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
@@ -205,7 +209,7 @@ module Stripe
       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`.
+      # 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. 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
       # The name of the configuration.
       attr_accessor :name

data/lib/stripe/params/billing_portal/session_create_params.rb

@@ -91,11 +91,11 @@ module Stripe
           end
 
           class Item < ::Stripe::RequestParams
-            # The ID of the [subscription item](https://stripe.com/docs/api/subscriptions/object#subscription_object-items-data-id) to be updated.
+            # The ID of the [subscription item](https://docs.stripe.com/api/subscriptions/object#subscription_object-items-data-id) to be updated.
             attr_accessor :id
-            # The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products).
+            # The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products).
             attr_accessor :price
-            # [Quantity](https://stripe.com/docs/subscriptions/quantities) for this item that the customer should subscribe to through this flow.
+            # [Quantity](https://docs.stripe.com/subscriptions/quantities) for this item that the customer should subscribe to through this flow.
             attr_accessor :quantity
 
             def initialize(id: nil, price: nil, quantity: nil)
@@ -106,7 +106,7 @@ module Stripe
           end
           # The coupon or promotion code to apply to this subscription update.
           attr_accessor :discounts
-          # The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
+          # The [subscription item](https://docs.stripe.com/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
           attr_accessor :items
           # The ID of the subscription to be updated.
           attr_accessor :subscription
@@ -142,7 +142,7 @@ module Stripe
           @type = type
         end
       end
-      # The ID of an existing [configuration](https://stripe.com/docs/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
+      # The ID of an existing [configuration](https://docs.stripe.com/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
       attr_accessor :configuration
       # The ID of an existing customer.
       attr_accessor :customer
@@ -150,11 +150,11 @@ module Stripe
       attr_accessor :customer_account
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
-      # Information about a specific flow for the customer to go through. See the [docs](https://stripe.com/docs/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows.
+      # Information about a specific flow for the customer to go through. See the [docs](https://docs.stripe.com/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows.
       attr_accessor :flow_data
       # The IETF language tag of the locale customer portal is displayed in. If blank or auto, the customer’s `preferred_locales` or browser’s locale is used.
       attr_accessor :locale
-      # The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
+      # The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://docs.stripe.com/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://docs.stripe.com/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
       attr_accessor :on_behalf_of
       # The default URL to redirect customers to when they click on the portal's link to return to your website.
       attr_accessor :return_url