stripe 13.6.0.pre.beta.1 → 14.0.0

data/rbi/stripe/services/credit_note_service.rbi

@@ -9,43 +9,45 @@ module Stripe
     class ListParams < Stripe::RequestParams
       class Created < Stripe::RequestParams
         # Minimum value to filter by (exclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :gt
         # Minimum value to filter by (inclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :gte
         # Maximum value to filter by (exclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :lt
         # Maximum value to filter by (inclusive)
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :lte
-        sig { params(gt: Integer, gte: Integer, lt: Integer, lte: Integer).void }
+        sig {
+          params(gt: T.nilable(Integer), gte: T.nilable(Integer), lt: T.nilable(Integer), lte: T.nilable(Integer)).void
+         }
         def initialize(gt: nil, gte: nil, lt: nil, lte: nil); end
       end
       # Only return credit notes that were created during the given date interval.
-      sig { returns(T.any(::Stripe::CreditNoteService::ListParams::Created, Integer)) }
+      sig { returns(T.nilable(T.any(::Stripe::CreditNoteService::ListParams::Created, Integer))) }
       attr_accessor :created
       # Only return credit notes for the customer specified by this customer ID.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :customer
       # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :ending_before
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # Only return credit notes for the invoice specified by this invoice ID.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :invoice
       # 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(created: T.any(::Stripe::CreditNoteService::ListParams::Created, Integer), customer: String, ending_before: String, expand: T::Array[String], invoice: String, limit: Integer, starting_after: String).void
