stripe 10.1.0 → 12.6.0

data/lib/stripe/resources/review.rb

@@ -10,7 +10,11 @@ module Stripe
     extend Stripe::APIOperations::List
 
     OBJECT_NAME = "review"
+    def self.object_name
+      "review"
+    end
 
+    # Approves a Review object, closing it and removing it from the list of reviews.
     def approve(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -20,6 +24,7 @@ module Stripe
       )
     end
 
+    # Approves a Review object, closing it and removing it from the list of reviews.
     def self.approve(review, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -28,5 +33,10 @@ module Stripe
         opts: opts
       )
     end
+
+    # Returns a list of Review objects that have open set to true. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/reviews", params: filters, opts: opts)
+    end
   end
 end

data/lib/stripe/resources/setup_attempt.rb

@@ -10,5 +10,13 @@ module Stripe
     extend Stripe::APIOperations::List
 
     OBJECT_NAME = "setup_attempt"
+    def self.object_name
+      "setup_attempt"
+    end
+
+    # Returns a list of SetupAttempts that associate with a provided SetupIntent.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/setup_attempts", params: filters, opts: opts)
+    end
   end
 end

data/lib/stripe/resources/setup_intent.rb

@@ -8,13 +8,13 @@ module Stripe
   #
   # Create a SetupIntent when you're ready to collect your customer's payment credentials.
   # Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid.
-  # The SetupIntent transitions through multiple [statuses](https://stripe.com/docs/payments/intents#intent-statuses) as it guides
+  # The SetupIntent transitions through multiple [statuses](https://docs.stripe.com/payments/intents#intent-statuses) as it guides
   # you through the setup process.
   #
   # Successful SetupIntents result in payment credentials that are optimized for future payments.
   # For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through
-  # [Strong Customer Authentication](https://stripe.com/docs/strong-customer-authentication) during payment method collection
-  # to streamline later [off-session payments](https://stripe.com/docs/payments/setup-intents).
+  # [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection
+  # to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents).
   # If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer),
   # it automatically attaches the resulting payment method to that Customer after successful setup.
   # We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on
@@ -22,14 +22,20 @@ module Stripe
   #
   # By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
   #
-  # Related guide: [Setup Intents API](https://stripe.com/docs/payments/setup-intents)
+  # Related guide: [Setup Intents API](https://docs.stripe.com/payments/setup-intents)
   class SetupIntent < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "setup_intent"
+    def self.object_name
+      "setup_intent"
+    end
 
+    # You can cancel a SetupIntent object when it's in one of these statuses: requires_payment_method, requires_confirmation, or requires_action.
+    #
+    # After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error. You can't cancel the SetupIntent for a Checkout Session. [Expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -39,6 +45,32 @@ module Stripe
       )
     end
 
+    # You can cancel a SetupIntent object when it's in one of these statuses: requires_payment_method, requires_confirmation, or requires_action.
+    #
+    # After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error. You can't cancel the SetupIntent for a Checkout Session. [Expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead.
+    def self.cancel(intent, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/cancel", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Confirm that your customer intends to set up the current or
+    # provided payment method. For example, you would confirm a SetupIntent
+    # when a customer hits the “Save” button on a payment method management
+    # page on your website.
+    #
+    # If the selected payment method does not require any additional
+    # steps from the customer, the SetupIntent will transition to the
+    # succeeded status.
+    #
+    # Otherwise, it will transition to the requires_action status and
+    # suggest additional actions via next_action. If setup fails,
+    # the SetupIntent will transition to the
+    # requires_payment_method status or the canceled status if the
+    # confirmation limit is reached.
     def confirm(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -48,33 +80,63 @@ module Stripe
       )
     end
 
-    def verify_microdeposits(params = {}, opts = {})
+    # Confirm that your customer intends to set up the current or
+    # provided payment method. For example, you would confirm a SetupIntent
+    # when a customer hits the “Save” button on a payment method management
+    # page on your website.
+    #
+    # If the selected payment method does not require any additional
+    # steps from the customer, the SetupIntent will transition to the
+    # succeeded status.
+    #
+    # Otherwise, it will transition to the requires_action status and
+    # suggest additional actions via next_action. If setup fails,
+    # the SetupIntent will transition to the
+    # requires_payment_method status or the canceled status if the
+    # confirmation limit is reached.
+    def self.confirm(intent, params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(self["id"]) }),
+        path: format("/v1/setup_intents/%<intent>s/confirm", { intent: CGI.escape(intent) }),
         params: params,
         opts: opts
       )
     end
 
