stripe 13.6.0.pre.beta.1 → 14.0.0

data/rbi/stripe/services/billing_portal/configuration_service.rbi

@@ -7,25 +7,25 @@ module Stripe
     class ConfigurationService < StripeService
       class ListParams < Stripe::RequestParams
         # Only return configurations that are active or inactive (e.g., pass `true` to only list active configurations).
-        sig { returns(T::Boolean) }
+        sig { returns(T.nilable(T::Boolean)) }
         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.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :ending_before
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :expand
         # Only return the default or non-default configurations (e.g., pass `true` to only list the default configuration).
-        sig { returns(T::Boolean) }
+        sig { returns(T.nilable(T::Boolean)) }
         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.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(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) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :starting_after
         sig {
-          params(active: T::Boolean, ending_before: String, expand: T::Array[String], is_default: T::Boolean, limit: Integer, starting_after: String).void
+          params(active: T.nilable(T::Boolean), ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), is_default: T.nilable(T::Boolean), limit: T.nilable(Integer), starting_after: T.nilable(String)).void
          }
         def initialize(
           active: nil,
@@ -39,28 +39,30 @@ module Stripe
       class CreateParams < Stripe::RequestParams
         class BusinessProfile < Stripe::RequestParams
           # The messaging shown to customers in the portal.
-          sig { returns(T.nilable(String)) }
+          sig { returns(T.nilable(T.nilable(String))) }
           attr_accessor :headline
           # A link to the business’s publicly available privacy policy.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :privacy_policy_url
           # A link to the business’s publicly available terms of service.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :terms_of_service_url
           sig {
-            params(headline: T.nilable(String), privacy_policy_url: String, terms_of_service_url: String).void
+            params(headline: T.nilable(T.nilable(String)), privacy_policy_url: T.nilable(String), terms_of_service_url: T.nilable(String)).void
            }
           def initialize(headline: nil, privacy_policy_url: nil, terms_of_service_url: nil); end
         end
         class Features < Stripe::RequestParams
           class CustomerUpdate < Stripe::RequestParams
             # The types of customer updates that are supported. When empty, customers are not updateable.
-            sig { returns(T.nilable(T::Array[String])) }
+            sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
             attr_accessor :allowed_updates
             # Whether the feature is enabled.
             sig { returns(T::Boolean) }
             attr_accessor :enabled
-            sig { params(allowed_updates: T.nilable(T::Array[String]), enabled: T::Boolean).void }
+            sig {
+              params(allowed_updates: T.nilable(T.nilable(T.any(String, T::Array[String]))), enabled: T::Boolean).void
+             }
             def initialize(allowed_updates: nil, enabled: nil); end
           end
           class InvoiceHistory < Stripe::RequestParams
@@ -83,27 +85,29 @@ module Stripe
               sig { returns(T::Boolean) }
               attr_accessor :enabled
               # Which cancellation reasons will be given as options to the customer.
-              sig { returns(T.nilable(T::Array[String])) }
+              sig { returns(T.nilable(T.any(String, T::Array[String]))) }
               attr_accessor :options
-              sig { params(enabled: T::Boolean, options: T.nilable(T::Array[String])).void }
+              sig {
+                params(enabled: T::Boolean, options: T.nilable(T.any(String, T::Array[String]))).void
+               }
               def initialize(enabled: nil, options: nil); end
             end
             # Whether the cancellation reasons will be collected in the portal and which options are exposed to the customer
             sig {
-              returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel::CancellationReason)
+              returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel::CancellationReason))
              }
             attr_accessor :cancellation_reason
             # Whether the feature is enabled.
             sig { returns(T::Boolean) }
             attr_accessor :enabled
             # Whether to cancel subscriptions immediately or at the end of the billing period.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             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.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :proration_behavior
             sig {
-              params(cancellation_reason: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel::CancellationReason, enabled: T::Boolean, mode: String, proration_behavior: String).void
+              params(cancellation_reason: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel::CancellationReason), enabled: T::Boolean, mode: T.nilable(String), proration_behavior: T.nilable(String)).void
              }
             def initialize(
               cancellation_reason: nil,
@@ -133,35 +137,35 @@ module Stripe
               end
               # List of conditions. When any condition is true, the update will be scheduled at the end of the current period.
               sig {
-                returns(T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition])
+                returns(T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition]))
                }
               attr_accessor :conditions
               sig {
-                params(conditions: T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition]).void
+                params(conditions: T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition])).void
                }
               def initialize(conditions: nil); end
             end
             # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
