bongloy 4.21.3

data/lib/stripe/resources/bitcoin_transaction.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Stripe
+  class BitcoinTransaction < APIResource
+    # Directly retrieving BitcoinTransactions is deprecated. Please use the
+    # Sources API instead: https://stripe.com/docs/sources/bitcoin
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "bitcoin_transaction".freeze
+
+    def self.resource_url
+      "/v1/bitcoin/transactions"
+    end
+  end
+end

data/lib/stripe/resources/capability.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Capability < APIResource
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "capability".freeze
+
+    def resource_url
+      if !respond_to?(:account) || account.nil?
+        raise NotImplementedError,
+              "Capabilities cannot be accessed without an account ID."
+      end
+      "#{Account.resource_url}/#{CGI.escape(account)}/capabilities" \
+      "/#{CGI.escape(id)}"
+    end
+
+    def self.retrieve(_id, _opts = {})
+      raise NotImplementedError,
+            "Capabilities cannot be retrieve without an account ID. " \
+            "Retrieve a capability using Account.retrieve_capability(" \
+            "'account_id', 'capability_id')`"
+    end
+
+    def self.update(_id, _params = nil, _opts = nil)
+      raise NotImplementedError,
+            "Capabilities cannot be updated without an account ID. Update a " \
+            "capability using Account.update_capability('account_id', " \
+            "'capability_id', update_params)`"
+    end
+  end
+end

data/lib/stripe/resources/card.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Card < APIResource
+    include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "card".freeze
+
+    def resource_url
+      if respond_to?(:recipient) && !recipient.nil? && !recipient.empty?
+        "#{Recipient.resource_url}/#{CGI.escape(recipient)}/cards/#{CGI.escape(id)}"
+      elsif respond_to?(:customer) && !customer.nil? && !customer.empty?
+        "#{Customer.resource_url}/#{CGI.escape(customer)}/sources/#{CGI.escape(id)}"
+      elsif respond_to?(:account) && !account.nil? && !account.empty?
+        "#{Account.resource_url}/#{CGI.escape(account)}/external_accounts/#{CGI.escape(id)}"
+      end
+    end
+
+    def self.update(_id, _params = nil, _opts = nil)
+      raise NotImplementedError,
+            "Card cannot be updated without a customer ID or an account ID. " \
+            "Update a card using `Customer.update_source('customer_id', " \
+            "'card_id', update_params)` or `Account.update_external_account(" \
+            "'account_id', 'card_id', update_params)`"
+    end
+
+    def self.retrieve(_id, _opts = nil)
+      raise NotImplementedError,
+            "Card cannot be retrieved without a customer ID or an account " \
+            "ID. Retrieve a card using `Customer.retrieve_source(" \
+            "'customer_id', 'card_id')` or " \
+            "`Account.retrieve_external_account('account_id', 'card_id')`"
+    end
+  end
+end

