stripe 13.3.0 → 13.4.0.pre.beta.2

data/rbi/stripe/services/tax/settings_service.rbi

@@ -0,0 +1,93 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Tax
+    class SettingsService < StripeService
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class UpdateParams < Stripe::RequestParams
+        class Defaults < Stripe::RequestParams
+          # Specifies the default [tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#tax-behavior) to be used when the item's price has unspecified tax behavior. One of inclusive, exclusive, or inferred_by_currency. Once specified, it cannot be changed back to null.
+          sig { returns(String) }
+          attr_accessor :tax_behavior
+          # A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
+          sig { returns(String) }
+          attr_accessor :tax_code
+          sig { params(tax_behavior: String, tax_code: String).void }
+          def initialize(tax_behavior: nil, tax_code: nil); end
+        end
+        class HeadOffice < Stripe::RequestParams
+          class Address < Stripe::RequestParams
+            # City, district, suburb, town, or village.
+            sig { returns(String) }
+            attr_accessor :city
+            # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+            sig { returns(String) }
+            attr_accessor :country
+            # Address line 1 (e.g., street, PO Box, or company name).
+            sig { returns(String) }
+            attr_accessor :line1
+            # Address line 2 (e.g., apartment, suite, unit, or building).
+            sig { returns(String) }
+            attr_accessor :line2
+            # ZIP or postal code.
+            sig { returns(String) }
+            attr_accessor :postal_code
+            # State/province as an [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) subdivision code, without country prefix. Example: "NY" or "TX".
+            sig { returns(String) }
+            attr_accessor :state
+            sig {
+              params(city: String, country: String, line1: String, line2: String, postal_code: String, state: String).void
+             }
+            def initialize(
+              city: nil,
+              country: nil,
+              line1: nil,
+              line2: nil,
+              postal_code: nil,
+              state: nil
+            ); end
+          end
+          # The location of the business for tax purposes.
+          sig { returns(::Stripe::Tax::SettingsService::UpdateParams::HeadOffice::Address) }
+          attr_accessor :address
+          sig {
+            params(address: ::Stripe::Tax::SettingsService::UpdateParams::HeadOffice::Address).void
+           }
+          def initialize(address: nil); end
+        end
+        # Default configuration to be used on Stripe Tax calculations.
+        sig { returns(::Stripe::Tax::SettingsService::UpdateParams::Defaults) }
+        attr_accessor :defaults
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The place where your business is located.
+        sig { returns(::Stripe::Tax::SettingsService::UpdateParams::HeadOffice) }
+        attr_accessor :head_office
+        sig {
+          params(defaults: ::Stripe::Tax::SettingsService::UpdateParams::Defaults, expand: T::Array[String], head_office: ::Stripe::Tax::SettingsService::UpdateParams::HeadOffice).void
+         }
+        def initialize(defaults: nil, expand: nil, head_office: nil); end
+      end
+      # Retrieves Tax Settings for a merchant.
+      sig {
+        params(params: T.any(::Stripe::Tax::SettingsService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Tax::Settings)
+       }
+      def retrieve(params = {}, opts = {}); end
+
+      # Updates Tax Settings parameters used in tax calculations. All parameters are editable but none can be removed once set.
+      sig {
+        params(params: T.any(::Stripe::Tax::SettingsService::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Tax::Settings)
+       }
+      def update(params = {}, opts = {}); end
+    end
+  end
+end

data/rbi/stripe/services/tax/transaction_line_item_service.rbi

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Tax
+    class TransactionLineItemService < 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) }
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        sig { returns(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) }
+        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) }
+        attr_accessor :starting_after
+        sig {
+          params(ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+         }
+        def initialize(ending_before: nil, expand: nil, limit: nil, starting_after: nil); end
+      end
+      # Retrieves the line items of a committed standalone transaction as a collection.
+      sig {
+        params(transaction: String, params: T.any(::Stripe::Tax::TransactionLineItemService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def list(transaction, params = {}, opts = {}); end
+    end
+  end
+end

data/rbi/stripe/services/tax/transaction_service.rbi

@@ -0,0 +1,142 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Tax
+    class TransactionService < StripeService
+      attr_reader :line_items
+      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 CreateFromCalculationParams < Stripe::RequestParams
+        # Tax Calculation ID to be used as input when creating the transaction.
+        sig { returns(String) }
+        attr_accessor :calculation
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+        sig { returns(T::Hash[String, String]) }
+        attr_accessor :metadata
+        # The Unix timestamp representing when the tax liability is assumed or reduced, which determines the liability posting period and handling in tax liability reports. The timestamp must fall within the `tax_date` and the current time, unless the `tax_date` is scheduled in advance. Defaults to the current time.
+        sig { returns(Integer) }
+        attr_accessor :posted_at
+        # A custom order or sale identifier, such as 'myOrder_123'. Must be unique across all transactions, including reversals.
+        sig { returns(String) }
+        attr_accessor :reference
+        sig {
+          params(calculation: String, expand: T::Array[String], metadata: T::Hash[String, String], posted_at: Integer, reference: String).void
+         }
+        def initialize(
+          calculation: nil,
+          expand: nil,
+          metadata: nil,
+          posted_at: nil,
+          reference: nil
+        ); end
+      end
+      class CreateReversalParams < Stripe::RequestParams
+        class LineItem < Stripe::RequestParams
+          # The amount to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+          sig { returns(Integer) }
+          attr_accessor :amount
+          # The amount of tax to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+          sig { returns(Integer) }
+          attr_accessor :amount_tax
+          # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+          sig { returns(T::Hash[String, String]) }
+          attr_accessor :metadata
+          # The `id` of the line item to reverse in the original transaction.
+          sig { returns(String) }
+          attr_accessor :original_line_item
+          # The quantity reversed. Appears in [tax exports](https://stripe.com/docs/tax/reports), but does not affect the amount of tax reversed.
+          sig { returns(Integer) }
+          attr_accessor :quantity
+          # A custom identifier for this line item in the reversal transaction, such as 'L1-refund'.
+          sig { returns(String) }
+          attr_accessor :reference
+          sig {
+            params(amount: Integer, amount_tax: Integer, metadata: T::Hash[String, String], original_line_item: String, quantity: Integer, reference: String).void
+           }
+          def initialize(
+            amount: nil,
+            amount_tax: nil,
+            metadata: nil,
+            original_line_item: nil,
+            quantity: nil,
+            reference: nil
+          ); end
+        end
+        class ShippingCost < Stripe::RequestParams
+          # The amount to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+          sig { returns(Integer) }
+          attr_accessor :amount
+          # The amount of tax to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+          sig { returns(Integer) }
+          attr_accessor :amount_tax
+          sig { params(amount: Integer, amount_tax: Integer).void }
+          def initialize(amount: nil, amount_tax: nil); end
+        end
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # A flat amount to reverse across the entire transaction, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. This value represents the total amount to refund from the transaction, including taxes.
+        sig { returns(Integer) }
+        attr_accessor :flat_amount
+        # The line item amounts to reverse.
+        sig { returns(T::Array[::Stripe::Tax::TransactionService::CreateReversalParams::LineItem]) }
+        attr_accessor :line_items
+        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+        sig { returns(T::Hash[String, String]) }
+        attr_accessor :metadata
+        # If `partial`, the provided line item or shipping cost amounts are reversed. If `full`, the original transaction is fully reversed.
+        sig { returns(String) }
+        attr_accessor :mode
+        # The ID of the Transaction to partially or fully reverse.
+        sig { returns(String) }
+        attr_accessor :original_transaction
+        # A custom identifier for this reversal, such as `myOrder_123-refund_1`, which must be unique across all transactions. The reference helps identify this reversal transaction in exported [tax reports](https://stripe.com/docs/tax/reports).
+        sig { returns(String) }
+        attr_accessor :reference
+        # The shipping cost to reverse.
+        sig { returns(::Stripe::Tax::TransactionService::CreateReversalParams::ShippingCost) }
+        attr_accessor :shipping_cost
+        sig {
+          params(expand: T::Array[String], flat_amount: Integer, line_items: T::Array[::Stripe::Tax::TransactionService::CreateReversalParams::LineItem], metadata: T::Hash[String, String], mode: String, original_transaction: String, reference: String, shipping_cost: ::Stripe::Tax::TransactionService::CreateReversalParams::ShippingCost).void
+         }
+        def initialize(
+          expand: nil,
+          flat_amount: nil,
+          line_items: nil,
+          metadata: nil,
+          mode: nil,
+          original_transaction: nil,
+          reference: nil,
+          shipping_cost: nil
+        ); end
+      end
+      # Creates a Tax Transaction from a calculation, if that calculation hasn't expired. Calculations expire after 90 days.
+      sig {
+        params(params: T.any(::Stripe::Tax::TransactionService::CreateFromCalculationParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Tax::Transaction)
+       }
+      def create_from_calculation(params = {}, opts = {}); end
+
+      # Partially or fully reverses a previously created Transaction.
+      sig {
+        params(params: T.any(::Stripe::Tax::TransactionService::CreateReversalParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Tax::Transaction)
+       }
+      def create_reversal(params = {}, opts = {}); end
+
+      # Retrieves a Tax Transaction object.
+      sig {
+        params(transaction: String, params: T.any(::Stripe::Tax::TransactionService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Tax::Transaction)
+       }
+      def retrieve(transaction, params = {}, opts = {}); end
+    end
+  end
+end

data/rbi/stripe/services/tax_code_service.rbi

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  class TaxCodeService < 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) }
+      attr_accessor :ending_before
+      # Specifies which fields in the response should be expanded.
+      sig { returns(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) }
+      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) }
+      attr_accessor :starting_after
+      sig {
+        params(ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+       }
+      def initialize(ending_before: nil, expand: nil, limit: nil, starting_after: nil); end
+    end
+    class RetrieveParams < Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      sig { params(expand: T::Array[String]).void }
+      def initialize(expand: nil); end
+    end
+    # A list of [all tax codes available](https://stripe.com/docs/tax/tax-categories) to add to Products in order to allow specific tax calculations.
+    sig {
+      params(params: T.any(::Stripe::TaxCodeService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+     }
+    def list(params = {}, opts = {}); end
+
+    # Retrieves the details of an existing tax code. Supply the unique tax code ID and Stripe will return the corresponding tax code information.
+    sig {
+      params(id: String, params: T.any(::Stripe::TaxCodeService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxCode)
+     }
+    def retrieve(id, params = {}, opts = {}); end
+  end
+end

data/rbi/stripe/services/tax_id_service.rbi

@@ -0,0 +1,112 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  class TaxIdService < StripeService
+    class DeleteParams < Stripe::RequestParams
+
+    end
+    class RetrieveParams < Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      sig { params(expand: T::Array[String]).void }
+      def initialize(expand: nil); end
+    end
+    class ListParams < Stripe::RequestParams
+      class Owner < Stripe::RequestParams
+        # Account the tax ID belongs to. Required when `type=account`
+        sig { returns(String) }
+        attr_accessor :account
+        # Customer the tax ID belongs to. Required when `type=customer`
+        sig { returns(String) }
+        attr_accessor :customer
+        # Type of owner referenced.
+        sig { returns(String) }
+        attr_accessor :type
+        sig { params(account: String, customer: String, type: String).void }
+        def initialize(account: nil, customer: nil, type: nil); end
+      end
+      # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
+      sig { returns(String) }
+      attr_accessor :ending_before
+      # Specifies which fields in the response should be expanded.
+      sig { returns(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) }
+      attr_accessor :limit
+      # The account or customer the tax ID belongs to. Defaults to `owner[type]=self`.
+      sig { returns(::Stripe::TaxIdService::ListParams::Owner) }
+      attr_accessor :owner
+      # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
+      sig { returns(String) }
+      attr_accessor :starting_after
+      sig {
+        params(ending_before: String, expand: T::Array[String], limit: Integer, owner: ::Stripe::TaxIdService::ListParams::Owner, starting_after: String).void
+       }
+      def initialize(
+        ending_before: nil,
+        expand: nil,
+        limit: nil,
+        owner: nil,
+        starting_after: nil
+      ); end
+    end
+    class CreateParams < Stripe::RequestParams
+      class Owner < Stripe::RequestParams
+        # Account the tax ID belongs to. Required when `type=account`
+        sig { returns(String) }
+        attr_accessor :account
+        # Customer the tax ID belongs to. Required when `type=customer`
+        sig { returns(String) }
+        attr_accessor :customer
+        # Type of owner referenced.
+        sig { returns(String) }
+        attr_accessor :type
+        sig { params(account: String, customer: String, type: String).void }
+        def initialize(account: nil, customer: nil, type: nil); end
+      end
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      # The account or customer the tax ID belongs to. Defaults to `owner[type]=self`.
+      sig { returns(::Stripe::TaxIdService::CreateParams::Owner) }
+      attr_accessor :owner
+      # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `ba_tin`, `bb_tin`, `bg_uic`, `bh_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cn_tin`, `co_nit`, `cr_tin`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kh_tin`, `kr_brn`, `kz_bin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
+      sig { returns(String) }
+      attr_accessor :type
+      # Value of the tax ID.
+      sig { returns(String) }
+      attr_accessor :value
+      sig {
+        params(expand: T::Array[String], owner: ::Stripe::TaxIdService::CreateParams::Owner, type: String, value: String).void
+       }
+      def initialize(expand: nil, owner: nil, type: nil, value: nil); end
+    end
+    # Creates a new account or customer tax_id object.
+    sig {
+      params(params: T.any(::Stripe::TaxIdService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxId)
+     }
+    def create(params = {}, opts = {}); end
+
+    # Deletes an existing account or customer tax_id object.
+    sig {
+      params(id: String, params: T.any(::Stripe::TaxIdService::DeleteParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxId)
+     }
+    def delete(id, params = {}, opts = {}); end
+
+    # Returns a list of tax IDs.
+    sig {
+      params(params: T.any(::Stripe::TaxIdService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+     }
+    def list(params = {}, opts = {}); end
+
+    # Retrieves an account or customer tax_id object.
+    sig {
+      params(id: String, params: T.any(::Stripe::TaxIdService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxId)
+     }
+    def retrieve(id, params = {}, opts = {}); end
+  end
+end

data/rbi/stripe/services/tax_rate_service.rbi

@@ -0,0 +1,183 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  class TaxRateService < StripeService
+    class ListParams < Stripe::RequestParams
+      class Created < Stripe::RequestParams
+        # Minimum value to filter by (exclusive)
+        sig { returns(Integer) }
+        attr_accessor :gt
+        # Minimum value to filter by (inclusive)
+        sig { returns(Integer) }
+        attr_accessor :gte
+        # Maximum value to filter by (exclusive)
+        sig { returns(Integer) }
+        attr_accessor :lt
+        # Maximum value to filter by (inclusive)
+        sig { returns(Integer) }
+        attr_accessor :lte
+        sig { params(gt: Integer, gte: Integer, lt: Integer, lte: Integer).void }
+        def initialize(gt: nil, gte: nil, lt: nil, lte: nil); end
+      end
+      # Optional flag to filter by tax rates that are either active or inactive (archived).
+      sig { returns(T::Boolean) }
+      attr_accessor :active
+      # Optional range for filtering created date.
+      sig { returns(T.any(::Stripe::TaxRateService::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) }
+      attr_accessor :ending_before
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      # Optional flag to filter by tax rates that are inclusive (or those that are not inclusive).
+      sig { returns(T::Boolean) }
+      attr_accessor :inclusive
+      # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+      sig { returns(Integer) }
+      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) }
+      attr_accessor :starting_after
+      sig {
+        params(active: T::Boolean, created: T.any(::Stripe::TaxRateService::ListParams::Created, Integer), ending_before: String, expand: T::Array[String], inclusive: T::Boolean, limit: Integer, starting_after: String).void
+       }
+      def initialize(
+        active: nil,
+        created: nil,
+        ending_before: nil,
+        expand: nil,
+        inclusive: nil,
+        limit: nil,
+        starting_after: nil
+      ); end
+    end
+    class CreateParams < Stripe::RequestParams
+      # Flag determining whether the tax rate is active or inactive (archived). Inactive tax rates cannot be used with new applications or Checkout Sessions, but will still work for subscriptions and invoices that already have it set.
+      sig { returns(T::Boolean) }
+      attr_accessor :active
+      # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+      sig { returns(String) }
+      attr_accessor :country
+      # An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
+      sig { returns(String) }
+      attr_accessor :description
+      # The display name of the tax rate, which will be shown to users.
+      sig { returns(String) }
+      attr_accessor :display_name
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      # This specifies if the tax rate is inclusive or exclusive.
+      sig { returns(T::Boolean) }
+      attr_accessor :inclusive
+      # The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer’s invoice.
+      sig { returns(String) }
+      attr_accessor :jurisdiction
+      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+      sig { returns(T::Hash[String, String]) }
+      attr_accessor :metadata
+      # This represents the tax rate percent out of 100.
+      sig { returns(Float) }
+      attr_accessor :percentage
+      # [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix. For example, "NY" for New York, United States.
+      sig { returns(String) }
+      attr_accessor :state
+      # The high-level tax type, such as `vat` or `sales_tax`.
+      sig { returns(String) }
+      attr_accessor :tax_type
+      sig {
+        params(active: T::Boolean, country: String, description: String, display_name: String, expand: T::Array[String], inclusive: T::Boolean, jurisdiction: String, metadata: T::Hash[String, String], percentage: Float, state: String, tax_type: String).void
+       }
+      def initialize(
+        active: nil,
+        country: nil,
+        description: nil,
+        display_name: nil,
+        expand: nil,
+        inclusive: nil,
+        jurisdiction: nil,
+        metadata: nil,
+        percentage: nil,
+        state: nil,
+        tax_type: nil
+      ); end
+    end
+    class RetrieveParams < Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      sig { params(expand: T::Array[String]).void }
+      def initialize(expand: nil); end
+    end
+    class UpdateParams < Stripe::RequestParams
+      # Flag determining whether the tax rate is active or inactive (archived). Inactive tax rates cannot be used with new applications or Checkout Sessions, but will still work for subscriptions and invoices that already have it set.
+      sig { returns(T::Boolean) }
+      attr_accessor :active
+      # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+      sig { returns(String) }
+      attr_accessor :country
+      # An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
+      sig { returns(String) }
+      attr_accessor :description
+      # The display name of the tax rate, which will be shown to users.
+      sig { returns(String) }
+      attr_accessor :display_name
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T::Array[String]) }
+      attr_accessor :expand
+      # The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer’s invoice.
+      sig { returns(String) }
+      attr_accessor :jurisdiction
+      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :metadata
+      # [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix. For example, "NY" for New York, United States.
+      sig { returns(String) }
+      attr_accessor :state
+      # The high-level tax type, such as `vat` or `sales_tax`.
+      sig { returns(String) }
+      attr_accessor :tax_type
+      sig {
+        params(active: T::Boolean, country: String, description: String, display_name: String, expand: T::Array[String], jurisdiction: String, metadata: T.nilable(T::Hash[String, String]), state: String, tax_type: String).void
+       }
+      def initialize(
+        active: nil,
+        country: nil,
+        description: nil,
+        display_name: nil,
+        expand: nil,
+        jurisdiction: nil,
+        metadata: nil,
+        state: nil,
+        tax_type: nil
+      ); end
+    end
+    # Creates a new tax rate.
+    sig {
+      params(params: T.any(::Stripe::TaxRateService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxRate)
+     }
+    def create(params = {}, opts = {}); end
+
+    # Returns a list of your tax rates. Tax rates are returned sorted by creation date, with the most recently created tax rates appearing first.
+    sig {
+      params(params: T.any(::Stripe::TaxRateService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+     }
+    def list(params = {}, opts = {}); end
+
+    # Retrieves a tax rate with the given ID
+    sig {
+      params(tax_rate: String, params: T.any(::Stripe::TaxRateService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxRate)
+     }
+    def retrieve(tax_rate, params = {}, opts = {}); end
+
+    # Updates an existing tax rate.
+    sig {
+      params(tax_rate: String, params: T.any(::Stripe::TaxRateService::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::TaxRate)
+     }
+    def update(tax_rate, params = {}, opts = {}); end
+  end
+end

data/rbi/stripe/services/tax_service.rbi

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  class TaxService < StripeService
+    attr_reader :associations
+    attr_reader :calculations
+    attr_reader :forms
+    attr_reader :registrations
+    attr_reader :settings
+    attr_reader :transactions
+  end
+end