-            sig { returns(T.nilable(T::Array[String])) }
+            sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
             attr_accessor :default_allowed_updates
             # Whether the feature is enabled.
             sig { returns(T::Boolean) }
             attr_accessor :enabled
             # The list of up to 10 products that support subscription updates.
             sig {
-              returns(T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::Product]))
+              returns(T.nilable(T.nilable(T.any(String, T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::Product]))))
              }
             attr_accessor :products
             # Determines how to handle prorations resulting from subscription updates. Valid values are `none`, `create_prorations`, and `always_invoice`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :proration_behavior
             # Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
             sig {
-              returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd)
+              returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd))
              }
             attr_accessor :schedule_at_period_end
             sig {
-              params(default_allowed_updates: T.nilable(T::Array[String]), enabled: T::Boolean, products: T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::Product]), proration_behavior: String, schedule_at_period_end: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd).void
+              params(default_allowed_updates: T.nilable(T.nilable(T.any(String, T::Array[String]))), enabled: T::Boolean, products: T.nilable(T.nilable(T.any(String, T::Array[::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::Product]))), proration_behavior: T.nilable(String), schedule_at_period_end: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd)).void
              }
             def initialize(
               default_allowed_updates: nil,
@@ -173,31 +177,31 @@ module Stripe
           end
           # Information about updating the customer details in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::CustomerUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::CustomerUpdate))
            }
           attr_accessor :customer_update
           # Information about showing the billing history in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::InvoiceHistory)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::InvoiceHistory))
            }
           attr_accessor :invoice_history
           # Information about updating payment methods in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::PaymentMethodUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::PaymentMethodUpdate))
            }
           attr_accessor :payment_method_update
           # Information about canceling subscriptions in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel))
            }
           attr_accessor :subscription_cancel
           # Information about updating subscriptions in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate))
            }
           attr_accessor :subscription_update
           sig {
-            params(customer_update: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::CustomerUpdate, invoice_history: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::InvoiceHistory, payment_method_update: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::PaymentMethodUpdate, subscription_cancel: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel, subscription_update: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate).void
+            params(customer_update: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::CustomerUpdate), invoice_history: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::InvoiceHistory), payment_method_update: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::PaymentMethodUpdate), subscription_cancel: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionCancel), subscription_update: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features::SubscriptionUpdate)).void
            }
           def initialize(
             customer_update: nil,
@@ -216,26 +220,28 @@ module Stripe
         end
         # The business information shown to customers in the portal.
         sig {
-          returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::BusinessProfile)
+          returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::BusinessProfile))
          }
         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.
-        sig { returns(T.nilable(String)) }
+        sig { returns(T.nilable(T.nilable(String))) }
         attr_accessor :default_return_url
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :expand
         # Information about the features available in the portal.
         sig { returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::Features) }
         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).
