stripe 4.10.0 → 5.0.0

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

@@ -5,15 +5,17 @@ module Stripe
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "dispute".freeze
+    OBJECT_NAME = "dispute"
 
-    def close(params = {}, opts = {})
-      resp, opts = request(:post, close_url, params, opts)
-      initialize_from(resp.data, opts)
-    end
+    custom_method :close, http_verb: :post
 
-    def close_url
-      resource_url + "/close"
+    def close(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/close",
+        params: params,
+        opts: opts
+      )
     end
   end
 end

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

@@ -5,11 +5,14 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
 
-    OBJECT_NAME = "ephemeral_key".freeze
+    OBJECT_NAME = "ephemeral_key"
 
     def self.create(params = {}, opts = {})
       opts = Util.normalize_opts(opts)
-      raise ArgumentError, "stripe_version must be specified to create an ephemeral key" unless opts[:stripe_version]
+      unless opts[:stripe_version]
+        raise ArgumentError,
+              "stripe_version must be specified to create an ephemeral key"
+      end
       super
     end
   end

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

@@ -4,6 +4,6 @@ module Stripe
   class Event < APIResource
     extend Stripe::APIOperations::List
 
-    OBJECT_NAME = "event".freeze
+    OBJECT_NAME = "event"
   end
 end

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

@@ -4,6 +4,6 @@ module Stripe
   class ExchangeRate < APIResource
     extend Stripe::APIOperations::List
 
-    OBJECT_NAME = "exchange_rate".freeze
+    OBJECT_NAME = "exchange_rate"
   end
 end

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

@@ -5,33 +5,30 @@ module Stripe
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
 
+    OBJECT_NAME = "file"
+
     # This resource can have two different object names. In latter API
     # versions, only `file` is used, but since stripe-ruby may be used with
     # any API version, we need to support deserializing the older
     # `file_upload` object into the same class.
-    OBJECT_NAME = "file".freeze
-    OBJECT_NAME_ALT = "file_upload".freeze
+    OBJECT_NAME_ALT = "file_upload"
 
     def self.resource_url
       "/v1/files"
     end
 
     def self.create(params = {}, opts = {})
-      # rest-client would accept a vanilla `File` for upload, but Faraday does
-      # not. Support the old API by wrapping a `File`-like object with an
-      # `UploadIO` object if we're given one.
-      if params[:file] && params[:file].respond_to?(:path) && params[:file].respond_to?(:read)
-        params[:file] = Faraday::UploadIO.new(params[:file], nil)
+      if params[:file] && !params[:file].is_a?(String)
+        unless params[:file].respond_to?(:read)
+          raise ArgumentError, "file must respond to `#read`"
+        end
       end
 
       opts = {
         api_base: Stripe.uploads_base,
-        content_type: "multipart/form-data",
+        content_type: MultipartEncoder::MULTIPART_FORM_DATA,
       }.merge(Util.normalize_opts(opts))
       super
     end
   end
-
-  # For backwards compatibility, the `File` class is aliased to `FileUpload`.
-  FileUpload = File
 end

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

@@ -3,9 +3,9 @@
 module Stripe
   class FileLink < APIResource
     extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "file_link".freeze
+    OBJECT_NAME = "file_link"
   end
 end