+        params(created: T.nilable(T.any(::Stripe::CreditNoteService::ListParams::Created, Integer)), customer: T.nilable(String), ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), invoice: T.nilable(String), limit: T.nilable(Integer), starting_after: T.nilable(String)).void
        }
       def initialize(
         created: nil,
@@ -73,36 +75,36 @@ module Stripe
           def initialize(amount: nil, tax_rate: nil, taxable_amount: nil); end
         end
         # The line item amount to credit. Only valid when `type` is `invoice_line_item`. If invoice is set up with `automatic_tax[enabled]=true`, this amount is tax exclusive
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :amount
         # The description of the credit note line item. Only valid when the `type` is `custom_line_item`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :description
         # The invoice line item to credit. Only valid when the `type` is `invoice_line_item`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :invoice_line_item
         # The line item quantity to credit.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :quantity
         # A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
         sig {
-          returns(T.nilable(T::Array[::Stripe::CreditNoteService::CreateParams::Line::TaxAmount]))
+          returns(T.nilable(T.nilable(T.any(String, T::Array[::Stripe::CreditNoteService::CreateParams::Line::TaxAmount]))))
          }
         attr_accessor :tax_amounts
         # The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
-        sig { returns(T.nilable(T::Array[String])) }
+        sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
         attr_accessor :tax_rates
         # Type of the credit note line item, one of `invoice_line_item` or `custom_line_item`
         sig { returns(String) }
         attr_accessor :type
         # The integer unit amount in cents (or local equivalent) of the credit note line item. This `unit_amount` will be multiplied by the quantity to get the full amount to credit for this line item. Only valid when `type` is `custom_line_item`.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :unit_amount
         # Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :unit_amount_decimal
         sig {
-          params(amount: Integer, description: String, invoice_line_item: String, quantity: Integer, tax_amounts: T.nilable(T::Array[::Stripe::CreditNoteService::CreateParams::Line::TaxAmount]), tax_rates: T.nilable(T::Array[String]), type: String, unit_amount: Integer, unit_amount_decimal: String).void
+          params(amount: T.nilable(Integer), description: T.nilable(String), invoice_line_item: T.nilable(String), quantity: T.nilable(Integer), tax_amounts: T.nilable(T.nilable(T.any(String, T::Array[::Stripe::CreditNoteService::CreateParams::Line::TaxAmount]))), tax_rates: T.nilable(T.nilable(T.any(String, T::Array[String]))), type: String, unit_amount: T.nilable(Integer), unit_amount_decimal: T.nilable(String)).void
          }
         def initialize(
           amount: nil,
@@ -118,68 +120,65 @@ module Stripe
       end
       class Refund < Stripe::RequestParams
         # Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :amount_refunded
         # ID of an existing refund to link this credit note to.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :refund
-        sig { params(amount_refunded: Integer, refund: String).void }
+        sig { params(amount_refunded: T.nilable(Integer), refund: T.nilable(String)).void }
         def initialize(amount_refunded: nil, refund: nil); end
       end
       class ShippingCost < Stripe::RequestParams
         # The ID of the shipping rate to use for this order.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_rate
-        sig { params(shipping_rate: String).void }
+        sig { params(shipping_rate: T.nilable(String)).void }
         def initialize(shipping_rate: nil); end
       end
       # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :credit_amount
       # The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :effective_at
       # Type of email to send to the customer, one of `credit_note` or `none` and the default is `credit_note`.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :email_type
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # ID of the invoice.
       sig { returns(String) }
       attr_accessor :invoice
       # Line items that make up the credit note.
-      sig { returns(T::Array[::Stripe::CreditNoteService::CreateParams::Line]) }
+      sig { returns(T.nilable(T::Array[::Stripe::CreditNoteService::CreateParams::Line])) }
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :memo
       # 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 integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :out_of_band_amount
       # Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :reason
-      # ID of an existing refund to link this credit note to.
-      sig { returns(String) }
-      attr_accessor :refund
       # The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
-      sig { returns(T::Array[::Stripe::CreditNoteService::CreateParams::Refund]) }
+      sig { returns(T.nilable(T::Array[::Stripe::CreditNoteService::CreateParams::Refund])) }
       attr_accessor :refunds
       # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
-      sig { returns(::Stripe::CreditNoteService::CreateParams::ShippingCost) }
+      sig { returns(T.nilable(::Stripe::CreditNoteService::CreateParams::ShippingCost)) }
       attr_accessor :shipping_cost
       sig {
-        params(amount: Integer, credit_amount: Integer, effective_at: Integer, email_type: String, expand: T::Array[String], invoice: String, lines: T::Array[::Stripe::CreditNoteService::CreateParams::Line], memo: String, metadata: T::Hash[String, String], out_of_band_amount: Integer, reason: String, refund: String, refund_amount: Integer, refunds: T::Array[::Stripe::CreditNoteService::CreateParams::Refund], shipping_cost: ::Stripe::CreditNoteService::CreateParams::ShippingCost).void
+        params(amount: T.nilable(Integer), credit_amount: T.nilable(Integer), effective_at: T.nilable(Integer), email_type: T.nilable(String), expand: T.nilable(T::Array[String]), invoice: String, lines: T.nilable(T::Array[::Stripe::CreditNoteService::CreateParams::Line]), memo: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), out_of_band_amount: T.nilable(Integer), reason: T.nilable(String), refund_amount: T.nilable(Integer), refunds: T.nilable(T::Array[::Stripe::CreditNoteService::CreateParams::Refund]), shipping_cost: T.nilable(::Stripe::CreditNoteService::CreateParams::ShippingCost)).void
        }
       def initialize(
         amount: nil,
@@ -193,7 +192,6 @@ module Stripe
         metadata: nil,
         out_of_band_amount: nil,
         reason: nil,
-        refund: nil,
         refund_amount: nil,
         refunds: nil,
         shipping_cost: nil
@@ -201,22 +199,24 @@ module Stripe
     end
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
+      sig { params(expand: T.nilable(T::Array[String])).void }
       def initialize(expand: nil); end
     end
     class UpdateParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # Credit note memo.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :memo
       # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-      sig { returns(T::Hash[String, String]) }
+      sig { returns(T.nilable(T::Hash[String, String])) }
       attr_accessor :metadata
-      sig { params(expand: T::Array[String], memo: String, metadata: T::Hash[String, String]).void }
+      sig {
+        params(expand: T.nilable(T::Array[String]), memo: T.nilable(String), metadata: T.nilable(T::Hash[String, String])).void
+       }
       def initialize(expand: nil, memo: nil, metadata: nil); end
     end
     class PreviewParams < Stripe::RequestParams
@@ -235,36 +235,36 @@ module Stripe
           def initialize(amount: nil, tax_rate: nil, taxable_amount: nil); end
         end
         # The line item amount to credit. Only valid when `type` is `invoice_line_item`. If invoice is set up with `automatic_tax[enabled]=true`, this amount is tax exclusive
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :amount
         # The description of the credit note line item. Only valid when the `type` is `custom_line_item`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :description
         # The invoice line item to credit. Only valid when the `type` is `invoice_line_item`.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :invoice_line_item
         # The line item quantity to credit.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :quantity
         # A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
         sig {
-          returns(T.nilable(T::Array[::Stripe::CreditNoteService::PreviewParams::Line::TaxAmount]))
+          returns(T.nilable(T.nilable(T.any(String, T::Array[::Stripe::CreditNoteService::PreviewParams::Line::TaxAmount]))))
          }
         attr_accessor :tax_amounts
         # The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
-        sig { returns(T.nilable(T::Array[String])) }
+        sig { returns(T.nilable(T.nilable(T.any(String, T::Array[String])))) }
         attr_accessor :tax_rates
         # Type of the credit note line item, one of `invoice_line_item` or `custom_line_item`
         sig { returns(String) }
         attr_accessor :type
         # The integer unit amount in cents (or local equivalent) of the credit note line item. This `unit_amount` will be multiplied by the quantity to get the full amount to credit for this line item. Only valid when `type` is `custom_line_item`.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :unit_amount
         # Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :unit_amount_decimal
         sig {
-          params(amount: Integer, description: String, invoice_line_item: String, quantity: Integer, tax_amounts: T.nilable(T::Array[::Stripe::CreditNoteService::PreviewParams::Line::TaxAmount]), tax_rates: T.nilable(T::Array[String]), type: String, unit_amount: Integer, unit_amount_decimal: String).void
+          params(amount: T.nilable(Integer), description: T.nilable(String), invoice_line_item: T.nilable(String), quantity: T.nilable(Integer), tax_amounts: T.nilable(T.nilable(T.any(String, T::Array[::Stripe::CreditNoteService::PreviewParams::Line::TaxAmount]))), tax_rates: T.nilable(T.nilable(T.any(String, T::Array[String]))), type: String, unit_amount: T.nilable(Integer), unit_amount_decimal: T.nilable(String)).void
          }
         def initialize(
           amount: nil,
@@ -280,68 +280,65 @@ module Stripe
       end
       class Refund < Stripe::RequestParams
         # Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
-        sig { returns(Integer) }
+        sig { returns(T.nilable(Integer)) }
         attr_accessor :amount_refunded
         # ID of an existing refund to link this credit note to.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :refund
-        sig { params(amount_refunded: Integer, refund: String).void }
+        sig { params(amount_refunded: T.nilable(Integer), refund: T.nilable(String)).void }
         def initialize(amount_refunded: nil, refund: nil); end
       end
       class ShippingCost < Stripe::RequestParams
         # The ID of the shipping rate to use for this order.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :shipping_rate
-        sig { params(shipping_rate: String).void }
+        sig { params(shipping_rate: T.nilable(String)).void }
         def initialize(shipping_rate: nil); end
       end
       # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :credit_amount
       # The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :effective_at
       # Type of email to send to the customer, one of `credit_note` or `none` and the default is `credit_note`.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :email_type
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
       # ID of the invoice.
       sig { returns(String) }
       attr_accessor :invoice
       # Line items that make up the credit note.
-      sig { returns(T::Array[::Stripe::CreditNoteService::PreviewParams::Line]) }
+      sig { returns(T.nilable(T::Array[::Stripe::CreditNoteService::PreviewParams::Line])) }
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :memo
       # 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 integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :out_of_band_amount
       # Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :reason
-      # ID of an existing refund to link this credit note to.
-      sig { returns(String) }
-      attr_accessor :refund
       # The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice.
-      sig { returns(Integer) }
+      sig { returns(T.nilable(Integer)) }
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
-      sig { returns(T::Array[::Stripe::CreditNoteService::PreviewParams::Refund]) }
+      sig { returns(T.nilable(T::Array[::Stripe::CreditNoteService::PreviewParams::Refund])) }
       attr_accessor :refunds
       # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
-      sig { returns(::Stripe::CreditNoteService::PreviewParams::ShippingCost) }
+      sig { returns(T.nilable(::Stripe::CreditNoteService::PreviewParams::ShippingCost)) }
       attr_accessor :shipping_cost
       sig {
-        params(amount: Integer, credit_amount: Integer, effective_at: Integer, email_type: String, expand: T::Array[String], invoice: String, lines: T::Array[::Stripe::CreditNoteService::PreviewParams::Line], memo: String, metadata: T::Hash[String, String], out_of_band_amount: Integer, reason: String, refund: String, refund_amount: Integer, refunds: T::Array[::Stripe::CreditNoteService::PreviewParams::Refund], shipping_cost: ::Stripe::CreditNoteService::PreviewParams::ShippingCost).void
+        params(amount: T.nilable(Integer), credit_amount: T.nilable(Integer), effective_at: T.nilable(Integer), email_type: T.nilable(String), expand: T.nilable(T::Array[String]), invoice: String, lines: T.nilable(T::Array[::Stripe::CreditNoteService::PreviewParams::Line]), memo: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), out_of_band_amount: T.nilable(Integer), reason: T.nilable(String), refund_amount: T.nilable(Integer), refunds: T.nilable(T::Array[::Stripe::CreditNoteService::PreviewParams::Refund]), shipping_cost: T.nilable(::Stripe::CreditNoteService::PreviewParams::ShippingCost)).void
        }
       def initialize(
         amount: nil,
@@ -355,7 +352,6 @@ module Stripe
         metadata: nil,
         out_of_band_amount: nil,
         reason: nil,
-        refund: nil,
         refund_amount: nil,
         refunds: nil,
         shipping_cost: nil
@@ -363,9 +359,9 @@ module Stripe
     end
     class VoidCreditNoteParams < 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
     # Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces

data/rbi/stripe/services/customer_balance_transaction_service.rbi

@@ -6,19 +6,19 @@ module Stripe
   class CustomerBalanceTransactionService < StripeService
     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
@@ -30,38 +30,38 @@ module Stripe
       sig { returns(String) }
       attr_accessor :currency
       # An arbitrary string attached to the object. Often useful for displaying to users.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :description
       # 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(amount: Integer, currency: String, description: String, expand: T::Array[String], metadata: T.nilable(T::Hash[String, String])).void
+        params(amount: Integer, currency: String, description: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String])))).void
        }
       def initialize(amount: nil, currency: nil, description: nil, expand: nil, metadata: nil); end
     end
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
+      sig { params(expand: T.nilable(T::Array[String])).void }
       def initialize(expand: nil); end
     end
     class UpdateParams < Stripe::RequestParams
       # An arbitrary string attached to the object. Often useful for displaying to users.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :description
       # 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(description: String, expand: T::Array[String], metadata: T.nilable(T::Hash[String, String])).void
