stripe 13.6.0.pre.beta.1 → 14.0.0

data/rbi/stripe/services/customer_session_service.rbi

@@ -18,31 +18,31 @@ module Stripe
             # A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the Payment Element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
             #
             # If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
-            sig { returns(T::Array[String]) }
+            sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :payment_method_allow_redisplay_filters
             # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :payment_method_redisplay
             # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :payment_method_redisplay_limit
             # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
             #
             # Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :payment_method_remove
             # Controls whether the Payment Element displays a checkbox offering to save a new payment method. This parameter defaults to `disabled`.
             #
             # If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :payment_method_save
             # When using PaymentIntents and the customer checks the save checkbox, this field determines the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value used to confirm the PaymentIntent.
             #
             # When using SetupIntents, directly configure the [`usage`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-usage) value on SetupIntent creation.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :payment_method_save_usage
             sig {
-              params(payment_method_allow_redisplay_filters: T::Array[String], payment_method_redisplay: String, payment_method_redisplay_limit: Integer, payment_method_remove: String, payment_method_save: String, payment_method_save_usage: String).void
+              params(payment_method_allow_redisplay_filters: T.nilable(T::Array[String]), payment_method_redisplay: T.nilable(String), payment_method_redisplay_limit: T.nilable(Integer), payment_method_remove: T.nilable(String), payment_method_save: T.nilable(String), payment_method_save_usage: T.nilable(String)).void
              }
             def initialize(
               payment_method_allow_redisplay_filters: nil,
@@ -58,11 +58,11 @@ module Stripe
           attr_accessor :enabled
           # This hash defines whether the Payment Element supports certain features.
           sig {
-            returns(::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement::Features)
+            returns(T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement::Features))
            }
           attr_accessor :features
           sig {
-            params(enabled: T::Boolean, features: ::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement::Features).void
+            params(enabled: T::Boolean, features: T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement::Features)).void
            }
           def initialize(enabled: nil, features: nil); end
         end
@@ -74,16 +74,22 @@ module Stripe
           def initialize(enabled: nil); end
         end
         # Configuration for buy button.
-        sig { returns(::Stripe::CustomerSessionService::CreateParams::Components::BuyButton) }
+        sig {
+          returns(T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::BuyButton))
+         }
         attr_accessor :buy_button
         # Configuration for the Payment Element.
-        sig { returns(::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement) }
+        sig {
+          returns(T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement))
+         }
         attr_accessor :payment_element
         # Configuration for the pricing table.
-        sig { returns(::Stripe::CustomerSessionService::CreateParams::Components::PricingTable) }
+        sig {
+          returns(T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::PricingTable))
+         }
         attr_accessor :pricing_table
         sig {
-          params(buy_button: ::Stripe::CustomerSessionService::CreateParams::Components::BuyButton, payment_element: ::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement, pricing_table: ::Stripe::CustomerSessionService::CreateParams::Components::PricingTable).void
+          params(buy_button: T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::BuyButton), payment_element: T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::PaymentElement), pricing_table: T.nilable(::Stripe::CustomerSessionService::CreateParams::Components::PricingTable)).void
          }
         def initialize(buy_button: nil, payment_element: nil, pricing_table: nil); end
       end
@@ -94,10 +100,10 @@ module Stripe
       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
       sig {
-        params(components: ::Stripe::CustomerSessionService::CreateParams::Components, customer: String, expand: T::Array[String]).void
+        params(components: ::Stripe::CustomerSessionService::CreateParams::Components, customer: String, expand: T.nilable(T::Array[String])).void
        }
       def initialize(components: nil, customer: nil, expand: nil); end
     end

data/rbi/stripe/services/customer_tax_id_service.rbi

@@ -9,32 +9,32 @@ 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 ListParams < Stripe::RequestParams
       # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
-      sig { returns(String) }
+      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
       # 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(ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+        params(ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), starting_after: T.nilable(String)).void
        }
       def initialize(ending_before: nil, expand: nil, limit: nil, starting_after: nil); end
     end
     class CreateParams < 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
       # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `ba_tin`, `bb_tin`, `bg_uic`, `bh_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cn_tin`, `co_nit`, `cr_tin`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kh_tin`, `kr_brn`, `kz_bin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
       sig { returns(String) }
