dwolla-ruby 2.5.1 → 2.5.5

data/examples/contacts.rb

@@ -1,33 +1,33 @@
-# Include the Dwolla gem
-require 'rubygems'
-require 'pp'
-require 'dwolla'
-
-# Include any required keys
-require './_keys.rb'
-
-# Instantiate a new Dwolla User client
-# And, seed a previously generated access token
-Dwolla::token = @token
-Dwolla::api_key = @api_key
-Dwolla::api_secret = @api_secret
-
-
-# EXAMPLE 1: 
-#   Fetch last 10 contacts from the 
-#   account associated with the provided
-#   OAuth token
-pp Dwolla::Contacts.get
-
-
-# EXAMPLE 2: 
-#   Search through the contacts of the
-#   account associated with the provided
-#   OAuth token
-pp Dwolla::Contacts.get({:search => 'Ben'})
-
-
-# EXAMPLE 3: 
-#   Get a list of nearby Dwolla spots
-#   for a given set of coordinates
+# Include the Dwolla gem
+require 'rubygems'
+require 'pp'
+require 'dwolla'
+
+# Include any required keys
+require './_keys.rb'
+
+# Instantiate a new Dwolla User client
+# And, seed a previously generated access token
+Dwolla::token = @token
+Dwolla::api_key = @api_key
+Dwolla::api_secret = @api_secret
+
+
+# EXAMPLE 1: 
+#   Fetch last 10 contacts from the 
+#   account associated with the provided
+#   OAuth token
+pp Dwolla::Contacts.get
+
+
+# EXAMPLE 2: 
+#   Search through the contacts of the
+#   account associated with the provided
+#   OAuth token
+pp Dwolla::Contacts.get({:search => 'Ben'})
+
+
+# EXAMPLE 3: 
+#   Get a list of nearby Dwolla spots
+#   for a given set of coordinates
 pp Dwolla::Contacts.nearby({:latitude => 1, :longitude => 2})

data/examples/fundingSources.rb

@@ -1,39 +1,39 @@
-# Include the Dwolla gem
-require 'rubygems'
-require 'pp'
-require 'dwolla'
-
-# Include any required keys
-require './_keys.rb'
-
-# Instantiate a new Dwolla User client
-# And, seed a previously generated access token
-Dwolla::token = @token
-
-
-# EXAMPLE 1: 
-#   Fetch all funding sources for the
-#   account associated with the provided
-#   OAuth token
-pp Dwolla::FundingSources.get
-
-
-# EXAMPLE 2: 
-#   Fetch detailed information for the
-#   funding source with a specific ID
-pp Dwolla::FundingSources.get('funding_source_id')
-
-# EXAMPLE 3:
-#   Deposit funds from a funding source (bank account)
-#   into the Dwolla account balance.
-pp Dwolla::FundingSources.deposit('funding_source_id', {:amount => 12.95, :pin => @pin})
-
-# EXAMPLE 4:
-#   Withdraw funds from a Dwolla account balance into
-#   a funding source (bank account)
-pp Dwolla::FundingSources.withdraw('funding_source_id', {:amount => 12.95, :pin => @pin})
-
-# EXAMPLE 5:
-#   Add a new funding source (bank account).
-#   Possible values for account_type: "Checking" and "Savings"
-pp Dwolla::FundingSources.add({:routing_number => 99999999, :account_number => 99999999, :account_type => "Checking", :name => "Some Nickname"})
+# Include the Dwolla gem
+require 'rubygems'
+require 'pp'
+require 'dwolla'
+
+# Include any required keys
+require './_keys.rb'
+
+# Instantiate a new Dwolla User client
+# And, seed a previously generated access token
+Dwolla::token = @token
+
+
+# EXAMPLE 1: 
+#   Fetch all funding sources for the
+#   account associated with the provided
+#   OAuth token
+pp Dwolla::FundingSources.get
+
+
+# EXAMPLE 2: 
+#   Fetch detailed information for the
+#   funding source with a specific ID
+pp Dwolla::FundingSources.get('funding_source_id')
+
+# EXAMPLE 3:
+#   Deposit funds from a funding source (bank account)
+#   into the Dwolla account balance.
+pp Dwolla::FundingSources.deposit('funding_source_id', {:amount => 12.95, :pin => @pin})
+
+# EXAMPLE 4:
+#   Withdraw funds from a Dwolla account balance into
+#   a funding source (bank account)
+pp Dwolla::FundingSources.withdraw('funding_source_id', {:amount => 12.95, :pin => @pin})
+
+# EXAMPLE 5:
+#   Add a new funding source (bank account).
+#   Possible values for account_type: "Checking" and "Savings"
+pp Dwolla::FundingSources.add({:routing_number => 99999999, :account_number => 99999999, :account_type => "Checking", :name => "Some Nickname"})