+        params(description: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String])))).void
        }
       def initialize(description: nil, expand: nil, metadata: nil); end
     end

data/rbi/stripe/services/customer_cash_balance_service.rbi

@@ -6,27 +6,27 @@ module Stripe
   class CustomerCashBalanceService < StripeService
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
+      sig { params(expand: T.nilable(T::Array[String])).void }
       def initialize(expand: nil); end
     end
     class UpdateParams < Stripe::RequestParams
       class Settings < Stripe::RequestParams
         # Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation).
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :reconciliation_mode
-        sig { params(reconciliation_mode: String).void }
+        sig { params(reconciliation_mode: T.nilable(String)).void }
         def initialize(reconciliation_mode: 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 hash of settings for this cash balance.
-      sig { returns(::Stripe::CustomerCashBalanceService::UpdateParams::Settings) }
+      sig { returns(T.nilable(::Stripe::CustomerCashBalanceService::UpdateParams::Settings)) }
       attr_accessor :settings
       sig {
-        params(expand: T::Array[String], settings: ::Stripe::CustomerCashBalanceService::UpdateParams::Settings).void
+        params(expand: T.nilable(T::Array[String]), settings: T.nilable(::Stripe::CustomerCashBalanceService::UpdateParams::Settings)).void
        }
       def initialize(expand: nil, settings: nil); end
     end

data/rbi/stripe/services/customer_cash_balance_transaction_service.rbi

@@ -6,27 +6,27 @@ module Stripe
   class CustomerCashBalanceTransactionService < StripeService
     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]) }