-        sig { returns(::Stripe::BillingPortal::ConfigurationService::CreateParams::LoginPage) }
+        sig {
+          returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::LoginPage))
+         }
         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`.
-        sig { returns(T::Hash[String, String]) }
+        sig { returns(T.nilable(T::Hash[String, String])) }
         attr_accessor :metadata
         sig {
-          params(business_profile: ::Stripe::BillingPortal::ConfigurationService::CreateParams::BusinessProfile, default_return_url: T.nilable(String), expand: T::Array[String], features: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features, login_page: ::Stripe::BillingPortal::ConfigurationService::CreateParams::LoginPage, metadata: T::Hash[String, String]).void
+          params(business_profile: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::BusinessProfile), default_return_url: T.nilable(T.nilable(String)), expand: T.nilable(T::Array[String]), features: ::Stripe::BillingPortal::ConfigurationService::CreateParams::Features, login_page: T.nilable(::Stripe::BillingPortal::ConfigurationService::CreateParams::LoginPage), metadata: T.nilable(T::Hash[String, String])).void
          }
         def initialize(
           business_profile: nil,
@@ -248,36 +254,38 @@ module Stripe
       end
       class RetrieveParams < Stripe::RequestParams
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :expand
-        sig { params(expand: T::Array[String]).void }
+        sig { params(expand: T.nilable(T::Array[String])).void }
         def initialize(expand: nil); end
       end
       class UpdateParams < Stripe::RequestParams
         class BusinessProfile < Stripe::RequestParams
           # The messaging shown to customers in the portal.
-          sig { returns(T.nilable(String)) }
+          sig { returns(T.nilable(T.nilable(String))) }
           attr_accessor :headline
           # A link to the business’s publicly available privacy policy.
-          sig { returns(T.nilable(String)) }
+          sig { returns(T.nilable(T.nilable(String))) }
           attr_accessor :privacy_policy_url
           # A link to the business’s publicly available terms of service.
-          sig { returns(T.nilable(String)) }
+          sig { returns(T.nilable(T.nilable(String))) }
           attr_accessor :terms_of_service_url
           sig {
-            params(headline: T.nilable(String), privacy_policy_url: T.nilable(String), terms_of_service_url: T.nilable(String)).void
+            params(headline: T.nilable(T.nilable(String)), privacy_policy_url: T.nilable(T.nilable(String)), terms_of_service_url: T.nilable(T.nilable(String))).void
            }
           def initialize(headline: nil, privacy_policy_url: nil, terms_of_service_url: nil); end
         end
         class Features < Stripe::RequestParams
           class CustomerUpdate < Stripe::RequestParams
             # The types of customer updates that are supported. When empty, customers are not updateable.
-            sig { returns(T.nilable(T::Array[String])) }
+            sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
             attr_accessor :allowed_updates
             # Whether the feature is enabled.
-            sig { returns(T::Boolean) }
+            sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :enabled
-            sig { params(allowed_updates: T.nilable(T::Array[String]), enabled: T::Boolean).void }
+            sig {
+              params(allowed_updates: T.nilable(T.nilable(T.any(String, T::Array[String]))), enabled: T.nilable(T::Boolean)).void
+             }
             def initialize(allowed_updates: nil, enabled: nil); end
           end
           class InvoiceHistory < Stripe::RequestParams
@@ -300,27 +308,29 @@ module Stripe
               sig { returns(T::Boolean) }
               attr_accessor :enabled
               # Which cancellation reasons will be given as options to the customer.
-              sig { returns(T.nilable(T::Array[String])) }
+              sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
               attr_accessor :options
-              sig { params(enabled: T::Boolean, options: T.nilable(T::Array[String])).void }
+              sig {
+                params(enabled: T::Boolean, options: T.nilable(T.nilable(T.any(String, T::Array[String])))).void
+               }
               def initialize(enabled: nil, options: nil); end
             end
             # Whether the cancellation reasons will be collected in the portal and which options are exposed to the customer
             sig {
-              returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel::CancellationReason)
+              returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel::CancellationReason))
              }
             attr_accessor :cancellation_reason
             # Whether the feature is enabled.
-            sig { returns(T::Boolean) }
+            sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :enabled
             # Whether to cancel subscriptions immediately or at the end of the billing period.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             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.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :proration_behavior
             sig {
-              params(cancellation_reason: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel::CancellationReason, enabled: T::Boolean, mode: String, proration_behavior: String).void
+              params(cancellation_reason: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel::CancellationReason), enabled: T.nilable(T::Boolean), mode: T.nilable(String), proration_behavior: T.nilable(String)).void
              }
             def initialize(
               cancellation_reason: nil,
@@ -350,35 +360,35 @@ module Stripe
               end
               # List of conditions. When any condition is true, the update will be scheduled at the end of the current period.
               sig {
-                returns(T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition]))
+                returns(T.nilable(T.nilable(T.any(String, T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition]))))
                }
               attr_accessor :conditions
               sig {
-                params(conditions: T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition])).void
+                params(conditions: T.nilable(T.nilable(T.any(String, T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd::Condition])))).void
                }
               def initialize(conditions: nil); end
             end
             # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
-            sig { returns(T.nilable(T::Array[String])) }
+            sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
             attr_accessor :default_allowed_updates
             # Whether the feature is enabled.
-            sig { returns(T::Boolean) }
+            sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :enabled
             # The list of up to 10 products that support subscription updates.
             sig {
-              returns(T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::Product]))
+              returns(T.nilable(T.nilable(T.any(String, T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::Product]))))
              }
             attr_accessor :products
             # Determines how to handle prorations resulting from subscription updates. Valid values are `none`, `create_prorations`, and `always_invoice`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :proration_behavior
             # Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
             sig {
-              returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd)
+              returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd))
              }
             attr_accessor :schedule_at_period_end
             sig {
-              params(default_allowed_updates: T.nilable(T::Array[String]), enabled: T::Boolean, products: T.nilable(T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::Product]), proration_behavior: String, schedule_at_period_end: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd).void
+              params(default_allowed_updates: T.nilable(T.nilable(T.any(String, T::Array[String]))), enabled: T.nilable(T::Boolean), products: T.nilable(T.nilable(T.any(String, T::Array[::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::Product]))), proration_behavior: T.nilable(String), schedule_at_period_end: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate::ScheduleAtPeriodEnd)).void
              }
             def initialize(
               default_allowed_updates: nil,
@@ -390,31 +400,31 @@ module Stripe
           end
           # Information about updating the customer details in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::CustomerUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::CustomerUpdate))
            }
           attr_accessor :customer_update
           # Information about showing the billing history in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::InvoiceHistory)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::InvoiceHistory))
            }
           attr_accessor :invoice_history
           # Information about updating payment methods in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::PaymentMethodUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::PaymentMethodUpdate))
            }
           attr_accessor :payment_method_update
           # Information about canceling subscriptions in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel))
            }
           attr_accessor :subscription_cancel
           # Information about updating subscriptions in the portal.
           sig {
-            returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate))
            }
           attr_accessor :subscription_update
           sig {
-            params(customer_update: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::CustomerUpdate, invoice_history: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::InvoiceHistory, payment_method_update: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::PaymentMethodUpdate, subscription_cancel: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel, subscription_update: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate).void
+            params(customer_update: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::CustomerUpdate), invoice_history: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::InvoiceHistory), payment_method_update: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::PaymentMethodUpdate), subscription_cancel: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionCancel), subscription_update: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features::SubscriptionUpdate)).void
            }
           def initialize(
             customer_update: nil,
@@ -434,30 +444,34 @@ module Stripe
           def initialize(enabled: nil); end
         end
         # Whether the configuration is active and can be used to create portal sessions.
-        sig { returns(T::Boolean) }
+        sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :active
         # The business information shown to customers in the portal.
         sig {
-          returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::BusinessProfile)
+          returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::BusinessProfile))
          }
         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.
-        sig { returns(T.nilable(String)) }
+        sig { returns(T.nilable(T.nilable(String))) }
         attr_accessor :default_return_url
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :expand
         # Information about the features available in the portal.
-        sig { returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features) }
+        sig {
+          returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features))
+         }
         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).
-        sig { returns(::Stripe::BillingPortal::ConfigurationService::UpdateParams::LoginPage) }
+        sig {
+          returns(T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::LoginPage))
+         }
         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`.