data/examples/oauth.rb

@@ -1,34 +1,34 @@
-# Include the Dwolla gem
-require 'rubygems'
-require 'pp'
-require 'sinatra'
-require 'dwolla'
-
-# Include any required keys
-require './_keys.rb'
-
-# Instantiate a new Dwolla User client
-Dwolla::api_key = @api_key
-Dwolla::api_secret = @api_secret
-
-# Constants...
-redirect_uri = 'http://localhost:4567/oauth_return'
-
-# STEP 1:
-#   Create an authentication URL
-#   that the user will be redirected to
-get '/' do
-    authUrl = Dwolla::OAuth.get_auth_url(redirect_uri)
-    "To begin the OAuth process, send the user off to <a href=\"#{authUrl}\">#{authUrl}</a>"
-end
-
-
-# STEP 2:
-#   Exchange the temporary code given
-#   to us in the querystring, for
-#   a never-expiring OAuth access token
-get '/oauth_return' do
-    code = params['code']
-    token = Dwolla::OAuth.get_token(code, redirect_uri)
-    "Your never-expiring OAuth access token is: <b>#{token}</b>"
-end
+# Include the Dwolla gem
+require 'rubygems'
+require 'pp'
+require 'sinatra'
+require 'dwolla'
+
+# Include any required keys
+require './_keys.rb'
+
+# Instantiate a new Dwolla User client
+Dwolla::api_key = @api_key
+Dwolla::api_secret = @api_secret
+
+# Constants...
+redirect_uri = 'http://localhost:4567/oauth_return'
+
+# STEP 1:
+#   Create an authentication URL
+#   that the user will be redirected to
+get '/' do
+    authUrl = Dwolla::OAuth.get_auth_url(redirect_uri)
+    "To begin the OAuth process, send the user off to <a href=\"#{authUrl}\">#{authUrl}</a>"
+end
+
+
+# STEP 2:
+#   Exchange the temporary code given
+#   to us in the querystring, for
+#   a never-expiring OAuth access token
+get '/oauth_return' do
+    code = params['code']
+    token = Dwolla::OAuth.get_token(code, redirect_uri)
+    "Your never-expiring OAuth access token is: <b>#{token}</b>"
+end

data/examples/offsiteGateway.rb

