stripe 13.6.0.pre.beta.1 → 14.0.0

data/rbi/stripe/resources/tax/settings.rbi

@@ -73,46 +73,39 @@ module Stripe
       # Attribute for field status_details
       sig { returns(StatusDetails) }
       attr_reader :status_details
-      class RetrieveParams < Stripe::RequestParams
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
-        attr_accessor :expand
-        sig { params(expand: T::Array[String]).void }
-        def initialize(expand: nil); end
-      end
       class UpdateParams < Stripe::RequestParams
         class Defaults < Stripe::RequestParams
           # Specifies the default [tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#tax-behavior) to be used when the item's price has unspecified tax behavior. One of inclusive, exclusive, or inferred_by_currency. Once specified, it cannot be changed back to null.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :tax_behavior
           # A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :tax_code
-          sig { params(tax_behavior: String, tax_code: String).void }
+          sig { params(tax_behavior: T.nilable(String), tax_code: T.nilable(String)).void }
           def initialize(tax_behavior: nil, tax_code: nil); end
         end
         class HeadOffice < Stripe::RequestParams
           class Address < Stripe::RequestParams
             # City, district, suburb, town, or village.
-            sig { returns(String) }
+            sig { returns(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(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :country
             # Address line 1 (e.g., street, PO Box, or company name).
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :line1
             # Address line 2 (e.g., apartment, suite, unit, or building).
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :line2
             # ZIP or postal code.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :postal_code
             # State/province as an [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) subdivision code, without country prefix. Example: "NY" or "TX".
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :state
             sig {
-              params(city: String, country: String, line1: String, line2: String, postal_code: String, state: String).void
+              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
              }
             def initialize(
               city: nil,
@@ -130,16 +123,16 @@ module Stripe
           def initialize(address: nil); end
         end
         # Default configuration to be used on Stripe Tax calculations.
-        sig { returns(::Stripe::Tax::Settings::UpdateParams::Defaults) }
+        sig { returns(T.nilable(::Stripe::Tax::Settings::UpdateParams::Defaults)) }
         attr_accessor :defaults
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :expand
         # The place where your business is located.
-        sig { returns(::Stripe::Tax::Settings::UpdateParams::HeadOffice) }
+        sig { returns(T.nilable(::Stripe::Tax::Settings::UpdateParams::HeadOffice)) }
         attr_accessor :head_office
         sig {
-          params(defaults: ::Stripe::Tax::Settings::UpdateParams::Defaults, expand: T::Array[String], head_office: ::Stripe::Tax::Settings::UpdateParams::HeadOffice).void
+          params(defaults: T.nilable(::Stripe::Tax::Settings::UpdateParams::Defaults), expand: T.nilable(T::Array[String]), head_office: T.nilable(::Stripe::Tax::Settings::UpdateParams::HeadOffice)).void
          }
         def initialize(defaults: nil, expand: nil, head_office: nil); end
       end

data/rbi/stripe/resources/tax/transaction.rbi

@@ -196,28 +196,21 @@ module Stripe
       # If `reversal`, this transaction reverses an earlier transaction.
       sig { returns(String) }
       attr_reader :type
-      class RetrieveParams < Stripe::RequestParams
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
-        attr_accessor :expand
-        sig { params(expand: T::Array[String]).void }
-        def initialize(expand: nil); end
-      end
       class ListLineItemsParams < 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
@@ -226,19 +219,19 @@ module Stripe
         sig { returns(String) }
         attr_accessor :calculation
         # 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::Hash[String, String]) }
+        sig { returns(T.nilable(T::Hash[String, String])) }
         attr_accessor :metadata
         # The Unix timestamp representing when the tax liability is assumed or reduced, which determines the liability posting period and handling in tax liability reports. The timestamp must fall within the `tax_date` and the current time, unless the `tax_date` is scheduled in advance. Defaults to the current time.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :posted_at
         # A custom order or sale identifier, such as 'myOrder_123'. Must be unique across all transactions, including reversals.
         sig { returns(String) }
         attr_accessor :reference
         sig {
-          params(calculation: String, expand: T::Array[String], metadata: T::Hash[String, String], posted_at: Integer, reference: String).void
+          params(calculation: String, expand: T.nilable(T::Array[String]), metadata: T.nilable(T::Hash[String, String]), posted_at: T.nilable(Integer), reference: String).void
          }
         def initialize(
           calculation: nil,
@@ -257,19 +250,19 @@ module Stripe
           sig { returns(Integer) }
           attr_accessor :amount_tax
           # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
-          sig { returns(T::Hash[String, String]) }
+          sig { returns(T.nilable(T::Hash[String, String])) }
           attr_accessor :metadata
           # The `id` of the line item to reverse in the original transaction.
           sig { returns(String) }
           attr_accessor :original_line_item
           # The quantity reversed. Appears in [tax exports](https://stripe.com/docs/tax/reports), but does not affect the amount of tax reversed.
-          sig { returns(Integer) }
+          sig { returns(T.nilable(Integer)) }
           attr_accessor :quantity
           # A custom identifier for this line item in the reversal transaction, such as 'L1-refund'.
           sig { returns(String) }
           attr_accessor :reference
           sig {
-            params(amount: Integer, amount_tax: Integer, metadata: T::Hash[String, String], original_line_item: String, quantity: Integer, reference: String).void
+            params(amount: Integer, amount_tax: Integer, metadata: T.nilable(T::Hash[String, String]), original_line_item: String, quantity: T.nilable(Integer), reference: String).void
            }
           def initialize(
             amount: nil,
@@ -291,16 +284,18 @@ module Stripe
           def initialize(amount: nil, amount_tax: nil); end
         end
         # 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 flat amount to reverse across the entire transaction, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. This value represents the total amount to refund from the transaction, including taxes.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :flat_amount
         # The line item amounts to reverse.
-        sig { returns(T::Array[::Stripe::Tax::Transaction::CreateReversalParams::LineItem]) }
+        sig {
+          returns(T.nilable(T::Array[::Stripe::Tax::Transaction::CreateReversalParams::LineItem]))
+         }
         attr_accessor :line_items
         # 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
         # If `partial`, the provided line item or shipping cost amounts are reversed. If `full`, the original transaction is fully reversed.
         sig { returns(String) }
@@ -312,10 +307,10 @@ module Stripe
         sig { returns(String) }
         attr_accessor :reference
         # The shipping cost to reverse.
-        sig { returns(::Stripe::Tax::Transaction::CreateReversalParams::ShippingCost) }
+        sig { returns(T.nilable(::Stripe::Tax::Transaction::CreateReversalParams::ShippingCost)) }
         attr_accessor :shipping_cost
         sig {
-          params(expand: T::Array[String], flat_amount: Integer, line_items: T::Array[::Stripe::Tax::Transaction::CreateReversalParams::LineItem], metadata: T::Hash[String, String], mode: String, original_transaction: String, reference: String, shipping_cost: ::Stripe::Tax::Transaction::CreateReversalParams::ShippingCost).void
+          params(expand: T.nilable(T::Array[String]), flat_amount: T.nilable(Integer), line_items: T.nilable(T::Array[::Stripe::Tax::Transaction::CreateReversalParams::LineItem]), metadata: T.nilable(T::Hash[String, String]), mode: String, original_transaction: String, reference: String, shipping_cost: T.nilable(::Stripe::Tax::Transaction::CreateReversalParams::ShippingCost)).void
          }
         def initialize(
           expand: nil,

data/rbi/stripe/resources/tax_code.rbi

@@ -19,29 +19,22 @@ module Stripe
     attr_reader :object
     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 RetrieveParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
-      attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
-      def initialize(expand: nil); end
-    end
     # A list of [all tax codes available](https://stripe.com/docs/tax/tax-categories) to add to Products in order to allow specific tax calculations.
     sig {
       params(params: T.any(::Stripe::TaxCode::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)

data/rbi/stripe/resources/tax_id.rbi

@@ -68,45 +68,38 @@ module Stripe
     attr_reader :deleted
     class DeleteParams < Stripe::RequestParams
 
-    end
-    class RetrieveParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
-      attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
-      def initialize(expand: nil); end
     end
     class ListParams < Stripe::RequestParams
       class Owner < Stripe::RequestParams
         # Account the tax ID belongs to. Required when `type=account`
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :account
         # Customer the tax ID belongs to. Required when `type=customer`
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer
         # Type of owner referenced.
         sig { returns(String) }
         attr_accessor :type
-        sig { params(account: String, customer: String, type: String).void }
+        sig { params(account: T.nilable(String), customer: T.nilable(String), type: String).void }
         def initialize(account: nil, customer: nil, type: nil); end
       end
       # 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
       # The account or customer the tax ID belongs to. Defaults to `owner[type]=self`.
-      sig { returns(::Stripe::TaxId::ListParams::Owner) }
+      sig { returns(T.nilable(::Stripe::TaxId::ListParams::Owner)) }
       attr_accessor :owner
       # 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, owner: ::Stripe::TaxId::ListParams::Owner, starting_after: String).void
+        params(ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), owner: T.nilable(::Stripe::TaxId::ListParams::Owner), starting_after: T.nilable(String)).void
        }
       def initialize(
         ending_before: nil,
@@ -119,22 +112,22 @@ module Stripe
     class CreateParams < Stripe::RequestParams
       class Owner < Stripe::RequestParams
         # Account the tax ID belongs to. Required when `type=account`
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :account
         # Customer the tax ID belongs to. Required when `type=customer`
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :customer
         # Type of owner referenced.
         sig { returns(String) }
         attr_accessor :type
-        sig { params(account: String, customer: String, type: String).void }
+        sig { params(account: T.nilable(String), customer: T.nilable(String), type: String).void }
         def initialize(account: nil, customer: nil, type: nil); end
       end
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # The account or customer the tax ID belongs to. Defaults to `owner[type]=self`.
-      sig { returns(::Stripe::TaxId::CreateParams::Owner) }
+      sig { returns(T.nilable(::Stripe::TaxId::CreateParams::Owner)) }
       attr_accessor :owner
       # 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) }
@@ -143,7 +136,7 @@ module Stripe
       sig { returns(String) }
       attr_accessor :value
       sig {
-        params(expand: T::Array[String], owner: ::Stripe::TaxId::CreateParams::Owner, type: String, value: String).void
+        params(expand: T.nilable(T::Array[String]), owner: T.nilable(::Stripe::TaxId::CreateParams::Owner), type: String, value: String).void
        }
       def initialize(expand: nil, owner: nil, type: nil, value: nil); end
     end

data/rbi/stripe/resources/tax_rate.rbi

@@ -74,43 +74,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
       # Optional flag to filter by tax rates that are either active or inactive (archived).
-      sig { returns(T::Boolean) }
+      sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :active
       # Optional range for filtering created date.
-      sig { returns(T.any(::Stripe::TaxRate::ListParams::Created, Integer)) }
+      sig { returns(T.nilable(T.any(::Stripe::TaxRate::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
       # Optional flag to filter by tax rates that are inclusive (or those that are not inclusive).
-      sig { returns(T::Boolean) }
+      sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :inclusive
       # 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, created: T.any(::Stripe::TaxRate::ListParams::Created, Integer), ending_before: String, expand: T::Array[String], inclusive: T::Boolean, limit: Integer, starting_after: String).void
+        params(active: T.nilable(T::Boolean), created: T.nilable(T.any(::Stripe::TaxRate::ListParams::Created, Integer)), ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), inclusive: T.nilable(T::Boolean), limit: T.nilable(Integer), starting_after: T.nilable(String)).void
        }
       def initialize(
         active: nil,
@@ -124,40 +126,40 @@ module Stripe
     end
     class CreateParams < Stripe::RequestParams
       # Flag determining whether the tax rate is active or inactive (archived). Inactive tax rates cannot be used with new applications or Checkout Sessions, but will still work for subscriptions and invoices that already have it set.
-      sig { returns(T::Boolean) }
+      sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :active
       # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :country
       # An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :description
       # The display name of the tax rate, which will be shown to users.
       sig { returns(String) }
       attr_accessor :display_name
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # This specifies if the tax rate is inclusive or exclusive.
       sig { returns(T::Boolean) }
       attr_accessor :inclusive
       # The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer’s invoice.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :jurisdiction
       # 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
       # This represents the tax rate percent out of 100.
       sig { returns(Float) }
       attr_accessor :percentage
       # [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2), without country prefix. For example, "NY" for New York, United States.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :state
       # The high-level tax type, such as `vat` or `sales_tax`.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :tax_type
       sig {
-        params(active: T::Boolean, country: String, description: String, display_name: String, expand: T::Array[String], inclusive: T::Boolean, jurisdiction: String, metadata: T::Hash[String, String], percentage: Float, state: String, tax_type: String).void
+        params(active: T.nilable(T::Boolean), country: T.nilable(String), description: T.nilable(String), display_name: String, expand: T.nilable(T::Array[String]), inclusive: T::Boolean, jurisdiction: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), percentage: Float, state: T.nilable(String), tax_type: T.nilable(String)).void
        }
       def initialize(
         active: nil,
@@ -173,43 +175,36 @@ module Stripe
         tax_type: nil
       ); end
     end
-    class RetrieveParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
-      attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
-      def initialize(expand: nil); end
-    end
     class UpdateParams < Stripe::RequestParams
       # Flag determining whether the tax rate is active or inactive (archived). Inactive tax rates cannot be used with new applications or Checkout Sessions, but will still work for subscriptions and invoices that already have it set.
-      sig { returns(T::Boolean) }
+      sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :active
       # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :country
       # An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :description
       # The display name of the tax rate, which will be shown to users.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :display_name
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer’s invoice.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :jurisdiction
       # 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
       # [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2), without country prefix. For example, "NY" for New York, United States.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :state
       # The high-level tax type, such as `vat` or `sales_tax`.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :tax_type
       sig {
-        params(active: T::Boolean, country: String, description: String, display_name: String, expand: T::Array[String], jurisdiction: String, metadata: T.nilable(T::Hash[String, String]), state: String, tax_type: String).void
+        params(active: T.nilable(T::Boolean), country: T.nilable(String), description: T.nilable(String), display_name: T.nilable(String), expand: T.nilable(T::Array[String]), jurisdiction: T.nilable(String), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String]))), state: T.nilable(String), tax_type: T.nilable(String)).void
        }
       def initialize(
         active: nil,