localocracy-remit 0.0.5

data/lib/remit/operations/refund.rb

@@ -0,0 +1,37 @@
+require 'remit/common'
+
+module Remit
+  module Refund
+    class Request < Remit::Request
+      action :Refund
+      parameter :caller_description
+      parameter :caller_reference, :required => true
+      parameter :caller_token_id, :required => true
+      parameter :charge_fee_to, :required => true
+      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, :required => true
+      parameter :transaction_date
+      parameter :transaction_id, :required => true
+
+      # 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
+      parser :rexml
+      parameter :transaction_response, :namespace => 'ns3', :type => TransactionResponse
+    end
+
+    def refund(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/operations/reserve.rb

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

data/lib/remit/operations/retry_transaction.rb

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

data/lib/remit/operations/settle.rb

@@ -0,0 +1,20 @@
+require 'remit/common'
+
+module Remit
+  module Settle
+    class Request < Remit::Request
+      action :Settle
+      parameter :reserve_transaction_id, :required => true
+      parameter :transaction_amount, :type => Remit::RequestTypes::Amount
+      parameter :transaction_date
+    end
+
+    class Response < Remit::Response
+      parameter :transaction_response, :type => TransactionResponse
+    end
+
+    def settle(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/operations/settle_debt.rb

@@ -0,0 +1,30 @@
+require 'remit/common'
+
+module Remit
+  module SettleDebt
+    class Request < Remit::Request
+      action :SettleDebt
+      parameter :caller_description
+      parameter :caller_reference, :required => true
+      parameter :caller_token_id, :required => true
+      parameter :charge_fee_to, :required => true
+      parameter :credit_instrument_id, :required => true
+      parameter :meta_data
+      parameter :recipient_description
+      parameter :recipient_reference
+      parameter :sender_description
+      parameter :sender_reference
+      parameter :sender_token_id, :required => true
+      parameter :settlement_amount, :type => Remit::RequestTypes::Amount, :required => true
+      parameter :transaction_date
+    end
+
+    class Response < Remit::Response
+      parameter :transaction_response, :type => TransactionResponse
+    end
+
+    def settle_debt(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/operations/subscribe_for_caller_notification.rb

@@ -0,0 +1,18 @@
+require 'remit/common'
+
+module Remit
+  module SubscribeForCallerNotification
+    class Request < Remit::Request
+      action :SubscribeForCallerNotification
+      parameter :notification_operation_name, :required => true
+      parameter :web_service_api_url, :required => true
+    end
+
+    class Response < Remit::Response
+    end
+
+    def subscribe_for_caller_notification(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/operations/unsubscribe_for_caller_notification.rb

@@ -0,0 +1,17 @@
+require 'remit/common'
+
+module Remit
+  module UnsubscribeForCallerNotification
+    class Request < Remit::Request
+      action :UnSubscribeForCallerNotification
+      parameter :notification_operation_name, :required => true
+    end
+
+    class Response < Remit::Response
+    end
+
+    def unsubscribe_for_caller_notification(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/operations/write_off_debt.rb

@@ -0,0 +1,28 @@
+require 'remit/common'
+
+module Remit
+  module WriteOffDebt
+    class Request < Remit::Request
+      action :WriteOffDebt
+      parameter :caller_token_id, :required => true
+      parameter :credit_instrument_id, :required => true
+      parameter :adjustment_amount, :required => true
+      parameter :transaction_date
+      parameter :sender_reference
+      parameter :caller_reference, :required => true
+      parameter :recipient_reference
+      parameter :sender_description
+      parameter :recipient_description
+      parameter :caller_description
+      parameter :meta_data
+    end
+
+    class Response < Remit::Response
+      parameter :transaction_response, :type => TransactionResponse
+    end
+
+    def write_off_debt(request = Request.new)
+      call(request, Response)
+    end
+  end
+end

data/lib/remit/pipeline_response.rb

@@ -0,0 +1,52 @@
+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
+
+    def request_query(reload = false)
+      @query ||= Remit::SignedQuery.parse(@uri, @secret_key, @uri.query || '')
+    end
+    private :request_query
+
+    def given_signature
+      request_query[:awsSignature]
+    end
+    private :given_signature
+
+    def correct_signature
+      Remit::SignedQuery.new(@uri.path, @secret_key, request_query).sign
+    end
+    private :correct_signature
+  end
+end

data/spec/integrations/get_account_activity_spec.rb

@@ -0,0 +1,36 @@
+require File.dirname(__FILE__) + '/integrations_helper'
+
+describe 'a GetAccountActivity call' do
+  it_should_behave_like 'a successful response'
+
+  before(:all) do
+    request = Remit::GetAccountActivity::Request.new
+    request.start_date = Date.today - 7
+    @response = remit.get_account_activity(request)
+  end
+
+  it 'should have a collection of transactions' do
+    @response.should have_at_least(1).transactions
+  end
+
+  it 'should have a transaction with all of its values set' do
+    transaction = @response.transactions.first
+    transaction.caller_name.should_not be_empty
+    transaction.caller_token_id.should_not be_empty
+    transaction.caller_transaction_date.should_not be_nil
+    transaction.date_completed.should_not be_nil
+    transaction.date_received.should_not be_nil
+    transaction.error_code.should be_empty
+    transaction.error_detail.should be_nil
+    transaction.error_message.should be_nil
+    transaction.fees.should_not be_nil
+    transaction.operation.should_not be_empty
+    transaction.recipient_name.should_not be_empty
+    transaction.sender_name.should_not be_empty
+    transaction.sender_token_id.should_not be_empty
+    transaction.status.should_not be_empty
+    transaction.transaction_amount.should_not be_nil
+    transaction.transaction_id.should_not be_empty
+    transaction.transaction_parts.should_not be_empty
+  end
+end

data/spec/integrations/get_tokens_spec.rb

@@ -0,0 +1,38 @@
+require File.dirname(__FILE__) + '/integrations_helper'
+
+describe 'a GetTokens call' do
+  it_should_behave_like 'a successful response'
+
+  before(:all) do
+    @response = remit.get_tokens
+  end
+
+  it 'should have a collection of tokens' do
+    @response.should have_at_least(1).tokens
+  end
+
+  it 'should have a token with all of its values set' do
+    token = @response.tokens.first
+    token.token_id.should_not be_empty
+    token.friendly_name.should_not be_empty
+    token.status.should_not be_empty
+    token.date_installed.should_not be_nil
+    token.caller_installed.should_not be_empty
+    token.caller_reference.should_not be_empty
+    token.token_type.should_not be_empty
+    token.old_token_id.should_not be_empty
+    token.payment_reason.should_not be_empty
+  end
+
+  it 'should have a token with a token ID' do
+    @response.tokens.first.token_id.should_not be_empty
+  end
+
+  it 'should have a token with a valid token status' do
+    @response.tokens.first.status.should match(/^(IN)?ACTIVE$/i)
+  end
+
+  it 'should have a token with a valid installation date' do
+    @response.tokens.first.date_installed.should be_a_kind_of(Time)
+  end
+end

data/spec/integrations/integrations_helper.rb

@@ -0,0 +1,8 @@
+ACCESS_KEY = ENV['AWS_ACCESS_KEY'] || ENV['AMAZON_ACCESS_KEY_ID']
+SECRET_KEY = ENV['AWS_SECRET_KEY'] || ENV['AMAZON_SECRET_ACCESS_KEY']
+
+unless ACCESS_KEY and SECRET_KEY
+  raise RuntimeError, "You must set your AWS_ACCESS_KEY and AWS_SECRET_KEY environment variables to run integration tests"
+end
+
+require File.dirname(__FILE__) + '/../spec_helper'

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+require 'rubygems'
+require 'spec'
+
+require File.dirname(__FILE__) + '/../lib/remit'
+
+def remit
+  @remit ||= Remit::API.new(ACCESS_KEY, SECRET_KEY, true)
+end
+
+describe 'a successful response', :shared => true do
+  it 'should return success' do
+    @response.status.should == 'Success'
+  end
+
+  it 'should not have any errors' do
+    @response.errors.should be_nil
+  end
+
+  it 'should have a request ID' do
+    @response.request_id.should_not be_nil
+  end
+end
+
+describe 'a failed response', :shared => true do
+  it "is not successful" do
+    @response.should_not be_successful
+  end
+
+  it "has a request id" do
+    @response.request_id.should_not be_empty
+  end
+
+  it "has errors" do
+    @response.errors.should_not be_empty
+  end
+end

data/spec/units/get_pipeline_spec.rb

@@ -0,0 +1,165 @@
+require File.dirname(__FILE__) + '/units_helper'
+
+describe 'A pipeline', :shared => true do
+  before do
+    @pipeline_options = {
+      :return_url => 'http://example.com/'
+    }
+  end
+
+  it 'should sign its URL' do
+    uri = URI.parse(@pipeline.url)
+    pipeline = Remit::SignedQuery.parse(uri, remit.secret_key, uri.query)
+    query = Relax::Query.parse(uri)
+
+    pipeline[:awsSignature].should == query[:awsSignature]
+  end
+end
+
+describe 'A single-use pipeline' do
+  it_should_behave_like 'A pipeline'
+
+  before do
+    @pipeline_options.merge!({
+      :transaction_amount => 10,
+      :caller_reference => 'N2PCBEIA5864E27EL7C86PJL1FGUGPBL61QTJJM5GQK265SPEN8ZKIJPMQARDVJK',
+      :recipient_token => 'N5PCME5A5Q6FE2QEB7CD64JLGFTUGXBE61HTCJMGGAK2R5IPEQ8EKIVP3QAVD7JP'
+    })
+
+    @pipeline = remit.get_single_use_pipeline(@pipeline_options)
+  end
+
+  it 'should ignore unused parameters' do
+    uri = URI.parse(@pipeline.url)
+    query = Relax::Query.parse(uri)
+
+    query[:paymentReason].should be_nil
+  end
+
+  it 'should have the right name' do
+    @pipeline.pipeline_name.should == Remit::PipelineName::SINGLE_USE
+  end
+end
+
+describe 'A multi-use pipeline' do
+  it_should_behave_like 'A pipeline'
+
+  before do
+    @pipeline_options.merge!({
+      :transaction_amount => 10,
+      :caller_reference => 'N2PCBEIA5864E27EL7C86PJL1FGUGPBL61QTJJM5GQK265SPEN8ZKIJPMQARDVJK',
+      :recipient_token_list => 'N5PCME5A5Q6FE2QEB7CD64JLGFTUGXBE61HTCJMGGAK2R5IPEQ8EKIVP3QAVD7JP'
+    })
+
+    @pipeline = remit.get_multi_use_pipeline(@pipeline_options)
+  end
+
+  it 'should ignore unused parameters' do
+    uri = URI.parse(@pipeline.url)
+    query = Relax::Query.parse(uri)
+
+    query[:paymentReason].should be_nil
+  end
+
+  it 'should have the right name' do
+    @pipeline.pipeline_name.should == Remit::PipelineName::MULTI_USE
+  end
+end
+
+describe 'A recipient pipeline' do
+  it_should_behave_like 'A pipeline'
+
+  before do
+    @validity_start   = Time.now + (3600 * 24) # 1 day from now
+    @validity_expiry  = Time.now + (2600 * 24 * 180) # ~6 months from now
+
+    @pipeline_options.merge!({
+      :validity_start => @validity_start,
+      :validity_expiry  => @validity_expiry,
+      :caller_reference => 'N2PCBEIA5864E27EL7C86PJL1FGUGPBL61QTJJM5GQK265SPEN8ZKIJPMQARDVJK',
+      :max_variable_fee => '0.25',
+      :recipient_pays_fee => true
+    })
+
+    @pipeline = remit.get_recipient_pipeline(@pipeline_options)
+  end
+
+  it 'should have the recipient pay marketplace fees' do
+    @pipeline.url.should match(/recipientPaysFee=true/)
+  end
+
+  it 'should have the right name' do
+    @pipeline.pipeline_name.should == Remit::PipelineName::RECIPIENT
+  end
+end
+
+describe 'A recurring-use pipeline' do
+  it_should_behave_like 'A pipeline'
+
+  before do
+    @validity_start = Time.now + (3600 * 24)  # 1 day from now
+    @validity_expiry = Time.now + (3600 * 24 * 180) # ~6 months from now
+    @recurring_period = '1 Month'
+
+    @pipeline_options.merge!({
+      :validity_start => @validity_start,
+      :validity_expiry => @validity_expiry,
+      :recurring_period => @recurring_period,
+      :transaction_amount => 10,
+      :caller_reference => 'N2PCBEIA5864E27EL7C86PJL1FGUGPBL61QTJJM5GQK265SPEN8ZKIJPMQARDVJK',
+      :recipient_token => 'N5PCME5A5Q6FE2QEB7CD64JLGFTUGXBE61HTCJMGGAK2R5IPEQ8EKIVP3QAVD7JP'
+    })
+
+    @pipeline = remit.get_recurring_use_pipeline(@pipeline_options)
+  end
+
+  it 'should convert times to seconds from epoch' do
+    uri = URI.parse(@pipeline.url)
+    query = Relax::Query.parse(uri)
+
+    @validity_start.to_i.to_s.should == query[:validityStart]
+    @validity_expiry.to_i.to_s.should == query[:validityExpiry]
+  end
+
+  it 'should allow time in seconds' do
+    options = @pipeline_options.merge({
+      :validity_start => @validity_start.to_i,
+      :validity_expiry => @validity_expiry.to_i
+    })
+    @pipeline = remit.get_recurring_use_pipeline(options)
+
+    uri = URI.parse(@pipeline.url)
+    query = Relax::Query.parse(uri)
+
+    @validity_start.to_i.to_s.should == query[:validityStart]
+    @validity_expiry.to_i.to_s.should == query[:validityExpiry]
+  end
+
+  it 'should have the right name' do
+    @pipeline.pipeline_name.should == Remit::PipelineName::RECURRING
+  end
+end
+
+describe 'A postpaid pipeline' do
+  it_should_behave_like 'A pipeline'
+
+  before do
+    @credit_limit = 100
+    @global_amount_limit = 100
+
+    @pipeline_options.merge!({
+      :credit_limit => @credit_limit,
+      :global_amount_limit => @global_amount_limit
+    })
+
+    @pipeline = remit.get_postpaid_pipeline(@pipeline_options)
+  end
+
+  it 'should create a PostpaidPipeline' do
+    @pipeline.class.should == Remit::GetPipeline::PostpaidPipeline
+  end
+
+  it 'should have the right name' do
+    @pipeline.pipeline_name.should == Remit::PipelineName::SETUP_POSTPAID
+  end
+end