stripe 10.11.0 → 10.12.0.pre.beta.1

data/lib/stripe/resources/quote.rb

@@ -8,12 +8,16 @@ module Stripe
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
+    extend Stripe::APIOperations::NestedResource
 
     OBJECT_NAME = "quote"
     def self.object_name
       "quote"
     end
 
+    nested_resource_class_methods :preview_invoice, operations: %i[list]
+    nested_resource_class_methods :preview_subscription_schedule, operations: %i[list]
+
     # Accepts the specified quote.
     def accept(params = {}, opts = {})
       request_stripe_object(
@@ -24,6 +28,16 @@ module Stripe
       )
     end
 
+    # Accepts the specified quote.
+    def self.accept(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/accept", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Cancels the quote.
     def cancel(params = {}, opts = {})
       request_stripe_object(
@@ -34,6 +48,21 @@ module Stripe
       )
     end
 
+    # Cancels the quote.
+    def self.cancel(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/cancel", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # A quote models prices and services for a customer. Default options for header, description, footer, and expires_at can be set in the dashboard via the [quote template](https://dashboard.stripe.com/settings/billing/quote).
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/quotes", params: params, opts: opts)
+    end
+
     # Finalizes the quote.
     def finalize_quote(params = {}, opts = {})
       request_stripe_object(
@@ -44,6 +73,21 @@ module Stripe
       )
     end
 
+    # Finalizes the quote.
+    def self.finalize_quote(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/finalize", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Returns a list of your quotes.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/quotes", params: filters, opts: opts)
+    end
+
     # When retrieving a quote, there is an includable [computed.upfront.line_items](https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items) property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of upfront line items.
     def list_computed_upfront_line_items(params = {}, opts = {})
       request_stripe_object(
@@ -54,6 +98,16 @@ module Stripe
       )
     end
 
+    # When retrieving a quote, there is an includable [computed.upfront.line_items](https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items) property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of upfront line items.
+    def self.list_computed_upfront_line_items(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/computed_upfront_line_items", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # When retrieving a quote, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
     def list_line_items(params = {}, opts = {})
       request_stripe_object(
@@ -64,69 +118,109 @@ module Stripe
       )
     end
 
-    # Download the PDF for a finalized quote
-    def pdf(params = {}, opts = {}, &read_body_chunk_block)
-      config = opts[:client]&.config || Stripe.config
-      opts = { api_base: config.uploads_base }.merge(opts)
-      request_stream(
+    # When retrieving a quote, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def self.list_line_items(quote, params = {}, opts = {})
+      request_stripe_object(
         method: :get,
-        path: format("/v1/quotes/%<quote>s/pdf", { quote: CGI.escape(self["id"]) }),
+        path: format("/v1/quotes/%<quote>s/line_items", { quote: CGI.escape(quote) }),
         params: params,
-        opts: opts,
-        &read_body_chunk_block
+        opts: opts
       )
     end
 
-    # Accepts the specified quote.
-    def self.accept(quote, params = {}, opts = {})
+    # Retrieves a paginated list of lines for a quote. These lines describe changes that will be used to create new subscription schedules or update existing subscription schedules when the quote is accepted.
+    def list_lines(params = {}, opts = {})
       request_stripe_object(
-        method: :post,
-        path: format("/v1/quotes/%<quote>s/accept", { quote: CGI.escape(quote) }),
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/lines", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
-    # Cancels the quote.
-    def self.cancel(quote, params = {}, opts = {})
+    # Retrieves a paginated list of lines for a quote. These lines describe changes that will be used to create new subscription schedules or update existing subscription schedules when the quote is accepted.
+    def self.list_lines(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/lines", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Preview the invoice line items that would be generated by accepting the quote.
+    def list_preview_invoice_lines(preview_invoice, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/preview_invoices/%<preview_invoice>s/lines", { quote: CGI.escape(self["id"]), preview_invoice: CGI.escape(preview_invoice) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Preview the invoice line items that would be generated by accepting the quote.
+    def self.list_preview_invoice_lines(quote, preview_invoice, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/preview_invoices/%<preview_invoice>s/lines", { quote: CGI.escape(quote), preview_invoice: CGI.escape(preview_invoice) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Converts a stale quote to draft.
+    def mark_draft(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/quotes/%<quote>s/cancel", { quote: CGI.escape(quote) }),
+        path: format("/v1/quotes/%<quote>s/mark_draft", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
-    # Finalizes the quote.
-    def self.finalize_quote(quote, params = {}, opts = {})
+    # Converts a stale quote to draft.
+    def self.mark_draft(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/quotes/%<quote>s/finalize", { quote: CGI.escape(quote) }),
+        path: format("/v1/quotes/%<quote>s/mark_draft", { quote: CGI.escape(quote) }),
         params: params,
         opts: opts
       )
     end
 
-    # When retrieving a quote, there is an includable [computed.upfront.line_items](https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items) property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of upfront line items.
-    def self.list_computed_upfront_line_items(quote, params = {}, opts = {})
+    # Converts a draft or open quote to stale.
+    def mark_stale(params = {}, opts = {})
       request_stripe_object(
-        method: :get,
-        path: format("/v1/quotes/%<quote>s/computed_upfront_line_items", { quote: CGI.escape(quote) }),
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_stale", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
-    # When retrieving a quote, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
-    def self.list_line_items(quote, params = {}, opts = {})
+    # Converts a draft or open quote to stale.
+    def self.mark_stale(quote, params = {}, opts = {})
       request_stripe_object(
-        method: :get,
-        path: format("/v1/quotes/%<quote>s/line_items", { quote: CGI.escape(quote) }),
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_stale", { quote: CGI.escape(quote) }),
         params: params,
         opts: opts
       )
     end
 
+    # Download the PDF for a finalized quote
+    def pdf(params = {}, opts = {}, &read_body_chunk_block)
+      config = opts[:client]&.config || Stripe.config
+      opts = { api_base: config.uploads_base }.merge(opts)
+      request_stream(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/pdf", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts,
+        &read_body_chunk_block
+      )
+    end
+
     # Download the PDF for a finalized quote
     def self.pdf(quote, params = {}, opts = {}, &read_body_chunk_block)
       config = opts[:client]&.config || Stripe.config
@@ -140,14 +234,24 @@ module Stripe
       )
     end
 
-    # A quote models prices and services for a customer. Default options for header, description, footer, and expires_at can be set in the dashboard via the [quote template](https://dashboard.stripe.com/settings/billing/quote).
-    def self.create(params = {}, opts = {})
-      request_stripe_object(method: :post, path: "/v1/quotes", params: params, opts: opts)
+    # Recompute the upcoming invoice estimate for the quote.
+    def reestimate(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/reestimate", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
     end
 
-    # Returns a list of your quotes.
-    def self.list(filters = {}, opts = {})
-      request_stripe_object(method: :get, path: "/v1/quotes", params: filters, opts: opts)
+    # Recompute the upcoming invoice estimate for the quote.
+    def self.reestimate(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/reestimate", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
     end
 
     # A quote models prices and services for a customer.

data/lib/stripe/resources/quote_phase.rb

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A quote phase describes the line items, coupons, and trialing status of a subscription for a predefined time period.
+  class QuotePhase < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "quote_phase"
+    def self.object_name
+      "quote_phase"
+    end
+
+    # Returns a list of quote phases.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/quote_phases", params: filters, opts: opts)
+    end
+
+    # When retrieving a quote phase, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def list_line_items(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quote_phases/%<quote_phase>s/line_items", { quote_phase: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # When retrieving a quote phase, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+    def self.list_line_items(quote_phase, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quote_phases/%<quote_phase>s/line_items", { quote_phase: CGI.escape(quote_phase) }),
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/quote_preview_invoice.rb

@@ -0,0 +1,43 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # Invoices are statements of amounts owed by a customer, and are either
+  # generated one-off, or generated periodically from a subscription.
+  #
+  # They contain [invoice items](https://stripe.com/docs/api#invoiceitems), and proration adjustments
+  # that may be caused by subscription upgrades/downgrades (if necessary).
+  #
+  # If your invoice is configured to be billed through automatic charges,
+  # Stripe automatically finalizes your invoice and attempts payment. Note
+  # that finalizing the invoice,
+  # [when automatic](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection), does
+  # not happen immediately as the invoice is created. Stripe waits
+  # until one hour after the last webhook was successfully sent (or the last
+  # webhook timed out after failing). If you (and the platforms you may have
+  # connected to) have no webhooks configured, Stripe waits one hour after
+  # creation to finalize the invoice.
+  #
+  # If your invoice is configured to be billed by sending an email, then based on your
+  # [email settings](https://dashboard.stripe.com/account/billing/automatic),
+  # Stripe will email the invoice to your customer and await payment. These
+  # emails can contain a link to a hosted page to pay the invoice.
+  #
+  # Stripe applies any customer credit on the account before determining the
+  # amount due for the invoice (i.e., the amount that will be actually
+  # charged). If the amount due for the invoice is less than Stripe's [minimum allowed charge
+  # per currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts), the
+  # invoice is automatically marked paid, and we add the amount due to the
+  # customer's credit balance which is applied to the next invoice.
+  #
+  # More details on the customer's credit balance are
+  # [here](https://stripe.com/docs/billing/customer/balance).
+  #
+  # Related guide: [Send invoices to customers](https://stripe.com/docs/billing/invoices/sending)
+  class QuotePreviewInvoice < APIResource
+    OBJECT_NAME = "quote_preview_invoice"
+    def self.object_name
+      "quote_preview_invoice"
+    end
+  end
+end

data/lib/stripe/resources/quote_preview_subscription_schedule.rb

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuotePreviewSubscriptionSchedule < APIResource
+    OBJECT_NAME = "quote_preview_subscription_schedule"
+    def self.object_name
+      "quote_preview_subscription_schedule"
+    end
+  end
+end

data/lib/stripe/resources/setup_intent.rb

@@ -45,6 +45,18 @@ 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.
+    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
@@ -68,28 +80,6 @@ module Stripe
       )
     end
 
-    # Verifies microdeposits on a SetupIntent object.
-    def verify_microdeposits(params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(self["id"]) }),
-        params: params,
-        opts: opts
-      )
-    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.
-    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
@@ -113,16 +103,6 @@ module Stripe
       )
     end
 
-    # Verifies microdeposits on a SetupIntent object.
-    def self.verify_microdeposits(intent, params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(intent) }),
-        params: params,
-        opts: opts
-      )
-    end
-
     # Creates a SetupIntent object.
     #
     # After you create the SetupIntent, attach a payment method and [confirm](https://stripe.com/docs/api/setup_intents/confirm)
@@ -145,5 +125,25 @@ module Stripe
         opts: opts
       )
     end
+
+    # Verifies microdeposits on a SetupIntent object.
+    def verify_microdeposits(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        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,
+        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

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

@@ -15,10 +15,6 @@ module Stripe
         "scheduled_query_run"
       end
 
-      def self.resource_url
-        "/v1/sigma/scheduled_query_runs"
-      end
-
       # Returns a list of scheduled query runs.
       def self.list(filters = {}, opts = {})
         request_stripe_object(
@@ -28,6 +24,10 @@ module Stripe
           opts: opts
         )
       end
+
+      def self.resource_url
+        "/v1/sigma/scheduled_query_runs"
+      end
     end
   end
 end

data/lib/stripe/resources/source.rb

@@ -24,6 +24,23 @@ module Stripe
 
     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(
@@ -67,22 +84,5 @@ module Stripe
     end
     extend Gem::Deprecate
     deprecate :source_transactions, :"Source.list_source_transactions", 2020, 1
-
-    # 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
   end
 end

data/lib/stripe/resources/subscription.rb

@@ -30,35 +30,36 @@ module Stripe
       )
     end
 
-    # Removes the currently applied discount on a subscription.
-    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"]) }),
-        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 resume(params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/subscriptions/%<subscription>s/resume", { subscription: 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
 
-    # Cancels a customer's subscription immediately. The customer will not be charged again for the subscription.
+    # Creates a new subscription on an existing customer. Each customer can have up to 500 active or scheduled subscriptions.
     #
-    # 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.
+    # 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.
     #
-    # 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 = {})
+    # 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: :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(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -74,32 +75,29 @@ module Stripe
       )
     end
 
+    # 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 self.resume(subscription, params = {}, opts = {})
+    def resume(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/subscriptions/%<subscription>s/resume", { subscription: CGI.escape(subscription) }),
+        path: format("/v1/subscriptions/%<subscription>s/resume", { subscription: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
-    save_nested_resource :source
-
-    # 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
-
-    # 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)
+    # 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,
+        path: format("/v1/subscriptions/%<subscription>s/resume", { subscription: CGI.escape(subscription) }),
+        params: params,
+        opts: opts
+      )
     end
 
     def self.search(params = {}, opts = {})
@@ -144,5 +142,7 @@ module Stripe
         opts: opts
       )
     end
+
+    save_nested_resource :source
   end
 end