@@ -1,31 +1,31 @@
-# Include the Dwolla gem
-require 'rubygems'
-require 'pp'
-require 'dwolla'
-
-# Include any required keys
-require './_keys.rb'
-
-# Instantiate a new Dwolla User client
-Dwolla::api_key = @api_key
-Dwolla::api_secret = @api_secret
-
-# Clear out any previous session data
-Dwolla::OffsiteGateway.clear_session
-
-# Optional Settings
-Dwolla::OffsiteGateway.redirect = 'http://dwolla.com/payment_redirect'
-Dwolla::OffsiteGateway.callback = 'http://dwolla.com/payment_callback'
-Dwolla::OffsiteGateway.set_customer_info('Michael', 'Schonfeld', 'michael@dwolla.com', 'New York', 'NY', '10001')
-Dwolla::OffsiteGateway.discount = 4.95
-Dwolla::OffsiteGateway.notes = 'This is just an offsite gateway test...'
-
-# Add products
-Dwolla::OffsiteGateway.add_product('Macbook Air', '13" Macbook Air; Model #0001', 499.99, 1)
-
-# Generate a checkout sesssion
-pp Dwolla::OffsiteGateway.get_checkout_url('812-734-7288')
-
-# Verify and parse gateway callback
-data = Dwolla::OffsiteGateway.read_callback('{"Amount":0.01,"OrderId":null,"Status":"Completed","Error":null,"TransactionId":3396300,"CheckoutId":"51f9dfaa-20ed-41a7-8874-00a47c19c655","Signature":"8be03dfd0e95c567b2855f5876acfc98992f6402","TestMode":"false","ClearingDate":"7/22/2013 8:42:18 PM"}')
-pp data
+# Include the Dwolla gem
+require 'rubygems'
+require 'pp'
+require 'dwolla'
+
+# Include any required keys
+require './_keys.rb'
+
+# Instantiate a new Dwolla User client
+Dwolla::api_key = @api_key
+Dwolla::api_secret = @api_secret
+
+# Clear out any previous session data
+Dwolla::OffsiteGateway.clear_session
+
+# Optional Settings
+Dwolla::OffsiteGateway.redirect = 'http://dwolla.com/payment_redirect'
+Dwolla::OffsiteGateway.callback = 'http://dwolla.com/payment_callback'
+Dwolla::OffsiteGateway.set_customer_info('Michael', 'Schonfeld', 'michael@dwolla.com', 'New York', 'NY', '10001')
+Dwolla::OffsiteGateway.discount = 4.95
+Dwolla::OffsiteGateway.notes = 'This is just an offsite gateway test...'
+
+# Add products
+Dwolla::OffsiteGateway.add_product('Macbook Air', '13" Macbook Air; Model #0001', 499.99, 1)
+
+# Generate a checkout sesssion
+pp Dwolla::OffsiteGateway.get_checkout_url('812-734-7288')
+
+# Verify and parse gateway callback
+data = Dwolla::OffsiteGateway.read_callback('{"Amount":0.01,"OrderId":null,"Status":"Completed","Error":null,"TransactionId":3396300,"CheckoutId":"51f9dfaa-20ed-41a7-8874-00a47c19c655","Signature":"8be03dfd0e95c567b2855f5876acfc98992f6402","TestMode":"false","ClearingDate":"7/22/2013 8:42:18 PM"}')
+pp data

data/examples/transactions.rb

@@ -1,38 +1,38 @@
-# Include the Dwolla gem
-require 'rubygems'
-require 'pp'
-require '../lib/dwolla'
-
-# Include any required keys
-require './_keys.rb'
-
-# Instantiate a new Dwolla User client
-# And, seed a previously generated access token
-Dwolla::token = @token
-Dwolla::debug = true
-
-# EXAMPLE 1:
-#   Send money ($1.00) to a Dwolla ID
-transactionId = Dwolla::Transactions.send({:destinationId => '812-626-8794', :amount => 1.00, :pin => @pin})
-pp transactionId
-
-# EXAMPLE 2:
-#   Send money ($1.00) to an email address, with a note
-transactionId = Dwolla::Transactions.send({:destinationId => '812-626-8794', :destinationType => 'Email', :amount => 1.00, :pin => @pin, :notes => 'Everyone loves getting money'})
-pp transactionId
-
-# EXAMPLE 3:
-#   Get details about all recent transactions
-pp Dwolla::Transactions.get
-
-# EXAMPLE 4:
-#   Get details about a certain Transaction
-pp Dwolla::Transactions.get(transactionId)
-
-# EXAMPLE 4:
-#   Get details about a certain Transaction
-#   using the API key & secret
-Dwolla::token = ''
-Dwolla::api_key = @api_key
-Dwolla::api_secret = @api_secret
-pp Dwolla::Transactions.get(transactionId, {}, false)
+# Include the Dwolla gem
+require 'rubygems'
+require 'pp'
+require '../lib/dwolla'
+
+# Include any required keys
+require './_keys.rb'
+
+# Instantiate a new Dwolla User client
+# And, seed a previously generated access token
+Dwolla::token = @token
+Dwolla::debug = true
+
+# EXAMPLE 1:
+#   Send money ($1.00) to a Dwolla ID
+transactionId = Dwolla::Transactions.send({:destinationId => '812-626-8794', :amount => 1.00, :pin => @pin})
+pp transactionId
+
+# EXAMPLE 2:
+#   Send money ($1.00) to an email address, with a note
+transactionId = Dwolla::Transactions.send({:destinationId => '812-626-8794', :destinationType => 'Email', :amount => 1.00, :pin => @pin, :notes => 'Everyone loves getting money'})
+pp transactionId
+
+# EXAMPLE 3:
+#   Get details about all recent transactions
+pp Dwolla::Transactions.get
+
+# EXAMPLE 4:
+#   Get details about a certain Transaction
+pp Dwolla::Transactions.get(transactionId)
+
+# EXAMPLE 4:
+#   Get details about a certain Transaction
+#   using the API key & secret
+Dwolla::token = ''
+Dwolla::api_key = @api_key
+Dwolla::api_secret = @api_secret
+pp Dwolla::Transactions.get(transactionId, {}, false)