@@ -42,7 +42,7 @@ module Stripe
       # Value of the tax ID.
       sig { returns(String) }
       attr_accessor :value
-      sig { params(expand: T::Array[String], type: String, value: String).void }
+      sig { params(expand: T.nilable(T::Array[String]), type: String, value: String).void }
       def initialize(expand: nil, type: nil, value: nil); end
     end
     # Creates a new tax_id object for a customer.

data/rbi/stripe/services/dispute_service.rbi

@@ -7,43 +7,45 @@ module Stripe
     class ListParams < Stripe::RequestParams
       class Created < Stripe::RequestParams
         # Minimum value to filter by (exclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :gt
         # Minimum value to filter by (inclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :gte
         # Maximum value to filter by (exclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :lt
         # Maximum value to filter by (inclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :lte
-        sig { params(gt: Integer, gte: Integer, lt: Integer, lte: Integer).void }
+        sig {
+          params(gt: T.nilable(Integer), gte: T.nilable(Integer), lt: T.nilable(Integer), lte: T.nilable(Integer)).void
+         }
         def initialize(gt: nil, gte: nil, lt: nil, lte: nil); end
       end
       # Only return disputes associated to the charge specified by this charge ID.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :charge
       # Only return disputes that were created during the given date interval.
-      sig { returns(T.any(::Stripe::DisputeService::ListParams::Created, Integer)) }
+      sig { returns(T.nilable(T.any(::Stripe::DisputeService::ListParams::Created, Integer))) }
       attr_accessor :created
       # 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
       # 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
       # Only return disputes associated to the PaymentIntent specified by this PaymentIntent ID.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :payment_intent
       # 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(charge: String, created: T.any(::Stripe::DisputeService::ListParams::Created, Integer), ending_before: String, expand: T::Array[String], limit: Integer, payment_intent: String, starting_after: String).void