-    def self.cancel(intent, params = {}, opts = {})
+    # Creates a SetupIntent object.
+    #
+    # After you create the SetupIntent, attach a payment method and [confirm](https://stripe.com/docs/api/setup_intents/confirm)
+    # it to collect any required permissions to charge the payment method later.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/setup_intents", params: params, opts: opts)
+    end
+
+    # Returns a list of SetupIntents.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/setup_intents", params: filters, opts: opts)
+    end
+
+    # Updates a SetupIntent object.
+    def self.update(id, params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/setup_intents/%<intent>s/cancel", { intent: CGI.escape(intent) }),
+        path: format("/v1/setup_intents/%<id>s", { id: CGI.escape(id) }),
         params: params,
         opts: opts
       )
     end
 
-    def self.confirm(intent, params = {}, opts = {})
+    # Verifies microdeposits on a SetupIntent object.
+    def verify_microdeposits(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/setup_intents/%<intent>s/confirm", { intent: CGI.escape(intent) }),
+        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
+    # Verifies microdeposits on a SetupIntent object.
     def self.verify_microdeposits(intent, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/shipping_rate.rb

@@ -10,5 +10,28 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "shipping_rate"
+    def self.object_name
+      "shipping_rate"
+    end
+
+    # Creates a new shipping rate object.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/shipping_rates", params: params, opts: opts)
+    end
+
+    # Returns a list of your shipping rates.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/shipping_rates", params: filters, opts: opts)
+    end
+
+    # Updates an existing shipping rate object.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/shipping_rates/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

data/lib/stripe/resources/sigma/scheduled_query_run.rb

@@ -11,6 +11,19 @@ module Stripe
       extend Stripe::APIOperations::List
 
       OBJECT_NAME = "scheduled_query_run"
+      def self.object_name
+        "scheduled_query_run"
+      end
+
+      # Returns a list of scheduled query runs.
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/sigma/scheduled_query_runs",
+          params: filters,
+          opts: opts
+        )
+      end
 
       def self.resource_url
         "/v1/sigma/scheduled_query_runs"

data/lib/stripe/resources/source.rb

@@ -14,13 +14,34 @@ module Stripe
   # Related guides: [Sources API](https://stripe.com/docs/sources) and [Sources & Customers](https://stripe.com/docs/sources/customers).
   class Source < APIResource
     extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::NestedResource
+    include Stripe::APIOperations::Save
 
     OBJECT_NAME = "source"
+    def self.object_name
+      "source"
+    end
 
     nested_resource_class_methods :source_transaction, operations: %i[retrieve list]
 
+    # Creates a new source object.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/sources", params: params, opts: opts)
+    end
+
+    # Updates the specified source by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
+    #
+    # This request accepts the metadata and owner as arguments. It is also possible to update type specific information for selected payment methods. Please refer to our [payment method guides](https://stripe.com/docs/sources) for more detail.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/sources/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Verify a given source.
     def verify(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -30,6 +51,7 @@ module Stripe
       )
     end
 
+    # Verify a given source.
     def self.verify(source, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/source_transaction.rb

@@ -8,5 +8,8 @@ module Stripe
   # transactions.
   class SourceTransaction < StripeObject
     OBJECT_NAME = "source_transaction"
+    def self.object_name
+      "source_transaction"
+    end
   end
 end

data/lib/stripe/resources/subscription.rb

@@ -12,7 +12,15 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "subscription"
+    def self.object_name
+      "subscription"
+    end
 
+    # Cancels a customer's subscription immediately. The customer will not be charged again for the subscription.
+    #
+    # Note, however, that any pending invoice items that you've created will still be charged for at the end of the period, unless manually [deleted](https://stripe.com/docs/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations will also be left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations will be removed.
+    #
+    # By default, upon subscription cancellation, Stripe will stop automatic collection of all finalized invoices for the customer. This is intended to prevent unexpected payment attempts after the customer has canceled a subscription. However, you can resume automatic collection of the invoices manually after subscription cancellation to have us proceed. Or, you could check for unpaid invoices before allowing the customer to cancel the subscription at all.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :delete,
@@ -22,42 +30,67 @@ module Stripe
       )
     end
 
-    def delete_discount(params = {}, opts = {})
+    # Cancels a customer's subscription immediately. The customer will not be charged again for the subscription.
+    #
+    # Note, however, that any pending invoice items that you've created will still be charged for at the end of the period, unless manually [deleted](https://stripe.com/docs/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations will also be left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations will be removed.
+    #
+    # By default, upon subscription cancellation, Stripe will stop automatic collection of all finalized invoices for the customer. This is intended to prevent unexpected payment attempts after the customer has canceled a subscription. However, you can resume automatic collection of the invoices manually after subscription cancellation to have us proceed. Or, you could check for unpaid invoices before allowing the customer to cancel the subscription at all.
+    def self.cancel(subscription_exposed_id, params = {}, opts = {})
       request_stripe_object(
         method: :delete,
-        path: format("/v1/subscriptions/%<subscription_exposed_id>s/discount", { subscription_exposed_id: CGI.escape(self["id"]) }),
+        path: format("/v1/subscriptions/%<subscription_exposed_id>s", { subscription_exposed_id: CGI.escape(subscription_exposed_id) }),
         params: params,
         opts: opts
       )
     end
 
-    def resume(params = {}, opts = {})
+    # Creates a new subscription on an existing customer. Each customer can have up to 500 active or scheduled subscriptions.
+    #
+    # When you create a subscription with collection_method=charge_automatically, the first invoice is finalized as part of the request.
+    # The payment_behavior parameter determines the exact behavior of the initial payment.
+    #
+    # To start subscriptions where the first invoice always begins in a draft status, use [subscription schedules](https://stripe.com/docs/billing/subscriptions/subscription-schedules#managing) instead.
+    # Schedules provide the flexibility to model more complex billing configurations that change over time.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/subscriptions", params: params, opts: opts)
+    end
+
+    # Removes the currently applied discount on a subscription.
+    def delete_discount(params = {}, opts = {})
       request_stripe_object(
-        method: :post,
-        path: format("/v1/subscriptions/%<subscription>s/resume", { subscription: CGI.escape(self["id"]) }),
+        method: :delete,
+        path: format("/v1/subscriptions/%<subscription_exposed_id>s/discount", { subscription_exposed_id: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
-    def self.cancel(subscription_exposed_id, params = {}, opts = {})
+    # Removes the currently applied discount on a subscription.
+    def self.delete_discount(subscription_exposed_id, params = {}, opts = {})
       request_stripe_object(
         method: :delete,
-        path: format("/v1/subscriptions/%<subscription_exposed_id>s", { subscription_exposed_id: CGI.escape(subscription_exposed_id) }),
+        path: format("/v1/subscriptions/%<subscription_exposed_id>s/discount", { subscription_exposed_id: CGI.escape(subscription_exposed_id) }),
         params: params,
         opts: opts
       )
     end
 
-    def self.delete_discount(subscription_exposed_id, params = {}, opts = {})
+    # By default, returns a list of subscriptions that have not been canceled. In order to list canceled subscriptions, specify status=canceled.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/subscriptions", params: filters, opts: opts)
+    end
+
+    # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
+    def resume(params = {}, opts = {})
       request_stripe_object(
-        method: :delete,
-        path: format("/v1/subscriptions/%<subscription_exposed_id>s/discount", { subscription_exposed_id: CGI.escape(subscription_exposed_id) }),
+        method: :post,
+        path: format("/v1/subscriptions/%<subscription>s/resume", { subscription: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
+    # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
     def self.resume(subscription, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -67,14 +100,49 @@ module Stripe
       )
     end
 
-    save_nested_resource :source
-
     def self.search(params = {}, opts = {})
-      _search("/v1/subscriptions/search", params, opts)
+      request_stripe_object(
+        method: :get,
+        path: "/v1/subscriptions/search",
+        params: params,
+        opts: opts
+      )
     end
 
     def self.search_auto_paging_each(params = {}, opts = {}, &blk)
       search(params, opts).auto_paging_each(&blk)
     end
+
+    # Updates an existing subscription to match the specified parameters.
+    # When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes.
+    # To preview how the proration is calculated, use the [create preview](https://stripe.com/docs/api/invoices/create_preview) endpoint.
+    #
+    # By default, we prorate subscription changes. For example, if a customer signs up on May 1 for a 100 price, they'll be billed 100 immediately. If on May 15 they switch to a 200 price, then on June 1 they'll be billed 250 (200 for a renewal of her subscription, plus a 50 prorating adjustment for half of the previous month's 100 difference). Similarly, a downgrade generates a credit that is applied to the next invoice. We also prorate when you make quantity changes.
+    #
+    # Switching prices does not normally change the billing date or generate an immediate charge unless:
+    #
+    #
+    # The billing interval is changed (for example, from monthly to yearly).
+    # The subscription moves from free to paid.
+    # A trial starts or ends.
+    #
+    #
+    # In these cases, we apply a credit for the unused time on the previous price, immediately charge the customer using the new price, and reset the billing date. Learn about how [Stripe immediately attempts payment for subscription changes](https://stripe.com/billing/subscriptions/upgrade-downgrade#immediate-payment).
+    #
+    # If you want to charge for an upgrade immediately, pass proration_behavior as always_invoice to create prorations, automatically invoice the customer for those proration adjustments, and attempt to collect payment. If you pass create_prorations, the prorations are created but not automatically invoiced. If you want to bill the customer for the prorations before the subscription's renewal date, you need to manually [invoice the customer](https://stripe.com/docs/api/invoices/create).
+    #
+    # If you don't want to prorate, set the proration_behavior option to none. With this option, the customer is billed 100 on May 1 and 200 on June 1. Similarly, if you set proration_behavior to none when switching between different billing intervals (for example, from monthly to yearly), we don't generate any credits for the old subscription's unused time. We still reset the billing date and bill immediately for the new subscription.
+    #
+    # Updating the quantity on a subscription many times in an hour may result in [rate limiting. If you need to bill for a frequently changing quantity, consider integrating <a href="/docs/billing/subscriptions/usage-based">usage-based billing](https://stripe.com/docs/rate-limits) instead.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscriptions/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    save_nested_resource :source
   end
 end

data/lib/stripe/resources/subscription_item.rb

@@ -8,14 +8,67 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::NestedResource
+    include Stripe::APIOperations::Save
 
     OBJECT_NAME = "subscription_item"
+    def self.object_name
+      "subscription_item"
+    end
 
     nested_resource_class_methods :usage_record, operations: %i[create]
     nested_resource_class_methods :usage_record_summary,
                                   operations: %i[list],
                                   resource_plural: "usage_record_summaries"
+
+    # Adds a new item to an existing subscription. No existing items will be changed or replaced.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: "/v1/subscription_items",
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Deletes an item from the subscription. Removing a subscription item from a subscription will not cancel the subscription.
+    def self.delete(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: format("/v1/subscription_items/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Deletes an item from the subscription. Removing a subscription item from a subscription will not cancel the subscription.
+    def delete(params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: format("/v1/subscription_items/%<item>s", { item: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Returns a list of your subscription items for a given subscription.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: "/v1/subscription_items",
+        params: filters,
+        opts: opts
+      )
+    end
+
+    # Updates the plan or quantity of an item on a current subscription.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscription_items/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

data/lib/stripe/resources/subscription_schedule.rb

@@ -11,7 +11,11 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "subscription_schedule"
+    def self.object_name
+      "subscription_schedule"
+    end
 
+    # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -21,24 +25,47 @@ module Stripe
       )
     end
 
-    def release(params = {}, opts = {})
+    # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
+    def self.cancel(schedule, params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/subscription_schedules/%<schedule>s/release", { schedule: CGI.escape(self["id"]) }),
+        path: format("/v1/subscription_schedules/%<schedule>s/cancel", { schedule: CGI.escape(schedule) }),
         params: params,
         opts: opts
       )
     end
 
-    def self.cancel(schedule, params = {}, opts = {})
+    # Creates a new subscription schedule object. Each customer can have up to 500 active or scheduled subscriptions.
+    def self.create(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/subscription_schedules/%<schedule>s/cancel", { schedule: CGI.escape(schedule) }),
+        path: "/v1/subscription_schedules",
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Retrieves the list of your subscription schedules.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: "/v1/subscription_schedules",
+        params: filters,
+        opts: opts
+      )
+    end
+
+    # Releases the subscription schedule immediately, which will stop scheduling of its phases, but leave any existing subscription in place. A schedule can only be released if its status is not_started or active. If the subscription schedule is currently associated with a subscription, releasing it will remove its subscription property and set the subscription's ID to the released_subscription property.
+    def release(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscription_schedules/%<schedule>s/release", { schedule: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
+    # Releases the subscription schedule immediately, which will stop scheduling of its phases, but leave any existing subscription in place. A schedule can only be released if its status is not_started or active. If the subscription schedule is currently associated with a subscription, releasing it will remove its subscription property and set the subscription's ID to the released_subscription property.
     def self.release(schedule, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -47,5 +74,15 @@ module Stripe
         opts: opts
       )
     end
+
+    # Updates an existing subscription schedule.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscription_schedules/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

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

@@ -10,7 +10,21 @@ module Stripe
       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,
@@ -20,6 +34,7 @@ module Stripe
         )
       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,

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

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