stripe 13.6.0.pre.beta.1 → 14.0.0

data/rbi/stripe/resources/issuing/transaction.rbi

@@ -282,9 +282,6 @@ module Stripe
       # Additional purchase information that is optionally provided by the merchant.
       sig { returns(T.nilable(PurchaseDetails)) }
       attr_reader :purchase_details
-      # Attribute for field settlement
-      sig { returns(T.nilable(T.any(String, Stripe::Issuing::Settlement))) }
-      attr_reader :settlement
       # [Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
       sig { returns(T.nilable(T.any(String, Stripe::Issuing::Token))) }
       attr_reader :token
@@ -300,49 +297,50 @@ 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 transactions that belong to the given card.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :card
         # Only return transactions that belong to the given cardholder.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :cardholder
         # Only return transactions that were created during the given date interval.
-        sig { returns(T.any(::Stripe::Issuing::Transaction::ListParams::Created, Integer)) }
+        sig {
+          returns(T.nilable(T.any(::Stripe::Issuing::Transaction::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 transactions that are associated with the given settlement.
-        sig { returns(String) }
-        attr_accessor :settlement
         # 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 transactions that have the given type. One of `capture` or `refund`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :type
         sig {
-          params(card: String, cardholder: String, created: T.any(::Stripe::Issuing::Transaction::ListParams::Created, Integer), ending_before: String, expand: T::Array[String], limit: Integer, settlement: String, starting_after: String, type: String).void
+          params(card: T.nilable(String), cardholder: T.nilable(String), created: T.nilable(T.any(::Stripe::Issuing::Transaction::ListParams::Created, Integer)), ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), starting_after: T.nilable(String), type: T.nilable(String)).void
          }
         def initialize(
           card: nil,
@@ -351,69 +349,63 @@ module Stripe
           ending_before: nil,
           expand: nil,
           limit: nil,
-          settlement: nil,
           starting_after: nil,
           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
         # 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
-        sig { params(expand: T::Array[String], metadata: T.nilable(T::Hash[String, String])).void }
+        sig {
+          params(expand: T.nilable(T::Array[String]), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String])))).void
+         }
         def initialize(expand: nil, metadata: nil); end
       end
       class RefundParams < 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
         # The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :refund_amount
