stripe 1.57.1 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cc1cb05bfb9a08a00e144b883b27f19adecd393a
-  data.tar.gz: ba84a7e8456dc66a137cb149a8dc8ca36962e2d3
+  metadata.gz: 62e0a925e86bf0a18b48c88a9a359241075cd94a
+  data.tar.gz: 8de490482c9fd1a2e7e8d5bd28ac8eb34a0276c6
 SHA512:
-  metadata.gz: f023b3c00e55b05fc9a7eb84dc2d876c9b518a51ce445f0c78f03e82158a544c2f2a7d825953bd80228f527fd7cd6db14a88f87913d4a6309ff26b423b57ebcb
-  data.tar.gz: 125b78e32aebaaaee71f8d22afd33a10f90d899f8a4ff1bf9352ed2fd8dd35549186b2ef96c943670cd17dcbaa95c1d0f7ce3c6808fa0a690529ba42b716f037
+  metadata.gz: bf4525ce47f09b015d0a450667df948a15794538b13c076aefa0ba147d7d6829e344abd7c61285f38c2fcbad7a859f708942a661fe6521b4f76357383627ca6d
+  data.tar.gz: b86195048056fb06aade87235e6bf46c7d642101bf55b7bfd1f3375bf9f741ff522c22f1b74cee3fa4c7d8228a47f1fd53bf548e89b243e8af5826f5ebef3393

data/History.txt

@@ -1,3 +1,7 @@
+=== 1.58.0 2017-01-19
+
+* Remove erroneously added list methods for `Source` model
+
 === 1.57.1 2016-11-28
 
 * Disallow sending protected fields along with API resource `.update`

data/VERSION

@@ -1 +1 @@
-1.57.1
+1.58.0

data/lib/stripe.rb

@@ -19,56 +19,49 @@ require 'stripe/api_operations/delete'
 require 'stripe/api_operations/list'
 require 'stripe/api_operations/request'
 
-# Resources
+# API resource support classes
+require 'stripe/errors'
 require 'stripe/util'
 require 'stripe/stripe_object'
+require 'stripe/list_object'
 require 'stripe/api_resource'
 require 'stripe/singleton_api_resource'
-require 'stripe/list_object'
+
+# Named API resources
 require 'stripe/account'
+require 'stripe/alipay_account'
+require 'stripe/apple_pay_domain'
+require 'stripe/application_fee'
+require 'stripe/application_fee_refund'
 require 'stripe/balance'
 require 'stripe/balance_transaction'
-require 'stripe/customer'
-require 'stripe/invoice'
-require 'stripe/invoice_item'
+require 'stripe/bank_account'
+require 'stripe/bitcoin_receiver'
+require 'stripe/bitcoin_transaction'
+require 'stripe/card'
 require 'stripe/charge'
 require 'stripe/country_spec'
-require 'stripe/plan'
-require 'stripe/file_upload'
 require 'stripe/coupon'
-require 'stripe/token'
+require 'stripe/customer'
+require 'stripe/dispute'
 require 'stripe/event'
-require 'stripe/transfer'
+require 'stripe/file_upload'
+require 'stripe/invoice'
+require 'stripe/invoice_item'
+require 'stripe/order'
+require 'stripe/order_return'
+require 'stripe/plan'
+require 'stripe/product'
 require 'stripe/recipient'
-require 'stripe/bank_account'
-require 'stripe/card'
-require 'stripe/subscription'
-require 'stripe/subscription_item'
-require 'stripe/application_fee'
 require 'stripe/refund'
 require 'stripe/reversal'
-require 'stripe/application_fee_refund'
-require 'stripe/bitcoin_receiver'
-require 'stripe/bitcoin_transaction'
-require 'stripe/dispute'
-require 'stripe/product'
 require 'stripe/sku'
-require 'stripe/order'
-require 'stripe/order_return'
-require 'stripe/alipay_account'
-require 'stripe/three_d_secure'
 require 'stripe/source'