-        sig { returns(T.nilable(T::Hash[String, String])) }
+        sig { returns(T.nilable(T.nilable(T.any(String, T::Hash[String, String])))) }
         attr_accessor :metadata
         sig {
-          params(active: T::Boolean, business_profile: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::BusinessProfile, default_return_url: T.nilable(String), expand: T::Array[String], features: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features, login_page: ::Stripe::BillingPortal::ConfigurationService::UpdateParams::LoginPage, metadata: T.nilable(T::Hash[String, String])).void
+          params(active: T.nilable(T::Boolean), business_profile: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::BusinessProfile), default_return_url: T.nilable(T.nilable(String)), expand: T.nilable(T::Array[String]), features: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::Features), login_page: T.nilable(::Stripe::BillingPortal::ConfigurationService::UpdateParams::LoginPage), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String])))).void
          }
         def initialize(
           active: nil,

data/rbi/stripe/services/billing_portal/session_service.rbi

@@ -10,9 +10,9 @@ module Stripe
           class AfterCompletion < Stripe::RequestParams
             class HostedConfirmation < Stripe::RequestParams
               # A custom message to display to the customer after the flow is completed.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :custom_message
-              sig { params(custom_message: String).void }
+              sig { params(custom_message: T.nilable(String)).void }
               def initialize(custom_message: nil); end
             end
             class Redirect < Stripe::RequestParams
@@ -24,19 +24,19 @@ module Stripe
             end
             # Configuration when `after_completion.type=hosted_confirmation`.
             sig {
-              returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::HostedConfirmation)
+              returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::HostedConfirmation))
              }
             attr_accessor :hosted_confirmation
             # Configuration when `after_completion.type=redirect`.
             sig {
-              returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::Redirect)
+              returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::Redirect))
              }
             attr_accessor :redirect
             # The specified behavior after the flow is completed.
             sig { returns(String) }
             attr_accessor :type
             sig {
-              params(hosted_confirmation: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::HostedConfirmation, redirect: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::Redirect, type: String).void
+              params(hosted_confirmation: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::HostedConfirmation), redirect: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion::Redirect), type: String).void
              }
             def initialize(hosted_confirmation: nil, redirect: nil, type: nil); end
           end