-        sig { params(expand: T::Array[String], refund_amount: Integer).void }
+        sig { params(expand: T.nilable(T::Array[String]), refund_amount: T.nilable(Integer)).void }
         def initialize(expand: nil, refund_amount: nil); end
       end
       class CreateForceCaptureParams < Stripe::RequestParams
         class MerchantData < Stripe::RequestParams
           # A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :category
           # City where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :city
           # Country where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :country
           # Name of the seller
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :name
           # Identifier assigned to the seller by the card network. Different card networks may assign different network_id fields to the same merchant.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :network_id
           # Postal code where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :postal_code
           # State where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :state
           # An ID assigned by the seller to the location of the sale.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :terminal_id
           # URL provided by the merchant on a 3DS request
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :url
           sig {
-            params(category: String, city: String, country: String, name: String, network_id: String, postal_code: String, state: String, terminal_id: String, url: String).void
+            params(category: T.nilable(String), city: T.nilable(String), country: T.nilable(String), name: T.nilable(String), network_id: T.nilable(String), postal_code: T.nilable(String), state: T.nilable(String), terminal_id: T.nilable(String), url: T.nilable(String)).void
            }
           def initialize(
             category: nil,
@@ -431,22 +423,22 @@ module Stripe
           class Fleet < Stripe::RequestParams
             class CardholderPromptData < Stripe::RequestParams
               # Driver ID.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :driver_id
               # Odometer reading.
-              sig { returns(Integer) }
+              sig { returns(T.nilable(Integer)) }
               attr_accessor :odometer
               # An alphanumeric ID. This field is used when a vehicle ID, driver ID, or generic ID is entered by the cardholder, but the merchant or card network did not specify the prompt type.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :unspecified_id
               # User ID.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :user_id
               # Vehicle number.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :vehicle_number
               sig {
-                params(driver_id: String, odometer: Integer, unspecified_id: String, user_id: String, vehicle_number: String).void
+                params(driver_id: T.nilable(String), odometer: T.nilable(Integer), unspecified_id: T.nilable(String), user_id: T.nilable(String), vehicle_number: T.nilable(String)).void
                }
               def initialize(
                 driver_id: nil,
@@ -459,66 +451,68 @@ module Stripe
             class ReportedBreakdown < Stripe::RequestParams
               class Fuel < Stripe::RequestParams
                 # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :gross_amount_decimal
-                sig { params(gross_amount_decimal: String).void }
+                sig { params(gross_amount_decimal: T.nilable(String)).void }
                 def initialize(gross_amount_decimal: nil); end
               end
               class NonFuel < Stripe::RequestParams
                 # Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :gross_amount_decimal
-                sig { params(gross_amount_decimal: String).void }
+                sig { params(gross_amount_decimal: T.nilable(String)).void }
                 def initialize(gross_amount_decimal: nil); end
               end
               class Tax < Stripe::RequestParams
                 # Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :local_amount_decimal
                 # Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :national_amount_decimal
-                sig { params(local_amount_decimal: String, national_amount_decimal: String).void }
+                sig {
+                  params(local_amount_decimal: T.nilable(String), national_amount_decimal: T.nilable(String)).void
+                 }
                 def initialize(local_amount_decimal: nil, national_amount_decimal: nil); end
               end
               # Breakdown of fuel portion of the purchase.
               sig {
-                returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel)
+                returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel))
                }
               attr_accessor :fuel
               # Breakdown of non-fuel portion of the purchase.
               sig {
-                returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel)
+                returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel))
                }
               attr_accessor :non_fuel
               # Information about tax included in this transaction.
               sig {
-                returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax)
+                returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax))
                }
               attr_accessor :tax
               sig {
-                params(fuel: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel, non_fuel: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel, tax: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax).void
+                params(fuel: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel), non_fuel: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel), tax: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax)).void
                }
               def initialize(fuel: nil, non_fuel: nil, tax: nil); end
             end
             # Answers to prompts presented to the cardholder at the point of sale. Prompted fields vary depending on the configuration of your physical fleet cards. Typical points of sale support only numeric entry.
             sig {
-              returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::CardholderPromptData)
+              returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::CardholderPromptData))
              }
             attr_accessor :cardholder_prompt_data
             # The type of purchase. One of `fuel_purchase`, `non_fuel_purchase`, or `fuel_and_non_fuel_purchase`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :purchase_type
             # More information about the total amount. This information is not guaranteed to be accurate as some merchants may provide unreliable data.
             sig {
-              returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown)
+              returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown))
              }
             attr_accessor :reported_breakdown
             # The type of fuel service. One of `non_fuel_transaction`, `full_service`, or `self_service`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :service_type
             sig {
-              params(cardholder_prompt_data: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::CardholderPromptData, purchase_type: String, reported_breakdown: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown, service_type: String).void
+              params(cardholder_prompt_data: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::CardholderPromptData), purchase_type: T.nilable(String), reported_breakdown: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet::ReportedBreakdown), service_type: T.nilable(String)).void
              }
             def initialize(
               cardholder_prompt_data: nil,
@@ -530,25 +524,25 @@ module Stripe
           class Flight < Stripe::RequestParams
             class Segment < Stripe::RequestParams
               # The three-letter IATA airport code of the flight's destination.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :arrival_airport_code
               # The airline carrier code.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :carrier
               # The three-letter IATA airport code that the flight departed from.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :departure_airport_code
               # The flight number.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :flight_number
               # The flight's service class.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :service_class
               # Whether a stopover is allowed on this flight.
-              sig { returns(T::Boolean) }
+              sig { returns(T.nilable(T::Boolean)) }
               attr_accessor :stopover_allowed
               sig {
-                params(arrival_airport_code: String, carrier: String, departure_airport_code: String, flight_number: String, service_class: String, stopover_allowed: T::Boolean).void
+                params(arrival_airport_code: T.nilable(String), carrier: T.nilable(String), departure_airport_code: T.nilable(String), flight_number: T.nilable(String), service_class: T.nilable(String), stopover_allowed: T.nilable(T::Boolean)).void
                }
               def initialize(
                 arrival_airport_code: nil,
@@ -560,24 +554,24 @@ module Stripe
               ); end
             end
             # The time that the flight departed.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :departure_at
             # The name of the passenger.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :passenger_name
             # Whether the ticket is refundable.
-            sig { returns(T::Boolean) }
+            sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :refundable
             # The legs of the trip.
             sig {
-              returns(T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight::Segment])
+              returns(T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight::Segment]))
              }
             attr_accessor :segments
             # The travel agency that issued the ticket.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :travel_agency
             sig {
-              params(departure_at: Integer, passenger_name: String, refundable: T::Boolean, segments: T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight::Segment], travel_agency: String).void
+              params(departure_at: T.nilable(Integer), passenger_name: T.nilable(String), refundable: T.nilable(T::Boolean), segments: T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight::Segment]), travel_agency: T.nilable(String)).void
              }
             def initialize(
               departure_at: nil,
@@ -589,22 +583,22 @@ module Stripe
           end
           class Fuel < Stripe::RequestParams
             # [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :industry_product_code
             # The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :quantity_decimal
             # The type of fuel that was purchased. One of `diesel`, `unleaded_plus`, `unleaded_regular`, `unleaded_super`, or `other`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :type
             # The units for `quantity_decimal`. One of `charging_minute`, `imperial_gallon`, `kilogram`, `kilowatt_hour`, `liter`, `pound`, `us_gallon`, or `other`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :unit
             # The cost in cents per each unit of fuel, represented as a decimal string with at most 12 decimal places.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :unit_cost_decimal
             sig {
-              params(industry_product_code: String, quantity_decimal: String, type: String, unit: String, unit_cost_decimal: String).void
+              params(industry_product_code: T.nilable(String), quantity_decimal: T.nilable(String), type: T.nilable(String), unit: T.nilable(String), unit_cost_decimal: T.nilable(String)).void
              }
             def initialize(
               industry_product_code: nil,
@@ -616,62 +610,62 @@ module Stripe
           end
           class Lodging < Stripe::RequestParams
             # The time of checking into the lodging.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :check_in_at
             # The number of nights stayed at the lodging.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :nights
-            sig { params(check_in_at: Integer, nights: Integer).void }
+            sig { params(check_in_at: T.nilable(Integer), nights: T.nilable(Integer)).void }
             def initialize(check_in_at: nil, nights: nil); end
           end
           class Receipt < Stripe::RequestParams
             # Attribute for param field description
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :description
             # Attribute for param field quantity
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :quantity
             # Attribute for param field total
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :total
             # Attribute for param field unit_cost
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :unit_cost
             sig {
-              params(description: String, quantity: String, total: Integer, unit_cost: Integer).void
+              params(description: T.nilable(String), quantity: T.nilable(String), total: T.nilable(Integer), unit_cost: T.nilable(Integer)).void
              }
             def initialize(description: nil, quantity: nil, total: nil, unit_cost: nil); end
           end
           # Fleet-specific information for transactions using Fleet cards.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet))
            }
           attr_accessor :fleet
           # Information about the flight that was purchased with this transaction.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight))
            }
           attr_accessor :flight
           # Information about fuel that was purchased with this transaction.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fuel)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fuel))
            }
           attr_accessor :fuel
           # Information about lodging that was purchased with this transaction.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Lodging)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Lodging))
            }
           attr_accessor :lodging
           # The line items in the purchase.
           sig {
-            returns(T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Receipt])
+            returns(T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Receipt]))
            }
           attr_accessor :receipt
           # A merchant-specific order number.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :reference
           sig {
-            params(fleet: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet, flight: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight, fuel: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fuel, lodging: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Lodging, receipt: T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Receipt], reference: String).void
+            params(fleet: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fleet), flight: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Flight), fuel: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Fuel), lodging: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Lodging), receipt: T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails::Receipt]), reference: T.nilable(String)).void
            }
           def initialize(
             fleet: nil,
@@ -689,19 +683,23 @@ module Stripe
         sig { returns(String) }
         attr_accessor :card
         # The currency of the capture. If not provided, defaults to the currency of the card. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-        sig { returns(String) }
+        sig { returns(T.nilable(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
         # Details about the seller (grocery store, e-commerce website, etc.) where the card authorization happened.
-        sig { returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::MerchantData) }
+        sig {
+          returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::MerchantData))
+         }
         attr_accessor :merchant_data
         # Additional purchase information that is optionally provided by the merchant.
-        sig { returns(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails) }
+        sig {
+          returns(T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails))
+         }
         attr_accessor :purchase_details
         sig {
-          params(amount: Integer, card: String, currency: String, expand: T::Array[String], merchant_data: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::MerchantData, purchase_details: ::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails).void
+          params(amount: Integer, card: String, currency: T.nilable(String), expand: T.nilable(T::Array[String]), merchant_data: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::MerchantData), purchase_details: T.nilable(::Stripe::Issuing::Transaction::CreateForceCaptureParams::PurchaseDetails)).void
          }
         def initialize(
           amount: nil,
@@ -715,34 +713,34 @@ module Stripe
       class CreateUnlinkedRefundParams < Stripe::RequestParams
         class MerchantData < Stripe::RequestParams
           # A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :category
           # City where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :city
           # Country where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :country
           # Name of the seller
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :name
           # Identifier assigned to the seller by the card network. Different card networks may assign different network_id fields to the same merchant.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :network_id
           # Postal code where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :postal_code
           # State where the seller is located
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :state
           # An ID assigned by the seller to the location of the sale.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :terminal_id
           # URL provided by the merchant on a 3DS request
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :url
           sig {
-            params(category: String, city: String, country: String, name: String, network_id: String, postal_code: String, state: String, terminal_id: String, url: String).void
+            params(category: T.nilable(String), city: T.nilable(String), country: T.nilable(String), name: T.nilable(String), network_id: T.nilable(String), postal_code: T.nilable(String), state: T.nilable(String), terminal_id: T.nilable(String), url: T.nilable(String)).void
            }
           def initialize(
             category: nil,
@@ -760,22 +758,22 @@ module Stripe
           class Fleet < Stripe::RequestParams
             class CardholderPromptData < Stripe::RequestParams
               # Driver ID.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :driver_id
               # Odometer reading.
-              sig { returns(Integer) }
+              sig { returns(T.nilable(Integer)) }
               attr_accessor :odometer
               # An alphanumeric ID. This field is used when a vehicle ID, driver ID, or generic ID is entered by the cardholder, but the merchant or card network did not specify the prompt type.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :unspecified_id
               # User ID.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :user_id
               # Vehicle number.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :vehicle_number
               sig {
-                params(driver_id: String, odometer: Integer, unspecified_id: String, user_id: String, vehicle_number: String).void
+                params(driver_id: T.nilable(String), odometer: T.nilable(Integer), unspecified_id: T.nilable(String), user_id: T.nilable(String), vehicle_number: T.nilable(String)).void
                }
               def initialize(
                 driver_id: nil,
@@ -788,66 +786,68 @@ module Stripe
             class ReportedBreakdown < Stripe::RequestParams
               class Fuel < Stripe::RequestParams
                 # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :gross_amount_decimal
-                sig { params(gross_amount_decimal: String).void }
+                sig { params(gross_amount_decimal: T.nilable(String)).void }
                 def initialize(gross_amount_decimal: nil); end
               end
               class NonFuel < Stripe::RequestParams
                 # Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :gross_amount_decimal
-                sig { params(gross_amount_decimal: String).void }
+                sig { params(gross_amount_decimal: T.nilable(String)).void }
                 def initialize(gross_amount_decimal: nil); end
               end
               class Tax < Stripe::RequestParams
                 # Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :local_amount_decimal
                 # Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
-                sig { returns(String) }
+                sig { returns(T.nilable(String)) }
                 attr_accessor :national_amount_decimal
-                sig { params(local_amount_decimal: String, national_amount_decimal: String).void }
+                sig {
+                  params(local_amount_decimal: T.nilable(String), national_amount_decimal: T.nilable(String)).void
+                 }
                 def initialize(local_amount_decimal: nil, national_amount_decimal: nil); end
               end
               # Breakdown of fuel portion of the purchase.
               sig {
-                returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel)
+                returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel))
                }
               attr_accessor :fuel
               # Breakdown of non-fuel portion of the purchase.
               sig {
-                returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel)
+                returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel))
                }
               attr_accessor :non_fuel
               # Information about tax included in this transaction.
               sig {
-                returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax)
+                returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax))
                }
               attr_accessor :tax
               sig {
-                params(fuel: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel, non_fuel: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel, tax: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax).void
+                params(fuel: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Fuel), non_fuel: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::NonFuel), tax: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown::Tax)).void
                }
               def initialize(fuel: nil, non_fuel: nil, tax: nil); end
             end
             # Answers to prompts presented to the cardholder at the point of sale. Prompted fields vary depending on the configuration of your physical fleet cards. Typical points of sale support only numeric entry.
             sig {
-              returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::CardholderPromptData)
+              returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::CardholderPromptData))
              }
             attr_accessor :cardholder_prompt_data
             # The type of purchase. One of `fuel_purchase`, `non_fuel_purchase`, or `fuel_and_non_fuel_purchase`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :purchase_type
             # More information about the total amount. This information is not guaranteed to be accurate as some merchants may provide unreliable data.
             sig {
-              returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown)
+              returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown))
              }
             attr_accessor :reported_breakdown
             # The type of fuel service. One of `non_fuel_transaction`, `full_service`, or `self_service`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :service_type
             sig {
-              params(cardholder_prompt_data: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::CardholderPromptData, purchase_type: String, reported_breakdown: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown, service_type: String).void
+              params(cardholder_prompt_data: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::CardholderPromptData), purchase_type: T.nilable(String), reported_breakdown: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet::ReportedBreakdown), service_type: T.nilable(String)).void
              }
             def initialize(
               cardholder_prompt_data: nil,
@@ -859,25 +859,25 @@ module Stripe
           class Flight < Stripe::RequestParams
             class Segment < Stripe::RequestParams
               # The three-letter IATA airport code of the flight's destination.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :arrival_airport_code
               # The airline carrier code.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :carrier
               # The three-letter IATA airport code that the flight departed from.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :departure_airport_code
               # The flight number.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :flight_number
               # The flight's service class.
-              sig { returns(String) }
+              sig { returns(T.nilable(String)) }
               attr_accessor :service_class
               # Whether a stopover is allowed on this flight.
-              sig { returns(T::Boolean) }
+              sig { returns(T.nilable(T::Boolean)) }
               attr_accessor :stopover_allowed
               sig {
-                params(arrival_airport_code: String, carrier: String, departure_airport_code: String, flight_number: String, service_class: String, stopover_allowed: T::Boolean).void
+                params(arrival_airport_code: T.nilable(String), carrier: T.nilable(String), departure_airport_code: T.nilable(String), flight_number: T.nilable(String), service_class: T.nilable(String), stopover_allowed: T.nilable(T::Boolean)).void
                }
               def initialize(
                 arrival_airport_code: nil,
@@ -889,24 +889,24 @@ module Stripe
               ); end
             end
             # The time that the flight departed.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :departure_at
             # The name of the passenger.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :passenger_name
             # Whether the ticket is refundable.
-            sig { returns(T::Boolean) }
+            sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :refundable
             # The legs of the trip.
             sig {
-              returns(T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight::Segment])
+              returns(T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight::Segment]))
              }
             attr_accessor :segments
             # The travel agency that issued the ticket.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :travel_agency
             sig {
-              params(departure_at: Integer, passenger_name: String, refundable: T::Boolean, segments: T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight::Segment], travel_agency: String).void
+              params(departure_at: T.nilable(Integer), passenger_name: T.nilable(String), refundable: T.nilable(T::Boolean), segments: T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight::Segment]), travel_agency: T.nilable(String)).void
              }
             def initialize(
               departure_at: nil,
@@ -918,22 +918,22 @@ module Stripe
           end
           class Fuel < Stripe::RequestParams
             # [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :industry_product_code
             # The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :quantity_decimal
             # The type of fuel that was purchased. One of `diesel`, `unleaded_plus`, `unleaded_regular`, `unleaded_super`, or `other`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :type
             # The units for `quantity_decimal`. One of `charging_minute`, `imperial_gallon`, `kilogram`, `kilowatt_hour`, `liter`, `pound`, `us_gallon`, or `other`.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :unit
             # The cost in cents per each unit of fuel, represented as a decimal string with at most 12 decimal places.
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :unit_cost_decimal
             sig {
-              params(industry_product_code: String, quantity_decimal: String, type: String, unit: String, unit_cost_decimal: String).void
+              params(industry_product_code: T.nilable(String), quantity_decimal: T.nilable(String), type: T.nilable(String), unit: T.nilable(String), unit_cost_decimal: T.nilable(String)).void
              }
             def initialize(
               industry_product_code: nil,
@@ -945,62 +945,62 @@ module Stripe
           end
           class Lodging < Stripe::RequestParams
             # The time of checking into the lodging.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :check_in_at
             # The number of nights stayed at the lodging.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :nights
-            sig { params(check_in_at: Integer, nights: Integer).void }
+            sig { params(check_in_at: T.nilable(Integer), nights: T.nilable(Integer)).void }
             def initialize(check_in_at: nil, nights: nil); end
           end
           class Receipt < Stripe::RequestParams
             # Attribute for param field description
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :description
             # Attribute for param field quantity
-            sig { returns(String) }
+            sig { returns(T.nilable(String)) }
             attr_accessor :quantity
             # Attribute for param field total
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :total
             # Attribute for param field unit_cost
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :unit_cost
             sig {
-              params(description: String, quantity: String, total: Integer, unit_cost: Integer).void
+              params(description: T.nilable(String), quantity: T.nilable(String), total: T.nilable(Integer), unit_cost: T.nilable(Integer)).void
              }
             def initialize(description: nil, quantity: nil, total: nil, unit_cost: nil); end
           end
           # Fleet-specific information for transactions using Fleet cards.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet))
            }
           attr_accessor :fleet
           # Information about the flight that was purchased with this transaction.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight))
            }
           attr_accessor :flight
           # Information about fuel that was purchased with this transaction.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fuel)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fuel))
            }
           attr_accessor :fuel
           # Information about lodging that was purchased with this transaction.
           sig {
-            returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Lodging)
+            returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Lodging))
            }
           attr_accessor :lodging
           # The line items in the purchase.
           sig {
-            returns(T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Receipt])
+            returns(T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Receipt]))
            }
           attr_accessor :receipt
           # A merchant-specific order number.
