stripe 10.1.0 → 12.6.0

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

@@ -14,6 +14,41 @@ module Stripe
       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(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/tax/registrations",
+          params: filters,
+          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

@@ -7,9 +7,11 @@ module Stripe
     #
     # Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api)
     class Settings < SingletonAPIResource
-      include Stripe::APIOperations::Save
-
+      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

@@ -8,16 +8,11 @@ module Stripe
     # 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 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
-        )
+      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,
@@ -27,6 +22,7 @@ module Stripe
         )
       end
 
+      # Partially or fully reverses a previously created Transaction.
       def self.create_reversal(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -36,6 +32,17 @@ module Stripe
         )
       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,

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

@@ -5,6 +5,9 @@ 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

@@ -7,5 +7,13 @@ module Stripe
     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(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/tax_codes", params: filters, opts: opts)
+    end
   end
 end

data/lib/stripe/resources/tax_id.rb

@@ -7,25 +7,43 @@ module Stripe
   #
   # 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(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/tax_ids", params: filters, opts: opts)
     end
   end
 end

data/lib/stripe/resources/tax_rate.rb

@@ -11,5 +11,28 @@ module Stripe
     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(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/tax_rates", params: filters, opts: opts)
+    end
+
+    # Updates an existing tax rate.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/tax_rates/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

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

@@ -11,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(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/terminal/configurations/%<id>s", { id: CGI.escape(id) }),
+          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(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/terminal/configurations",
+          params: filters,
+          opts: opts
+        )
+      end
+
+      # Updates a new Configuration object.
+      def self.update(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/configurations/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
     end
   end
 end

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

@@ -10,6 +10,19 @@ module Stripe
       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

@@ -13,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(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/terminal/locations/%<id>s", { id: CGI.escape(id) }),
+          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(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/terminal/locations",
+          params: filters,
+          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(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/locations/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
     end
   end
 end

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

@@ -13,7 +13,11 @@ module Stripe
       include Stripe::APIOperations::Save
 
       OBJECT_NAME = "terminal.reader"
+      def self.object_name
+        "terminal.reader"
+      end
 
+      # Cancels the current reader action.
       def cancel_action(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -23,51 +27,67 @@ module Stripe
         )
       end
 
-      def process_payment_intent(params = {}, opts = {})
+      # Cancels the current reader action.
+      def self.cancel_action(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
-          path: format("/v1/terminal/readers/%<reader>s/process_payment_intent", { reader: CGI.escape(self["id"]) }),
+          path: format("/v1/terminal/readers/%<reader>s/cancel_action", { reader: CGI.escape(reader) }),
           params: params,
           opts: opts
         )
       end
 
-      def process_setup_intent(params = {}, opts = {})
+      # Creates a new Reader object.
+      def self.create(params = {}, opts = {})
         request_stripe_object(
           method: :post,
-          path: format("/v1/terminal/readers/%<reader>s/process_setup_intent", { reader: CGI.escape(self["id"]) }),
+          path: "/v1/terminal/readers",
           params: params,
           opts: opts
         )
       end
 
-      def refund_payment(params = {}, opts = {})
+      # Deletes a Reader object.
+      def self.delete(id, params = {}, opts = {})
         request_stripe_object(
-          method: :post,
-          path: format("/v1/terminal/readers/%<reader>s/refund_payment", { reader: CGI.escape(self["id"]) }),
+          method: :delete,
+          path: format("/v1/terminal/readers/%<id>s", { id: CGI.escape(id) }),
           params: params,
           opts: opts
         )
       end
 
-      def set_reader_display(params = {}, opts = {})
+      # Deletes a Reader object.
+      def delete(params = {}, opts = {})
         request_stripe_object(
-          method: :post,
-          path: format("/v1/terminal/readers/%<reader>s/set_reader_display", { reader: CGI.escape(self["id"]) }),
+          method: :delete,
+          path: format("/v1/terminal/readers/%<reader>s", { reader: CGI.escape(self["id"]) }),
           params: params,
           opts: opts
         )
       end
 
-      def self.cancel_action(reader, params = {}, opts = {})
+      # Returns a list of Reader objects.
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/terminal/readers",
+          params: filters,
+          opts: opts
+        )
+      end
+
+      # Initiates a payment flow on a Reader.
+      def process_payment_intent(params = {}, opts = {})
         request_stripe_object(
           method: :post,
-          path: format("/v1/terminal/readers/%<reader>s/cancel_action", { reader: CGI.escape(reader) }),
+          path: format("/v1/terminal/readers/%<reader>s/process_payment_intent", { reader: CGI.escape(self["id"]) }),
           params: params,
           opts: opts
         )
       end
 
+      # Initiates a payment flow on a Reader.
       def self.process_payment_intent(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -77,6 +97,17 @@ module Stripe
         )
       end
 
+      # Initiates a setup intent flow on a Reader.
+      def process_setup_intent(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/process_setup_intent", { reader: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Initiates a setup intent flow on a Reader.
       def self.process_setup_intent(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -86,6 +117,17 @@ module Stripe
         )
       end
 
+      # Initiates a refund on a Reader
+      def refund_payment(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/refund_payment", { reader: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Initiates a refund on a Reader
       def self.refund_payment(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -95,6 +137,17 @@ module Stripe
         )
       end
 
+      # Sets reader display to show cart details.
+      def set_reader_display(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/set_reader_display", { reader: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Sets reader display to show cart details.
       def self.set_reader_display(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -104,13 +157,27 @@ module Stripe
         )
       end
 
+      # Updates a Reader object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
+      def self.update(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/terminal/readers/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+
       def test_helpers
         TestHelpers.new(self)
       end
 
       class TestHelpers < APIResourceTestHelpers
         RESOURCE_CLASS = Reader
+        def self.resource_class
+          "Reader"
+        end
 
+        # Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
         def self.present_payment_method(reader, params = {}, opts = {})
           request_stripe_object(
             method: :post,
@@ -120,6 +187,7 @@ module Stripe
           )
         end
 
+        # Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
         def present_payment_method(params = {}, opts = {})
           @resource.request_stripe_object(
             method: :post,

data/lib/stripe/resources/test_helpers/test_clock.rb

@@ -12,7 +12,11 @@ module Stripe
       extend Stripe::APIOperations::List
 
       OBJECT_NAME = "test_helpers.test_clock"
+      def self.object_name
+        "test_helpers.test_clock"
+      end
 
+      # Starts advancing a test clock to a specified time in the future. Advancement is done when status changes to Ready.
       def advance(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -22,6 +26,7 @@ module Stripe
         )
       end
 
+      # Starts advancing a test clock to a specified time in the future. Advancement is done when status changes to Ready.
       def self.advance(test_clock, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -30,6 +35,46 @@ module Stripe
           opts: opts
         )
       end
+
+      # Creates a new test clock that can be attached to new customers and quotes.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/test_helpers/test_clocks",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Deletes a test clock.
+      def self.delete(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/test_helpers/test_clocks/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Deletes a test clock.
+      def delete(params = {}, opts = {})
+        request_stripe_object(
+          method: :delete,
+          path: format("/v1/test_helpers/test_clocks/%<test_clock>s", { test_clock: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Returns a list of your test clocks.
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/test_helpers/test_clocks",
+          params: filters,
+          opts: opts
+        )
+      end
     end
   end
 end

data/lib/stripe/resources/token.rb

@@ -19,12 +19,21 @@ module Stripe
   #
   # You can't store or use tokens more than once. To store card or bank account
   # information for later use, create [Customer](https://stripe.com/docs/api#customers)
-  # objects or [Custom accounts](https://stripe.com/docs/api#external_accounts).
+  # objects or [External accounts](https://stripe.com/api#external_accounts).
   # [Radar](https://stripe.com/docs/radar), our integrated solution for automatic fraud protection,
   # performs best with integrations that use client-side tokenization.
   class Token < APIResource
     extend Stripe::APIOperations::Create
 
     OBJECT_NAME = "token"
+    def self.object_name
+      "token"
+    end
+
+    # Creates a single-use token that represents a bank account's details.
+    # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/tokens", params: params, opts: opts)
+    end
   end
 end

data/lib/stripe/resources/topup.rb

@@ -13,7 +13,11 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "topup"
+    def self.object_name
+      "topup"
+    end
 
+    # Cancels a top-up. Only pending top-ups can be canceled.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -23,6 +27,7 @@ module Stripe
       )
     end
 
+    # Cancels a top-up. Only pending top-ups can be canceled.
     def self.cancel(topup, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -31,5 +36,25 @@ module Stripe
         opts: opts
       )
     end
+
+    # Top up the balance of an account
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/topups", params: params, opts: opts)
+    end
+
+    # Returns a list of top-ups.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/topups", params: filters, opts: opts)
+    end
+
+    # Updates the metadata of a top-up. Other top-up details are not editable by design.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/topups/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end