stripe 5.38.0 → 6.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c7a2e67a4d91e1a22dff9303644b5f2efb74675bce05e364fff8d287f3fa8bd
-  data.tar.gz: a560d866c948d0bbc8f3389571c313da67a26650a771159fa785d7a1e3beccc9
+  metadata.gz: 56384c5d588a2d922c4cd813adfd6015bce5169cd334ae8dd6f45c16fcb07392
+  data.tar.gz: 5f9460024d8c4d1b7cd0ac44883d4aa9a3ed52e0104b129bdf0eacfff62e1698
 SHA512:
-  metadata.gz: a257d84bec5ef9fe3005b362da5c5194a71e257e77baa71c5872b990fefc3e3ee7cc26201d773cf4f5ca29af0fd8b2d3f3b047e11a833c51aba7bca2f6b3947a
-  data.tar.gz: eae3ef2579f9ce37a5e447cd46ca67bdfebc2324e5767cc0925d7f2bee5d8f289a69512ff9221cb28bdd9c4ec39a8cea1f7b5af14b67d18b2fa8a3c9ce7dbb47
+  metadata.gz: 7b53fda899dfd3e44e27482860880228f93c3948425fef83c33ff106504cdae9441a3438488f80416946f653736389491cd5fc0c5e5e6d2ed604ffc50aa6a013
+  data.tar.gz: 602f93db8d61c5f7953e7f930eb7e74d09a0bc01fc02b32277cd6335a12cb93fa7f5c2767b111bac5c4d19a129fc1ed6749780cb8d1285d52e342f87523c47ee

data/CHANGELOG.md

@@ -1,5 +1,90 @@
 # Changelog
 