@@ -64,14 +64,14 @@ module Stripe
             end
             # Specify a retention strategy to be used in the cancellation flow.
             sig {
-              returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel::Retention)
+              returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel::Retention))
              }
             attr_accessor :retention
             # The ID of the subscription to be canceled.
             sig { returns(String) }
             attr_accessor :subscription
             sig {
-              params(retention: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel::Retention, subscription: String).void
+              params(retention: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel::Retention), subscription: String).void
              }
             def initialize(retention: nil, subscription: nil); end
           end
@@ -85,12 +85,12 @@ module Stripe
           class SubscriptionUpdateConfirm < Stripe::RequestParams
             class Discount < Stripe::RequestParams
               # The ID of the coupon to apply to this subscription update.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :coupon
               # The ID of a promotion code to apply to this subscription update.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :promotion_code
-              sig { params(coupon: String, promotion_code: String).void }
+              sig { params(coupon: T.nilable(String), promotion_code: T.nilable(String)).void }
               def initialize(coupon: nil, promotion_code: nil); end
             end
             class Item < Stripe::RequestParams
@@ -98,17 +98,19 @@ module Stripe
               sig { returns(String) }
               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).
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :price
               # [Quantity](https://stripe.com/docs/subscriptions/quantities) for this item that the customer should subscribe to through this flow.
-              sig { returns(Integer) }
+              sig { returns(T.nilable(Integer)) }
               attr_accessor :quantity
-              sig { params(id: String, price: String, quantity: Integer).void }
+              sig {
+                params(id: String, price: T.nilable(String), quantity: T.nilable(Integer)).void
+               }
               def initialize(id: nil, price: nil, quantity: nil); end
             end
             # The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
             sig {
-              returns(T::Array[::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm::Discount])
+              returns(T.nilable(T::Array[::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm::Discount]))
              }
             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.
@@ -120,35 +122,35 @@ module Stripe
             sig { returns(String) }
             attr_accessor :subscription
             sig {
-              params(discounts: T::Array[::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm::Discount], items: T::Array[::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm::Item], subscription: String).void
+              params(discounts: T.nilable(T::Array[::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm::Discount]), items: T::Array[::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm::Item], subscription: String).void
              }
             def initialize(discounts: nil, items: nil, subscription: nil); end
           end
           # Behavior after the flow is completed.
           sig {
-            returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion)
+            returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion))
            }
           attr_accessor :after_completion
           # Configuration when `flow_data.type=subscription_cancel`.
           sig {
-            returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel)
+            returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel))
            }
           attr_accessor :subscription_cancel
           # Configuration when `flow_data.type=subscription_update`.
           sig {
-            returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdate)
+            returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdate))
            }
           attr_accessor :subscription_update
           # Configuration when `flow_data.type=subscription_update_confirm`.
           sig {
-            returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm)
+            returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm))
            }
           attr_accessor :subscription_update_confirm
           # Type of flow that the customer will go through.
           sig { returns(String) }
           attr_accessor :type
           sig {
-            params(after_completion: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion, subscription_cancel: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel, subscription_update: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdate, subscription_update_confirm: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm, type: String).void
+            params(after_completion: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::AfterCompletion), subscription_cancel: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionCancel), subscription_update: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdate), subscription_update_confirm: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData::SubscriptionUpdateConfirm), type: String).void
            }
           def initialize(
             after_completion: nil,
@@ -159,28 +161,28 @@ module Stripe
           ); 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.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :configuration
         # The ID of an existing customer.
         sig { returns(String) }
         attr_accessor :customer
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         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.
-        sig { returns(::Stripe::BillingPortal::SessionService::CreateParams::FlowData) }
+        sig { returns(T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData)) }
         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.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         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.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         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.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :return_url
         sig {
-          params(configuration: String, customer: String, expand: T::Array[String], flow_data: ::Stripe::BillingPortal::SessionService::CreateParams::FlowData, locale: String, on_behalf_of: String, return_url: String).void
+          params(configuration: T.nilable(String), customer: String, expand: T.nilable(T::Array[String]), flow_data: T.nilable(::Stripe::BillingPortal::SessionService::CreateParams::FlowData), locale: T.nilable(String), on_behalf_of: T.nilable(String), return_url: T.nilable(String)).void
          }
         def initialize(
           configuration: nil,