+      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
     # Returns a list of transactions that modified the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).

data/rbi/stripe/services/customer_funding_instructions_service.rbi

@@ -15,19 +15,19 @@ module Stripe
         end
         # Configuration for eu_bank_transfer funding type.
         sig {
-          returns(::Stripe::CustomerFundingInstructionsService::CreateParams::BankTransfer::EuBankTransfer)
+          returns(T.nilable(::Stripe::CustomerFundingInstructionsService::CreateParams::BankTransfer::EuBankTransfer))
          }
         attr_accessor :eu_bank_transfer
         # List of address types that should be returned in the financial_addresses response. If not specified, all valid types will be returned.
         #
         # Permitted values include: `sort_code`, `zengin`, `iban`, or `spei`.
-        sig { returns(T::Array[String]) }
+        sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :requested_address_types
         # The type of the `bank_transfer`
         sig { returns(String) }
         attr_accessor :type
         sig {
-          params(eu_bank_transfer: ::Stripe::CustomerFundingInstructionsService::CreateParams::BankTransfer::EuBankTransfer, requested_address_types: T::Array[String], type: String).void
+          params(eu_bank_transfer: T.nilable(::Stripe::CustomerFundingInstructionsService::CreateParams::BankTransfer::EuBankTransfer), requested_address_types: T.nilable(T::Array[String]), type: String).void
          }
         def initialize(eu_bank_transfer: nil, requested_address_types: nil, type: nil); end
       end