data/examples/users.rb

@@ -1,31 +1,31 @@
-# Include the Dwolla gem
-require 'rubygems'
-require 'pp'
-require 'dwolla'
-
-# Include any required keys
-require '_keys.rb'
-
-# Instantiate a new Dwolla User client
-# And, seed a previously generated access token
-Dwolla::token = @token
-Dwolla::api_key = @api_key
-Dwolla::api_secret = @api_secret
-
-# EXAMPLE 1:
-#   Fetch account information for the
-#   account associated with the provided
-#   OAuth token
-pp Dwolla::Users.get
-
-
-# EXAMPLE 2: 
-#   Fetch basic account information
-#   for a given Dwolla ID
-pp Dwolla::Users.get('812-626-8794')
-
-
-# EXAMPLE 3: 
-#   Fetch basic account information
-#   for a given Email address
+# Include the Dwolla gem
+require 'rubygems'
+require 'pp'
+require 'dwolla'
+
+# Include any required keys
+require '_keys.rb'
+
+# Instantiate a new Dwolla User client
+# And, seed a previously generated access token
+Dwolla::token = @token
+Dwolla::api_key = @api_key
+Dwolla::api_secret = @api_secret
+
+# EXAMPLE 1:
+#   Fetch account information for the
+#   account associated with the provided
+#   OAuth token
+pp Dwolla::Users.get
+
+
+# EXAMPLE 2: 
+#   Fetch basic account information
+#   for a given Dwolla ID
+pp Dwolla::Users.get('812-626-8794')
+
+
+# EXAMPLE 3: 
+#   Fetch basic account information
+#   for a given Email address
 pp Dwolla::Users.get('michael@dwolla.com')

data/gemfiles/json.gemfile

@@ -1,3 +1,3 @@
-source "https://rubygems.org"
-gemspec :path => File.join(File.dirname(__FILE__), "..")
+source "https://rubygems.org"
+gemspec :path => File.join(File.dirname(__FILE__), "..")
 gem "json"

data/lib/dwolla.rb