-          sig { returns(String) }
+          sig { returns(T.nilable(String)) }
           attr_accessor :reference
           sig {
-            params(fleet: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet, flight: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight, fuel: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fuel, lodging: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Lodging, receipt: T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Receipt], reference: String).void
+            params(fleet: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fleet), flight: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Flight), fuel: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Fuel), lodging: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Lodging), receipt: T.nilable(T::Array[::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails::Receipt]), reference: T.nilable(String)).void
            }
           def initialize(
             fleet: nil,
@@ -1018,19 +1018,23 @@ module Stripe
         sig { returns(String) }
         attr_accessor :card
         # The currency of the unlinked refund. If not provided, defaults to the currency of the card. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-        sig { returns(String) }
+        sig { returns(T.nilable(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
         # Details about the seller (grocery store, e-commerce website, etc.) where the card authorization happened.
-        sig { returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::MerchantData) }
+        sig {
+          returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::MerchantData))
+         }
         attr_accessor :merchant_data
         # Additional purchase information that is optionally provided by the merchant.
-        sig { returns(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails) }
+        sig {
+          returns(T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails))
+         }
         attr_accessor :purchase_details
         sig {
-          params(amount: Integer, card: String, currency: String, expand: T::Array[String], merchant_data: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::MerchantData, purchase_details: ::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails).void
+          params(amount: Integer, card: String, currency: T.nilable(String), expand: T.nilable(T::Array[String]), merchant_data: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::MerchantData), purchase_details: T.nilable(::Stripe::Issuing::Transaction::CreateUnlinkedRefundParams::PurchaseDetails)).void
          }
         def initialize(
           amount: nil,