+        params(charge: T.nilable(String), created: T.nilable(T.any(::Stripe::DisputeService::ListParams::Created, Integer)), ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), payment_intent: T.nilable(String), starting_after: T.nilable(String)).void
        }
       def initialize(
         charge: nil,
@@ -57,9 +59,9 @@ 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
@@ -69,25 +71,25 @@ module Stripe
             class DisputedTransaction < Stripe::RequestParams
               class ShippingAddress < Stripe::RequestParams
                 # City, district, suburb, town, or village.
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :city
                 # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :country
                 # Address line 1 (e.g., street, PO Box, or company name).
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :line1
                 # Address line 2 (e.g., apartment, suite, unit, or building).
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :line2
                 # ZIP or postal code.
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :postal_code
                 # State, county, province, or region.
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :state
                 sig {
-                  params(city: T.nilable(String), country: T.nilable(String), line1: T.nilable(String), line2: T.nilable(String), postal_code: T.nilable(String), state: T.nilable(String)).void
+                  params(city: T.nilable(T.nilable(String)), country: T.nilable(T.nilable(String)), line1: T.nilable(T.nilable(String)), line2: T.nilable(T.nilable(String)), postal_code: T.nilable(T.nilable(String)), state: T.nilable(T.nilable(String))).void
                  }
                 def initialize(
                   city: nil,
@@ -99,33 +101,33 @@ module Stripe
                 ); end
               end
               # User Account ID used to log into business platform. Must be recognizable by the user.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_account_id
               # Unique identifier of the cardholder’s device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_device_fingerprint
               # Unique identifier of the cardholder’s device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_device_id
               # The email address of the customer.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_email_address
               # The IP address that the customer used when making the purchase.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_purchase_ip
               # Categorization of disputed payment.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :merchandise_or_services
               # A description of the product or service that was sold.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :product_description
               # The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
               sig {
-                returns(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction::ShippingAddress)
+                returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction::ShippingAddress))
                }
               attr_accessor :shipping_address
               sig {
-                params(customer_account_id: T.nilable(String), customer_device_fingerprint: T.nilable(String), customer_device_id: T.nilable(String), customer_email_address: T.nilable(String), customer_purchase_ip: T.nilable(String), merchandise_or_services: String, product_description: T.nilable(String), shipping_address: ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction::ShippingAddress).void
+                params(customer_account_id: T.nilable(T.nilable(String)), customer_device_fingerprint: T.nilable(T.nilable(String)), customer_device_id: T.nilable(T.nilable(String)), customer_email_address: T.nilable(T.nilable(String)), customer_purchase_ip: T.nilable(T.nilable(String)), merchandise_or_services: T.nilable(String), product_description: T.nilable(T.nilable(String)), shipping_address: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction::ShippingAddress)).void
                }
               def initialize(
                 customer_account_id: nil,
@@ -141,25 +143,25 @@ module Stripe
             class PriorUndisputedTransaction < Stripe::RequestParams
               class ShippingAddress < Stripe::RequestParams
                 # City, district, suburb, town, or village.
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :city
                 # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :country
                 # Address line 1 (e.g., street, PO Box, or company name).
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :line1
                 # Address line 2 (e.g., apartment, suite, unit, or building).
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :line2
                 # ZIP or postal code.
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :postal_code
                 # State, county, province, or region.
-                sig { returns(T.nilable(String)) }
+                sig { returns(T.nilable(T.nilable(String))) }
                 attr_accessor :state
                 sig {
-                  params(city: T.nilable(String), country: T.nilable(String), line1: T.nilable(String), line2: T.nilable(String), postal_code: T.nilable(String), state: T.nilable(String)).void
+                  params(city: T.nilable(T.nilable(String)), country: T.nilable(T.nilable(String)), line1: T.nilable(T.nilable(String)), line2: T.nilable(T.nilable(String)), postal_code: T.nilable(T.nilable(String)), state: T.nilable(T.nilable(String))).void
                  }
                 def initialize(
                   city: nil,
@@ -174,30 +176,30 @@ module Stripe
               sig { returns(String) }
               attr_accessor :charge
               # User Account ID used to log into business platform. Must be recognizable by the user.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_account_id
               # Unique identifier of the cardholder’s device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_device_fingerprint
               # Unique identifier of the cardholder’s device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_device_id
               # The email address of the customer.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_email_address
               # The IP address that the customer used when making the purchase.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :customer_purchase_ip
               # A description of the product or service that was sold.
-              sig { returns(T.nilable(String)) }
+              sig { returns(T.nilable(T.nilable(String))) }
               attr_accessor :product_description
               # The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
               sig {
-                returns(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction::ShippingAddress)
+                returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction::ShippingAddress))
                }
               attr_accessor :shipping_address
               sig {
-                params(charge: String, customer_account_id: T.nilable(String), customer_device_fingerprint: T.nilable(String), customer_device_id: T.nilable(String), customer_email_address: T.nilable(String), customer_purchase_ip: T.nilable(String), product_description: T.nilable(String), shipping_address: ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction::ShippingAddress).void
+                params(charge: String, customer_account_id: T.nilable(T.nilable(String)), customer_device_fingerprint: T.nilable(T.nilable(String)), customer_device_id: T.nilable(T.nilable(String)), customer_email_address: T.nilable(T.nilable(String)), customer_purchase_ip: T.nilable(T.nilable(String)), product_description: T.nilable(T.nilable(String)), shipping_address: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction::ShippingAddress)).void
                }
               def initialize(
                 charge: nil,
@@ -212,129 +214,129 @@ module Stripe
             end
             # Disputed transaction details for Visa Compelling Evidence 3.0 evidence submission.
             sig {
-              returns(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction)
+              returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction))
              }
             attr_accessor :disputed_transaction
             # List of exactly two prior undisputed transaction objects for Visa Compelling Evidence 3.0 evidence submission.
             sig {
-              returns(T::Array[::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction])
+              returns(T.nilable(T::Array[::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction]))
              }
             attr_accessor :prior_undisputed_transactions
             sig {
-              params(disputed_transaction: ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction, prior_undisputed_transactions: T::Array[::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction]).void
+              params(disputed_transaction: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::DisputedTransaction), prior_undisputed_transactions: T.nilable(T::Array[::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3::PriorUndisputedTransaction])).void
              }
             def initialize(disputed_transaction: nil, prior_undisputed_transactions: nil); end
           end
           class VisaCompliance < Stripe::RequestParams
             # A field acknowledging the fee incurred when countering a Visa compliance dispute. If this field is set to true, evidence can be submitted for the compliance dispute. Stripe collects a 500 USD (or local equivalent) amount to cover the network costs associated with resolving compliance disputes. Stripe refunds the 500 USD network fee if you win the dispute.