@@ -1,326 +1,326 @@
-# Dwolla Ruby API Wrapper
-# Heavily based off Stripe's Ruby Gem
-# API spec at https://developers.dwolla.com
-require 'openssl'
-require 'rest_client'
-require 'multi_json'
-require 'addressable/uri'
-
-# Version
-require 'dwolla/version'
-
-# Resources
-require 'dwolla/json'
-require 'dwolla/transactions'
-require 'dwolla/requests'
-require 'dwolla/contacts'
-require 'dwolla/users'
-require 'dwolla/balance'
-require 'dwolla/funding_sources'
-require 'dwolla/oauth'
-require 'dwolla/offsite_gateway'
-require 'dwolla/accounts'
-# require 'dwolla/register' // Under Construction
-
-# Errors
-require 'dwolla/errors/dwolla_error'
-require 'dwolla/errors/api_connection_error'
-require 'dwolla/errors/api_error'
-require 'dwolla/errors/missing_parameter_error'
-require 'dwolla/errors/authentication_error'
-require 'dwolla/errors/invalid_request_error'
-
-module Dwolla
-    @@api_key = nil
-    @@api_secret = nil
-    @@token = nil
-    @@api_base = '/oauth/rest'
-    @@verify_ssl_certs = true
-    @@api_version = nil
-    @@debug = false
-    @@sandbox = false
-    @@scope = 'send|transactions|balance|request|contacts|accountinfofull|funding'
-
-    def self.api_key=(api_key)
-        @@api_key = api_key
-    end
-
-    def self.api_key
-        @@api_key
-    end
-
-    def self.api_secret=(api_secret)
-        @@api_secret = api_secret
-    end
-
-    def self.api_secret
-        @@api_secret
-    end
-
-    def self.sandbox=(sandbox)
-        @@sandbox = sandbox
-    end
-
-    def self.sandbox
-        @@sandbox
-    end
-
-    def self.debug
-        @@debug
-    end
-
-    def self.debug=(debug)
-        @@debug = debug
-    end
-
-    def self.api_version=(api_version)
-        @@api_version = api_version
-    end
-
-    def self.api_version
-        @@api_version
-    end
-
-    def self.verify_ssl_certs=(verify_ssl_certs)
-        @@verify_ssl_certs = verify_ssl_certs
-    end
-
-    def self.verify_ssl_certs
-        @@verify_ssl_certs
-    end
-
-    def self.token=(token)
-        @@token = token
-    end
-
-    def self.token
-        @@token
-    end
-
-    def self.scope=(scope)
-        @@scope = scope
-    end
-
-    def self.scope
-        @@scope
-    end
-
-    def self.hostname
-        if not @@sandbox
-            return 'https://www.dwolla.com'
-        else
-            return 'http://uat.dwolla.com'
-        end
-    end
-
-    def self.endpoint_url(endpoint)
-        self.hostname + @@api_base + endpoint
-    end
-
-    def self.request(method, url, params={}, headers={}, oauth=true, parse_response=true, custom_url=false)
-        # if oauth is nil, assume default [true]
-        oauth = true if oauth.nil?
-
-        # figure out which auth to use
-        if oauth and not params[:oauth_token]
-            if not oauth.is_a?(TrueClass) # was token passed in the oauth param?
-                params = {
-                    :oauth_token => oauth
-                }.merge(params)
-            else
-                raise AuthenticationError.new('No OAuth Token Provided.') unless token
-                params = {
-                    :oauth_token => token
-                }.merge(params)
-            end
-        elsif oauth and params[:oauth_token]
-            raise AuthenticationError.new('No OAuth Token Provided.') unless params[:oauth_token]
-        else not oauth
-            raise AuthenticationError.new('No App Key & Secret Provided.') unless (api_key && api_secret)
-            params = {
-                :client_id => api_key,
-                :client_secret => api_secret
-            }.merge(params)
-        end
-
-        if !verify_ssl_certs
-            $stderr.puts "WARNING: Running without SSL cert verification."
-        else
-            ssl_opts = {
-                :use_ssl => true
-            }
-        end
-
-        uname = (@@uname ||= RUBY_PLATFORM =~ /linux|darwin/i ? `uname -a 2>/dev/null`.strip : nil)
-        lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
-        ua = {
-            :bindings_version => Dwolla::VERSION,
-            :lang => 'ruby',
-            :lang_version => lang_version,
-            :platform => RUBY_PLATFORM,
-            :publisher => 'dwolla',
-            :uname => uname
-        }
-
-        url = self.endpoint_url(url) unless custom_url
-
-        case method.to_s.downcase.to_sym
-            when :get
-                # Make params into GET parameters
-                if params && params.count > 0
-                    uri = Addressable::URI.new
-                    uri.query_values = params
-                    url += '?' + uri.query
-                end
-                payload = nil
-            else
-                payload = JSON.dump(params)
-        end
-
-        begin
-            headers = { :x_dwolla_client_user_agent => Dwolla::JSON.dump(ua) }.merge(headers)
-        rescue => e
-            headers = {
-                :x_dwolla_client_raw_user_agent => ua.inspect,
-                :error => "#{e} (#{e.class})"
-            }.merge(headers)
-        end
-
-        headers = {
-            :user_agent => "Dwolla Ruby API Wrapper/#{Dwolla::VERSION}",
-            :content_type => 'application/json'
-        }.merge(headers)
-
-        if self.api_version
-            headers[:dwolla_version] = self.api_version
-        end
-
-        opts = {
-            :method => method,
-            :url => url,
-            :headers => headers,
-            :open_timeout => 30,
-            :payload => payload,
-            :timeout => 80
-        }.merge(ssl_opts)
-
-        if self.debug
-            if self.sandbox
-                puts "[DWOLLA SANDBOX MODE OPERATION]"
-            end
-
-            puts "Firing request with options and headers:"
-            puts opts
-            puts headers
-        end
-
-        begin
-            response = execute_request(opts)
-        rescue SocketError => e
-            self.handle_restclient_error(e)
-        rescue NoMethodError => e
-            # Work around RestClient bug
-            if e.message =~ /\WRequestFailed\W/
-                e = APIConnectionError.new('Unexpected HTTP response code')
-                self.handle_restclient_error(e)
-            else
-                raise
-            end
-        rescue RestClient::ExceptionWithResponse => e
-            if rcode = e.http_code and rbody = e.http_body
-                self.handle_api_error(rcode, rbody)
-            else
-                self.handle_restclient_error(e)
-            end
-        rescue RestClient::Exception, Errno::ECONNREFUSED => e
-            self.handle_restclient_error(e)
-        end
-
-        rbody = response.body
-        rcode = response.code
-
-        if self.debug
-            puts "Raw response headers received:"
-            puts headers
-            puts "Raw response body received:"
-            puts rbody
-        end
-
-        resp = self.extract_json(rbody, rcode)
-
-        if parse_response
-            return self.parse_response(resp)
-        else
-            return resp
-        end
-    end
-
-    private
-
-    def self.execute_request(opts)
-        RestClient::Request.execute(opts)
-    end
-
-    def self.extract_json(rbody, rcode)
-        begin
-            resp = Dwolla::JSON.load(rbody)
-        rescue MultiJson::DecodeError
-            raise APIError.new("There was an error parsing Dwolla's API response: #{rbody.inspect} (HTTP response code was #{rcode})", rcode, rbody)
-        end
-
-        return resp
-    end
-
-    def self.parse_response(resp)
-        raise APIError.new(resp['Message']) unless resp['Success']
-
-        return resp['Response']
-    end
-
-    def self.handle_api_error(rcode, rbody)
-        begin
-            error_obj = Dwolla::JSON.load(rbody)
-            error = error_obj[:error] or raise DwollaError.new # escape from parsing
-        rescue MultiJson::DecodeError, DwollaError
-            raise APIError.new("Invalid response object from API: #{rbody.inspect} (HTTP response code was #{rcode})", rcode, rbody)
-        end
-
-        case rcode
-            when 400, 404 then
-                raise invalid_request_error(error, rcode, rbody, error_obj)
-            when 401
-                raise authentication_error(error, rcode, rbody, error_obj)
-            else
-                raise api_error(error, rcode, rbody, error_obj)
-        end
-    end
-
-    def self.invalid_request_error(error, rcode, rbody, error_obj)
-        InvalidRequestError.new(error[:message], error[:param], rcode, rbody, error_obj)
-    end
-
-    def self.authentication_error(error, rcode, rbody, error_obj)
-        AuthenticationError.new(error[:message], rcode, rbody, error_obj)
-    end
-
-    def self.api_error(error, rcode, rbody, error_obj)
-        APIError.new(error[:message], rcode, rbody, error_obj)
-    end
-
-    def self.handle_restclient_error(e)
-        case e
-            when RestClient::ServerBrokeConnection, RestClient::RequestTimeout
-                message = "Could not connect to Dwolla (#{@@api_base}).  Please check your internet connection and try again.  If this problem persists, you should check Dwolla's service status at https://twitter.com/Dwolla, or let us know at support@Dwolla.com."
-            when RestClient::SSLCertificateNotVerified
-                message = "Could not verify Dwolla's SSL certificate. If this problem persists, let us know at support@dwolla.com."
-            when SocketError
-                message = "Unexpected error communicating when trying to connect to Dwolla. If this problem persists, let us know at support@dwolla.com."
-            else
-                message = "Unexpected error communicating with Dwolla. If this problem persists, let us know at support@dwolla.com."
-        end
-
-        message += "\n\n(Network error: #{e.message})"
-
-        raise APIConnectionError.new(message)
-    end
-end
+# Dwolla Ruby API Wrapper
+# Heavily based off Stripe's Ruby Gem
+# API spec at https://developers.dwolla.com
+require 'openssl'
+require 'rest_client'
+require 'multi_json'
+require 'addressable/uri'
+
+# Version
+require 'dwolla/version'
+
+# Resources
+require 'dwolla/json'
+require 'dwolla/transactions'
+require 'dwolla/requests'
+require 'dwolla/contacts'
+require 'dwolla/users'
+require 'dwolla/balance'
+require 'dwolla/funding_sources'
+require 'dwolla/oauth'
+require 'dwolla/offsite_gateway'
+require 'dwolla/accounts'
+# require 'dwolla/register' // Under Construction
+
+# Errors
+require 'dwolla/errors/dwolla_error'
+require 'dwolla/errors/api_connection_error'
+require 'dwolla/errors/api_error'
+require 'dwolla/errors/missing_parameter_error'
+require 'dwolla/errors/authentication_error'
+require 'dwolla/errors/invalid_request_error'
+
+module Dwolla
+    @@api_key = nil
+    @@api_secret = nil
+    @@token = nil
+    @@api_base = '/oauth/rest'
+    @@verify_ssl_certs = true
+    @@api_version = nil
+    @@debug = false
+    @@sandbox = false
+    @@scope = 'send|transactions|balance|request|contacts|accountinfofull|funding'
+
+    def self.api_key=(api_key)
+        @@api_key = api_key
+    end
+
+    def self.api_key
+        @@api_key
+    end
+
+    def self.api_secret=(api_secret)
+        @@api_secret = api_secret
+    end
+
+    def self.api_secret
+        @@api_secret
+    end
+
+    def self.sandbox=(sandbox)
+        @@sandbox = sandbox
+    end
+
+    def self.sandbox
+        @@sandbox
+    end
+
+    def self.debug
+        @@debug
+    end
+
+    def self.debug=(debug)
+        @@debug = debug
+    end
+
+    def self.api_version=(api_version)
+        @@api_version = api_version
+    end
+
+    def self.api_version
+        @@api_version
+    end
+
+    def self.verify_ssl_certs=(verify_ssl_certs)
+        @@verify_ssl_certs = verify_ssl_certs
+    end
+
+    def self.verify_ssl_certs
+        @@verify_ssl_certs
+    end
+
+    def self.token=(token)
+        @@token = token
+    end
+
+    def self.token
+        @@token
+    end
+
+    def self.scope=(scope)
+        @@scope = scope
+    end
+
+    def self.scope
+        @@scope
+    end
+
+    def self.hostname
+        if not @@sandbox
+            return 'https://www.dwolla.com'
+        else
+            return 'https://uat.dwolla.com'
+        end
+    end
+
+    def self.endpoint_url(endpoint)
+        self.hostname + @@api_base + endpoint
+    end
+
+    def self.request(method, url, params={}, headers={}, oauth=true, parse_response=true, custom_url=false)
+        # if oauth is nil, assume default [true]
+        oauth = true if oauth.nil?
+
+        # figure out which auth to use
+        if oauth and not params[:oauth_token]
+            if not oauth.is_a?(TrueClass) # was token passed in the oauth param?
+                params = {
+                    :oauth_token => oauth
+                }.merge(params)
+            else
+                raise AuthenticationError.new('No OAuth Token Provided.') unless token
+                params = {
+                    :oauth_token => token
+                }.merge(params)
+            end
+        elsif oauth and params[:oauth_token]
+            raise AuthenticationError.new('No OAuth Token Provided.') unless params[:oauth_token]
+        else not oauth
+            raise AuthenticationError.new('No App Key & Secret Provided.') unless (api_key && api_secret)
+            params = {
+                :client_id => api_key,
+                :client_secret => api_secret
+            }.merge(params)
+        end
+
+        if !verify_ssl_certs
+            $stderr.puts "WARNING: Running without SSL cert verification."
+        else
+            ssl_opts = {
+                :use_ssl => true
+            }
+        end
+
+        uname = (@@uname ||= RUBY_PLATFORM =~ /linux|darwin/i ? `uname -a 2>/dev/null`.strip : nil)
+        lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
+        ua = {
+            :bindings_version => Dwolla::VERSION,
+            :lang => 'ruby',
+            :lang_version => lang_version,
+            :platform => RUBY_PLATFORM,
+            :publisher => 'dwolla',
+            :uname => uname
+        }
+
+        url = self.endpoint_url(url) unless custom_url
+
+        case method.to_s.downcase.to_sym
+            when :get
+                # Make params into GET parameters
+                if params && params.count > 0
+                    uri = Addressable::URI.new
+                    uri.query_values = params
+                    url += '?' + uri.query
+                end
+                payload = nil
+            else
+                payload = JSON.dump(params)
+        end
+
+        begin
+            headers = { :x_dwolla_client_user_agent => Dwolla::JSON.dump(ua) }.merge(headers)
+        rescue => e
+            headers = {
+                :x_dwolla_client_raw_user_agent => ua.inspect,
+                :error => "#{e} (#{e.class})"
+            }.merge(headers)
+        end
+
+        headers = {
+            :user_agent => "Dwolla Ruby API Wrapper/#{Dwolla::VERSION}",
+            :content_type => 'application/json'
+        }.merge(headers)
+
+        if self.api_version
+            headers[:dwolla_version] = self.api_version
+        end
+
+        opts = {
+            :method => method,
+            :url => url,
+            :headers => headers,
+            :open_timeout => 30,
+            :payload => payload,
+            :timeout => 80
+        }.merge(ssl_opts)
+
+        if self.debug
+            if self.sandbox
+                puts "[DWOLLA SANDBOX MODE OPERATION]"
+            end
+
+            puts "Firing request with options and headers:"
+            puts opts
+            puts headers
+        end
+
+        begin
+            response = execute_request(opts)
+        rescue SocketError => e
+            self.handle_restclient_error(e)
+        rescue NoMethodError => e
+            # Work around RestClient bug
+            if e.message =~ /\WRequestFailed\W/
+                e = APIConnectionError.new('Unexpected HTTP response code')
+                self.handle_restclient_error(e)
+            else
+                raise
+            end
+        rescue RestClient::ExceptionWithResponse => e
+            if rcode = e.http_code and rbody = e.http_body
+                self.handle_api_error(rcode, rbody)
+            else
+                self.handle_restclient_error(e)
+            end
+        rescue RestClient::Exception, Errno::ECONNREFUSED => e
+            self.handle_restclient_error(e)
+        end
+
+        rbody = response.body
+        rcode = response.code
+
+        if self.debug
+            puts "Raw response headers received:"
+            puts headers
+            puts "Raw response body received:"
+            puts rbody
+        end
+
+        resp = self.extract_json(rbody, rcode)
+
+        if parse_response
+            return self.parse_response(resp)
+        else
+            return resp
+        end
+    end
+
+    private
+
+    def self.execute_request(opts)
+        RestClient::Request.execute(opts)
+    end
+
+    def self.extract_json(rbody, rcode)
+        begin
+            resp = Dwolla::JSON.load(rbody)
+        rescue MultiJson::DecodeError
+            raise APIError.new("There was an error parsing Dwolla's API response: #{rbody.inspect} (HTTP response code was #{rcode})", rcode, rbody)
+        end
+
+        return resp
+    end
+
+    def self.parse_response(resp)
+        raise APIError.new(resp['Message']) unless resp['Success']
+
+        return resp['Response']
+    end
+
+    def self.handle_api_error(rcode, rbody)
+        begin
+            error_obj = Dwolla::JSON.load(rbody)
+            error = error_obj[:error] or raise DwollaError.new # escape from parsing
+        rescue MultiJson::DecodeError, DwollaError
+            raise APIError.new("Invalid response object from API: #{rbody.inspect} (HTTP response code was #{rcode})", rcode, rbody)
+        end
+
+        case rcode
+            when 400, 404 then
+                raise invalid_request_error(error, rcode, rbody, error_obj)
+            when 401
+                raise authentication_error(error, rcode, rbody, error_obj)
+            else
+                raise api_error(error, rcode, rbody, error_obj)
+        end
+    end
+
+    def self.invalid_request_error(error, rcode, rbody, error_obj)
+        InvalidRequestError.new(error[:message], error[:param], rcode, rbody, error_obj)
+    end
+
+    def self.authentication_error(error, rcode, rbody, error_obj)
+        AuthenticationError.new(error[:message], rcode, rbody, error_obj)
+    end
+
+    def self.api_error(error, rcode, rbody, error_obj)
+        APIError.new(error[:message], rcode, rbody, error_obj)
+    end
+
+    def self.handle_restclient_error(e)
+        case e
+            when RestClient::ServerBrokeConnection, RestClient::RequestTimeout
+                message = "Could not connect to Dwolla (#{@@api_base}).  Please check your internet connection and try again.  If this problem persists, you should check Dwolla's service status at https://twitter.com/Dwolla, or let us know at support@Dwolla.com."
+            when RestClient::SSLCertificateNotVerified
+                message = "Could not verify Dwolla's SSL certificate. If this problem persists, let us know at support@dwolla.com."
+            when SocketError
+                message = "Unexpected error communicating when trying to connect to Dwolla. If this problem persists, let us know at support@dwolla.com."
+            else
+                message = "Unexpected error communicating with Dwolla. If this problem persists, let us know at support@dwolla.com."
+        end
+
+        message += "\n\n(Network error: #{e.message})"
+
+        raise APIConnectionError.new(message)
+    end
+end