@@ -38,13 +38,13 @@ module Stripe
       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
       # The `funding_type` to get the instructions for.
       sig { returns(String) }
       attr_accessor :funding_type
       sig {
-        params(bank_transfer: ::Stripe::CustomerFundingInstructionsService::CreateParams::BankTransfer, currency: String, expand: T::Array[String], funding_type: String).void
+        params(bank_transfer: ::Stripe::CustomerFundingInstructionsService::CreateParams::BankTransfer, currency: String, expand: T.nilable(T::Array[String]), funding_type: String).void
        }
       def initialize(bank_transfer: nil, currency: nil, expand: nil, funding_type: nil); end
     end

data/rbi/stripe/services/customer_payment_method_service.rbi

@@ -6,25 +6,25 @@ module Stripe
   class CustomerPaymentMethodService < StripeService
     class ListParams < Stripe::RequestParams
       # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to `unspecified`.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :allow_redisplay
       # 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
       # An optional filter on the list, based on the object `type` field. Without the filter, the list includes all current and future payment method types. If your integration expects only one type of payment method in the response, make sure to provide a type value in the request.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :type
       sig {
-        params(allow_redisplay: String, ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String, type: String).void
+        params(allow_redisplay: T.nilable(String), 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(
         allow_redisplay: nil,
@@ -37,9 +37,9 @@ module Stripe
     end
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :expand
-      sig { params(expand: T::Array[String]).void }
+      sig { params(expand: T.nilable(T::Array[String])).void }
       def initialize(expand: nil); end
     end
     # Returns a list of PaymentMethods for a given Customer