stripe 5.55.0 → 13.5.1

data/lib/stripe/resources/tax/calculation.rb

@@ -0,0 +1,48 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # A Tax Calculation allows you to calculate the tax to collect from your customer.
+    #
+    # Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom)
+    class Calculation < APIResource
+      extend Stripe::APIOperations::Create
+
+      OBJECT_NAME = "tax.calculation"
+      def self.object_name
+        "tax.calculation"
+      end
+
+      # Calculates tax based on the input and returns a Tax Calculation object.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/tax/calculations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Retrieves the line items of a tax calculation as a collection, if the calculation hasn't expired.
+      def list_line_items(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: format("/v1/tax/calculations/%<calculation>s/line_items", { calculation: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Retrieves the line items of a tax calculation as a collection, if the calculation hasn't expired.
+      def self.list_line_items(calculation, params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: format("/v1/tax/calculations/%<calculation>s/line_items", { calculation: CGI.escape(calculation) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax/calculation_line_item.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    class CalculationLineItem < APIResource
+      OBJECT_NAME = "tax.calculation_line_item"
+      def self.object_name
+        "tax.calculation_line_item"
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax/registration.rb

@@ -0,0 +1,54 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://stripe.com/docs/tax).
+    #
+    # Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://stripe.com/docs/tax/registering).
+    #
+    # Related guide: [Using the Registrations API](https://stripe.com/docs/tax/registrations-api)
+    class Registration < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "tax.registration"
+      def self.object_name
+        "tax.registration"
+      end
+
+      # Creates a new Tax Registration object.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/tax/registrations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Returns a list of Tax Registration objects.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/tax/registrations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Updates an existing Tax Registration object.
+      #
+      # A registration cannot be deleted after it has been created. If you wish to end a registration you may do so by setting expires_at.
+      def self.update(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/tax/registrations/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax/settings.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # You can use Tax `Settings` to manage configurations used by Stripe Tax calculations.
+    #
+    # Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api)
+    class Settings < SingletonAPIResource
+      include Stripe::APIOperations::SingletonSave
+      OBJECT_NAME = "tax.settings"
+      def self.object_name
+        "tax.settings"
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax/transaction.rb

@@ -0,0 +1,56 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # A Tax Transaction records the tax collected from or refunded to your customer.
+    #
+    # Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom#tax-transaction)
+    class Transaction < APIResource
+      OBJECT_NAME = "tax.transaction"
+      def self.object_name
+        "tax.transaction"
+      end
+
+      # Creates a Tax Transaction from a calculation, if that calculation hasn't expired. Calculations expire after 90 days.
+      def self.create_from_calculation(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/tax/transactions/create_from_calculation",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Partially or fully reverses a previously created Transaction.
+      def self.create_reversal(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/tax/transactions/create_reversal",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Retrieves the line items of a committed standalone transaction as a collection.
+      def list_line_items(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: format("/v1/tax/transactions/%<transaction>s/line_items", { transaction: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Retrieves the line items of a committed standalone transaction as a collection.
+      def self.list_line_items(transaction, params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: format("/v1/tax/transactions/%<transaction>s/line_items", { transaction: CGI.escape(transaction) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax/transaction_line_item.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    class TransactionLineItem < APIResource
+      OBJECT_NAME = "tax.transaction_line_item"
+      def self.object_name
+        "tax.transaction_line_item"
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax_code.rb

@@ -2,9 +2,18 @@
 # frozen_string_literal: true
 
 module Stripe
+  # [Tax codes](https://stripe.com/docs/tax/tax-categories) classify goods and services for tax purposes.
   class TaxCode < APIResource
     extend Stripe::APIOperations::List
 
     OBJECT_NAME = "tax_code"
+    def self.object_name
+      "tax_code"
+    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.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/tax_codes", params: params, opts: opts)
+    end
   end
 end

data/lib/stripe/resources/tax_id.rb

@@ -2,26 +2,48 @@
 # frozen_string_literal: true
 
 module Stripe
+  # You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers) or account.
+  # Customer and account tax IDs get displayed on related invoices and credit notes.
+  #
+  # Related guides: [Customer tax identification numbers](https://stripe.com/docs/billing/taxes/tax-ids), [Account tax IDs](https://stripe.com/docs/invoicing/connect#account-tax-ids)
   class TaxId < APIResource
+    extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
 
     OBJECT_NAME = "tax_id"
+    def self.object_name
+      "tax_id"
+    end
+
+    # Creates a new account or customer tax_id object.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/tax_ids", params: params, opts: opts)
+    end
+
+    # Deletes an existing account or customer tax_id object.
+    def self.delete(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: format("/v1/tax_ids/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
 
-    def resource_url
-      if !respond_to?(:customer) || customer.nil?
-        raise NotImplementedError,
-              "Tax IDs cannot be accessed without a customer ID."
-      end
-      "#{Customer.resource_url}/#{CGI.escape(customer)}/tax_ids" \
-      "/#{CGI.escape(id)}"
+    # Deletes an existing account or customer tax_id object.
+    def delete(params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: format("/v1/tax_ids/%<id>s", { id: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
     end
 
-    def self.retrieve(_id, _opts = {})
-      raise NotImplementedError,
-            "Tax IDs cannot be retrieved without a customer ID. Retrieve a " \
-            "tax ID using `Customer.retrieve_tax_id('customer_id', " \
-            "'tax_id_id')`"
+    # Returns a list of tax IDs.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/tax_ids", params: params, opts: opts)
     end
   end
 end

data/lib/stripe/resources/tax_rate.rb

@@ -2,11 +2,37 @@
 # frozen_string_literal: true
 
 module Stripe
+  # Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+  #
+  # Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
   class TaxRate < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "tax_rate"
+    def self.object_name
+      "tax_rate"
+    end
+
+    # Creates a new tax rate.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/tax_rates", params: params, opts: 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.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/tax_rates", params: params, opts: opts)
+    end
+
+    # Updates an existing tax rate.
+    def self.update(tax_rate, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/tax_rates/%<tax_rate>s", { tax_rate: CGI.escape(tax_rate) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

data/lib/stripe/resources/terminal/configuration.rb

@@ -3,6 +3,7 @@
 
 module Stripe
   module Terminal
+    # A Configurations object represents how features should be configured for terminal readers.
     class Configuration < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
@@ -10,6 +11,59 @@ module Stripe
       include Stripe::APIOperations::Save
 
       OBJECT_NAME = "terminal.configuration"
+      def self.object_name
+        "terminal.configuration"
+      end
+
+      # Creates a new Configuration object.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/terminal/configurations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Deletes a Configuration object.
+      def self.delete(configuration, params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/terminal/configurations/%<configuration>s", { configuration: CGI.escape(configuration) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Deletes a Configuration object.
+      def delete(params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/terminal/configurations/%<configuration>s", { configuration: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Returns a list of Configuration objects.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/terminal/configurations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Updates a new Configuration object.
+      def self.update(configuration, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/configurations/%<configuration>s", { configuration: CGI.escape(configuration) }),
+          params: params,
+          opts: opts
+        )
+      end
     end
   end
 end

data/lib/stripe/resources/terminal/connection_token.rb

@@ -3,10 +3,26 @@
 
 module Stripe
   module Terminal
+    # A Connection Token is used by the Stripe Terminal SDK to connect to a reader.
+    #
+    # Related guide: [Fleet management](https://stripe.com/docs/terminal/fleet/locations)
     class ConnectionToken < APIResource
       extend Stripe::APIOperations::Create
 
       OBJECT_NAME = "terminal.connection_token"
+      def self.object_name
+        "terminal.connection_token"
+      end
+
+      # To connect to a reader the Stripe Terminal SDK needs to retrieve a short-lived connection token from Stripe, proxied through your server. On your backend, add an endpoint that creates and returns a connection token.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/terminal/connection_tokens",
+          params: params,
+          opts: opts
+        )
+      end
     end
   end
 end

data/lib/stripe/resources/terminal/location.rb

@@ -3,6 +3,9 @@
 
 module Stripe
   module Terminal
+    # A Location represents a grouping of readers.
+    #
+    # Related guide: [Fleet management](https://stripe.com/docs/terminal/fleet/locations)
     class Location < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
@@ -10,6 +13,60 @@ module Stripe
       include Stripe::APIOperations::Save
 
       OBJECT_NAME = "terminal.location"
+      def self.object_name
+        "terminal.location"
+      end
+
+      # Creates a new Location object.
+      # For further details, including which address fields are required in each country, see the [Manage locations](https://stripe.com/docs/terminal/fleet/locations) guide.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/terminal/locations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Deletes a Location object.
+      def self.delete(location, params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/terminal/locations/%<location>s", { location: CGI.escape(location) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Deletes a Location object.
+      def delete(params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/terminal/locations/%<location>s", { location: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Returns a list of Location objects.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/terminal/locations",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Updates a Location object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
+      def self.update(location, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/locations/%<location>s", { location: CGI.escape(location) }),
+          params: params,
+          opts: opts
+        )
+      end
     end
   end
 end