data/lib/stripe/resources/invoice.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Invoice < APIResource
+    extend Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "invoice"
+
+    custom_method :finalize_invoice, http_verb: :post, http_path: "finalize"
+    custom_method :mark_uncollectible, http_verb: :post
+    custom_method :pay, http_verb: :post
+    custom_method :send_invoice, http_verb: :post, http_path: "send"
+    custom_method :void_invoice, http_verb: :post, http_path: "void"
+
+    def finalize_invoice(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/finalize",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def mark_uncollectible(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/mark_uncollectible",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def pay(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/pay",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def send_invoice(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/send",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def void_invoice(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/void",
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.upcoming(params, opts = {})
+      resp, opts = request(:get, resource_url + "/upcoming", params, opts)
+      Util.convert_to_stripe_object(resp.data, opts)
+    end
+
+    def self.list_upcoming_line_items(params, opts = {})
+      resp, opts = request(:get, resource_url + "/upcoming/lines", params, opts)
+      Util.convert_to_stripe_object(resp.data, opts)
+    end
+  end
+end

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

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

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

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

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    class Authorization < APIResource
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "issuing.authorization"
+
+      custom_method :approve, http_verb: :post
+      custom_method :decline, http_verb: :post
+
+      def approve(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: resource_url + "/approve",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def decline(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: resource_url + "/decline",
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    class Card < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "issuing.card"
+
+      custom_method :details, http_verb: :get
+
+      def details(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: resource_url + "/details",
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/{issuing → resources/issuing}/card_details.rb

@@ -3,7 +3,7 @@
 module Stripe
   module Issuing
     class CardDetails < Stripe::StripeObject
-      OBJECT_NAME = "issuing.card_details".freeze
+      OBJECT_NAME = "issuing.card_details"
     end
   end
 end

data/lib/stripe/{issuing → resources/issuing}/cardholder.rb

@@ -2,12 +2,12 @@
 
 module Stripe
   module Issuing
-    class Cardholder < Stripe::APIResource
+    class Cardholder < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
-      OBJECT_NAME = "issuing.cardholder".freeze
+      OBJECT_NAME = "issuing.cardholder"
     end
   end
 end

data/lib/stripe/{issuing → resources/issuing}/dispute.rb

@@ -2,12 +2,12 @@
 
 module Stripe
   module Issuing
-    class Dispute < Stripe::APIResource
+    class Dispute < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
-      OBJECT_NAME = "issuing.dispute".freeze
+      OBJECT_NAME = "issuing.dispute"
     end
   end
 end

data/lib/stripe/{issuing → resources/issuing}/transaction.rb

@@ -2,11 +2,11 @@
 
 module Stripe
   module Issuing
-    class Transaction < Stripe::APIResource
+    class Transaction < APIResource
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
-      OBJECT_NAME = "issuing.transaction".freeze
+      OBJECT_NAME = "issuing.transaction"
     end
   end
 end

data/lib/stripe/resources/login_link.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Stripe
+  class LoginLink < APIResource
+    OBJECT_NAME = "login_link"
+
+    def self.retrieve(_id, _opts = nil)
+      raise NotImplementedError,
+            "Login links do not have IDs and cannot be retrieved. They can " \
+            "only be created using `Account.create_login_link('account_id', " \
+            "create_params)`"
+    end
+  end
+end

data/lib/stripe/resources/order.rb

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

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

@@ -4,6 +4,6 @@ module Stripe
   class OrderReturn < APIResource
     extend Stripe::APIOperations::List
 
-    OBJECT_NAME = "order_return".freeze
+    OBJECT_NAME = "order_return"
   end
 end

data/lib/stripe/resources/payment_intent.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Stripe
+  class PaymentIntent < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "payment_intent"
+
+    custom_method :cancel, http_verb: :post
+    custom_method :capture, 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 capture(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: resource_url + "/capture",
+        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/resources/payment_method.rb

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

data/lib/stripe/resources/payout.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Payout < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "payout"
+
+    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/{person.rb → resources/person.rb}

@@ -5,7 +5,7 @@ module Stripe
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "person".freeze
+    OBJECT_NAME = "person"
 
     def resource_url
       if !respond_to?(:account) || account.nil?
@@ -16,11 +16,16 @@ module Stripe
     end
 
     def self.retrieve(_id, _opts = {})
-      raise NotImplementedError, "Persons cannot be retrieved without an account ID. Retrieve a person using account.persons.retrieve('person_id')"
+      raise NotImplementedError,
+            "Persons cannot be retrieved without an account ID. Retrieve a " \
+            "person using `Account.retrieve_person('account_id', 'person_id')`"
     end
 
     def self.update(_id, _params = nil, _opts = nil)
-      raise NotImplementedError, "Persons cannot be updated without an account ID. Update a person using `p = account.persons.retrieve('person_id'); p.save`"
+      raise NotImplementedError,
+            "Persons cannot be updated without an account ID. Update a " \
+            "person using `Account.update_person('account_id', 'person_id', " \
+            "update_params)`"
     end
   end
 end

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

@@ -7,6 +7,6 @@ module Stripe
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "plan".freeze
+    OBJECT_NAME = "plan"
   end
 end

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

@@ -2,11 +2,11 @@
 
 module Stripe
   class Product < 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 = "product".freeze
+    OBJECT_NAME = "product"
   end
 end

data/lib/stripe/resources/radar/early_fraud_warning.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Stripe
+  module Radar
+    class EarlyFraudWarning < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "radar.early_fraud_warning"
+    end
+  end
+end

data/lib/stripe/{radar → resources/radar}/value_list.rb

@@ -2,13 +2,13 @@
 
 module Stripe
   module Radar
-    class ValueList < Stripe::APIResource
+    class ValueList < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 
-      OBJECT_NAME = "radar.value_list".freeze
+      OBJECT_NAME = "radar.value_list"
     end
   end
 end

data/lib/stripe/{radar → resources/radar}/value_list_item.rb

@@ -2,12 +2,12 @@
 
 module Stripe
   module Radar
-    class ValueListItem < Stripe::APIResource
+    class ValueListItem < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List
 
-      OBJECT_NAME = "radar.value_list_item".freeze
+      OBJECT_NAME = "radar.value_list_item"
     end
   end
 end

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

@@ -5,13 +5,9 @@ module Stripe
   class Recipient < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "recipient".freeze
-
-    def transfers
-      Transfer.all({ recipient: id }, @api_key)
-    end
+    OBJECT_NAME = "recipient"
   end
 end

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

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

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

@@ -6,6 +6,6 @@ module Stripe
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
-    OBJECT_NAME = "refund".freeze
+    OBJECT_NAME = "refund"
   end
 end

data/lib/stripe/{reporting → resources/reporting}/report_run.rb

@@ -2,11 +2,11 @@
 
 module Stripe
   module Reporting
-    class ReportRun < Stripe::APIResource
+    class ReportRun < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
 
-      OBJECT_NAME = "reporting.report_run".freeze
+      OBJECT_NAME = "reporting.report_run"
     end
   end
 end

data/lib/stripe/{reporting → resources/reporting}/report_type.rb

@@ -2,11 +2,11 @@
 
 module Stripe
   module Reporting
-    class ReportType < Stripe::APIResource
+    class ReportType < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
 
-      OBJECT_NAME = "reporting.report_type".freeze
+      OBJECT_NAME = "reporting.report_type"
     end
   end
 end