stripe 12.7.0.pre.beta.2 → 13.1.0.pre.beta.2

data/lib/stripe/services/quote_preview_subscription_schedule_service.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuotePreviewSubscriptionScheduleService < StripeService
+    # Preview the schedules that would be generated by accepting the quote
+    def list(quote, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/preview_subscription_schedules", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/quote_service.rb

@@ -0,0 +1,140 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuoteService < StripeService
+    attr_reader :preview_invoices, :preview_subscription_schedules, :lines, :line_items, :computed_upfront_line_items
+
+    def initialize(requestor)
+      super(requestor)
+      @preview_invoices = Stripe::QuotePreviewInvoiceService.new(@requestor)
+      @preview_subscription_schedules = Stripe::QuotePreviewSubscriptionScheduleService
+                                        .new(@requestor)
+      @lines = Stripe::QuoteLineService.new(@requestor)
+      @line_items = Stripe::QuoteLineItemService.new(@requestor)
+      @computed_upfront_line_items = Stripe::QuoteComputedUpfrontLineItemsService.new(@requestor)
+    end
+
+    # Accepts the specified quote.
+    def accept(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/accept", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Cancels the quote.
+    def cancel(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/cancel", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    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 create(params = {}, opts = {})
+      request(method: :post, path: "/v1/quotes", params: params, opts: opts, base_address: :api)
+    end
+
+    # Finalizes the quote.
+    def finalize_quote(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/finalize", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Returns a list of your quotes.
+    def list(params = {}, opts = {})
+      request(method: :get, path: "/v1/quotes", params: params, opts: opts, base_address: :api)
+    end
+
+    # Preview the invoice line items that would be generated by accepting the quote.
+    def list_preview_invoice_lines(quote, preview_invoice, params = {}, opts = {})
+      request(
+        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,
+        base_address: :api
+      )
+    end
+
+    # Converts a stale quote to draft.
+    def mark_draft(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_draft", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Converts a draft or open quote to stale.
+    def mark_stale(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/mark_stale", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Download the PDF for a finalized quote. Explanation for special handling can be found [here](https://docs.stripe.com/quotes/overview#quote_pdf)
+    def pdf(quote, params = {}, opts = {}, &read_body_chunk_block)
+      opts = { api_base: APIRequestor.active_requestor.config.uploads_base }.merge(opts)
+      request_stream(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/pdf", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :files,
+        &read_body_chunk_block
+      )
+    end
+
+    # Recompute the upcoming invoice estimate for the quote.
+    def reestimate(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/reestimate", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves the quote with the given ID.
+    def retrieve(quote, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # A quote models prices and services for a customer.
+    def update(quote, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/radar/early_fraud_warning_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Radar
+    class EarlyFraudWarningService < StripeService
+      # Returns a list of early fraud warnings.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/radar/early_fraud_warnings",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieves the details of an early fraud warning that has previously been created.
+      #
+      # Please refer to the [early fraud warning](https://stripe.com/docs/api#early_fraud_warning_object) object reference for more details.
+      def retrieve(early_fraud_warning, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/radar/early_fraud_warnings/%<early_fraud_warning>s", { early_fraud_warning: CGI.escape(early_fraud_warning) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/radar/value_list_item_service.rb

@@ -0,0 +1,52 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Radar
+    class ValueListItemService < StripeService
+      # Creates a new ValueListItem object, which is added to the specified parent value list.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/radar/value_list_items",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Deletes a ValueListItem object, removing it from its parent value list.
+      def delete(item, params = {}, opts = {})
+        request(
+          method: :delete,
+          path: format("/v1/radar/value_list_items/%<item>s", { item: CGI.escape(item) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Returns a list of ValueListItem objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/radar/value_list_items",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieves a ValueListItem object.
+      def retrieve(item, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/radar/value_list_items/%<item>s", { item: CGI.escape(item) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/radar/value_list_service.rb

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Radar
+    class ValueListService < StripeService
+      # Creates a new ValueList object, which can then be referenced in rules.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/radar/value_lists",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Deletes a ValueList object, also deleting any items contained within the value list. To be deleted, a value list must not be referenced in any rules.
+      def delete(value_list, params = {}, opts = {})
+        request(
+          method: :delete,
+          path: format("/v1/radar/value_lists/%<value_list>s", { value_list: CGI.escape(value_list) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Returns a list of ValueList objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/radar/value_lists",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieves a ValueList object.
+      def retrieve(value_list, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/radar/value_lists/%<value_list>s", { value_list: CGI.escape(value_list) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Updates a ValueList object by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Note that item_type is immutable.
+      def update(value_list, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/radar/value_lists/%<value_list>s", { value_list: CGI.escape(value_list) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/radar_service.rb

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class RadarService < StripeService
+    attr_reader :early_fraud_warnings, :value_lists, :value_list_items
+
+    def initialize(requestor)
+      super(requestor)
+      @early_fraud_warnings = Stripe::Radar::EarlyFraudWarningService.new(@requestor)
+      @value_lists = Stripe::Radar::ValueListService.new(@requestor)
+      @value_list_items = Stripe::Radar::ValueListItemService.new(@requestor)
+    end
+  end
+end

data/lib/stripe/services/refund_service.rb

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class RefundService < StripeService
+    # Cancels a refund with a status of requires_action.
+    #
+    # You can't cancel refunds in other states. Only refunds for payment methods that require customer action can enter the requires_action state.
+    def cancel(refund, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/refunds/%<refund>s/cancel", { refund: CGI.escape(refund) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # When you create a new refund, you must specify a Charge or a PaymentIntent object on which to create it.
+    #
+    # Creating a new refund will refund a charge that has previously been created but not yet refunded.
+    # Funds will be refunded to the credit or debit card that was originally charged.
+    #
+    # You can optionally refund only part of a charge.
+    # You can do so multiple times, until the entire charge has been refunded.
+    #
+    # Once entirely refunded, a charge can't be refunded again.
+    # This method will raise an error when called on an already-refunded charge,
+    # or when trying to refund more money than is left on a charge.
+    def create(params = {}, opts = {})
+      request(method: :post, path: "/v1/refunds", params: params, opts: opts, base_address: :api)
+    end
+
+    # Returns a list of all refunds you created. We return the refunds in sorted order, with the most recent refunds appearing first. The 10 most recent refunds are always available by default on the Charge object.
+    def list(params = {}, opts = {})
+      request(method: :get, path: "/v1/refunds", params: params, opts: opts, base_address: :api)
+    end
+
+    # Retrieves the details of an existing refund.
+    def retrieve(refund, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/refunds/%<refund>s", { refund: CGI.escape(refund) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates the refund that you specify by setting the values of the passed parameters. Any parameters that you don't provide remain unchanged.
+    #
+    # This request only accepts metadata as an argument.
+    def update(refund, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/refunds/%<refund>s", { refund: CGI.escape(refund) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/reporting/report_run_service.rb

@@ -0,0 +1,41 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Reporting
+    class ReportRunService < StripeService
+      # Creates a new object and begin running the report. (Certain report types require a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).)
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/reporting/report_runs",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Returns a list of Report Runs, with the most recent appearing first.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/reporting/report_runs",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieves the details of an existing Report Run.
+      def retrieve(report_run, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/reporting/report_runs/%<report_run>s", { report_run: CGI.escape(report_run) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/reporting/report_type_service.rb

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Reporting
+    class ReportTypeService < StripeService
+      # Returns a full list of Report Types.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/reporting/report_types",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieves the details of a Report Type. (Certain report types require a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).)
+      def retrieve(report_type, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/reporting/report_types/%<report_type>s", { report_type: CGI.escape(report_type) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/reporting_service.rb

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class ReportingService < StripeService
+    attr_reader :report_runs, :report_types
+
+    def initialize(requestor)
+      super(requestor)
+      @report_runs = Stripe::Reporting::ReportRunService.new(@requestor)
+      @report_types = Stripe::Reporting::ReportTypeService.new(@requestor)
+    end
+  end
+end

data/lib/stripe/services/review_service.rb

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class ReviewService < StripeService
+    # Approves a Review object, closing it and removing it from the list of reviews.
+    def approve(review, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/reviews/%<review>s/approve", { review: CGI.escape(review) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    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 list(params = {}, opts = {})
+      request(method: :get, path: "/v1/reviews", params: params, opts: opts, base_address: :api)
+    end
+
+    # Retrieves a Review object.
+    def retrieve(review, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/reviews/%<review>s", { review: CGI.escape(review) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/setup_attempt_service.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class SetupAttemptService < StripeService
+    # Returns a list of SetupAttempts that associate with a provided SetupIntent.
+    def list(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/setup_attempts",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/setup_intent_service.rb

@@ -0,0 +1,105 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class SetupIntentService < StripeService
+    # 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(intent, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/cancel", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    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(intent, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/confirm", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # 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 create(params = {}, opts = {})
+      request(
+        method: :post,
+        path: "/v1/setup_intents",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Returns a list of SetupIntents.
+    def list(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/setup_intents",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves the details of a SetupIntent that has previously been created.
+    #
+    # Client-side retrieval using a publishable key is allowed when the client_secret is provided in the query string.
+    #
+    # When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the [SetupIntent](https://stripe.com/docs/api#setup_intent_object) object reference for more details.
+    def retrieve(intent, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/setup_intents/%<intent>s", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates a SetupIntent object.
+    def update(intent, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Verifies microdeposits on a SetupIntent object.
+    def verify_microdeposits(intent, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/shipping_rate_service.rb

@@ -0,0 +1,50 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class ShippingRateService < StripeService
+    # Creates a new shipping rate object.
+    def create(params = {}, opts = {})
+      request(
+        method: :post,
+        path: "/v1/shipping_rates",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Returns a list of your shipping rates.
+    def list(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/shipping_rates",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Returns the shipping rate object with the given ID.
+    def retrieve(shipping_rate_token, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/shipping_rates/%<shipping_rate_token>s", { shipping_rate_token: CGI.escape(shipping_rate_token) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates an existing shipping rate object.
+    def update(shipping_rate_token, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/shipping_rates/%<shipping_rate_token>s", { shipping_rate_token: CGI.escape(shipping_rate_token) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end