-require 'stripe/apple_pay_domain'
-
-# Errors
-require 'stripe/errors/stripe_error'
-require 'stripe/errors/api_error'
-require 'stripe/errors/api_connection_error'
-require 'stripe/errors/card_error'
-require 'stripe/errors/invalid_request_error'
-require 'stripe/errors/authentication_error'
-require 'stripe/errors/permission_error'
-require 'stripe/errors/rate_limit_error'
+require 'stripe/subscription'
+require 'stripe/subscription_item'
+require 'stripe/three_d_secure'
+require 'stripe/token'
+require 'stripe/transfer'
 
 module Stripe
   DEFAULT_CA_BUNDLE_PATH = File.dirname(__FILE__) + '/data/ca-certificates.crt'
@@ -128,6 +121,37 @@ module Stripe
     (api_base_url || @api_base) + url
   end
 
+  # The location of a file containing a bundle of CA certificates. By default
+  # the library will use an included bundle that can successfully validate
+  # Stripe certificates.
+  def self.ca_bundle_path
+    @ca_bundle_path
+  end
+
+  def self.ca_bundle_path=(path)
+    @ca_bundle_path = path
+
+    # empty this field so a new store is initialized
+    @ca_store = nil
+  end
+
+  # A certificate store initialized from the the bundle in #ca_bundle_path and
+  # which is used to validate TLS on every request.
+  #
+  # This was added to the give the gem "pseudo thread safety" in that it seems
+  # when initiating many parallel requests marshaling the certificate store is
+  # the most likely point of failure (see issue #382). Any program attempting
+  # to leverage this pseudo safety should make a call to this method (i.e.
+  # `Stripe.ca_store`) in their initialization code because it marshals lazily
+  # and is itself not thread safe.
+  def self.ca_store
+    @ca_store ||= begin
+      store = OpenSSL::X509::Store.new
+      store.add_file(ca_bundle_path)
+      store
+    end
+  end
+
   def self.request(method, url, api_key, params={}, headers={}, api_base_url=nil)
     api_base_url = api_base_url || @api_base
 
@@ -184,46 +208,33 @@ module Stripe
     [parse(response), api_key]
   end
 
-  # The location of a file containing a bundle of CA certificates. By default
-  # the library will use an included bundle that can successfully validate
-  # Stripe certificates.
-  def self.ca_bundle_path
-    @ca_bundle_path
+  def self.max_network_retries
+    @max_network_retries
   end
 
-  def self.ca_bundle_path=(path)
-    @ca_bundle_path = path
-
-    # empty this field so a new store is initialized
-    @ca_store = nil
+  def self.max_network_retries=(val)
+    @max_network_retries = val.to_i
   end
 
-  # A certificate store initialized from the the bundle in #ca_bundle_path and
-  # which is used to validate TLS on every request.
-  #
-  # This was added to the give the gem "pseudo thread safety" in that it seems
-  # when initiating many parallel requests marshaling the certificate store is
-  # the most likely point of failure (see issue #382). Any program attempting
-  # to leverage this pseudo safety should make a call to this method (i.e.
-  # `Stripe.ca_store`) in their initialization code because it marshals lazily
-  # and is itself not thread safe.
-  def self.ca_store
-    @ca_store ||= begin
-      store = OpenSSL::X509::Store.new
-      store.add_file(ca_bundle_path)
-      store
-    end
+  private
+
+  def self.api_error(error, resp, error_obj)
+    APIError.new(error[:message], resp.code, resp.body, error_obj, resp.headers)
   end
 
-  def self.max_network_retries
-    @max_network_retries
+  def self.authentication_error(error, resp, error_obj)
+    AuthenticationError.new(error[:message], resp.code, resp.body, error_obj,
+                            resp.headers)
   end
 
