stripe 10.1.0 → 12.6.0

data/lib/stripe/resources/climate/order.rb

@@ -0,0 +1,67 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Climate
+    # Orders represent your intent to purchase a particular Climate product. When you create an order, the
+    # payment is deducted from your merchant balance.
+    class Order < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "climate.order"
+      def self.object_name
+        "climate.order"
+      end
+
+      # Cancels a Climate order. You can cancel an order within 24 hours of creation. Stripe refunds the
+      # reservation amount_subtotal, but not the amount_fees for user-triggered cancellations. Frontier
+      # might cancel reservations if suppliers fail to deliver. If Frontier cancels the reservation, Stripe
+      # provides 90 days advance notice and refunds the amount_total.
+      def cancel(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/climate/orders/%<order>s/cancel", { order: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Cancels a Climate order. You can cancel an order within 24 hours of creation. Stripe refunds the
+      # reservation amount_subtotal, but not the amount_fees for user-triggered cancellations. Frontier
+      # might cancel reservations if suppliers fail to deliver. If Frontier cancels the reservation, Stripe
+      # provides 90 days advance notice and refunds the amount_total.
+      def self.cancel(order, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/climate/orders/%<order>s/cancel", { order: CGI.escape(order) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Creates a Climate order object for a given Climate product. The order will be processed immediately
+      # after creation and payment will be deducted your Stripe balance.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(method: :post, path: "/v1/climate/orders", params: params, opts: opts)
+      end
+
+      # Lists all Climate order objects. The orders are returned sorted by creation date, with the
+      # most recently created orders appearing first.
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(method: :get, path: "/v1/climate/orders", params: filters, opts: opts)
+      end
+
+      # Updates the specified order by setting the values of the parameters passed.
+      def self.update(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/climate/orders/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/climate/product.rb

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Climate
+    # A Climate product represents a type of carbon removal unit available for reservation.
+    # You can retrieve it to see the current price and availability.
+    class Product < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "climate.product"
+      def self.object_name
+        "climate.product"
+      end
+
+      # Lists all available Climate product objects.
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/climate/products",
+          params: filters,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/climate/supplier.rb

@@ -0,0 +1,26 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Climate
+    # A supplier of carbon removal.
+    class Supplier < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "climate.supplier"
+      def self.object_name
+        "climate.supplier"
+      end
+
+      # Lists all available Climate supplier objects.
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/climate/suppliers",
+          params: filters,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/confirmation_token.rb

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # ConfirmationTokens help transport client side data collected by Stripe JS over
+  # to your server for confirming a PaymentIntent or SetupIntent. If the confirmation
+  # is successful, values present on the ConfirmationToken are written onto the Intent.
+  #
+  # To learn more about how to use ConfirmationToken, visit the related guides:
+  # - [Finalize payments on the server](https://stripe.com/docs/payments/finalize-payments-on-the-server)
+  # - [Build two-step confirmation](https://stripe.com/docs/payments/build-a-two-step-confirmation).
+  class ConfirmationToken < APIResource
+    OBJECT_NAME = "confirmation_token"
+    def self.object_name
+      "confirmation_token"
+    end
+
+    def test_helpers
+      TestHelpers.new(self)
+    end
+
+    class TestHelpers < APIResourceTestHelpers
+      RESOURCE_CLASS = ConfirmationToken
+      def self.resource_class
+        "ConfirmationToken"
+      end
+
+      # Creates a test mode Confirmation Token server side for your integration tests.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/test_helpers/confirmation_tokens",
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/country_spec.rb

@@ -12,5 +12,13 @@ module Stripe
     extend Stripe::APIOperations::List
 
     OBJECT_NAME = "country_spec"
+    def self.object_name
+      "country_spec"
+    end
+
+    # Lists all Country Spec objects available in the API.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/country_specs", params: filters, opts: opts)
+    end
   end
 end

data/lib/stripe/resources/coupon.rb

@@ -12,5 +12,50 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "coupon"
+    def self.object_name
+      "coupon"
+    end
+
+    # You can create coupons easily via the [coupon management](https://dashboard.stripe.com/coupons) page of the Stripe dashboard. Coupon creation is also accessible via the API if you need to create coupons on the fly.
+    #
+    # A coupon has either a percent_off or an amount_off and currency. If you set an amount_off, that amount will be subtracted from any invoice's subtotal. For example, an invoice with a subtotal of 100 will have a final total of 0 if a coupon with an amount_off of 200 is applied to it and an invoice with a subtotal of 300 will have a final total of 100 if a coupon with an amount_off of 200 is applied to it.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/coupons", params: params, opts: opts)
+    end
+
+    # You can delete coupons via the [coupon management](https://dashboard.stripe.com/coupons) page of the Stripe dashboard. However, deleting a coupon does not affect any customers who have already applied the coupon; it means that new customers can't redeem the coupon. You can also delete coupons via the API.
+    def self.delete(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: format("/v1/coupons/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # You can delete coupons via the [coupon management](https://dashboard.stripe.com/coupons) page of the Stripe dashboard. However, deleting a coupon does not affect any customers who have already applied the coupon; it means that new customers can't redeem the coupon. You can also delete coupons via the API.
+    def delete(params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: format("/v1/coupons/%<coupon>s", { coupon: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Returns a list of your coupons.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/coupons", params: filters, opts: opts)
+    end
+
+    # Updates the metadata of a coupon. Other coupon details (currency, duration, amount_off) are, by design, not editable.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/coupons/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end

data/lib/stripe/resources/credit_note.rb

@@ -11,16 +11,34 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "credit_note"
+    def self.object_name
+      "credit_note"
+    end
 
-    def void_credit_note(params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/credit_notes/%<id>s/void", { id: CGI.escape(self["id"]) }),
-        params: params,
-        opts: opts
-      )
+    # Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces
+    # its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result
+    # in any combination of the following:
+    #
+    #
+    # Refund: create a new refund (using refund_amount) or link an existing refund (using refund).
+    # Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
+    # Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
+    #
+    #
+    # For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total.
+    #
+    # You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount
+    # or post_payment_credit_notes_amount depending on its status at the time of credit note creation.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/credit_notes", params: params, opts: opts)
+    end
+
+    # Returns a list of credit notes.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/credit_notes", params: filters, opts: opts)
     end
 
+    # When retrieving a credit note preview, you'll get a lines property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items.
     def self.list_preview_line_items(params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -30,6 +48,7 @@ module Stripe
       )
     end
 
+    # Get a preview of a credit note without creating it.
     def self.preview(params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -39,6 +58,27 @@ module Stripe
       )
     end
 
+    # Updates an existing credit note.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/credit_notes/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+    def void_credit_note(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/credit_notes/%<id>s/void", { id: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
     def self.void_credit_note(id, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/credit_note_line_item.rb

@@ -5,5 +5,8 @@ module Stripe
   # The credit note line item object
   class CreditNoteLineItem < StripeObject
     OBJECT_NAME = "credit_note_line_item"
+    def self.object_name
+      "credit_note_line_item"
+    end
   end
 end

data/lib/stripe/resources/customer.rb

@@ -9,16 +9,28 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::NestedResource
     extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
-    extend Stripe::APIOperations::NestedResource
 
     OBJECT_NAME = "customer"
+    def self.object_name
+      "customer"
+    end
 
     nested_resource_class_methods :balance_transaction, operations: %i[create retrieve update list]
     nested_resource_class_methods :cash_balance_transaction, operations: %i[retrieve list]
+    nested_resource_class_methods :source, operations: %i[create retrieve update delete list]
     nested_resource_class_methods :tax_id, operations: %i[create retrieve delete list]
 
+    # Creates a new customer object.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/customers", params: params, opts: opts)
+    end
+
+    # Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist for the customer, new
+    # funding instructions will be created. If funding instructions have already been created for a given customer, the same
+    # funding instructions will be retrieved. In other words, we will return the same funding instructions each time.
     def create_funding_instructions(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -28,42 +40,49 @@ module Stripe
       )
     end
 
-    def delete_discount(params = {}, opts = {})
+    # Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist for the customer, new
+    # funding instructions will be created. If funding instructions have already been created for a given customer, the same
+    # funding instructions will be retrieved. In other words, we will return the same funding instructions each time.
+    def self.create_funding_instructions(customer, params = {}, opts = {})
       request_stripe_object(
-        method: :delete,
-        path: format("/v1/customers/%<customer>s/discount", { customer: CGI.escape(self["id"]) }),
+        method: :post,
+        path: format("/v1/customers/%<customer>s/funding_instructions", { customer: CGI.escape(customer) }),
         params: params,
         opts: opts
       )
     end
 
-    def list_payment_methods(params = {}, opts = {})
+    # Permanently deletes a customer. It cannot be undone. Also immediately cancels any active subscriptions on the customer.
+    def self.delete(id, params = {}, opts = {})
       request_stripe_object(
-        method: :get,
-        path: format("/v1/customers/%<customer>s/payment_methods", { customer: CGI.escape(self["id"]) }),
+        method: :delete,
+        path: format("/v1/customers/%<id>s", { id: CGI.escape(id) }),
         params: params,
         opts: opts
       )
     end
 
-    def retrieve_payment_method(payment_method, params = {}, opts = {})
+    # Permanently deletes a customer. It cannot be undone. Also immediately cancels any active subscriptions on the customer.
+    def delete(params = {}, opts = {})
       request_stripe_object(
-        method: :get,
-        path: format("/v1/customers/%<customer>s/payment_methods/%<payment_method>s", { customer: CGI.escape(self["id"]), payment_method: CGI.escape(payment_method) }),
+        method: :delete,
+        path: format("/v1/customers/%<customer>s", { customer: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
-    def self.create_funding_instructions(customer, params = {}, opts = {})
+    # Removes the currently applied discount on a customer.
+    def delete_discount(params = {}, opts = {})
       request_stripe_object(
-        method: :post,
-        path: format("/v1/customers/%<customer>s/funding_instructions", { customer: CGI.escape(customer) }),
+        method: :delete,
+        path: format("/v1/customers/%<customer>s/discount", { customer: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
     end
 
+    # Removes the currently applied discount on a customer.
     def self.delete_discount(customer, params = {}, opts = {})
       request_stripe_object(
         method: :delete,
@@ -73,6 +92,22 @@ module Stripe
       )
     end
 
+    # Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/customers", params: filters, opts: opts)
+    end
+
+    # Returns a list of PaymentMethods for a given Customer
+    def list_payment_methods(params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/customers/%<customer>s/payment_methods", { customer: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Returns a list of PaymentMethods for a given Customer
     def self.list_payment_methods(customer, params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -82,42 +117,57 @@ module Stripe
       )
     end
 
-    def self.retrieve_payment_method(customer, payment_method, params = {}, opts = {})
+    # Retrieves a customer's cash balance.
+    def self.retrieve_cash_balance(customer, params = {}, opts = {})
       request_stripe_object(
         method: :get,
-        path: format("/v1/customers/%<customer>s/payment_methods/%<payment_method>s", { customer: CGI.escape(customer), payment_method: CGI.escape(payment_method) }),
+        path: format("/v1/customers/%<customer>s/cash_balance", { customer: CGI.escape(customer) }),
         params: params,
         opts: opts
       )
     end
 
-    save_nested_resource :source
-    nested_resource_class_methods :source,
-                                  operations: %i[create retrieve update delete list]
+    # Retrieves a PaymentMethod object for a given Customer.
+    def retrieve_payment_method(payment_method, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/customers/%<customer>s/payment_methods/%<payment_method>s", { customer: CGI.escape(self["id"]), payment_method: CGI.escape(payment_method) }),
+        params: params,
+        opts: opts
+      )
+    end
 
-    # The API request for deleting a card or bank account and for detaching a
-    # source object are the same.
-    class << self
-      alias detach_source delete_source
+    # Retrieves a PaymentMethod object for a given Customer.
+    def self.retrieve_payment_method(customer, payment_method, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/customers/%<customer>s/payment_methods/%<payment_method>s", { customer: CGI.escape(customer), payment_method: CGI.escape(payment_method) }),
+        params: params,
+        opts: opts
+      )
     end
 
     def self.search(params = {}, opts = {})
-      _search("/v1/customers/search", params, opts)
+      request_stripe_object(method: :get, path: "/v1/customers/search", params: params, opts: opts)
     end
 
     def self.search_auto_paging_each(params = {}, opts = {}, &blk)
       search(params, opts).auto_paging_each(&blk)
     end
 
-    def self.retrieve_cash_balance(customer, params = {}, opts = {})
+    # Updates the specified customer by setting the values of the parameters passed. Any parameters not provided will be left unchanged. For example, if you pass the source parameter, that becomes the customer's active source (e.g., a card) to be used for all charges in the future. When you update a customer to a new valid card source by passing the source parameter: for each of the customer's current subscriptions, if the subscription bills automatically and is in the past_due state, then the latest open invoice for the subscription with automatic collection enabled will be retried. This retry will not count as an automatic retry, and will not affect the next regularly scheduled payment for the invoice. Changing the default_source for a customer will not trigger this behavior.
+    #
+    # This request accepts mostly the same arguments as the customer creation call.
+    def self.update(id, params = {}, opts = {})
       request_stripe_object(
-        method: :get,
-        path: format("/v1/customers/%<customer>s/cash_balance", { customer: CGI.escape(customer) }),
+        method: :post,
+        path: format("/v1/customers/%<id>s", { id: CGI.escape(id) }),
         params: params,
         opts: opts
       )
     end
 
+    # Changes the settings on a customer's cash balance.
     def self.update_cash_balance(customer, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -127,13 +177,25 @@ module Stripe
       )
     end
 
+    save_nested_resource :source
+
+    # The API request for deleting a card or bank account and for detaching a
+    # source object are the same.
+    class << self
+      alias detach_source delete_source
+    end
+
     def test_helpers
       TestHelpers.new(self)
     end
 
     class TestHelpers < APIResourceTestHelpers
       RESOURCE_CLASS = Customer
+      def self.resource_class
+        "Customer"
+      end
 
+      # Create an incoming testmode bank transfer
       def self.fund_cash_balance(customer, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -143,6 +205,7 @@ module Stripe
         )
       end
 
+      # Create an incoming testmode bank transfer
       def fund_cash_balance(params = {}, opts = {})
         @resource.request_stripe_object(
           method: :post,

data/lib/stripe/resources/customer_balance_transaction.rb

@@ -9,10 +9,12 @@ module Stripe
   #
   # Related guide: [Customer balance](https://stripe.com/docs/billing/customer/balance)
   class CustomerBalanceTransaction < APIResource
-    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "customer_balance_transaction"
+    def self.object_name
+      "customer_balance_transaction"
+    end
 
     def resource_url
       if !respond_to?(:customer) || customer.nil?

data/lib/stripe/resources/customer_cash_balance_transaction.rb

@@ -7,8 +7,9 @@ module Stripe
   # represent when funds are moved into or out of this balance. This includes funding by the customer, allocation
   # to payments, and refunds to the customer.
   class CustomerCashBalanceTransaction < APIResource
-    extend Stripe::APIOperations::List
-
     OBJECT_NAME = "customer_cash_balance_transaction"
+    def self.object_name
+      "customer_cash_balance_transaction"
+    end
   end
 end

data/lib/stripe/resources/customer_session.rb

@@ -0,0 +1,29 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A Customer Session allows you to grant Stripe's frontend SDKs (like Stripe.js) client-side access
+  # control over a Customer.
+  #
+  # Related guides: [Customer Session with the Payment Element](https://stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
+  # [Customer Session with the Pricing Table](https://stripe.com/payments/checkout/pricing-table#customer-session),
+  # [Customer Session with the Buy Button](https://stripe.com/payment-links/buy-button#pass-an-existing-customer).
+  class CustomerSession < APIResource
+    extend Stripe::APIOperations::Create
+
+    OBJECT_NAME = "customer_session"
+    def self.object_name
+      "customer_session"
+    end
+
+    # Creates a Customer Session object that includes a single-use client secret that you can use on your front-end to grant client-side API access for certain customer resources.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: "/v1/customer_sessions",
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/discount.rb

@@ -8,5 +8,8 @@ module Stripe
   # Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)
   class Discount < StripeObject
     OBJECT_NAME = "discount"
+    def self.object_name
+      "discount"
+    end
   end
 end

data/lib/stripe/resources/dispute.rb

@@ -12,7 +12,13 @@ module Stripe
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "dispute"
+    def self.object_name
+      "dispute"
+    end
 
+    # Closing the dispute for a charge indicates that you do not have any evidence to submit and are essentially dismissing the dispute, acknowledging it as lost.
+    #
+    # The status of the dispute will change from needs_response to lost. Closing a dispute is irreversible.
     def close(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -22,6 +28,9 @@ module Stripe
       )
     end
 
+    # Closing the dispute for a charge indicates that you do not have any evidence to submit and are essentially dismissing the dispute, acknowledging it as lost.
+    #
+    # The status of the dispute will change from needs_response to lost. Closing a dispute is irreversible.
     def self.close(dispute, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -30,5 +39,22 @@ module Stripe
         opts: opts
       )
     end
+
+    # Returns a list of your disputes.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/disputes", params: filters, opts: opts)
+    end
+
+    # When you get a dispute, contacting your customer is always the best first step. If that doesn't work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your [dashboard](https://dashboard.stripe.com/disputes), but if you prefer, you can use the API to submit evidence programmatically.
+    #
+    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://stripe.com/docs/disputes/categories).
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/disputes/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
   end
 end