-            sig { returns(T::Boolean) }
+            sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :fee_acknowledged
-            sig { params(fee_acknowledged: T::Boolean).void }
+            sig { params(fee_acknowledged: T.nilable(T::Boolean)).void }
             def initialize(fee_acknowledged: nil); end
           end
           # Evidence provided for Visa Compelling Evidence 3.0 evidence submission.
           sig {
-            returns(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3)
+            returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3))
            }
           attr_accessor :visa_compelling_evidence_3
           # Evidence provided for Visa compliance evidence submission.
           sig {
-            returns(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompliance)
+            returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompliance))
            }
           attr_accessor :visa_compliance
           sig {
-            params(visa_compelling_evidence_3: ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3, visa_compliance: ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompliance).void
+            params(visa_compelling_evidence_3: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompellingEvidence3), visa_compliance: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence::VisaCompliance)).void
            }
           def initialize(visa_compelling_evidence_3: nil, visa_compliance: nil); end
         end
         # Any server or activity logs showing proof that the customer accessed or downloaded the purchased digital product. This information should include IP addresses, corresponding timestamps, and any detailed recorded activity. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :access_activity_log
         # The billing address provided by the customer.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :billing_address
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Your subscription cancellation policy, as shown to the customer.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cancellation_policy
         # An explanation of how and when the customer was shown your refund policy prior to purchase. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cancellation_policy_disclosure
         # A justification for why the customer's subscription was not canceled. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cancellation_rebuttal
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any communication with the customer that you feel is relevant to your case. Examples include emails proving that the customer received the product or service, or demonstrating their use of or satisfaction with the product or service.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer_communication
         # The email address of the customer.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer_email_address
         # The name of the customer.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer_name
         # The IP address that the customer used when making the purchase.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer_purchase_ip
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) A relevant document or contract showing the customer's signature.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer_signature
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Documentation for the prior charge that can uniquely identify the charge, such as a receipt, shipping label, work order, etc. This document should be paired with a similar document from the disputed payment that proves the two payments are separate.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :duplicate_charge_documentation
         # An explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :duplicate_charge_explanation
         # The Stripe ID for the prior charge which appears to be a duplicate of the disputed charge.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :duplicate_charge_id
         # Additional evidence for qualifying evidence programs.
         sig {
-          returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence))
+          returns(T.nilable(T.nilable(T.any(String, ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence))))
          }
         attr_accessor :enhanced_evidence
         # A description of the product or service that was sold. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :product_description
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any receipt or message sent to the customer notifying them of the charge.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :receipt
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Your refund policy, as shown to the customer.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :refund_policy
         # Documentation demonstrating that the customer was shown your refund policy prior to purchase. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :refund_policy_disclosure
         # A justification for why the customer is not entitled to a refund. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :refund_refusal_explanation
         # The date on which the customer received or began receiving the purchased service, in a clear human-readable format.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :service_date
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Documentation showing proof that a service was provided to the customer. This could include a copy of a signed contract, work order, or other form of written agreement.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :service_documentation
         # The address to which a physical product was shipped. You should try to include as complete address information as possible.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_address
         # The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc. If multiple carriers were used for this purchase, please separate them with commas.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_carrier
         # The date on which a physical product began its route to the shipping address, in a clear human-readable format.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_date
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Documentation showing proof that a product was shipped to the customer at the same address the customer provided to you. This could include a copy of the shipment receipt, shipping label, etc. It should show the customer's full shipping address, if possible.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_documentation
         # The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_tracking_number
         # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any additional evidence or statements.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :uncategorized_file
         # Any additional evidence or statements. Has a maximum character count of 20,000.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :uncategorized_text
         sig {
-          params(access_activity_log: String, billing_address: String, cancellation_policy: String, cancellation_policy_disclosure: String, cancellation_rebuttal: String, customer_communication: String, customer_email_address: String, customer_name: String, customer_purchase_ip: String, customer_signature: String, duplicate_charge_documentation: String, duplicate_charge_explanation: String, duplicate_charge_id: String, enhanced_evidence: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence), product_description: String, receipt: String, refund_policy: String, refund_policy_disclosure: String, refund_refusal_explanation: String, service_date: String, service_documentation: String, shipping_address: String, shipping_carrier: String, shipping_date: String, shipping_documentation: String, shipping_tracking_number: String, uncategorized_file: String, uncategorized_text: String).void
+          params(access_activity_log: T.nilable(String), billing_address: T.nilable(String), cancellation_policy: T.nilable(String), cancellation_policy_disclosure: T.nilable(String), cancellation_rebuttal: T.nilable(String), customer_communication: T.nilable(String), customer_email_address: T.nilable(String), customer_name: T.nilable(String), customer_purchase_ip: T.nilable(String), customer_signature: T.nilable(String), duplicate_charge_documentation: T.nilable(String), duplicate_charge_explanation: T.nilable(String), duplicate_charge_id: T.nilable(String), enhanced_evidence: T.nilable(T.nilable(T.any(String, ::Stripe::DisputeService::UpdateParams::Evidence::EnhancedEvidence))), product_description: T.nilable(String), receipt: T.nilable(String), refund_policy: T.nilable(String), refund_policy_disclosure: T.nilable(String), refund_refusal_explanation: T.nilable(String), service_date: T.nilable(String), service_documentation: T.nilable(String), shipping_address: T.nilable(String), shipping_carrier: T.nilable(String), shipping_date: T.nilable(String), shipping_documentation: T.nilable(String), shipping_tracking_number: T.nilable(String), uncategorized_file: T.nilable(String), uncategorized_text: T.nilable(String)).void
          }
         def initialize(
           access_activity_log: nil,
@@ -368,27 +370,27 @@ module Stripe
         ); end
       end
       # Evidence to upload, to respond to a dispute. Updating any field in the hash will submit all fields in the hash for review. The combined character count of all fields is limited to 150,000.