-  def self.max_network_retries=(val)
-    @max_network_retries = val.to_i
+  def self.card_error(error, resp, error_obj)
+    CardError.new(error[:message], error[:param], error[:code],
+                  resp.code, resp.body, error_obj, resp.headers)
   end
 
-  private
+  def self.execute_request(opts)
+    RestClient::Request.execute(opts)
+  end
 
   def self.execute_request_with_rescues(request_opts, api_base_url, retry_count = 0)
     begin
@@ -263,21 +274,9 @@ module Stripe
     response
   end
 
-  def self.user_agent
-    @uname ||= get_uname
-    lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
-
-    {
-      :bindings_version => Stripe::VERSION,
-      :lang => 'ruby',
-      :lang_version => lang_version,
-      :platform => RUBY_PLATFORM,
-      :engine => defined?(RUBY_ENGINE) ? RUBY_ENGINE : '',
-      :publisher => 'stripe',
-      :uname => @uname,
-      :hostname => Socket.gethostname,
-    }
-
+  def self.general_api_error(rcode, rbody)
+    APIError.new("Invalid response object from API: #{rbody.inspect} " +
+                 "(HTTP response code was #{rcode})", rcode, rbody)
   end
 
   def self.get_uname
@@ -286,81 +285,31 @@ module Stripe
     else
       case RbConfig::CONFIG['host_os']
       when /linux|darwin|bsd|sunos|solaris|cygwin/i
-        _uname_uname
+        get_uname_from_system
       when /mswin|mingw/i
-        _uname_ver
+        get_uname_from_system_ver
       else
         "unknown platform"
       end
     end
   end
 
-  def self._uname_uname
+  def self.get_uname_from_system
     (`uname -a 2>/dev/null` || '').strip
+  rescue Errno::ENOENT
+    "uname executable not found"
   rescue Errno::ENOMEM # couldn't create subprocess
     "uname lookup failed"
   end
 
-  def self._uname_ver
+  def self.get_uname_from_system_ver
     (`ver` || '').strip
+  rescue Errno::ENOENT
+    "ver executable not found"
   rescue Errno::ENOMEM # couldn't create subprocess
     "uname lookup failed"
   end
 
-  # DEPRECATED. Use `Util#encode_parameters` instead.
-  def self.uri_encode(params)
-    Util.encode_parameters(params)
-  end
-  class << self
-    extend Gem::Deprecate
-    deprecate :uri_encode, "Stripe::Util#encode_parameters", 2016, 01
-  end
-
-  def self.request_headers(api_key, method)
-    headers = {
-      'User-Agent' => "Stripe/v1 RubyBindings/#{Stripe::VERSION}",
-      'Authorization' => "Bearer #{api_key}",
-      'Content-Type' => 'application/x-www-form-urlencoded'
-    }
-
-    # It is only safe to retry network failures on post and delete
-    # requests if we add an Idempotency-Key header
-    if [:post, :delete].include?(method) && self.max_network_retries > 0
-      headers['Idempotency-Key'] ||= SecureRandom.uuid
-    end
-
-    headers['Stripe-Version'] = api_version if api_version
-    headers['Stripe-Account'] = stripe_account if stripe_account
-
-    begin
-      headers.update('X-Stripe-Client-User-Agent' => JSON.generate(user_agent))
-    rescue => e
-      headers.update('X-Stripe-Client-Raw-User-Agent' => user_agent.inspect,
-                     :error => "#{e} (#{e.class})")
-    end
-  end
-
-  def self.execute_request(opts)
-    RestClient::Request.execute(opts)
-  end
-
-  def self.parse(response)
-    begin
-      # Would use :symbolize_names => true, but apparently there is
-      # some library out there that makes symbolize_names not work.
-      response = JSON.parse(response.body)
-    rescue JSON::ParserError
-      raise general_api_error(response.code, response.body)
-    end
-
-    Util.symbolize_names(response)
-  end
-
-  def self.general_api_error(rcode, rbody)
-    APIError.new("Invalid response object from API: #{rbody.inspect} " +
-                 "(HTTP response code was #{rcode})", rcode, rbody)
-  end
-
   def self.handle_api_error(resp)
     begin
       error_obj = JSON.parse(resp.body)
