NewMonarch-remit 0.0.1

data/lib/remit/get_prepaid_balance.rb

@@ -0,0 +1,23 @@
+require 'remit/common'
+
+module Remit
+  module GetPrepaidBalance
+    class Request < Remit::Request
+      action :GetPrepaidBalance
+      parameter :prepaid_instrument_id
+    end
+
+    class Response < Remit::Response
+      class PrepaidBalance < Remit::BaseResponse
+        parameter :available_balance, :type => Amount
+        parameter :pending_in_balance, :type => Amount
+      end
+
+      parameter :prepaid_balance, :type => PrepaidBalance
+    end
+
+    def get_prepaid_balance(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/get_results.rb

@@ -0,0 +1,27 @@
+require 'remit/common'
+
+module Remit
+  module GetResults
+    class Request < Remit::Request
+      action :GetResults
+      parameter :operation
+      parameter :max_results_count
+    end
+
+    class Response < Remit::Response
+      class TransactionResults < Remit::BaseResponse
+        parameter :transaction_id
+        parameter :operation_type, :element => :operation
+        parameter :caller_reference
+        parameter :transaction_status, :element => :status
+      end
+
+      parameter :transaction_results, :collection => TransactionResults
+      parameter :number_pending, :type => :integer
+    end
+
+    def get_results(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/get_token_by_caller.rb

@@ -0,0 +1,19 @@
+require 'remit/common'
+
+module Remit
+  module GetTokenByCaller
+    class Request < Remit::Request
+      action :GetTokenByCaller
+      parameter :caller_reference
+      parameter :token_id
+    end
+
+    class Response < Remit::Response
+      parameter :token, :type => Token
+    end
+
+    def get_token_by_caller(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/get_token_usage.rb

@@ -0,0 +1,18 @@
+require 'remit/common'
+
+module Remit
+  module GetTokenUsage
+    class Request < Remit::Request
+      action :GetTokenUsage
+      parameter :token_id
+    end
+
+    class Response < Remit::Response
+      parameter :token_usage_limits, :type => TokenUsageLimit
+    end
+
+    def get_token_usage(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/get_tokens.rb

@@ -0,0 +1,20 @@
+require 'remit/common'
+
+module Remit
+  module GetTokens
+    class Request < Remit::Request
+      action :GetTokens
+      parameter :caller_reference
+      parameter :token_friendly_name
+      parameter :token_status
+    end
+
+    class Response < Remit::Response
+      parameter :tokens, :collection => Token
+    end
+
+    def get_tokens(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/get_total_prepaid_liability.rb

@@ -0,0 +1,22 @@
+require 'remit/common'
+
+module Remit
+  module GetTotalPrepaidLiability
+    class Request < Remit::Request
+      action :GetTotalPrepaidLiability
+    end
+
+    class Response < Remit::Response
+      class OutstandingPrepaidLiability < Remit::BaseResponse
+        parameter :outstanding_balance, :type => Amount
+        parameter :panding_in_balance, :type => Amount
+      end
+
+      parameter :outstanding_prepaid_liability, :type => OutstandingPrepaidLiability
+    end
+
+    def get_total_prepaid_liability(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/get_transaction.rb

@@ -0,0 +1,42 @@
+require 'remit/common'
+
+module Remit
+  module GetTransaction
+    class Request < Remit::Request
+      action :GetTransaction
+      parameter :transaction_id
+    end
+
+    class Response < Remit::Response
+      class TransactionDetail < Remit::BaseResponse
+        parameter :caller_name
+        parameter :caller_token_id
+        parameter :caller_transaction_date, :type => :time
+        parameter :date_completed, :type => :time
+        parameter :date_received, :type => :time
+        parameter :error_code
+        parameter :error_message
+        parameter :fees, :type => Amount
+        parameter :meta_data
+        parameter :operation
+        parameter :payment_method
+        parameter :recipient_name
+        parameter :recipient_token_id
+        parameter :related_transactions
+        parameter :sender_name
+        parameter :sender_token_id
+        parameter :status
+        parameter :status_history
+        parameter :transaction_amount, :type => Amount
+        parameter :transaction_id
+        parameter :transaction_parts
+      end
+
+      parameter :transaction, :type => TransactionDetail
+    end
+
+    def get_transaction(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/install_payment_instruction.rb

@@ -0,0 +1,22 @@
+require 'remit/common'
+
+module Remit
+  module InstallPaymentInstruction
+    class Request < Remit::Request
+      action :InstallPaymentInstruction
+      parameter :payment_instruction
+      parameter :caller_reference
+      parameter :token_friendly_name
+      parameter :token_type
+      parameter :payment_reason
+    end
+
+    class Response < Remit::Response
+      parameter :token_id
+    end
+
+    def install_payment_instruction(request)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/ipn_request.rb

@@ -0,0 +1,56 @@
+require 'base64'
+require 'openssl/digest'
+
+module Remit
+  
+  ##
+  # Encapsulates the logic for IPN request validation and attribute retrieval.
+  # 
+  class IpnRequest
+    
+    # Signature key name used by AmazonFPS IPNs
+    SIGNATURE_KEY = 'signature'
+    
+    ##
+    # +params+ should be your controllers request parameters.
+    # 
+    def initialize(params, secret_key)
+      raise ArgumentError, "Expected the request params hash, received: #{params.inspect}" unless params.kind_of?(Hash)
+      @params             = strip_keys_from(params, 'action', 'controller')
+      @supplied_signature = @params.delete(SIGNATURE_KEY)
+      @secret_key         = secret_key
+    end
+    
+    def valid?
+      return false unless @supplied_signature
+      generate_signature_for(@params) == @supplied_signature
+    end
+    
+    def method_missing(method, *args) #:nodoc:
+      if @params.has_key?(method.to_s)
+        @params[method.to_s]
+      else
+        super(method, *args)
+      end
+    end
+    
+    
+    private
+    
+    
+    def generate_signature_for(params)
+      query   = params.sort_by { |k,v| k.downcase }
+      digest  = OpenSSL::Digest::Digest.new('sha1')
+      hmac    = OpenSSL::HMAC.digest(digest, @secret_key, query.to_s)
+      encoded = Base64.encode64(hmac).chomp
+    end
+    
+    def strip_keys_from(params, *ignore_keys)
+      parsed = params.dup
+      ignore_keys.each { |key| parsed.delete(key) }
+      parsed
+    end
+    
+  end
+  
+end

data/lib/remit/pay.rb

@@ -0,0 +1,35 @@
+require 'remit/common'
+
+module Remit
+  module Pay
+    class Request < Remit::Request
+      action :Pay
+      parameter :caller_description
+      parameter :caller_reference
+      parameter :caller_token_id
+      parameter :charge_fee_to
+      parameter :descriptor_policy, :type => Remit::RequestTypes::DescriptorPolicy
+      parameter :marketplace_fixed_fee, :type => Remit::RequestTypes::Amount
+      parameter :marketplace_variable_fee
+      parameter :meta_data
+      parameter :recipient_description
+      parameter :recipient_reference
+      parameter :recipient_token_id
+      parameter :sender_description
+      parameter :sender_reference
+      parameter :sender_token_id
+      parameter :temporary_decline_policy, :type => Remit::RequestTypes::TemporaryDeclinePolicy
+      parameter :transaction_amount, :type => Remit::RequestTypes::Amount
+      parameter :transaction_date
+    end
+
+    class Response < Remit::Response
+      parser :rexml
+      parameter :transaction_response, :namespace => 'ns3', :type => TransactionResponse
+    end
+
+    def pay(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/pipeline_response.rb

@@ -0,0 +1,62 @@
+module Remit
+  
+  class PipelineResponse
+    
+    def initialize(uri, secret_key)
+      @uri        = URI.parse(uri)
+      @secret_key = secret_key
+    end
+    
+    ##
+    # Returns +true+ if the response is correctly signed (awsSignature).
+    # 
+    #--
+    # The unescape_value method is used here because the awsSignature value
+    # pulled from the request is filtered through the same method.
+    #++
+    # 
+    def valid?
+      return false unless given_signature
+      Relax::Query.unescape_value(correct_signature) == given_signature
+    end
+    
+    ##
+    # Returns +true+ if the response returns a successful state.
+    # 
+    def successful?
+      [
+        Remit::PipelineStatusCode::SUCCESS_ABT,
+        Remit::PipelineStatusCode::SUCCESS_ACH,
+        Remit::PipelineStatusCode::SUCCESS_CC,
+        Remit::PipelineStatusCode::SUCCESS_RECIPIENT_TOKEN_INSTALLED
+      ].include?(request_query[:status])
+    end
+    
+    
+    def method_missing(method, *args) #:nodoc:
+      if request_query.has_key?(method.to_sym)
+        request_query[method.to_sym]
+      else
+        super
+      end
+    end
+    
+    
+    private
+    
+    
+    def request_query(reload = false)
+      @query ||= Remit::SignedQuery.parse(@uri, @secret_key, @uri.query || '')
+    end
+    
+    def given_signature
+      request_query[:awsSignature]
+    end
+    
+    def correct_signature
+      Remit::SignedQuery.new(@uri.path, @secret_key, request_query).sign
+    end
+    
+  end
+  
+end

data/lib/remit/refund.rb

@@ -0,0 +1,38 @@
+require 'remit/common'
+
+module Remit
+  module Refund
+    class Request < Remit::Request
+      action :Refund
+      parameter :caller_description
+      parameter :caller_reference
+      parameter :caller_token_id
+      parameter :charge_fee_to
+      parameter :meta_data
+      parameter :refund_amount, :type => Remit::RequestTypes::Amount
+      parameter :refund_recipient_description
+      parameter :refund_recipient_reference
+      parameter :refund_sender_description
+      parameter :refund_sender_reference
+      parameter :refund_sender_token_id
+      parameter :transaction_date
+      parameter :transaction_id
+      
+      
+      # The RefundAmount parameter has multiple components.  It is specified on the query string like
+      # so: RefundAmount.Amount=XXX&RefundAmount.CurrencyCode=YYY
+      def convert_complex_key(key, parameter)
+        "#{convert_key(key).to_s}.#{convert_key(parameter).to_s}"
+      end
+      
+    end
+
+    class Response < Remit::Response
+      parameter :transaction_response, :type => TransactionResponse
+    end
+
+    def refund(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/reserve.rb

@@ -0,0 +1,30 @@
+require 'remit/common'
+
+module Remit
+  module Reserve
+    class Request < Remit::Request
+      action :Reserve
+      parameter :recipient_token_id
+      parameter :sender_token_id
+      parameter :caller_token_id
+      parameter :sender_reference
+      parameter :recipient_reference
+      parameter :caller_reference
+      parameter :transaction_date
+      parameter :transaction_amount
+      parameter :charge_fee_to
+      parameter :sender_description
+      parameter :recipient_description
+      parameter :caller_description
+      parameter :meta_data
+    end
+
+    class Response < Remit::Response
+      parameter :transaction_response, :type => TransactionResponse
+    end
+
+    def reserve(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/retry_transaction.rb

@@ -0,0 +1,18 @@
+require 'remit/common'
+
+module Remit
+  module RetryTransaction
+    class Request < Remit::Request
+      action :RetryTransaction
+      parameter :original_transaction_id
+    end
+
+    class Response < Remit::Response
+      parameter :transaction_response, :type => TransactionResponse
+    end
+
+    def retry_transaction(request = Request.new)
+      call(request, Response)
+    end
+  end
+end