stripe 13.6.0.pre.beta.1 → 14.0.0

data/rbi/stripe/resources/issuing/card.rbi

@@ -238,58 +238,60 @@ 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 cards belonging to the Cardholder with the provided ID.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cardholder
         # Only return cards that were issued during the given date interval.
-        sig { returns(T.any(::Stripe::Issuing::Card::ListParams::Created, Integer)) }
+        sig { returns(T.nilable(T.any(::Stripe::Issuing::Card::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
         # Only return cards that have the given expiration month.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :exp_month
         # Only return cards that have the given expiration year.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :exp_year
         # 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 cards that have the given last four digits.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :last4
         # 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
         # Attribute for param field personalization_design
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :personalization_design
         # 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
         # Only return cards that have the given status. One of `active`, `inactive`, or `canceled`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :status
         # Only return cards that have the given type. One of `virtual` or `physical`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :type
         sig {
-          params(cardholder: String, created: T.any(::Stripe::Issuing::Card::ListParams::Created, Integer), ending_before: String, exp_month: Integer, exp_year: Integer, expand: T::Array[String], last4: String, limit: Integer, personalization_design: String, starting_after: String, status: String, type: String).void
+          params(cardholder: T.nilable(String), created: T.nilable(T.any(::Stripe::Issuing::Card::ListParams::Created, Integer)), ending_before: T.nilable(String), exp_month: T.nilable(Integer), exp_year: T.nilable(Integer), expand: T.nilable(T::Array[String]), last4: T.nilable(String), limit: T.nilable(Integer), personalization_design: T.nilable(String), starting_after: T.nilable(String), status: T.nilable(String), type: T.nilable(String)).void
          }
         def initialize(
           cardholder: nil,
@@ -309,9 +311,9 @@ module Stripe
       class CreateParams < Stripe::RequestParams
         class Pin < Stripe::RequestParams
           # The card's desired new PIN, encrypted under Stripe's public key.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :encrypted_number
-          sig { params(encrypted_number: String).void }
+          sig { params(encrypted_number: T.nilable(String)).void }
           def initialize(encrypted_number: nil); end
         end
         class Shipping < Stripe::RequestParams
@@ -326,16 +328,16 @@ module Stripe
             sig { returns(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) }
             attr_accessor :postal_code
             # State, county, province, or region.
-            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: String, country: String, line1: String, line2: T.nilable(String), postal_code: String, state: T.nilable(String)).void
              }
             def initialize(
               city: nil,
@@ -355,37 +357,39 @@ module Stripe
           end
           class Customs < Stripe::RequestParams
             # The Economic Operators Registration and Identification (EORI) number to use for Customs. Required for bulk shipments to Europe.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :eori_number
-            sig { params(eori_number: String).void }
+            sig { params(eori_number: T.nilable(String)).void }
             def initialize(eori_number: nil); end
           end
           # The address that the card is shipped to.
           sig { returns(::Stripe::Issuing::Card::CreateParams::Shipping::Address) }
           attr_accessor :address
           # Address validation settings.
-          sig { returns(::Stripe::Issuing::Card::CreateParams::Shipping::AddressValidation) }
+          sig {
+            returns(T.nilable(::Stripe::Issuing::Card::CreateParams::Shipping::AddressValidation))
+           }
           attr_accessor :address_validation
           # Customs information for the shipment.
-          sig { returns(::Stripe::Issuing::Card::CreateParams::Shipping::Customs) }
+          sig { returns(T.nilable(::Stripe::Issuing::Card::CreateParams::Shipping::Customs)) }
           attr_accessor :customs
           # The name printed on the shipping label when shipping the card.
           sig { returns(String) }
           attr_accessor :name
           # Phone number of the recipient of the shipment.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :phone_number
           # Whether a signature is required for card delivery.
-          sig { returns(T::Boolean) }
+          sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :require_signature
           # Shipment service.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :service
           # Packaging options.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :type
           sig {
-            params(address: ::Stripe::Issuing::Card::CreateParams::Shipping::Address, address_validation: ::Stripe::Issuing::Card::CreateParams::Shipping::AddressValidation, customs: ::Stripe::Issuing::Card::CreateParams::Shipping::Customs, name: String, phone_number: String, require_signature: T::Boolean, service: String, type: String).void
+            params(address: ::Stripe::Issuing::Card::CreateParams::Shipping::Address, address_validation: T.nilable(::Stripe::Issuing::Card::CreateParams::Shipping::AddressValidation), customs: T.nilable(::Stripe::Issuing::Card::CreateParams::Shipping::Customs), name: String, phone_number: T.nilable(String), require_signature: T.nilable(T::Boolean), service: T.nilable(String), type: T.nilable(String)).void
            }
           def initialize(
             address: nil,
@@ -404,33 +408,35 @@ module Stripe
             sig { returns(Integer) }
             attr_accessor :amount
             # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
-            sig { returns(T::Array[String]) }
+            sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :categories
             # Interval (or event) to which the amount applies.
             sig { returns(String) }
             attr_accessor :interval
-            sig { params(amount: Integer, categories: T::Array[String], interval: String).void }
+            sig {
+              params(amount: Integer, categories: T.nilable(T::Array[String]), interval: String).void
+             }
             def initialize(amount: nil, categories: nil, interval: nil); end
           end
           # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allowed_categories
           # Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `blocked_merchant_countries`. Provide an empty value to unset this control.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allowed_merchant_countries
           # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :blocked_categories
           # Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `allowed_merchant_countries`. Provide an empty value to unset this control.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :blocked_merchant_countries
           # Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its `replacement_for` card and _that_ card's `replacement_for` card, up the chain).
           sig {
-            returns(T::Array[::Stripe::Issuing::Card::CreateParams::SpendingControls::SpendingLimit])
+            returns(T.nilable(T::Array[::Stripe::Issuing::Card::CreateParams::SpendingControls::SpendingLimit]))
            }
           attr_accessor :spending_limits
           sig {
-            params(allowed_categories: T::Array[String], allowed_merchant_countries: T::Array[String], blocked_categories: T::Array[String], blocked_merchant_countries: T::Array[String], spending_limits: T::Array[::Stripe::Issuing::Card::CreateParams::SpendingControls::SpendingLimit]).void
+            params(allowed_categories: T.nilable(T::Array[String]), allowed_merchant_countries: T.nilable(T::Array[String]), blocked_categories: T.nilable(T::Array[String]), blocked_merchant_countries: T.nilable(T::Array[String]), spending_limits: T.nilable(T::Array[::Stripe::Issuing::Card::CreateParams::SpendingControls::SpendingLimit])).void
            }
           def initialize(
             allowed_categories: nil,
@@ -441,49 +447,49 @@ module Stripe
           ); end
         end
         # The [Cardholder](https://stripe.com/docs/api#issuing_cardholder_object) object with which the card will be associated.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cardholder
         # The currency for the card.
         sig { returns(String) }
         attr_accessor :currency
         # Specifies which fields in the response should be expanded.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :expand
         # Attribute for param field financial_account
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :financial_account
         # 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 personalization design object belonging to this card.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :personalization_design
         # The desired PIN for this card.
-        sig { returns(::Stripe::Issuing::Card::CreateParams::Pin) }
+        sig { returns(T.nilable(::Stripe::Issuing::Card::CreateParams::Pin)) }
         attr_accessor :pin
         # The card this is meant to be a replacement for (if any).
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :replacement_for
         # If `replacement_for` is specified, this should indicate why that card is being replaced.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :replacement_reason
         # The second line to print on the card. Max length: 24 characters.
-        sig { returns(T.nilable(String)) }
+        sig { returns(T.nilable(T.nilable(String))) }
         attr_accessor :second_line
         # The address where the card will be shipped.
-        sig { returns(::Stripe::Issuing::Card::CreateParams::Shipping) }
+        sig { returns(T.nilable(::Stripe::Issuing::Card::CreateParams::Shipping)) }
         attr_accessor :shipping
         # Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
-        sig { returns(::Stripe::Issuing::Card::CreateParams::SpendingControls) }
+        sig { returns(T.nilable(::Stripe::Issuing::Card::CreateParams::SpendingControls)) }
         attr_accessor :spending_controls
         # Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :status
         # The type of card to issue. Possible values are `physical` or `virtual`.
         sig { returns(String) }
         attr_accessor :type
         sig {
-          params(cardholder: String, currency: String, expand: T::Array[String], financial_account: String, metadata: T::Hash[String, String], personalization_design: String, pin: ::Stripe::Issuing::Card::CreateParams::Pin, replacement_for: String, replacement_reason: String, second_line: T.nilable(String), shipping: ::Stripe::Issuing::Card::CreateParams::Shipping, spending_controls: ::Stripe::Issuing::Card::CreateParams::SpendingControls, status: String, type: String).void
+          params(cardholder: T.nilable(String), currency: String, expand: T.nilable(T::Array[String]), financial_account: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), personalization_design: T.nilable(String), pin: T.nilable(::Stripe::Issuing::Card::CreateParams::Pin), replacement_for: T.nilable(String), replacement_reason: T.nilable(String), second_line: T.nilable(T.nilable(String)), shipping: T.nilable(::Stripe::Issuing::Card::CreateParams::Shipping), spending_controls: T.nilable(::Stripe::Issuing::Card::CreateParams::SpendingControls), status: T.nilable(String), type: String).void
          }
         def initialize(
           cardholder: nil,
@@ -502,19 +508,12 @@ module Stripe
           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
         class Pin < Stripe::RequestParams
           # The card's desired new PIN, encrypted under Stripe's public key.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :encrypted_number
-          sig { params(encrypted_number: String).void }
+          sig { params(encrypted_number: T.nilable(String)).void }
           def initialize(encrypted_number: nil); end
         end
         class Shipping < Stripe::RequestParams
@@ -529,16 +528,16 @@ module Stripe
             sig { returns(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) }
             attr_accessor :postal_code
             # State, county, province, or region.
-            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: String, country: String, line1: String, line2: T.nilable(String), postal_code: String, state: T.nilable(String)).void
              }
             def initialize(
               city: nil,
@@ -558,37 +557,39 @@ module Stripe
           end
           class Customs < Stripe::RequestParams
             # The Economic Operators Registration and Identification (EORI) number to use for Customs. Required for bulk shipments to Europe.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :eori_number
-            sig { params(eori_number: String).void }
+            sig { params(eori_number: T.nilable(String)).void }
             def initialize(eori_number: nil); end
           end
           # The address that the card is shipped to.
           sig { returns(::Stripe::Issuing::Card::UpdateParams::Shipping::Address) }
           attr_accessor :address
           # Address validation settings.
-          sig { returns(::Stripe::Issuing::Card::UpdateParams::Shipping::AddressValidation) }
+          sig {
+            returns(T.nilable(::Stripe::Issuing::Card::UpdateParams::Shipping::AddressValidation))
+           }
           attr_accessor :address_validation
           # Customs information for the shipment.
-          sig { returns(::Stripe::Issuing::Card::UpdateParams::Shipping::Customs) }
+          sig { returns(T.nilable(::Stripe::Issuing::Card::UpdateParams::Shipping::Customs)) }
           attr_accessor :customs
           # The name printed on the shipping label when shipping the card.
           sig { returns(String) }
           attr_accessor :name
           # Phone number of the recipient of the shipment.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :phone_number
           # Whether a signature is required for card delivery.
-          sig { returns(T::Boolean) }
+          sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :require_signature
           # Shipment service.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :service
           # Packaging options.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :type
           sig {
-            params(address: ::Stripe::Issuing::Card::UpdateParams::Shipping::Address, address_validation: ::Stripe::Issuing::Card::UpdateParams::Shipping::AddressValidation, customs: ::Stripe::Issuing::Card::UpdateParams::Shipping::Customs, name: String, phone_number: String, require_signature: T::Boolean, service: String, type: String).void
+            params(address: ::Stripe::Issuing::Card::UpdateParams::Shipping::Address, address_validation: T.nilable(::Stripe::Issuing::Card::UpdateParams::Shipping::AddressValidation), customs: T.nilable(::Stripe::Issuing::Card::UpdateParams::Shipping::Customs), name: String, phone_number: T.nilable(String), require_signature: T.nilable(T::Boolean), service: T.nilable(String), type: T.nilable(String)).void
            }
           def initialize(
             address: nil,
@@ -607,33 +608,35 @@ module Stripe
             sig { returns(Integer) }
             attr_accessor :amount
             # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
-            sig { returns(T::Array[String]) }
+            sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :categories
             # Interval (or event) to which the amount applies.
             sig { returns(String) }
             attr_accessor :interval
-            sig { params(amount: Integer, categories: T::Array[String], interval: String).void }
+            sig {
+              params(amount: Integer, categories: T.nilable(T::Array[String]), interval: String).void
+             }
             def initialize(amount: nil, categories: nil, interval: nil); end
           end
           # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allowed_categories
           # Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `blocked_merchant_countries`. Provide an empty value to unset this control.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allowed_merchant_countries
           # Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :blocked_categories
           # Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `allowed_merchant_countries`. Provide an empty value to unset this control.
-          sig { returns(T::Array[String]) }
+          sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :blocked_merchant_countries
           # Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its `replacement_for` card and _that_ card's `replacement_for` card, up the chain).
           sig {
-            returns(T::Array[::Stripe::Issuing::Card::UpdateParams::SpendingControls::SpendingLimit])
+            returns(T.nilable(T::Array[::Stripe::Issuing::Card::UpdateParams::SpendingControls::SpendingLimit]))
            }
           attr_accessor :spending_limits
           sig {
-            params(allowed_categories: T::Array[String], allowed_merchant_countries: T::Array[String], blocked_categories: T::Array[String], blocked_merchant_countries: T::Array[String], spending_limits: T::Array[::Stripe::Issuing::Card::UpdateParams::SpendingControls::SpendingLimit]).void
+            params(allowed_categories: T.nilable(T::Array[String]), allowed_merchant_countries: T.nilable(T::Array[String]), blocked_categories: T.nilable(T::Array[String]), blocked_merchant_countries: T.nilable(T::Array[String]), spending_limits: T.nilable(T::Array[::Stripe::Issuing::Card::UpdateParams::SpendingControls::SpendingLimit])).void
            }
           def initialize(
             allowed_categories: nil,
@@ -644,31 +647,31 @@ module Stripe
           ); end
         end
         # Reason why the `status` of this card is `canceled`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cancellation_reason
         # 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
         # Attribute for param field personalization_design
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :personalization_design
         # The desired new PIN for this card.
-        sig { returns(::Stripe::Issuing::Card::UpdateParams::Pin) }
+        sig { returns(T.nilable(::Stripe::Issuing::Card::UpdateParams::Pin)) }
         attr_accessor :pin
         # Updated shipping information for the card.
-        sig { returns(::Stripe::Issuing::Card::UpdateParams::Shipping) }
+        sig { returns(T.nilable(::Stripe::Issuing::Card::UpdateParams::Shipping)) }
         attr_accessor :shipping
         # Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
-        sig { returns(::Stripe::Issuing::Card::UpdateParams::SpendingControls) }
+        sig { returns(T.nilable(::Stripe::Issuing::Card::UpdateParams::SpendingControls)) }
         attr_accessor :spending_controls
         # Dictates whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`. If this card is being canceled because it was lost or stolen, this information should be provided as `cancellation_reason`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :status
         sig {
-          params(cancellation_reason: String, expand: T::Array[String], metadata: T.nilable(T::Hash[String, String]), personalization_design: String, pin: ::Stripe::Issuing::Card::UpdateParams::Pin, shipping: ::Stripe::Issuing::Card::UpdateParams::Shipping, spending_controls: ::Stripe::Issuing::Card::UpdateParams::SpendingControls, status: String).void
+          params(cancellation_reason: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String]))), personalization_design: T.nilable(String), pin: T.nilable(::Stripe::Issuing::Card::UpdateParams::Pin), shipping: T.nilable(::Stripe::Issuing::Card::UpdateParams::Shipping), spending_controls: T.nilable(::Stripe::Issuing::Card::UpdateParams::SpendingControls), status: T.nilable(String)).void
          }
         def initialize(
           cancellation_reason: nil,
@@ -683,37 +686,37 @@ module Stripe
       end
       class DeliverCardParams < 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 FailCardParams < 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 ReturnCardParams < 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 ShipCardParams < 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 SubmitCardParams < 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
       # Creates an Issuing Card object.