stripe 5.55.0 → 13.5.1

data/lib/stripe/services/price_service.rb

@@ -0,0 +1,52 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class PriceService < StripeService
+    # Creates a new price for an existing product. The price can be recurring or one-time.
+    def create(params = {}, opts = {})
+      request(method: :post, path: "/v1/prices", params: params, opts: opts, base_address: :api)
+    end
+
+    # Returns a list of your active prices, excluding [inline prices](https://stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
+    def list(params = {}, opts = {})
+      request(method: :get, path: "/v1/prices", params: params, opts: opts, base_address: :api)
+    end
+
+    # Retrieves the price with the given ID.
+    def retrieve(price, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/prices/%<price>s", { price: CGI.escape(price) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Search for prices you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
+    # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
+    # to an hour behind during outages. Search functionality is not available to merchants in India.
+    def search(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/prices/search",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates the specified price by setting the values of the parameters passed. Any parameters not provided are left unchanged.
+    def update(price, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/prices/%<price>s", { price: CGI.escape(price) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/product_feature_service.rb

@@ -0,0 +1,50 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class ProductFeatureService < StripeService
+    # Creates a product_feature, which represents a feature attachment to a product
+    def create(product, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/products/%<product>s/features", { product: CGI.escape(product) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Deletes the feature attachment to a product
+    def delete(product, id, params = {}, opts = {})
+      request(
+        method: :delete,
+        path: format("/v1/products/%<product>s/features/%<id>s", { product: CGI.escape(product), id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieve a list of features for a product
+    def list(product, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/products/%<product>s/features", { product: CGI.escape(product) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves a product_feature, which represents a feature attachment to a product
+    def retrieve(product, id, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/products/%<product>s/features/%<id>s", { product: CGI.escape(product), id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/product_service.rb

@@ -0,0 +1,70 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class ProductService < StripeService
+    attr_reader :features
+
+    def initialize(requestor)
+      super(requestor)
+      @features = Stripe::ProductFeatureService.new(@requestor)
+    end
+
+    # Creates a new product object.
+    def create(params = {}, opts = {})
+      request(method: :post, path: "/v1/products", params: params, opts: opts, base_address: :api)
+    end
+
+    # Delete a product. Deleting a product is only possible if it has no prices associated with it. Additionally, deleting a product with type=good is only possible if it has no SKUs associated with it.
+    def delete(id, params = {}, opts = {})
+      request(
+        method: :delete,
+        path: format("/v1/products/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first.
+    def list(params = {}, opts = {})
+      request(method: :get, path: "/v1/products", params: params, opts: opts, base_address: :api)
+    end
+
+    # Retrieves the details of an existing product. Supply the unique product ID from either a product creation request or the product list, and Stripe will return the corresponding product information.
+    def retrieve(id, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/products/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Search for products you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
+    # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
+    # to an hour behind during outages. Search functionality is not available to merchants in India.
+    def search(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/products/search",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
+    def update(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/products/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/promotion_code_service.rb

@@ -0,0 +1,50 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class PromotionCodeService < StripeService
+    # A promotion code points to a coupon. You can optionally restrict the code to a specific customer, redemption limit, and expiration date.
+    def create(params = {}, opts = {})
+      request(
+        method: :post,
+        path: "/v1/promotion_codes",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Returns a list of your promotion codes.
+    def list(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/promotion_codes",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://stripe.com/docs/api/promotion_codes/list) with the desired code.
+    def retrieve(promotion_code, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/promotion_codes/%<promotion_code>s", { promotion_code: CGI.escape(promotion_code) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates the specified promotion code by setting the values of the parameters passed. Most fields are, by design, not editable.
+    def update(promotion_code, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/promotion_codes/%<promotion_code>s", { promotion_code: CGI.escape(promotion_code) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/quote_computed_upfront_line_items_service.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuoteComputedUpfrontLineItemsService < StripeService
+    # 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(quote, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/computed_upfront_line_items", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/quote_line_item_service.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuoteLineItemService < StripeService
+    # 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(quote, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/line_items", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/quote_service.rb

@@ -0,0 +1,92 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class QuoteService < StripeService
+    attr_reader :line_items, :computed_upfront_line_items
+
+    def initialize(requestor)
+      super(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
+
+    # 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
+
+    # 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