-      sig { returns(::Stripe::DisputeService::UpdateParams::Evidence) }
+      sig { returns(T.nilable(::Stripe::DisputeService::UpdateParams::Evidence)) }
       attr_accessor :evidence
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # 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
       # Whether to immediately submit evidence to the bank. If `false`, evidence is staged on the dispute. Staged evidence is visible in the API and Dashboard, and can be submitted to the bank by making another request with this attribute set to `true` (the default).
-      sig { returns(T::Boolean) }
+      sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :submit
       sig {
-        params(evidence: ::Stripe::DisputeService::UpdateParams::Evidence, expand: T::Array[String], metadata: T.nilable(T::Hash[String, String]), submit: T::Boolean).void
+        params(evidence: T.nilable(::Stripe::DisputeService::UpdateParams::Evidence), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String]))), submit: T.nilable(T::Boolean)).void
        }
       def initialize(evidence: nil, expand: nil, metadata: nil, submit: nil); end
     end
     class CloseParams < 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
     # Closing the dispute for a charge indicates that you do not have any evidence to submit and are essentially dismissing the dispute, acknowledging it as lost.

data/rbi/stripe/services/entitlements/active_entitlement_service.rbi

@@ -10,19 +10,19 @@ module Stripe
         sig { returns(String) }
         attr_accessor :customer
         # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
-        sig { returns(String) }
+        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
         # 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(customer: String, ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+          params(customer: String, ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), starting_after: T.nilable(String)).void
          }
         def initialize(
           customer: nil,
@@ -34,9 +34,9 @@ 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
       # Retrieve a list of active entitlements for a customer