@@ -389,34 +338,6 @@ module Stripe
 
   end
 
-  def self.invalid_request_error(error, resp, error_obj)
-    InvalidRequestError.new(error[:message], error[:param], resp.code,
-                            resp.body, error_obj, resp.headers)
-  end
-
-  def self.authentication_error(error, resp, error_obj)
-    AuthenticationError.new(error[:message], resp.code, resp.body, error_obj,
-                            resp.headers)
-  end
-
-  def self.rate_limit_error(error, resp, error_obj)
-    RateLimitError.new(error[:message], resp.code, resp.body, error_obj,
-                       resp.headers)
-  end
-
-  def self.card_error(error, resp, error_obj)
-    CardError.new(error[:message], error[:param], error[:code],
-                  resp.code, resp.body, error_obj, resp.headers)
-  end
-
-  def self.permission_error(error, resp, error_obj)
-    PermissionError.new(error[:message], resp.code, resp.body, error_obj, resp.headers)
-  end
-
-  def self.api_error(error, resp, error_obj)
-    APIError.new(error[:message], resp.code, resp.body, error_obj, resp.headers)
-  end
-
   def self.handle_restclient_error(e, request_opts, retry_count, api_base_url=nil)
 
     api_base_url = @api_base unless api_base_url
@@ -462,6 +383,56 @@ module Stripe
     raise APIConnectionError.new(message + "\n\n(Network error: #{e.message})")
   end
 
+  def self.invalid_request_error(error, resp, error_obj)
+    InvalidRequestError.new(error[:message], error[:param], resp.code,
+                            resp.body, error_obj, resp.headers)
+  end
+
+  def self.parse(response)
+    begin
+      # Would use :symbolize_names => true, but apparently there is
+      # some library out there that makes symbolize_names not work.
+      response = JSON.parse(response.body)
+    rescue JSON::ParserError
+      raise general_api_error(response.code, response.body)
+    end
+
+    Util.symbolize_names(response)
+  end
+
+  def self.permission_error(error, resp, error_obj)
+    PermissionError.new(error[:message], resp.code, resp.body, error_obj, resp.headers)
+  end
+
+  def self.rate_limit_error(error, resp, error_obj)
+    RateLimitError.new(error[:message], resp.code, resp.body, error_obj,
+                       resp.headers)
+  end
+
+  def self.request_headers(api_key, method)
+    headers = {
+      'User-Agent' => "Stripe/v1 RubyBindings/#{Stripe::VERSION}",
+      'Authorization' => "Bearer #{api_key}",
+      'Content-Type' => 'application/x-www-form-urlencoded'
+    }
+
+    # It is only safe to retry network failures on post and delete
+    # requests if we add an Idempotency-Key header
+    if [:post, :delete].include?(method) && self.max_network_retries > 0
+      headers['Idempotency-Key'] ||= SecureRandom.uuid
+    end
+
+    headers['Stripe-Version'] = api_version if api_version
+    headers['Stripe-Account'] = stripe_account if stripe_account
+
+    begin
+      headers.update('X-Stripe-Client-User-Agent' => JSON.generate(user_agent))
+    rescue => e
+      headers.update('X-Stripe-Client-Raw-User-Agent' => user_agent.inspect,
+                     :error => "#{e} (#{e.class})")
+    end
+  end
+
   def self.should_retry?(e, retry_count)
     retry_count < self.max_network_retries &&
       RETRY_EXCEPTIONS.any? { |klass| e.is_a?(klass) }
@@ -482,4 +453,30 @@ module Stripe
 
     sleep_seconds
   end
