stripe 4.16.0 → 4.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0934383f23cd5a8cf8c5b7f3ff4250a6921aac0e318c0444fc882430a2421e42'
-  data.tar.gz: f9f84de78f36c63215df15859cdbb46fab395fd34548eabee1d47431f71c4017
+  metadata.gz: 8d3a140d2d3cb343cb427df5438201a04e82a8eb71cb352241955e4ae70ca6c3
+  data.tar.gz: d6bac1ffd1f4b9b5210bdd684b443fd6c12f1cc8084a854e728c8893f1dc768f
 SHA512:
-  metadata.gz: cc3cc8d160145bfe10b7b36f1d9e7210f061d0778b637784c3efac214699332abfaf2411f35e05807fc4f4e433ae2354301fe0335581fa9793b9280b4ae01af7
-  data.tar.gz: 3983a67fb632d6388aea881a68999604a25ffeac73e55ebe88b477956d61ef43a85f9510c42926fc07dc9e7817e601d73cdc7760d155328d3340d815a23af5e5
+  metadata.gz: 2d88469f61576501ebe5e9795381aba16fa4452eae217c4721abe8159468a8489ad54a18e09384c337f3fdebae4a3e5e5d0ae100f3587c491c880472d4cdd7f3
+  data.tar.gz: 575ab9b320e2dd5642964ad6a0b125d6c28cac9cfaa98260bb86b4489369e5413531bf26a285b85dd68f2d5afbace0beabd754f967b4aaa9c295d6644bcab058

data/.travis.yml

@@ -17,7 +17,7 @@ sudo: false
 env:
   global:
     # If changing this number, please also change it in `test/test_helper.rb`.
