stripe 4.10.0 → 5.0.0

data/lib/stripe/resources/reversal.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Reversal < APIResource
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "transfer_reversal"
+
+    def resource_url
+      "#{Transfer.resource_url}/#{CGI.escape(transfer)}/reversals" \
+      "/#{CGI.escape(id)}"
+    end
+
+    def self.update(_id, _params = nil, _opts = nil)
+      raise NotImplementedError,
+            "Reversals cannot be updated without a transfer ID. Update a " \
+            "reversal using `r = Transfer.update_reversal('transfer_id', " \
+            "'reversal_id', update_params)`"
+    end
+
+    def self.retrieve(_id, _opts = {})
+      raise NotImplementedError,
+            "Reversals cannot be retrieved without a transfer ID. Retrieve " \
+             "a reversal using `Transfer.retrieve_reversal('transfer_id', " \
+             "'reversal_id')`"
+    end
+  end
+end

data/lib/stripe/resources/review.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Review < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "review"
+
+    custom_method :approve, http_verb: :post
+
+    def approve(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/approve",
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/setup_intent.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Stripe
+  class SetupIntent < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "setup_intent"
+
+    custom_method :cancel, http_verb: :post
+    custom_method :confirm, http_verb: :post
+
+    def cancel(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/cancel",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def confirm(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/confirm",
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/{sigma → resources/sigma}/scheduled_query_run.rb

@@ -2,10 +2,10 @@
 
 module Stripe
   module Sigma
-    class ScheduledQueryRun < Stripe::APIResource
+    class ScheduledQueryRun < APIResource
       extend Stripe::APIOperations::List
 
-      OBJECT_NAME = "scheduled_query_run".freeze
+      OBJECT_NAME = "scheduled_query_run"
 
       def self.resource_url
         "/v1/sigma/scheduled_query_runs"

data/lib/stripe/{sku.rb → resources/sku.rb}

@@ -2,11 +2,11 @@
 
 module Stripe
   class SKU < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Save
     include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "sku".freeze
+    OBJECT_NAME = "sku"
   end
 end

data/lib/stripe/{source.rb → resources/source.rb}

@@ -5,7 +5,18 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "source".freeze
+    OBJECT_NAME = "source"
+
+    custom_method :verify, http_verb: :post
+
+    def verify(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/verify",
+        params: params,
+        opts: opts
+      )
+    end
 
     def detach(params = {}, opts = {})
       if !respond_to?(:customer) || customer.nil? || customer.empty?
@@ -14,25 +25,16 @@ module Stripe
               "to a customer object."
       end
 
-      url = "#{Customer.resource_url}/#{CGI.escape(customer)}/sources/#{CGI.escape(id)}"
-      resp, opts = request(:delete, url, params, Util.normalize_opts(opts))
+      url = "#{Customer.resource_url}/#{CGI.escape(customer)}/sources" \
+            "/#{CGI.escape(id)}"
+      resp, opts = request(:delete, url, params, opts)
       initialize_from(resp.data, opts)
     end
 
-    def delete(params = {}, opts = {})
-      detach(params, opts)
-    end
-    extend Gem::Deprecate
-    deprecate :delete, "#detach", 2017, 10
-
     def source_transactions(params = {}, opts = {})
-      resp, opts = request(:get, resource_url + "/source_transactions", params, Util.normalize_opts(opts))
+      resp, opts = request(:get, resource_url + "/source_transactions", params,
+                           opts)
       Util.convert_to_stripe_object(resp.data, opts)
     end
-
-    def verify(params = {}, opts = {})
-      resp, opts = request(:post, resource_url + "/verify", params, Util.normalize_opts(opts))
-      initialize_from(resp.data, opts)
-    end
   end
 end

data/lib/stripe/{source_transaction.rb → resources/source_transaction.rb}

@@ -2,6 +2,6 @@
 
 module Stripe
   class SourceTransaction < StripeObject
-    OBJECT_NAME = "source_transaction".freeze
+    OBJECT_NAME = "source_transaction"
   end
 end

data/lib/stripe/resources/subscription.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Subscription < APIResource
+    extend Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "subscription"
+
+    custom_method :delete_discount, http_verb: :delete, http_path: "discount"
+
+    def delete_discount(params = {}, opts = {})
+      request_stripe_object(
+        method: :delete,
+        path: resource_url + "/discount",
+        params: params,
+        opts: opts
+      )
+    end
+
+    save_nested_resource :source
+  end
+end

data/lib/stripe/{subscription_item.rb → resources/subscription_item.rb}

@@ -6,11 +6,14 @@ module Stripe
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
+    extend Stripe::APIOperations::NestedResource
 
-    OBJECT_NAME = "subscription_item".freeze
+    OBJECT_NAME = "subscription_item"
+
+    nested_resource_class_methods :usage_record, operations: %i[create]
 
     def usage_record_summaries(params = {}, opts = {})
-      resp, opts = request(:get, resource_url + "/usage_record_summaries", params, Util.normalize_opts(opts))
+      resp, opts = request(:get, resource_url + "/usage_record_summaries", params, opts)
       Util.convert_to_stripe_object(resp.data, opts)
     end
   end

data/lib/stripe/resources/subscription_schedule.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Stripe
+  class SubscriptionSchedule < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "subscription_schedule"
+
+    custom_method :cancel, http_verb: :post
+    custom_method :release, http_verb: :post
+
+    def cancel(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/cancel",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def release(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/release",
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/tax_id.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Stripe
+  class TaxId < APIResource
+    include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "tax_id"
+
+    def resource_url
+      if !respond_to?(:customer) || customer.nil?
+        raise NotImplementedError,
+              "Tax IDs cannot be accessed without a customer ID."
+      end
+      "#{Customer.resource_url}/#{CGI.escape(customer)}/tax_ids" \
+      "/#{CGI.escape(id)}"
+    end
+
+    def self.retrieve(_id, _opts = {})
+      raise NotImplementedError,
+            "Tax IDs cannot be retrieved without a customer ID. Retrieve a " \
+            "tax ID using `Customer.retrieve_tax_id('customer_id', " \
+            "'tax_id_id')`"
+    end
+  end
+end

data/lib/stripe/resources/tax_rate.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Stripe
+  class TaxRate < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "tax_rate"
+  end
+end

data/lib/stripe/{terminal → resources/terminal}/connection_token.rb

@@ -2,10 +2,10 @@
 
 module Stripe
   module Terminal
-    class ConnectionToken < Stripe::APIResource
+    class ConnectionToken < APIResource
       extend Stripe::APIOperations::Create
 
-      OBJECT_NAME = "terminal.connection_token".freeze
+      OBJECT_NAME = "terminal.connection_token"
     end
   end
 end

data/lib/stripe/{terminal → resources/terminal}/location.rb

@@ -2,13 +2,13 @@
 
 module Stripe
   module Terminal
-    class Location < Stripe::APIResource
+    class Location < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
-      OBJECT_NAME = "terminal.location".freeze
+      OBJECT_NAME = "terminal.location"
     end
   end
 end

data/lib/stripe/{terminal → resources/terminal}/reader.rb

@@ -2,13 +2,13 @@
 
 module Stripe
   module Terminal
-    class Reader < Stripe::APIResource
+    class Reader < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
-      OBJECT_NAME = "terminal.reader".freeze
+      OBJECT_NAME = "terminal.reader"
     end
   end
 end

data/lib/stripe/{three_d_secure.rb → resources/three_d_secure.rb}

@@ -4,7 +4,7 @@ module Stripe
   class ThreeDSecure < APIResource
     extend Stripe::APIOperations::Create
 
-    OBJECT_NAME = "three_d_secure".freeze
+    OBJECT_NAME = "three_d_secure"
 
     def self.resource_url
       "/v1/3d_secure"

data/lib/stripe/{token.rb → resources/token.rb}

@@ -4,6 +4,6 @@ module Stripe
   class Token < APIResource
     extend Stripe::APIOperations::Create
 
-    OBJECT_NAME = "token".freeze
+    OBJECT_NAME = "token"
   end
 end

data/lib/stripe/resources/topup.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Topup < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "topup"
+
+    custom_method :cancel, http_verb: :post
+
+    def cancel(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/cancel",
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/transfer.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Transfer < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+    extend Stripe::APIOperations::NestedResource
+
+    OBJECT_NAME = "transfer"
+
+    custom_method :cancel, http_verb: :post
+
+    nested_resource_class_methods :reversal,
+                                  operations: %i[create retrieve update list]
+
+    def cancel(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/cancel",
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/usage_record.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Stripe
+  class UsageRecord < APIResource
+    OBJECT_NAME = "usage_record"
+  end
+end

data/lib/stripe/{usage_record_summary.rb → resources/usage_record_summary.rb}

@@ -2,6 +2,6 @@
 
 module Stripe
   class UsageRecordSummary < StripeObject
-    OBJECT_NAME = "usage_record_summary".freeze
+    OBJECT_NAME = "usage_record_summary"
   end
 end

data/lib/stripe/{webhook_endpoint.rb → resources/webhook_endpoint.rb}

@@ -3,10 +3,10 @@
 module Stripe
   class WebhookEndpoint < APIResource
     extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Save
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "webhook_endpoint".freeze
+    OBJECT_NAME = "webhook_endpoint"
   end
 end

data/lib/stripe/resources.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "stripe/resources/account"
+require "stripe/resources/account_link"
+require "stripe/resources/alipay_account"
+require "stripe/resources/apple_pay_domain"
+require "stripe/resources/application_fee"
+require "stripe/resources/application_fee_refund"
+require "stripe/resources/balance"
+require "stripe/resources/balance_transaction"
+require "stripe/resources/bank_account"
+require "stripe/resources/bitcoin_receiver"
+require "stripe/resources/bitcoin_transaction"
+require "stripe/resources/capability"
+require "stripe/resources/card"
+require "stripe/resources/charge"
+require "stripe/resources/checkout/session"
+require "stripe/resources/country_spec"
+require "stripe/resources/coupon"
+require "stripe/resources/credit_note"
+require "stripe/resources/customer"
+require "stripe/resources/customer_balance_transaction"
+require "stripe/resources/discount"
+require "stripe/resources/dispute"
+require "stripe/resources/ephemeral_key"
+require "stripe/resources/event"
+require "stripe/resources/exchange_rate"
+require "stripe/resources/file"
+require "stripe/resources/file_link"
+require "stripe/resources/invoice"
+require "stripe/resources/invoice_item"
+require "stripe/resources/invoice_line_item"
+require "stripe/resources/issuing/authorization"
+require "stripe/resources/issuing/card"
+require "stripe/resources/issuing/card_details"
+require "stripe/resources/issuing/cardholder"
+require "stripe/resources/issuing/dispute"
+require "stripe/resources/issuing/transaction"
+require "stripe/resources/login_link"
+require "stripe/resources/order"
+require "stripe/resources/order_return"
+require "stripe/resources/payment_intent"
+require "stripe/resources/payment_method"
+require "stripe/resources/payout"
+require "stripe/resources/person"
+require "stripe/resources/plan"
+require "stripe/resources/product"
+require "stripe/resources/radar/early_fraud_warning"
+require "stripe/resources/radar/value_list"
+require "stripe/resources/radar/value_list_item"
+require "stripe/resources/recipient"
+require "stripe/resources/recipient_transfer"
+require "stripe/resources/refund"
+require "stripe/resources/reporting/report_run"
+require "stripe/resources/reporting/report_type"
+require "stripe/resources/reversal"
+require "stripe/resources/review"
+require "stripe/resources/setup_intent"
+require "stripe/resources/sigma/scheduled_query_run"
+require "stripe/resources/sku"
+require "stripe/resources/source"
+require "stripe/resources/source_transaction"
+require "stripe/resources/subscription"
+require "stripe/resources/subscription_item"
+require "stripe/resources/subscription_schedule"
+require "stripe/resources/tax_id"
+require "stripe/resources/tax_rate"
+require "stripe/resources/terminal/connection_token"
+require "stripe/resources/terminal/location"
+require "stripe/resources/terminal/reader"
+require "stripe/resources/three_d_secure"
+require "stripe/resources/token"
+require "stripe/resources/topup"
+require "stripe/resources/transfer"
+require "stripe/resources/usage_record"
+require "stripe/resources/usage_record_summary"
+require "stripe/resources/webhook_endpoint"

data/lib/stripe/singleton_api_resource.rb

@@ -4,7 +4,9 @@ module Stripe
   class SingletonAPIResource < APIResource
     def self.resource_url
       if self == SingletonAPIResource
-        raise NotImplementedError, "SingletonAPIResource is an abstract class.  You should perform actions on its subclasses (Account, etc.)"
+        raise NotImplementedError,
+              "SingletonAPIResource is an abstract class. You should " \
+              "perform actions on its subclasses (Balance, etc.)"
       end
       # Namespaces are separated in object names with periods (.) and in URLs
       # with forward slashes (/), so replace the former with the latter.