+
+  # DEPRECATED. Use `Util#encode_parameters` instead.
+  def self.uri_encode(params)
+    Util.encode_parameters(params)
+  end
+  class << self
+    extend Gem::Deprecate
+    deprecate :uri_encode, "Stripe::Util#encode_parameters", 2016, 01
+  end
+
+  def self.user_agent
+    @uname ||= get_uname
+    lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
+
+    {
+      :bindings_version => Stripe::VERSION,
+      :lang => 'ruby',
+      :lang_version => lang_version,
+      :platform => RUBY_PLATFORM,
+      :engine => defined?(RUBY_ENGINE) ? RUBY_ENGINE : '',
+      :publisher => 'stripe',
+      :uname => @uname,
+      :hostname => Socket.gethostname,
+    }
+
+  end
 end

data/lib/stripe/errors.rb

@@ -0,0 +1,82 @@
+module Stripe
+  # StripeError is the base error from which all other more specific Stripe
+  # errors derive.
+  class StripeError < StandardError
+    attr_reader :message
+    attr_reader :http_status
+    attr_reader :http_body
+    attr_reader :http_headers
+    attr_reader :request_id
+    attr_reader :json_body
+
+    def initialize(message=nil, http_status=nil, http_body=nil, json_body=nil,
+                   http_headers=nil)
+      @message = message
+      @http_status = http_status
+      @http_body = http_body
+      @http_headers = http_headers || {}
+      @json_body = json_body
+      @request_id = @http_headers[:request_id]
+    end
+
+    def to_s
+      status_string = @http_status.nil? ? "" : "(Status #{@http_status}) "
+      id_string = @request_id.nil? ? "" : "(Request #{@request_id}) "
+      "#{status_string}#{id_string}#{@message}"
+    end
+  end
+
+  # AuthenticationError is raised when invalid credentials are used to connect
+  # to Stripe's servers.
+  class AuthenticationError < StripeError
+  end
+
+  # APIConnectionError is raised in the event that the SDK can't connect to
+  # Stripe's servers. That can be for a variety of different reasons from a
+  # downed network to a bad TLS certificate.
+  class APIConnectionError < StripeError
+  end
+
+  # APIError is a generic error that may be raised in cases where none of the
+  # other named errors cover the problem. It could also be raised in the case
+  # that a new error has been introduced in the API, but this version of the
+  # Ruby SDK doesn't know how to handle it.
+  class APIError < StripeError
+  end
+
+  # CardError is raised when a user enters a card that can't be charged for
+  # some reason.
+  class CardError < StripeError
+    attr_reader :param, :code
+
+    def initialize(message, param, code, http_status=nil, http_body=nil, json_body=nil,
+                   http_headers=nil)
+      super(message, http_status, http_body, json_body, http_headers)
+      @param = param
+      @code = code
+    end
+  end
+
+  # InvalidRequestError is raised when a request is initiated with invalid
+  # parameters.
+  class InvalidRequestError < StripeError
+    attr_accessor :param
+
+    def initialize(message, param, http_status=nil, http_body=nil, json_body=nil,
+                   http_headers=nil)
+      super(message, http_status, http_body, json_body, http_headers)
+      @param = param
+    end
+  end
+
+  # PermissionError is raised in cases where access was attempted on a resource
+  # that wasn't allowed.
+  class PermissionError < StripeError
+  end
+
+  # RateLimitError is raised in cases where an account is putting too much load
+  # on Stripe's API servers (usually by performing too many requests). Please
+  # back off on request rate.
+  class RateLimitError < StripeError
+  end
+end

data/lib/stripe/source.rb

@@ -1,8 +1,7 @@
 module Stripe
   class Source < APIResource
-    include Stripe::APIOperations::Save
     extend Stripe::APIOperations::Create
-    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
 
     def verify(params={}, opts={})
       response, opts = request(:post, resource_url + '/verify', params, opts)

data/lib/stripe/util.rb

@@ -52,10 +52,10 @@ module Stripe
         'sku'                     => SKU,
         'subscription'            => Subscription,
         'subscription_item'       => SubscriptionItem,
