dwolla-ruby 1.1.0 → 2.0.0

data/lib/dwolla/balance.rb

@@ -0,0 +1,15 @@
+module Dwolla
+    class Balance
+        def self.get
+            url = balance_url
+
+            Dwolla.request(:get, url)
+        end
+
+        private
+
+        def self.balance_url
+            return '/balance/'
+        end
+    end
+end

data/lib/dwolla/contacts.rb

@@ -0,0 +1,22 @@
+module Dwolla
+    class Contacts
+        def self.get(filters={})
+            url = contacts_url
+
+            Dwolla.request(:get, url, filters)
+        end
+
+
+        def self.nearby(filters={})
+            url = contacts_url + 'nearby'
+
+            Dwolla.request(:get, url, filters, {}, false)
+        end
+
+        private
+
+        def self.contacts_url
+            return '/contacts/'
+        end
+    end
+end

data/lib/dwolla/errors/api_connection_error.rb

@@ -0,0 +1,4 @@
+module Dwolla
+  class APIConnectionError < DwollaError
+  end
+end

data/lib/dwolla/errors/api_error.rb

@@ -0,0 +1,4 @@
+module Dwolla
+  class APIError < DwollaError
+  end
+end

data/lib/dwolla/errors/authentication_error.rb

@@ -0,0 +1,4 @@
+module Dwolla
+  class AuthenticationError < DwollaError
+  end
+end

data/lib/dwolla/errors/dwolla_error.rb

@@ -0,0 +1,20 @@
+module Dwolla
+  class DwollaError < StandardError
+    attr_reader :message
+    attr_reader :http_status
+    attr_reader :http_body
+    attr_reader :json_body
+
+    def initialize(message=nil, http_status=nil, http_body=nil, json_body=nil)
+      @message = message
+      @http_status = http_status
+      @http_body = http_body
+      @json_body = json_body
+    end
+
+    def to_s
+      status_string = @http_status.nil? ? "" : "(Status #{@http_status}) "
+      "#{status_string}#{@message}"
+    end
+  end
+end

data/lib/dwolla/errors/invalid_request_error.rb

@@ -0,0 +1,10 @@
+module Dwolla
+  class InvalidRequestError < DwollaError
+    attr_accessor :param
+
+    def initialize(message, param, http_status=nil, http_body=nil, json_body=nil)
+      super(message, http_status, http_body, json_body)
+      @param = param
+    end
+  end
+end

data/lib/dwolla/errors/missing_parameter_error.rb

@@ -0,0 +1,4 @@
+module Dwolla
+  class MissingParameterError < DwollaError
+  end
+end

data/lib/dwolla/funding_sources.rb

@@ -0,0 +1,65 @@
+module Dwolla
+    class FundingSources
+        def self.get(id=nil)
+            url = funding_sources_url
+
+            url += id.to_s unless id.nil?
+
+            Dwolla.request(:get, url)
+        end
+
+        def self.withdraw(id=nil, params={})
+            raise MissingParameterError.new('No Funding Source ID Provided.') if id.nil?
+            raise MissingParameterError.new('No PIN Provided.') unless params[:pin]
+            raise MissingParameterError.new('No Amount Provided.') unless params[:amount]
+
+            url = funding_sources_url
+            url += id.to_s + '/withdraw'
+
+            Dwolla.request(:post, url, params)
+        end
+
+        def self.deposit(id=nil, params={})
+            raise MissingParameterError.new('No Funding Source ID Provided.') if id.nil?
+            raise MissingParameterError.new('No PIN Provided.') unless params[:pin]
+            raise MissingParameterError.new('No Amount Provided.') unless params[:amount]
+
+            url = funding_sources_url
+            url += id.to_s + '/deposit'
+
+            Dwolla.request(:post, url, params)
+        end
+
+        def self.add(params={})
+            raise MissingParameterError.new('No Account Number Provided.') unless params[:account_number]
+            raise MissingParameterError.new('No Routing Number (ABA) Provided.') unless params[:routing_number]
+            raise MissingParameterError.new('No Account Type Provided.') unless params[:account_type]
+            raise MissingParameterError.new('No Account Name Provided.') unless params[:name]
+
+            url = funding_sources_url
+
+            Dwolla.request(:post, url, params)
+        end
+
+        def self.verify(id=nil, params={})
+            raise MissingParameterError.new('No Funding Source ID Provided.') if id.nil?
+            raise MissingParameterError.new('No Deposit 1 Amount Provided.') unless params[:deposit1]
+            raise MissingParameterError.new('No Deposit 2 Amount Provided.') unless params[:deposit2]
+
+            url = funding_sources_url
+            url += id.to_s + '/verify'
+
+            Dwolla.request(:post, url, params)
+        end
+
+        class << self
+            alias_method :listing, :get
+        end
+
+        private
+
+        def self.funding_sources_url
+            return '/fundingsources/'
+        end
+    end
+end