-    - STRIPE_MOCK_VERSION=0.54.0
+    - STRIPE_MOCK_VERSION=0.56.0
 
 cache:
   directories:

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 4.17.0 - 2019-05-14
+* [#779](https://github.com/stripe/stripe-ruby/pull/779) Add support for the Capability resource and APIs
+
 ## 4.16.0 - 2019-04-24
 * [#760](https://github.com/stripe/stripe-ruby/pull/760) Add support for the `TaxRate` resource and APIs
 

data/README.md

@@ -95,6 +95,17 @@ Stripe::Charge.retrieve(
     :stripe_version => "2018-02-28"
   }
 )
+
+Stripe::Charge.retrieve(
+  {
+    id: 'ch_18atAXCdGbJFKhCuBAa4532Z',
+    expand: %w(balance_transaction)
+  },
+  {
+    stripe_version: '2018-02-28',
+    api_key: 'sk_test_...'
+  }
+)
 ```
 
 ### Configuring a Client

data/VERSION

@@ -1 +1 @@
-4.16.0
+4.17.0

data/lib/stripe.rb

@@ -47,6 +47,7 @@ require "stripe/balance_transaction"
 require "stripe/bank_account"
 require "stripe/bitcoin_receiver"
 require "stripe/bitcoin_transaction"
+require "stripe/capability"
 require "stripe/card"
 require "stripe/charge"
 require "stripe/checkout/session"

data/lib/stripe/account.rb

@@ -14,6 +14,9 @@ module Stripe
     custom_method :reject, http_verb: :post
 
     save_nested_resource :external_account
+    nested_resource_class_methods :capability,
+                                  operations: %i[retrieve update list],
+                                  resource_plural: "capabilities"
     nested_resource_class_methods :external_account,
                                   operations: %i[create retrieve update delete list]
     nested_resource_class_methods :login_link, operations: %i[create]
@@ -48,12 +51,14 @@ module Stripe
     end
 
     def persons(params = {}, opts = {})
-      resp, opts = request(:get, resource_url + "/persons", params, Util.normalize_opts(opts))
+      resp, opts = request(:get, resource_url + "/persons", params, opts)
       Util.convert_to_stripe_object(resp.data, opts)
     end
 
+    # We are not adding a helper for capabilities here as the Account object already has a
+    # capabilities property which is a hash and not the sub-list of capabilities.
+
     def reject(params = {}, opts = {})
-      opts = Util.normalize_opts(opts)
       resp, opts = request(:post, resource_url + "/reject", params, opts)
       initialize_from(resp.data, opts)
     end

data/lib/stripe/api_operations/delete.rb

@@ -17,14 +17,12 @@ module Stripe
         #   idempotency_key to be passed in the request headers, or for the
         #   api_key to be overwritten. See {APIOperations::Request.request}.
         def delete(id, params = {}, opts = {})
-          opts = Util.normalize_opts(opts)
           resp, opts = request(:delete, "#{resource_url}/#{id}", params, opts)
           Util.convert_to_stripe_object(resp.data, opts)
         end
       end
 
       def delete(params = {}, opts = {})
-        opts = Util.normalize_opts(opts)
         resp, opts = request(:delete, resource_url, params, opts)
         initialize_from(resp.data, opts)
       end

data/lib/stripe/api_operations/nested_resource.rb

@@ -10,8 +10,9 @@ module Stripe
     # methods `.create_reversal`, `.retrieve_reversal`, `.update_reversal`,
     # etc. all become available.
     module NestedResource
-      def nested_resource_class_methods(resource, path: nil, operations: nil)
-        path ||= "#{resource}s"
+      def nested_resource_class_methods(resource, path: nil, operations: nil, resource_plural: nil)
+        resource_plural ||= "#{resource}s"
+        path ||= resource_plural
         raise ArgumentError, "operations array required" if operations.nil?
 
         resource_url_method = :"#{resource}s_url"
@@ -48,7 +49,7 @@ module Stripe
               Util.convert_to_stripe_object(resp.data, opts)
             end
           when :list
-            define_singleton_method(:"list_#{resource}s") do |id, params = {}, opts = {}|
+            define_singleton_method(:"list_#{resource_plural}") do |id, params = {}, opts = {}|
               url = send(resource_url_method, id)
               resp, opts = request(:get, url, params, opts)
               Util.convert_to_stripe_object(resp.data, opts)

data/lib/stripe/bank_account.rb

@@ -2,9 +2,9 @@
 
 module Stripe
   class BankAccount < APIResource
-    include Stripe::APIOperations::Save
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
     OBJECT_NAME = "bank_account".freeze
 

data/lib/stripe/capability.rb

@@ -0,0 +1,26 @@
+# 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 retrieved without an account ID. Retrieve a capability using account.retrieve_capability('acct_123', 'acap_123')"
+    end
+
+    def self.update(_id, _params = nil, _opts = nil)
+      raise NotImplementedError, "Capabilities cannot be updated without an account ID. Update a capability using `p = account.update_capability('acct_123', 'acap_123', params)"
+    end
+  end
+end

data/lib/stripe/card.rb

@@ -2,9 +2,9 @@
 
 module Stripe
   class Card < APIResource
-    include Stripe::APIOperations::Save
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
     OBJECT_NAME = "card".freeze
 

data/lib/stripe/charge.rb

@@ -2,8 +2,8 @@
 
 module Stripe
   class Charge < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "charge".freeze

data/lib/stripe/checkout/session.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Checkout
-    class Session < Stripe::APIResource
+    class Session < APIResource
       extend Stripe::APIOperations::Create
 
       OBJECT_NAME = "checkout.session".freeze

data/lib/stripe/coupon.rb

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

data/lib/stripe/credit_note.rb

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

data/lib/stripe/dispute.rb

@@ -10,12 +10,14 @@ module Stripe
     custom_method :close, http_verb: :post
 
     def close(params = {}, opts = {})
-      resp, opts = request(:post, close_url, 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/file_link.rb

@@ -3,8 +3,8 @@
 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
   end

data/lib/stripe/invoice.rb

@@ -2,10 +2,10 @@
 
 module Stripe
   class Invoice < APIResource
+    extend Stripe::APIOperations::Create
+    include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
-    include Stripe::APIOperations::Delete
-    extend Stripe::APIOperations::Create
 
     OBJECT_NAME = "invoice".freeze
 
@@ -16,39 +16,33 @@ module Stripe
     custom_method :void_invoice, http_verb: :post, http_path: "void"
 
     def finalize_invoice(params = {}, opts = {})
-      url = resource_url + "/finalize"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/finalize", params, opts)
       initialize_from(resp.data, opts)
     end
 
     def mark_uncollectible(params = {}, opts = {})
-      url = resource_url + "/mark_uncollectible"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/mark_uncollectible", params, opts)
       initialize_from(resp.data, opts)
     end
 
     def pay(params = {}, opts = {})
-      url = resource_url + "/pay"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/pay", params, opts)
       initialize_from(resp.data, opts)
     end
 
     def send_invoice(params = {}, opts = {})
-      url = resource_url + "/send"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/send", params, opts)
       initialize_from(resp.data, opts)
     end
 
-    def self.upcoming(params, opts = {})
-      url = resource_url + "/upcoming"
-      resp, opts = request(:get, url, params, opts)
-      Util.convert_to_stripe_object(resp.data, opts)
-    end
-
     def void_invoice(params = {}, opts = {})
-      url = resource_url + "/void"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/void", params, opts)
       initialize_from(resp.data, 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
   end
 end

data/lib/stripe/invoice_item.rb

@@ -2,9 +2,9 @@
 
 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

data/lib/stripe/issuing/authorization.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Issuing
-    class Authorization < Stripe::APIResource
+    class Authorization < APIResource
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 

data/lib/stripe/issuing/card.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Issuing
-    class Card < Stripe::APIResource
+    class Card < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save

data/lib/stripe/issuing/cardholder.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Issuing
-    class Cardholder < Stripe::APIResource
+    class Cardholder < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save

data/lib/stripe/issuing/dispute.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Issuing
-    class Dispute < Stripe::APIResource
+    class Dispute < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save

data/lib/stripe/issuing/transaction.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Issuing
-    class Transaction < Stripe::APIResource
+    class Transaction < APIResource
       extend Stripe::APIOperations::List
       include Stripe::APIOperations::Save
 

data/lib/stripe/order.rb

@@ -2,8 +2,8 @@
 
 module Stripe
   class Order < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "order".freeze

data/lib/stripe/payment_method.rb

@@ -3,8 +3,8 @@
 module Stripe
   class PaymentMethod < APIResource
     extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
     OBJECT_NAME = "payment_method".freeze
 
@@ -12,14 +12,12 @@ module Stripe
     custom_method :detach, http_verb: :post
 
     def attach(params = {}, opts = {})
-      url = resource_url + "/attach"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/attach", params, opts)
       initialize_from(resp.data, opts)
     end
 
     def detach(params = {}, opts = {})
-      url = resource_url + "/detach"
-      resp, opts = request(:post, url, params, opts)
+      resp, opts = request(:post, resource_url + "/detach", params, opts)
       initialize_from(resp.data, opts)
     end
   end

data/lib/stripe/payout.rb

@@ -2,21 +2,23 @@
 
 module Stripe
   class Payout < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "payout".freeze
 
     custom_method :cancel, http_verb: :post
 
-    def cancel
-      resp, api_key = request(:post, cancel_url)
-      initialize_from(resp.data, api_key)
+    def cancel(params = {}, opts = {})
+      resp, opts = request(:post, resource_url + "/cancel", params, opts)
+      initialize_from(resp.data, opts)
     end
 
     def cancel_url
       resource_url + "/cancel"
     end
+    extend Gem::Deprecate
+    deprecate :cancel_url, :none, 2019, 11
   end
 end

data/lib/stripe/product.rb

@@ -2,10 +2,10 @@
 
 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
   end

data/lib/stripe/radar/value_list.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Radar
-    class ValueList < Stripe::APIResource
+    class ValueList < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List

data/lib/stripe/radar/value_list_item.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Radar
-    class ValueListItem < Stripe::APIResource
+    class ValueListItem < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List

data/lib/stripe/recipient.rb

@@ -5,8 +5,8 @@ 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
 

data/lib/stripe/reporting/report_run.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Reporting
-    class ReportRun < Stripe::APIResource
+    class ReportRun < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
 

data/lib/stripe/reporting/report_type.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Reporting
-    class ReportType < Stripe::APIResource
+    class ReportType < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
 

data/lib/stripe/sigma/scheduled_query_run.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Sigma
-    class ScheduledQueryRun < Stripe::APIResource
+    class ScheduledQueryRun < APIResource
       extend Stripe::APIOperations::List
 
       OBJECT_NAME = "scheduled_query_run".freeze

data/lib/stripe/sku.rb

@@ -2,10 +2,10 @@
 
 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
   end

data/lib/stripe/source.rb

@@ -17,7 +17,7 @@ module Stripe
       end
 
       url = "#{Customer.resource_url}/#{CGI.escape(customer)}/sources/#{CGI.escape(id)}"
-      resp, opts = request(:delete, url, params, Util.normalize_opts(opts))
+      resp, opts = request(:delete, url, params, opts)
       initialize_from(resp.data, opts)
     end
 
@@ -28,12 +28,12 @@ module Stripe
     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))
+      resp, opts = request(:post, resource_url + "/verify", params, opts)
       initialize_from(resp.data, opts)
     end
   end

data/lib/stripe/subscription_item.rb

@@ -10,7 +10,7 @@ module Stripe
     OBJECT_NAME = "subscription_item".freeze
 
     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/subscription_schedule.rb

@@ -2,8 +2,8 @@
 
 module Stripe
   class SubscriptionSchedule < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
     extend Stripe::APIOperations::NestedResource
 
@@ -28,7 +28,7 @@ module Stripe
     end
 
     def revisions(params = {}, opts = {})
-      resp, opts = request(:get, resource_url + "/revisions", params, Util.normalize_opts(opts))
+      resp, opts = request(:get, resource_url + "/revisions", params, opts)
       Util.convert_to_stripe_object(resp.data, opts)
     end
   end

data/lib/stripe/tax_id.rb

@@ -2,8 +2,8 @@
 
 module Stripe
   class TaxId < APIResource
-    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Delete
+    extend Stripe::APIOperations::List
 
     OBJECT_NAME = "tax_id".freeze
 

data/lib/stripe/tax_rate.rb

@@ -3,8 +3,8 @@
 module Stripe
   class TaxRate < APIResource
     extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
     OBJECT_NAME = "tax_rate".freeze
   end

data/lib/stripe/terminal/connection_token.rb

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

data/lib/stripe/terminal/location.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Terminal
-    class Location < Stripe::APIResource
+    class Location < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List

data/lib/stripe/terminal/reader.rb

@@ -2,7 +2,7 @@
 
 module Stripe
   module Terminal
-    class Reader < Stripe::APIResource
+    class Reader < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete
       extend Stripe::APIOperations::List

data/lib/stripe/topup.rb

@@ -2,17 +2,17 @@
 
 module Stripe
   class Topup < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
 
     OBJECT_NAME = "topup".freeze
 
     custom_method :cancel, http_verb: :post
 
-    def cancel
-      resp, api_key = request(:post, resource_url + "/cancel")
-      initialize_from(resp.data, api_key)
+    def cancel(params = {}, opts = {})
+      resp, opts = request(:post, resource_url + "/cancel", params, opts)
+      initialize_from(resp.data, opts)
     end
   end
 end

data/lib/stripe/transfer.rb

@@ -2,8 +2,8 @@
 
 module Stripe
   class Transfer < APIResource
-    extend Stripe::APIOperations::List
     extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save
     extend Stripe::APIOperations::NestedResource
 

data/lib/stripe/usage_record.rb

@@ -2,13 +2,13 @@
 
 module Stripe
   class UsageRecord < APIResource
+    OBJECT_NAME = "usage_record".freeze
+
     def self.create(params = {}, opts = {})
       raise(ArgumentError, "Params must have a subscription_item key") unless params.key?(:subscription_item)
       req_params = params.clone.delete_if { |key, _value| key == :subscription_item }
       resp, opts = request(:post, "/v1/subscription_items/#{params[:subscription_item]}/usage_records", req_params, opts)
       Util.convert_to_stripe_object(resp.data, opts)
     end
-
-    OBJECT_NAME = "usage_record".freeze
   end
 end

data/lib/stripe/util.rb

@@ -56,6 +56,7 @@ module Stripe
         BankAccount::OBJECT_NAME                  => BankAccount,
         BitcoinReceiver::OBJECT_NAME              => BitcoinReceiver,
         BitcoinTransaction::OBJECT_NAME           => BitcoinTransaction,
+        Capability::OBJECT_NAME                   => Capability,
         Card::OBJECT_NAME                         => Card,
         Charge::OBJECT_NAME                       => Charge,
         Checkout::Session::OBJECT_NAME            => Checkout::Session,
@@ -135,6 +136,8 @@ module Stripe
     # * +opts+ - Options for +StripeObject+ like an API key that will be reused
     #   on subsequent API calls.
     def self.convert_to_stripe_object(data, opts = {})
+      opts = normalize_opts(opts)
+
       case data
       when Array
         data.map { |i| convert_to_stripe_object(i, opts) }

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "4.16.0".freeze
+  VERSION = "4.17.0".freeze
 end

data/lib/stripe/webhook_endpoint.rb

@@ -3,9 +3,9 @@
 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
   end

data/test/stripe/account_test.rb

@@ -266,6 +266,40 @@ module Stripe
       end
     end
 
+    context "#retrieve_capability" do
+      should "retrieve a capability" do
+        capability = Stripe::Account.retrieve_capability(
+          "acct_123",
+          "acap_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/accounts/acct_123/capabilities/acap_123"
+        assert capability.is_a?(Stripe::Capability)
+      end
+    end
+
+    context "#update_capability" do
+      should "update a capability" do
+        capability = Stripe::Account.update_capability(
+          "acct_123",
+          "acap_123",
+          requested: true
+        )
+        assert_requested :post, "#{Stripe.api_base}/v1/accounts/acct_123/capabilities/acap_123"
+        assert capability.is_a?(Stripe::Capability)
+      end
+    end
+
+    context "#list_capabilities" do
+      should "list the account's external accounts" do
+        capabilities = Stripe::Account.list_capabilities(
+          "acct_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/accounts/acct_123/capabilities"
+        assert capabilities.is_a?(Stripe::ListObject)
+        assert capabilities.data.is_a?(Array)
+      end
+    end
+
     context "#create_external_account" do
       should "create an external account" do
         external_account = Stripe::Account.create_external_account(

data/test/stripe/api_resource_test.rb

@@ -5,7 +5,7 @@ require ::File.expand_path("../../test_helper", __FILE__)
 
 module Stripe
   class ApiResourceTest < Test::Unit::TestCase
-    class NestedTestAPIResource < Stripe::APIResource
+    class NestedTestAPIResource < APIResource
       save_nested_resource :external_account
     end
 

data/test/stripe/capability_test.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../../test_helper", __FILE__)
+
+module Stripe
+  class CapabilityTest < Test::Unit::TestCase
+    context "#resource_url" do
+      should "return a resource URL" do
+        capability = Stripe::Capability.construct_from(
+          id: "acap_123",
+          account: "acct_123"
+        )
+        assert_equal "/v1/accounts/acct_123/capabilities/acap_123",
+                     capability.resource_url
+      end
+
+      should "raise without an account" do
+        capability = Stripe::Capability.construct_from(id: "acap_123")
+        assert_raises NotImplementedError do
+          capability.resource_url
+        end
+      end
+    end
+
+    should "raise on #retrieve" do
+      assert_raises NotImplementedError do
+        Stripe::Capability.retrieve("acap_123")
+      end
+    end
+
+    should "raise on #update" do
+      assert_raises NotImplementedError do
+        Stripe::Capability.update("acap_123", {})
+      end
+    end
+
+    should "be saveable" do
+      capability = Stripe::Account.retrieve_capability("acct_123", "acap_123")
+      capability.requested = true
+      capability.save
+      assert_requested :post,
+                       "#{Stripe.api_base}/v1/accounts/#{capability.account}/capabilities/#{capability.id}"
+    end
+  end
+end

data/test/test_helper.rb

@@ -17,7 +17,7 @@ require ::File.expand_path("../test_data", __FILE__)
 require ::File.expand_path("../stripe_mock", __FILE__)
 
 # If changing this number, please also change it in `.travis.yml`.
-MOCK_MINIMUM_VERSION = "0.54.0".freeze
+MOCK_MINIMUM_VERSION = "0.56.0".freeze
 MOCK_PORT = Stripe::StripeMock.start
 
 # Disable all real network connections except those that are outgoing to

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 4.16.0
+  version: 4.17.0
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-24 00:00:00.000000000 Z
+date: 2019-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -81,6 +81,7 @@ files:
 - lib/stripe/bank_account.rb
 - lib/stripe/bitcoin_receiver.rb
 - lib/stripe/bitcoin_transaction.rb
+- lib/stripe/capability.rb
 - lib/stripe/card.rb
 - lib/stripe/charge.rb
 - lib/stripe/checkout/session.rb
@@ -166,6 +167,7 @@ files:
 - test/stripe/application_fee_test.rb
 - test/stripe/balance_test.rb
 - test/stripe/bank_account_test.rb
+- test/stripe/capability_test.rb
 - test/stripe/charge_test.rb
 - test/stripe/checkout/session_test.rb
 - test/stripe/country_spec_test.rb
@@ -272,6 +274,7 @@ test_files:
 - test/stripe/application_fee_test.rb
 - test/stripe/balance_test.rb
 - test/stripe/bank_account_test.rb
+- test/stripe/capability_test.rb
 - test/stripe/charge_test.rb
 - test/stripe/checkout/session_test.rb
 - test/stripe/country_spec_test.rb