+        'three_d_secure'          => ThreeDSecure,
         'token'                   => Token,
         'transfer'                => Transfer,
         'transfer_reversal'       => Reversal,
-        'three_d_secure'          => ThreeDSecure,
       }
     end
 

data/lib/stripe/version.rb

@@ -1,3 +1,3 @@
 module Stripe
-  VERSION = '1.57.1'
+  VERSION = '1.58.0'
 end

data/test/stripe/errors_test.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../../test_helper', __FILE__)
+
+module Stripe
+  class StripeErrorTest < Test::Unit::TestCase
+    context "#to_s" do
+      should "convert to string" do
+        e = StripeError.new("message")
+        assert_equal "message", e.to_s
+
+        e = StripeError.new("message", 200)
+        assert_equal "(Status 200) message", e.to_s
+
+        e = StripeError.new("message", nil, nil, nil, { :request_id => "request-id" })
+        assert_equal "(Request request-id) message", e.to_s
+      end
+    end
+  end
+end

data/test/stripe/source_test.rb

@@ -2,17 +2,82 @@ require File.expand_path('../../test_helper', __FILE__)
 
 module Stripe
   class SourceTest < Test::Unit::TestCase
-    should 'be verifiable' do
-      source = Stripe::Source.construct_from({
-        :id => 'ba_foo',
-      })
+    should 'be creatable' do
+      @mock.expects(:post).once.returns(make_response(make_source_card))
+      src = Stripe::Source.create(
+        type: 'card',
+        token: 'tok_test',
+      )
+      assert_equal 'src_test_card', src.id
+    end
+
+    should 'be retrievable' do
+      @mock.expects(:get).once.returns(make_response(make_source_card))
+      src = Stripe::Source.retrieve('src_test_card')
+      assert_equal 'src_test_card', src.id
+    end
 
-      @mock.expects(:post).
-        once.
-        with('https://api.stripe.com/v1/sources/ba_foo/verify', nil, 'amounts[]=1&amounts[]=2').
-        returns(make_response(:status => 'verified'))
+    should 'be updatable' do
+      @mock.expects(:post).once
+        .with(
+          "#{Stripe.api_base}/v1/sources/src_test_card",
+          nil,
+          'metadata[foo]=bar'
+        )
+        .returns(make_response(make_source_card(metadata: {foo: 'bar'})))
+      src = Stripe::Source.update('src_test_card', metadata: {foo: 'bar'})
+      assert_equal 'bar', src.metadata['foo']
+    end
+
+    should 'be saveable' do
+      @mock.expects(:get).once.returns(make_response(make_source_card))
+      src = Stripe::Source.retrieve('src_test_card')
+
+      @mock.expects(:post).once
+        .with(
+          "#{Stripe.api_base}/v1/sources/src_test_card",
+          nil,
+          'metadata[foo]=bar'
+        )
+        .returns(make_response(make_source_card(metadata: {foo: 'bar'})))
+      src.metadata['foo'] = 'bar'
+      src.save
+      assert_equal 'bar', src.metadata['foo']
+    end
+
+    should 'not be deletable' do
+      @mock.expects(:get).once.returns(make_response(make_source_card))
+      src = Stripe::Source.retrieve('src_test_card')
+
+      assert_raises NoMethodError do
+        src.delete
+      end
+    end
+
+    should 'not be listable' do
+      assert_raises NoMethodError do
+        Stripe::Source.list
+      end
+    end
+
+    should 'be verifiable' do
+      @mock.expects(:get).once.returns(make_response(make_source_ach_debit))
+      src = Stripe::Source.retrieve('src_test_ach_debit')
 