+## 6.0.0 - 2022-05-09
+* [#1056](https://github.com/stripe/stripe-ruby/pull/1056) API Updates
+  Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-Guide-for-v6) contains more information.
+  
+  (⚠️ = breaking changes):
+  * ⚠️ Replace the legacy `Order` API with the new `Order` API. 
+    * New methods: `cancel`, `list_line_items`, `reopen`, and `submit`
+    * Removed methods: `pay` and `return_order`
+    * Removed resources: `OrderItem` and `OrderReturn`
+  * ⚠️ Rename `FinancialConnections::Account.refresh` to `FinancialConnections::Account.refresh_account
+
+## 5.55.0 - 2022-05-05
+* [#1055](https://github.com/stripe/stripe-ruby/pull/1055) API Updates
+  * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
+  
+
+## 5.54.0 - 2022-05-03
+* [#1053](https://github.com/stripe/stripe-ruby/pull/1053) API Updates
+  * Add support for new resource `CashBalance`
+
+## 5.53.0 - 2022-04-21
+* [#1050](https://github.com/stripe/stripe-ruby/pull/1050) API Updates
+  * Add support for `expire` test helper method on resource `Refund`
+
+## 5.52.0 - 2022-04-18
+* [#1046](https://github.com/stripe/stripe-ruby/pull/1046) [#1047](https://github.com/stripe/stripe-ruby/pull/1047) API Updates 
+  * Add support for new resources `FundingInstructions` and `Terminal.Configuration`
+
+## 5.51.0 - 2022-04-15
+* [#1046](https://github.com/stripe/stripe-ruby/pull/1046) This release was incomplete and was yanked from RubyGems immediately after it was published.
+
+## 5.50.0 - 2022-04-13
+* [#1045](https://github.com/stripe/stripe-ruby/pull/1045) API Updates
+  * Add support for `increment_authorization` method on resource `PaymentIntent`
+
+## 5.49.0 - 2022-04-08
+* [#1043](https://github.com/stripe/stripe-ruby/pull/1043) API Updates
+  * Add support for `apply_customer_balance` method on resource `PaymentIntent`
+
+## 5.48.0 - 2022-03-30
+* [#1041](https://github.com/stripe/stripe-ruby/pull/1041) API Updates
+  * Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
+
+## 5.47.0 - 2022-03-29
+* [#1040](https://github.com/stripe/stripe-ruby/pull/1040) API Updates
+  * Add support for Search API
+    * Add support for `search` method on resources `Charge`, `Customer`, `Invoice`, `PaymentIntent`, `Price`, `Product`, and `Subscription`
+  
+* [#1034](https://github.com/stripe/stripe-ruby/pull/1034) Add supporting classes for test helper generation
+
+## 5.46.0 - 2022-03-23
+* [#1039](https://github.com/stripe/stripe-ruby/pull/1039) API Updates
+  * Add support for `cancel` method on resource `Refund`
+* [#992](https://github.com/stripe/stripe-ruby/pull/992) Add support for Search API
+
+## 5.45.0 - 2022-03-01
+* [#1035](https://github.com/stripe/stripe-ruby/pull/1035) API Updates
+  * Add support for new resource `TestHelpers.TestClock`
+
+## 5.44.0 - 2022-02-16
+* [#1032](https://github.com/stripe/stripe-ruby/pull/1032) API Updates
+  * Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
+
+## 5.43.0 - 2022-01-20
+* [#1031](https://github.com/stripe/stripe-ruby/pull/1031) API Updates
+  * Add support for new resource `PaymentLink`
+
+## 5.42.0 - 2021-12-13
+* [#1022](https://github.com/stripe/stripe-ruby/pull/1022) Add connection manager logging and include object IDs in logging.
+
+## 5.41.0 - 2021-11-16
+* [#1017](https://github.com/stripe/stripe-ruby/pull/1017) API Updates
+  * Add support for new resource `ShippingRate`
+
+## 5.40.0 - 2021-11-11
+* [#1015](https://github.com/stripe/stripe-ruby/pull/1015) API Updates
+  * Add support for `expire` method on resource `Checkout.Session`
+* [#1013](https://github.com/stripe/stripe-ruby/pull/1013) Add tests for child resources.
+* [#1012](https://github.com/stripe/stripe-ruby/pull/1012) Add tests for namespaced resources.
+* [#1011](https://github.com/stripe/stripe-ruby/pull/1011) codegen: 3 more files
+
+## 5.39.0 - 2021-10-11
+* [#1010](https://github.com/stripe/stripe-ruby/pull/1010) API Updates
+  * Add support for `list_payment_methods` method on resource `Customer`
+
 ## 5.38.0 - 2021-08-10
 * [#993](https://github.com/stripe/stripe-ruby/pull/993) Add `request_id` to RequestEndEvent
 * [#991](https://github.com/stripe/stripe-ruby/pull/991) Codegen more files

data/Makefile

@@ -0,0 +1,7 @@
+.PHONY: update-version codegen-format
+update-version:
+	@echo "$(VERSION)" > VERSION
+	@perl -pi -e 's|VERSION = "[.\d]+"|VERSION = "$(VERSION)"|' lib/stripe/version.rb
+
+codegen-format:
+	bundle exec rubocop -o /dev/null --auto-correct

data/README.md

@@ -18,7 +18,7 @@ The library also provides other features. For example:
 
 ## Documentation
 
-See the [Ruby API docs](https://stripe.com/docs/api/ruby#intro).
+See the [Ruby API docs](https://stripe.com/docs/api?lang=ruby).
 
 See [video demonstrations][youtube-playlist] covering how to use the library.
 
@@ -340,9 +340,9 @@ Update the bundled [stripe-mock] by editing the version number found in
 [api-keys]: https://dashboard.stripe.com/account/apikeys
 [connect]: https://stripe.com/connect
 [curl]: http://curl.haxx.se/docs/caextract.html
-[idempotency-keys]: https://stripe.com/docs/api/ruby#idempotent_requests
+[idempotency-keys]: https://stripe.com/docs/api/idempotent_requests?lang=ruby
 [stripe-mock]: https://github.com/stripe/stripe-mock
-[versioning]: https://stripe.com/docs/api/ruby#versioning
+[versioning]: https://stripe.com/docs/api/versioning?lang=ruby
 [youtube-playlist]: https://www.youtube.com/playlist?list=PLy1nL-pvL2M50RmP6ie-gdcSnfOuQCRYk
 
 <!--

data/VERSION

@@ -1 +1 @@
-5.38.0
+6.0.0

data/lib/stripe/api_operations/search.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Stripe
+  module APIOperations
+    module Search
+      def _search(search_url, filters = {}, opts = {})
+        opts = Util.normalize_opts(opts)
+
+        resp, opts = execute_resource_request(:get, search_url, filters, opts)
+        obj = SearchResultObject.construct_from(resp.data, opts)
+
+        # set filters so that we can fetch the same limit and query
+        # when accessing the next page
+        obj.filters = filters.dup
+        obj
+      end
+    end
+  end
+end

data/lib/stripe/api_resource.rb

@@ -63,22 +63,7 @@ module Stripe
     # adds a `capture` class method to the resource class that, when called,
     # will send a POST request to `/v1/<object_name>/capture`.
     def self.custom_method(name, http_verb:, http_path: nil)
-      unless %i[get post delete].include?(http_verb)
-        raise ArgumentError,
-              "Invalid http_verb value: #{http_verb.inspect}. Should be one " \
-              "of :get, :post or :delete."
-      end
-      http_path ||= name.to_s
-      define_singleton_method(name) do |id, params = {}, opts = {}|
-        unless id.is_a?(String)
-          raise ArgumentError,
-                "id should be a string representing the ID of an API resource"
-        end
-
-        url = "#{resource_url}/#{CGI.escape(id)}/#{CGI.escape(http_path)}"
-        resp, opts = execute_resource_request(http_verb, url, params, opts)
-        Util.convert_to_stripe_object(resp.data, opts)
-      end
+      Util.custom_method self, self, name, http_verb, http_path
     end
 
     def resource_url
@@ -105,7 +90,7 @@ module Stripe
       instance
     end
 
-    protected def request_stripe_object(method:, path:, params:, opts: {})
+    def request_stripe_object(method:, path:, params:, opts: {})
       resp, opts = execute_resource_request(method, path, params, opts)
 
       # If we're getting back this thing, update; otherwise, instantiate.

data/lib/stripe/api_resource_test_helpers.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Stripe
+  # The base class for nested TestHelpers classes in resource objects.
+  # The APIResourceTestHelpers handles URL generation and custom method
+  # support for test-helper methods.
+  #
+  #  class MyAPIResource < APIResource
+  #    class TestHelpers < APIResourceTestHelpers
+  class APIResourceTestHelpers
+    def initialize(resource)
+      @resource = resource
+    end
+
+    # Adds a custom method to a test helper. This is used to add support for
+    # non-CRUDL API requests, e.g. capturing charges. custom_method takes the
+    # following parameters:
+    # - name: the name of the custom method to create (as a symbol)
+    # - http_verb: the HTTP verb for the API request (:get, :post, or :delete)
+    # - http_path: the path to append to the resource's URL. If not provided,
+    #              the name is used as the path
+    #
+    # For example, this call:
+    #     custom_method :capture, http_verb: post
+    # adds a `capture` class method to the resource class that, when called,
+    # will send a POST request to `/v1/<object_name>/capture`.
+    def self.custom_method(name, http_verb:, http_path: nil)
+      Util.custom_method self::RESOURCE_CLASS, self, name, http_verb, http_path
+    end
+
+    def self.resource_url
+      "/v1/test_helpers/"\
+      "#{self::RESOURCE_CLASS::OBJECT_NAME.downcase.tr('.', '/')}s"
+    end
+
+    def resource_url
+      unless (id = @resource["id"])
+        raise InvalidRequestError.new(
+          "Could not determine which URL to request: #{self.class} instance " \
+          "has invalid ID: #{id.inspect}",
+          "id"
+        )
+      end
+      "#{self.class.resource_url}/#{CGI.escape(id)}"
+    end
+  end
+end

data/lib/stripe/connection_manager.rb

@@ -103,13 +103,34 @@ module Stripe
         headers
       )
 
-      @mutex.synchronize do
+      Util.log_debug("ConnectionManager starting request",
+                     method_name: method_name,
+                     path: path,
+                     process_id: Process.pid,
+                     thread_object_id: Thread.current.object_id,
+                     connection_manager_object_id: object_id,
+                     connection_object_id: connection.object_id,
+                     log_timestamp: Util.monotonic_time)
+
+      resp = @mutex.synchronize do
         # The block parameter is special here. If a block is provided, the block
         # is invoked with the Net::HTTPResponse. However, the body will not have
         # been read yet in the block, and can be streamed by calling
         # HTTPResponse#read_body.
         connection.request(request, body, &block)
       end
+
+      Util.log_debug("ConnectionManager request complete",
+                     method_name: method_name,
+                     path: path,
+                     process_id: Process.pid,
+                     thread_object_id: Thread.current.object_id,
+                     connection_manager_object_id: object_id,
+                     connection_object_id: connection.object_id,
+                     response_object_id: resp.object_id,
+                     log_timestamp: Util.monotonic_time)
+
+      resp
     end
 
     #

data/lib/stripe/object_types.rb

@@ -9,6 +9,7 @@ module Stripe
       {
         # data structures
         ListObject::OBJECT_NAME => ListObject,
+        SearchResultObject::OBJECT_NAME => SearchResultObject,
 
         # business objects
         Account::OBJECT_NAME => Account,
@@ -26,6 +27,7 @@ module Stripe
         BitcoinTransaction::OBJECT_NAME => BitcoinTransaction,
         Capability::OBJECT_NAME => Capability,
         Card::OBJECT_NAME => Card,
+        CashBalance::OBJECT_NAME => CashBalance,
         Charge::OBJECT_NAME => Charge,
         Checkout::Session::OBJECT_NAME => Checkout::Session,
         CountrySpec::OBJECT_NAME => CountrySpec,
@@ -42,6 +44,12 @@ module Stripe
         File::OBJECT_NAME => File,
         File::OBJECT_NAME_ALT => File,
         FileLink::OBJECT_NAME => FileLink,
+        FinancialConnections::Account::OBJECT_NAME => FinancialConnections::Account,
+        FinancialConnections::AccountOwner::OBJECT_NAME => FinancialConnections::AccountOwner,
+        FinancialConnections::AccountOwnership::OBJECT_NAME =>
+        FinancialConnections::AccountOwnership,
+        FinancialConnections::Session::OBJECT_NAME => FinancialConnections::Session,
+        FundingInstructions::OBJECT_NAME => FundingInstructions,
         Identity::VerificationReport::OBJECT_NAME => Identity::VerificationReport,
         Identity::VerificationSession::OBJECT_NAME => Identity::VerificationSession,
         Invoice::OBJECT_NAME => Invoice,
@@ -57,8 +65,8 @@ module Stripe
         LoginLink::OBJECT_NAME => LoginLink,
         Mandate::OBJECT_NAME => Mandate,
         Order::OBJECT_NAME => Order,
-        OrderReturn::OBJECT_NAME => OrderReturn,
         PaymentIntent::OBJECT_NAME => PaymentIntent,
+        PaymentLink::OBJECT_NAME => PaymentLink,
         PaymentMethod::OBJECT_NAME => PaymentMethod,
         Payout::OBJECT_NAME => Payout,
         Person::OBJECT_NAME => Person,
@@ -79,6 +87,7 @@ module Stripe
         Review::OBJECT_NAME => Review,
         SetupAttempt::OBJECT_NAME => SetupAttempt,
         SetupIntent::OBJECT_NAME => SetupIntent,
+        ShippingRate::OBJECT_NAME => ShippingRate,
         Sigma::ScheduledQueryRun::OBJECT_NAME => Sigma::ScheduledQueryRun,
         SKU::OBJECT_NAME => SKU,
         Source::OBJECT_NAME => Source,
@@ -89,9 +98,11 @@ module Stripe
         TaxCode::OBJECT_NAME => TaxCode,
         TaxId::OBJECT_NAME => TaxId,
         TaxRate::OBJECT_NAME => TaxRate,
+        Terminal::Configuration::OBJECT_NAME => Terminal::Configuration,
         Terminal::ConnectionToken::OBJECT_NAME => Terminal::ConnectionToken,
         Terminal::Location::OBJECT_NAME => Terminal::Location,
         Terminal::Reader::OBJECT_NAME => Terminal::Reader,
+        TestHelpers::TestClock::OBJECT_NAME => TestHelpers::TestClock,
         ThreeDSecure::OBJECT_NAME => ThreeDSecure,
         Token::OBJECT_NAME => Token,
         Topup::OBJECT_NAME => Topup,

data/lib/stripe/resources/cash_balance.rb

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class CashBalance < APIResource
+    OBJECT_NAME = "cash_balance"
+
+    def resource_url
+      if !respond_to?(:customer) || customer.nil?
+        raise NotImplementedError,
+              "Customer Cash Balance cannot be accessed without a customer ID."
+      end
+      "#{Customer.resource_url}/#{CGI.escape(customer)}/cash_balance"
+    end
+
+    def self.retrieve(_id, _opts = {})
+      raise NotImplementedError,
+            "Customer Cash Balance cannot be retrieved without a customer ID. " \
+            "Retrieve a Customer Cash Balance using `Customer.retrieve_cash_balance('cus_123')`"
+    end
+  end
+end

data/lib/stripe/resources/charge.rb

@@ -5,6 +5,7 @@ module Stripe
   class Charge < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "charge"
@@ -19,5 +20,13 @@ module Stripe
         opts: opts
       )
     end
+
+    def self.search(params = {}, opts = {})
+      _search("/v1/charges/search", params, opts)
+    end
+
+    def self.search_auto_paging_each(params = {}, opts = {}, &blk)
+      search(params, opts).auto_paging_each(&blk)
+    end
   end
 end

data/lib/stripe/resources/checkout/session.rb

@@ -10,7 +10,18 @@ module Stripe
 
       OBJECT_NAME = "checkout.session"
 
+      custom_method :expire, http_verb: :post
+
       nested_resource_class_methods :line_item, operations: %i[list]
+
+      def expire(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: resource_url + "/expire",
+          params: params,
+          opts: opts
+        )
+      end
     end
   end
 end

data/lib/stripe/resources/customer.rb

@@ -6,16 +6,41 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
     extend Stripe::APIOperations::NestedResource
 
     OBJECT_NAME = "customer"
 
+    custom_method :create_funding_instructions, http_verb: :post, http_path: "funding_instructions"
+    custom_method :list_payment_methods, http_verb: :get, http_path: "payment_methods"
+
+    nested_resource_class_methods :cash_balance,
+                                  operations: %i[retrieve update],
+                                  resource_plural: "cash_balance"
     nested_resource_class_methods :balance_transaction,
                                   operations: %i[create retrieve update list]
     nested_resource_class_methods :tax_id,
                                   operations: %i[create retrieve delete list]
 
+    def create_funding_instructions(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/funding_instructions",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def list_payment_methods(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: resource_url + "/payment_methods",
+        params: params,
+        opts: opts
+      )
+    end
+
     custom_method :delete_discount, http_verb: :delete, http_path: "discount"
 
     save_nested_resource :source
@@ -37,5 +62,13 @@ module Stripe
       resp, opts = execute_resource_request(:delete, resource_url + "/discount")
       Util.convert_to_stripe_object(resp.data, opts)
     end
+
+    def self.search(params = {}, opts = {})
+      _search("/v1/customers/search", params, opts)
+    end
+
+    def self.search_auto_paging_each(params = {}, opts = {}, &blk)
+      search(params, opts).auto_paging_each(&blk)
+    end
   end
 end

data/lib/stripe/resources/discount.rb

@@ -1,3 +1,4 @@
+# File generated from our OpenAPI spec
 # frozen_string_literal: true
 
 module Stripe

data/lib/stripe/resources/financial_connections/account.rb

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module FinancialConnections
+    class Account < APIResource
+      OBJECT_NAME = "financial_connections.account"
+
+      custom_method :disconnect, http_verb: :post
+      custom_method :refresh_account, http_verb: :post, http_path: "refresh"
+
+      def disconnect(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: resource_url + "/disconnect",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def refresh_account(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: resource_url + "/refresh",
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/financial_connections/account_owner.rb

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module FinancialConnections
+    class AccountOwner < StripeObject
+      OBJECT_NAME = "financial_connections.account_owner"
+    end
+  end
+end

data/lib/stripe/resources/financial_connections/account_ownership.rb

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module FinancialConnections
+    class AccountOwnership < StripeObject
+      OBJECT_NAME = "financial_connections.account_ownership"
+    end
+  end
+end

data/lib/stripe/resources/financial_connections/session.rb

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module FinancialConnections
+    class Session < APIResource
+      extend Stripe::APIOperations::Create
+
+      OBJECT_NAME = "financial_connections.session"
+    end
+  end
+end

data/lib/stripe/resources/funding_instructions.rb

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class FundingInstructions < APIResource
+    OBJECT_NAME = "funding_instructions"
+
+    def resource_url
+      if !respond_to?(:customer) || customer.nil?
+        raise NotImplementedError,
+              "FundingInstructions cannot be accessed without a customer ID."
+      end
+      "#{Customer.resource_url}/#{CGI.escape(customer)}/funding_instructions" "/#{CGI.escape(id)}"
+    end
+  end
+end

data/lib/stripe/resources/invoice.rb

@@ -6,6 +6,7 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "invoice"
@@ -70,5 +71,13 @@ module Stripe
       resp, opts = execute_resource_request(:get, resource_url + "/upcoming/lines", params, opts)
       Util.convert_to_stripe_object(resp.data, opts)
     end
+
+    def self.search(params = {}, opts = {})
+      _search("/v1/invoices/search", params, opts)
+    end
+
+    def self.search_auto_paging_each(params = {}, opts = {}, &blk)
+      search(params, opts).auto_paging_each(&blk)
+    end
   end
 end

data/lib/stripe/resources/issuing/card_details.rb

@@ -1,8 +1,9 @@
+# File generated from our OpenAPI spec
 # frozen_string_literal: true
 
 module Stripe
   module Issuing
-    class CardDetails < Stripe::StripeObject
+    class CardDetails < StripeObject
       OBJECT_NAME = "issuing.card_details"
     end
   end

data/lib/stripe/resources/order.rb

@@ -9,22 +9,42 @@ module Stripe
 
     OBJECT_NAME = "order"
 
-    custom_method :pay, http_verb: :post
-    custom_method :return_order, http_verb: :post, http_path: "returns"
+    custom_method :cancel, http_verb: :post
+    custom_method :list_line_items, http_verb: :get, http_path: "line_items"
+    custom_method :reopen, http_verb: :post
+    custom_method :submit, http_verb: :post
 
-    def pay(params = {}, opts = {})
+    def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/pay",
+        path: resource_url + "/cancel",
         params: params,
         opts: opts
       )
     end
 
-    def return_order(params = {}, opts = {})
+    def list_line_items(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: resource_url + "/line_items",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def reopen(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/reopen",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def submit(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/returns",
+        path: resource_url + "/submit",
         params: params,
         opts: opts
       )