data/lib/stripe/resources/charge.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Charge < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "charge".freeze
+
+    custom_method :capture, http_verb: :post
+
+    def refund(params = {}, opts = {})
+      # Old versions of charge objects included a `refunds` field that was just
+      # a vanilla array instead of a Stripe list object.
+      #
+      # Where possible, we'd still like to use the new refund endpoint (thus
+      # `self.refunds.create`), but detect the old API version by looking for
+      # an `Array` and fall back to the old refund URL if necessary so as to
+      # maintain internal compatibility.
+      if refunds.is_a?(Array)
+        resp, opts = request(:post, refund_url, params, opts)
+        initialize_from(resp.data, opts)
+      else
+        refunds.create(params, opts)
+
+        # now that a refund has been created, we expect the state of this object
+        # to change as well (i.e. `refunded` will now be `true`) so refresh it
+        # from the server
+        refresh
+      end
+    end
+
+    def capture(params = {}, opts = {})
+      resp, opts = request(:post, capture_url, params, opts)
+      initialize_from(resp.data, opts)
+    end
+
+    def update_dispute(params = {}, opts = {})
+      resp, opts = request(:post, dispute_url, params, opts)
+      initialize_from({ dispute: resp.data }, opts, true)
+      dispute
+    end
+
+    def close_dispute(params = {}, opts = {})
+      resp, opts = request(:post, close_dispute_url, params, opts)
+      initialize_from(resp.data, opts)
+    end
+
+    def mark_as_fraudulent
+      params = {
+        fraud_details: { user_report: "fraudulent" },
+      }
+      resp, opts = request(:post, resource_url, params)
+      initialize_from(resp.data, opts)
+    end
+
+    def mark_as_safe
+      params = {
+        fraud_details: { user_report: "safe" },
+      }
+      resp, opts = request(:post, resource_url, params)
+      initialize_from(resp.data, opts)
+    end
+
+    private def capture_url
+      resource_url + "/capture"
+    end
+
+    private def dispute_url
+      resource_url + "/dispute"
+    end
+
+    private def close_dispute_url
+      resource_url + "/dispute/close"
+    end
+
+    # Note that this is actually the *old* refund URL and its use is no longer
+    # preferred.
+    private def refund_url
+      resource_url + "/refund"
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Stripe
+  module Checkout
+    class Session < APIResource
+      extend Stripe::APIOperations::Create
+
+      OBJECT_NAME = "checkout.session".freeze
+    end
+  end
+end

data/lib/stripe/resources/country_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Stripe
+  class CountrySpec < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "country_spec".freeze
+  end
+end

data/lib/stripe/resources/coupon.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Coupon < APIResource
+    extend Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "coupon".freeze
+  end
+end

data/lib/stripe/resources/credit_note.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Stripe
+  class CreditNote < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "credit_note".freeze
+
+    custom_method :void_credit_note, http_verb: :post, http_path: "void"
+
+    def void_credit_note(params = {}, opts = {})
+      resp, opts = request(:post, resource_url + "/void", params, opts)
+      initialize_from(resp.data, opts)
+    end
+  end
+end

data/lib/stripe/resources/customer.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Customer < APIResource
+    extend Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+    extend Stripe::APIOperations::NestedResource
+
+    OBJECT_NAME = "customer".freeze
+
+    nested_resource_class_methods :balance_transaction,
+                                  operations: %i[create retrieve update list]
+    nested_resource_class_methods :tax_id,
+                                  operations: %i[create retrieve delete list]
+
+    custom_method :delete_discount, http_verb: :delete, http_path: "discount"
+
+    save_nested_resource :source
+    nested_resource_class_methods :source,
+                                  operations: %i[create retrieve update delete list]
+
+    # 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 add_invoice_item(params, opts = {})
+      opts = @opts.merge(Util.normalize_opts(opts))
+      InvoiceItem.create(params.merge(customer: id), opts)
+    end
+
+    def invoices(params = {}, opts = {})
+      opts = @opts.merge(Util.normalize_opts(opts))
+      Invoice.all(params.merge(customer: id), opts)
+    end
+
+    def invoice_items(params = {}, opts = {})
+      opts = @opts.merge(Util.normalize_opts(opts))
+      InvoiceItem.all(params.merge(customer: id), opts)
+    end
+
+    def upcoming_invoice(params = {}, opts = {})
+      opts = @opts.merge(Util.normalize_opts(opts))
+      Invoice.upcoming(params.merge(customer: id), opts)
+    end
+
+    def charges(params = {}, opts = {})
+      opts = @opts.merge(Util.normalize_opts(opts))
+      Charge.all(params.merge(customer: id), opts)
+    end
+
+    def create_upcoming_invoice(params = {}, opts = {})
+      opts = @opts.merge(Util.normalize_opts(opts))
+      Invoice.create(params.merge(customer: id), opts)
+    end
+
+    def cancel_subscription(params = {}, opts = {})
+      resp, opts = request(:delete, subscription_url, params, opts)
+      initialize_from({ subscription: resp.data }, opts, true)
+      subscription
+    end
+
+    def update_subscription(params = {}, opts = {})
+      resp, opts = request(:post, subscription_url, params, opts)
+      initialize_from({ subscription: resp.data }, opts, true)
+      subscription
+    end
+
+    def create_subscription(params = {}, opts = {})
+      resp, opts = request(:post, subscriptions_url, params, opts)
+      initialize_from({ subscription: resp.data }, opts, true)
+      subscription
+    end
+
+    def delete_discount
+      _, opts = request(:delete, discount_url)
+      initialize_from({ discount: nil }, opts, true)
+    end
+
+    private def discount_url
+      resource_url + "/discount"
+    end
+
+    private def subscription_url
+      resource_url + "/subscription"
+    end
+
+    private def subscriptions_url
+      resource_url + "/subscriptions"
+    end
+  end
+end