-      source.verify(:amounts => [1,2])
+      @mock.expects(:post).once
+        .with(
+          'https://api.stripe.com/v1/sources/src_test_ach_debit/verify',
+          nil,
+          'values[]=32&values[]=45'
+        )
+        .returns(make_response(make_source_ach_debit(
+          verification: {
+            attempts_remaining: 0,
+            status: 'succeeded',
+          }
+        )))
+      src.verify(values: [32, 45])
+      assert_equal 'succeeded', src.verification.status
     end
   end
 end

data/test/stripe_test.rb

@@ -48,4 +48,27 @@ class StripeTest < Test::Unit::TestCase
 
     Stripe.request(:post, '/v1/account', 'sk_live12334566')
   end
+
+  context "#get_uname" do
+    should "run without failure" do
+      # Don't actually check the result because we try a variety of different
+      # strategies that will have different results depending on where this
+      # test and running. We're mostly making sure that no exception is thrown.
+      _ = Stripe.get_uname
+    end
+  end
+
+  context "#get_uname_from_system" do
+    should "run without failure" do
+      # as above, just verify that an exception is not thrown
+      _ = Stripe.get_uname_from_system
+    end
+  end
+
+  context "#get_uname_from_system_ver" do
+    should "run without failure" do
+      # as above, just verify that an exception is not thrown
+      _ = Stripe.get_uname_from_system_ver
+    end
+  end
 end

data/test/test_data.rb

@@ -895,5 +895,91 @@ module Stripe
         ]
       }
     end
+
+    def make_source_card(params={})
+      id = params[:id] || 'src_test_card'
+      {
+        :id => id,
+        :object => 'source',
+        :type => 'card',
+        :amount => nil,
+        :card => {
+          :address_line1_check => nil,
+          :address_zip_check => nil,
+          :brand => 'Visa',
+          :country => 'US',
+          :cvc_check => 'unchecked',
+          :description => nil,
+          :dynamic_last4 => nil,
+          :exp_month => 1,
+          :exp_year => 2020,
+          :fingerprint => 'NrVafqTONZfbLkQK',
+          :funding => 'credit',
+          :google_reference => nil,
+          :iin => nil,
+          :issuer => nil,
+          :last4 => '4242',
+          :three_d_secure => 'optional',
+          :tokenization_method => 'nil',
+        },
+        :client_secret => 'src_client_secret_test',
+        :created => 1484841032,
+        :currency => nil,
+        :flow => 'none',
+        :livemode => false,
+        :metadata => {},
+        :owner => {
+          :address => nil,
+          :email => nil,
+          :name => nil,
+          :phone => nil,
+          :verified_address => nil,
+          :verified_email => nil,
+          :verified_name => nil,
+          :verified_phone => nil,
+        },
+        :status => 'chargeable',
+        :usage => 'reusable',
+      }.merge(params)
+    end
+
+    def make_source_ach_debit(params={})
+      id = params[:id] || 'src_test_ach_debit'
+      {
+        :id => id,
+        :object => 'source',
+        :type => 'ach_debit',
+        :ach_debit => {
+          :country => 'US',
+          :fingerprint => 'yY5BWKwnW98uydOa',
+          :last4 => '6789',
+          :routing_number => '110000000',
+          :type => 'individual',
+        },
+        :amount => nil,
+        :client_secret => 'src_client_secret_test',
+        :created => 1484842122,
+        :currency => 'usd',
+        :flow => 'verification',
+        :livemode => false,
+        :metadata => {},
+        :owner => {
+          :address => nil,
+          :email => nil,
+          :name => 'Jenny Rosen',
+          :phone => nil,
+          :verified_address => nil,
+          :verified_email => nil,
+          :verified_name => nil,
+          :verified_phone => nil,
+        },
+        :status => 'pending',
+        :usage => 'reusable',
+        :verification => {
+          :attempts_remaining => 10,
+          :status => 'pending',
+        },
+      }.merge(params)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 1.57.1
+  version: 1.58.0
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-29 00:00:00.000000000 Z
+date: 2017-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -73,14 +73,7 @@ files:
 - lib/stripe/coupon.rb
 - lib/stripe/customer.rb
 - lib/stripe/dispute.rb