data/lib/dwolla/json.rb

@@ -0,0 +1,21 @@
+module Dwolla
+  module JSON
+    if MultiJson.respond_to?(:dump)
+      def self.dump(*args)
+        MultiJson.dump(*args)
+      end
+
+      def self.load(*args)
+        MultiJson.load(*args)
+      end
+    else
+      def self.dump(*args)
+        MultiJson.encode(*args)
+      end
+
+      def self.load(*args)
+        MultiJson.decode(*args)
+      end
+    end
+  end
+end

data/lib/dwolla/oauth.rb

@@ -0,0 +1,43 @@
+module Dwolla
+    class OAuth
+        def self.get_auth_url(redirect_uri=nil, scope='send|transactions|balance|request|contacts|accountinfofull|funding')
+            raise AuthenticationError.new('No Api Key Provided.') unless Dwolla::api_key
+
+            params = {
+                :scope => scope,
+                :response_type => 'code',
+                :client_id => Dwolla::api_key
+            }
+
+            params['redirect_uri'] = redirect_uri unless redirect_uri.nil?
+
+            uri = Addressable::URI.new
+            uri.query_values = params
+
+            return auth_url + '?' + uri.query
+        end
+
+        def self.get_token(code=nil, redirect_uri=nil)
+            raise MissingParameterError.new('No Code Provided.') if code.nil?
+
+            params = {
+                :grant_type => 'authorization_code',
+                :code => code
+            }
+
+            params['redirect_uri'] = redirect_uri unless redirect_uri.nil?
+
+            Dwolla.request(:get, token_url, params, {}, false, false, true)['access_token']
+        end
+
+        private
+
+        def self.auth_url
+            return 'https://www.dwolla.com/oauth/v2/authenticate'
+        end
+
+        def self.token_url
+            return 'https://www.dwolla.com/oauth/v2/token'
+        end
+    end
+end

data/lib/dwolla/offsite_gateway.rb

@@ -0,0 +1,76 @@
+module Dwolla
+    class OffsiteGateway
+        @products = []
+        @discount = 0
+        @tax = 0
+        @shipping = 0
+        @destination_id = nil
+        @notes = nil
+        @facilitatorAmount = nil
+
+        def self.clear_session
+            @products = []
+        end
+
+        def self.add_product(name=nil, description=nil, price=nil, quantity=1)
+            @products.push {
+                :name => name,
+                :description => description,
+                :price => price,
+                :quantity => quantity
+            }
+        end
+
+        def self.discount=(discount)
+            @discount = discount
+        end
+
+        def self.tax=(tax)
+            @tax = tax
+        end
+
+        def self.shipping=(shipping)
+            @shipping = shipping
+        end
+
+        def self.get_checkout_url(params={})
+            params = {
+                :key => Dwolla::api_key,
+                :secret => Dwolla::api_secret,
+                :purchaseOrder => {
+                    :destinationId => @destinationId,
+                    :orderItems => @products,
+                    :discount => @discount,
+                    :shipping => @shipping,
+                    :tax => @tax,
+                    :total => @total
+                }
+            }
+
+            resp = Dwolla.request(:post, request_url, params, {}, false, false)
+
+            return checkout_url + resp['CheckoutId']
+        end
+
+        private
+
+        def self.request_url
+            return 'https://www.dwolla.com/payment/request'
+        end
+
+        def self.checkout_url
+            return 'https://www.dwolla.com/payment/checkout/'
+        end
+
+        def self.calculate_total
+            @total = 0
+
+            @products.each { |product|
+                @total += product['price'] * product['quantity']
+            }
+
+            return @total
+        end
+
+    end
+end

data/lib/dwolla/requests.rb