data/lib/stripe/resources/customer_balance_transaction.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Stripe
+  class CustomerBalanceTransaction < APIResource
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "customer_balance_transaction".freeze
+
+    def resource_url
+      if !respond_to?(:customer) || customer.nil?
+        raise NotImplementedError,
+              "Customer Balance Transactions cannot be accessed without a customer ID."
+      end
+      "#{Customer.resource_url}/#{CGI.escape(customer)}/balance_transactions/#{CGI.escape(id)}"
+    end
+
+    def self.retrieve(_id, _opts = {})
+      raise NotImplementedError,
+            "Customer Balance Transactions cannot be retrieved without a customer ID. " \
+            "Retrieve a Customer Balance Transaction using Customer.retrieve_balance_transaction('cus_123', 'cbtxn_123')"
+    end
+
+    def self.update(_id, _params = nil, _opts = nil)
+      raise NotImplementedError,
+            "Customer Balance Transactions cannot be retrieved without a customer ID. " \
+            "Update a Customer Balance Transaction using Customer.update_balance_transaction('cus_123', 'cbtxn_123', params)"
+    end
+  end
+end

data/lib/stripe/resources/discount.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Discount < StripeObject
+    OBJECT_NAME = "discount".freeze
+  end
+end

data/lib/stripe/resources/dispute.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Dispute < APIResource
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "dispute".freeze
+
+    custom_method :close, http_verb: :post
+
+    def close(params = {}, opts = {})
+      resp, opts = request(:post, resource_url + "/close", params, opts)
+      initialize_from(resp.data, opts)
+    end
+
+    def close_url
+      resource_url + "/close"
+    end
+    extend Gem::Deprecate
+    deprecate :close_url, :none, 2019, 11
+  end
+end

data/lib/stripe/resources/ephemeral_key.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Stripe
+  class EphemeralKey < APIResource
+    extend Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
+
+    OBJECT_NAME = "ephemeral_key".freeze
+
+    def self.create(params = {}, opts = {})
+      opts = Util.normalize_opts(opts)
+      unless opts[:stripe_version]
+        raise ArgumentError,
+              "stripe_version must be specified to create an ephemeral key"
+      end
+      super
+    end
+  end
+end

data/lib/stripe/resources/event.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Stripe
+  class Event < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "event".freeze
+  end
+end

data/lib/stripe/resources/exchange_rate.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Stripe
+  class ExchangeRate < APIResource
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "exchange_rate".freeze
+  end
+end

data/lib/stripe/resources/file.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Stripe
+  class File < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+
+    OBJECT_NAME = "file".freeze
+
+    # 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_ALT = "file_upload".freeze
+
+    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].is_a?(String)
+        unless params[:file].respond_to?(:read)
+          raise ArgumentError, "file must respond to `#read`"
+        end
+
+        params[:file] = Faraday::UploadIO.new(params[:file], nil)
+      end
+
+      opts = {
+        api_base: Stripe.uploads_base,
+        content_type: "multipart/form-data",
+      }.merge(Util.normalize_opts(opts))
+      super
+    end
+  end
+end
+
+module Stripe
+  # For backwards compatibility, the `File` class is aliased to `FileUpload`.
+  FileUpload = File
+end