-- lib/stripe/errors/api_connection_error.rb
-- lib/stripe/errors/api_error.rb
-- lib/stripe/errors/authentication_error.rb
-- lib/stripe/errors/card_error.rb
-- lib/stripe/errors/invalid_request_error.rb
-- lib/stripe/errors/permission_error.rb
-- lib/stripe/errors/rate_limit_error.rb
-- lib/stripe/errors/stripe_error.rb
+- lib/stripe/errors.rb
 - lib/stripe/event.rb
 - lib/stripe/file_upload.rb
 - lib/stripe/invoice.rb
@@ -123,6 +116,7 @@ files:
 - test/stripe/customer_card_test.rb
 - test/stripe/customer_test.rb
 - test/stripe/dispute_test.rb
+- test/stripe/errors_test.rb
 - test/stripe/file_upload_test.rb
 - test/stripe/invoice_item_test.rb
 - test/stripe/invoice_test.rb
@@ -190,6 +184,7 @@ test_files:
 - test/stripe/customer_card_test.rb
 - test/stripe/customer_test.rb
 - test/stripe/dispute_test.rb
+- test/stripe/errors_test.rb
 - test/stripe/file_upload_test.rb
 - test/stripe/invoice_item_test.rb
 - test/stripe/invoice_test.rb

data/lib/stripe/errors/api_connection_error.rb

@@ -1,4 +0,0 @@
-module Stripe
-  class APIConnectionError < StripeError
-  end
-end

data/lib/stripe/errors/api_error.rb

@@ -1,4 +0,0 @@
-module Stripe
-  class APIError < StripeError
-  end
-end

data/lib/stripe/errors/authentication_error.rb

@@ -1,4 +0,0 @@
-module Stripe
-  class AuthenticationError < StripeError
-  end
-end

data/lib/stripe/errors/card_error.rb

@@ -1,12 +0,0 @@
-module Stripe
-  class CardError < StripeError
-    attr_reader :param, :code
-
-    def initialize(message, param, code, http_status=nil, http_body=nil, json_body=nil,
-                   http_headers=nil)
-      super(message, http_status, http_body, json_body, http_headers)
-      @param = param
-      @code = code
-    end
-  end
-end

data/lib/stripe/errors/invalid_request_error.rb

@@ -1,11 +0,0 @@
-module Stripe
-  class InvalidRequestError < StripeError
-    attr_accessor :param
-
-    def initialize(message, param, http_status=nil, http_body=nil, json_body=nil,
-                   http_headers=nil)
-      super(message, http_status, http_body, json_body, http_headers)
-      @param = param
-    end
-  end
-end

data/lib/stripe/errors/permission_error.rb

@@ -1,4 +0,0 @@
-module Stripe
-  class PermissionError < StripeError
-  end
-end

data/lib/stripe/errors/rate_limit_error.rb

@@ -1,4 +0,0 @@
-module Stripe
-  class RateLimitError < StripeError
-  end
-end

data/lib/stripe/errors/stripe_error.rb

@@ -1,26 +0,0 @@
-module Stripe
-  class StripeError < StandardError
-    attr_reader :message
-    attr_reader :http_status
-    attr_reader :http_body
-    attr_reader :http_headers
-    attr_reader :request_id
-    attr_reader :json_body
-
-    def initialize(message=nil, http_status=nil, http_body=nil, json_body=nil,
-                   http_headers=nil)
-      @message = message
-      @http_status = http_status
-      @http_body = http_body
-      @http_headers = http_headers || {}
-      @json_body = json_body
-      @request_id = @http_headers[:request_id]
-    end
-
-    def to_s
-      status_string = @http_status.nil? ? "" : "(Status #{@http_status}) "
-      id_string = @request_id.nil? ? "" : "(Request #{@request_id}) "
-      "#{status_string}#{id_string}#{@message}"
-    end
-  end
-end