@@ -0,0 +1,56 @@
+module Dwolla
+    class Requests
+        def self.get(id=nil, filters={})
+            url = requests_url
+
+            if id.is_a?(Hash)
+                filters = id
+                id = nil
+            else
+                filters = {}
+            end
+
+            url += id.to_s unless id.nil?
+
+            Dwolla.request(:get, url, filters)
+        end
+
+        def self.delete(id=nil)
+            raise MissingParameterError.new('No Request ID Provided.') if id.nil?
+
+            url = requests_url + id.to_s + '/cancel'
+
+            Dwolla.request(:post, url)
+        end
+
+        def self.create(params={})
+            raise MissingParameterError.new('No Source ID Provided.') unless params[:sourceId]
+            raise MissingParameterError.new('No Amount Provided.') unless params[:amount]
+
+            url = requests_url
+
+            Dwolla.request(:post, url, params)
+        end
+
+        def self.fulfill(id=nil, params={})
+            raise MissingParameterError.new('No Request ID Provided.') if id.nil?
+            raise MissingParameterError.new('No PIN Provided.') unless params[:pin]
+
+            url = requests_url + id.to_s + '/fulfill'
+
+            Dwolla.request(:post, url, params)
+        end
+
+        class << self
+            alias_method :pending, :get
+            alias_method :cancel, :delete
+            alias_method :request, :create
+        end
+
+        private
+
+        def self.requests_url
+            return '/requests/'
+        end
+    end
+end

data/lib/dwolla/transactions.rb

@@ -0,0 +1,60 @@
+module Dwolla
+    class Transactions
+        def self.get(id=nil, filters={})
+            url = transactions_url
+
+            if id.is_a?(Hash)
+                filters = id
+                id = nil
+            else
+                filters = {}
+            end
+
+            url += id.to_s unless id.nil?
+
+            Dwolla.request(:get, url, filters)
+        end
+
+        def self.stats(filters={})
+            url = transactions_url + 'stats'
+
+            Dwolla.request(:get, url, filters)
+        end
+
+        def self.create(params={})
+            raise MissingParameterError.new('No PIN Provided.') unless params[:pin]
+            raise MissingParameterError.new('No Destination ID Provided.') unless params[:destinationId]
+            raise MissingParameterError.new('No Amount Provided.') unless params[:amount]
+
+            url = transactions_url + 'send'
+
+            Dwolla.request(:post, url, params)
+        end
+
+        def self.guest_send(params={})
+            raise MissingParameterError.new('No Destination ID Provided.') unless params[:destinationId]
+            raise MissingParameterError.new('No Amount Provided.') unless params[:amount]
+            raise MissingParameterError.new('No First Name Provided.') unless params[:firstName]
+            raise MissingParameterError.new('No Last Name Provided.') unless params[:lastName]
+            raise MissingParameterError.new('No Email Address Provided.') unless params[:emailAddress]
+            raise MissingParameterError.new('No Routing Number (ABA) Provided.') unless params[:routingNumber]
+            raise MissingParameterError.new('No Account Number Provided.') unless params[:accountNumber]
+            raise MissingParameterError.new('No Account Type Provided.') unless params[:accountType]
+
+            url = transactions_url + 'guestsend'
+
+            Dwolla.request(:post, url, params, {}, false)
+        end
+
+        class << self
+            alias_method :listing, :get
+            alias_method :send, :create
+        end
+
+        private
+
+        def self.transactions_url
+            return '/transactions/'
+        end
+    end
+end

data/lib/dwolla/users.rb

@@ -0,0 +1,36 @@
+module Dwolla
+    class Users
+        def self.get(id=nil)
+            url = users_url
+
+            unless id.nil?
+                url += id.to_s
+                @oauth = false
+            else
+                @oauth = true
+            end
+
+            Dwolla.request(:get, url, {}, {}, @oauth)
+        end
+
+        def self.me
+            # I'm not using the 'alias_method' fn
+            # because the .me method should not
+            # honor any parameters (i.e. User IDs)
+            # passed to it
+            self.get
+        end
+
+        def self.nearby(filters={})
+            url = users_url + 'nearby'
+
+            Dwolla.request(:get, url, filters, {}, false)
+        end
+
+        private
+
+        def self.users_url
+            return '/users/'
+        end
+    end
+end