VantivCnp 8.31.0

data/bin/sample_batch_driver.rb

@@ -0,0 +1,123 @@
+#!/usr/bin/env ruby
+=begin
+Copyright (c) 2011 Litle & Co.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+=end
+
+#Sample Driver
+require_relative '../lib/LitleOnline'
+
+saleHash = {
+        'reportGroup'=>'Planets',
+        'id' => '006',
+        'orderId'=>'12344',
+        'amount'=>'6000',
+        'orderSource'=>'ecommerce',
+        'card'=>{
+        'type'=>'VI',
+        'number' =>'4100000000000001',
+        'expDate' =>'1210'
+      }}     
+      
+accountUpdateHash = {
+        'reportGroup'=>'Planets',
+        'id'=>'12345',
+        'customerId'=>'0987',
+        'orderId'=>'1234',
+        'card'=>{
+        'type'=>'VI',
+        'number' =>'4100000000000001',
+        'expDate' =>'1210'
+      }}
+      
+rfrHash = {
+        'merchantId'=>101,
+        'postDay'=>'2013-06-04'  
+}
+      
+path = Dir.pwd
+
+request = LitleOnline::LitleRequest.new({'sessionId'=>'8675309'})
+  
+request.create_new_litle_request(path)
+puts "Created new LitleRequest at location: " + path
+start = Time::now
+#create five batches, each with 10 sales
+#5.times{
+  batch = LitleOnline::LitleBatchRequest.new
+  batch.create_new_batch(path)
+
+  #add the same sale ten times
+  #10.times{
+    batch.sale(saleHash)
+  #}
+  batch.account_update(accountUpdateHash)
+
+  #close the batch, indicating we plan to add no more transactions
+  batch.close_batch()
+  #add the batch to the LitleRequest
+  request.commit_batch(batch)
+#}
+
+request.add_rfr_request(rfrHash)
+
+
+ 
+# puts "Finished adding batches to LitleRequest at " + request.get_path_to_batches
+#finish the Litle Request, indicating we plan to add no more batches
+request.finish_request
+puts "Generated final XML markup of the LitleRequest"
+ 
+#send the batch files at the given directory over sFTP
+request.send_to_litle
+puts "Dropped off the XML of the LitleRequest over FTP"
+#grab the expected number of responses from the sFTP server and save them to the given path
+request.get_responses_from_server()
+puts "Received the LitleRequest responses from the server"
+#process the responses from the server with a listener which applies the given block
+start = Time::now
+request.process_responses({:transaction_listener => LitleOnline::DefaultLitleListener.new do |transaction|
+  type = transaction["type"]
+  #if we're dealing with a saleResponse (check the Litle XML Reference Guide!)
+  if(type == "saleResponse") then
+    #grab an attribute of the parent of the response
+    puts "Report Group: " + transaction["reportGroup"]
+    
+    #grab some child elements of the transaction
+    puts "Litle Txn Id: " + transaction["litleTxnId"]
+    puts "Order Id: " + transaction["orderId"]
+    puts "Response: " + transaction["response"]
+    
+    #grab a child element of a child element of the transation
+    puts "AVS Result: " + transaction["fraudResult"]["avsResult"]
+    puts "Token Response Message: " + transaction["tokenResponse"]["tokenMessage"] 
+  end
+  
+  if(type == "RFRResponse") then
+    puts "RFR Response Code: " + transaction["response"]
+    puts "RFR Response Message: " + transaction["message"]  
+  end 
+end})
+stop = Time::now
+puts "Total time: " + (stop - start).to_s
+

data/bin/sample_driver.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+=begin
+Copyright (c) 2011 Litle & Co.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+=end
+
+#Sample Driver
+#require 'LitleOnline'
+#include LitleOnline
+require_relative '../lib/LitleOnline'
+hash = {
+  'reportGroup'=>'product1',
+  'orderId'=>'12344',
+  'card'=>{
+    'type'=>'VI',
+    'number' =>'4100000000000001',
+    'expDate' =>'1210'
+    },
+  'orderSource'=>'ecommerce',
+  'amount'=>'106'
+}
+
+#perform credit transaction
+response= LitleOnline::LitleOnlineRequest.new.credit(hash)
+
+#display results
+puts "Message: "+response.message
+puts "Litle Transaction ID: "+response.creditResponse.litleTxnId

data/lib/Communications.rb

@@ -0,0 +1,85 @@
+=begin
+Copyright (c) 2011 Litle & Co.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+=end
+
+#
+# Used for all transmission to Litle over HTTP or HTTPS
+# works with or without an HTTP proxy
+#
+# URL and proxy server settings are derived from the configuration file
+#
+module LitleOnline
+  class Communications
+    ##For http or https post with or without a proxy
+    def Communications.http_post(post_data,config_hash)
+  
+      proxy_addr = config_hash['proxy_addr']
+      proxy_port = config_hash['proxy_port']
+      litle_url = config_hash['url']
+  
+      # setup https or http post
+      url = URI.parse(litle_url)
+  
+      response_xml = nil    
+      https = Net::HTTP.new(url.host, url.port, proxy_addr, proxy_port)
+      if(url.scheme == 'https') 
+        https.use_ssl = url.scheme=='https'
+        https.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        https.ca_file = File.join(File.dirname(__FILE__), "cacert.pem")
+      end
+      https.start { |http|
+        response = http.request_post(url.path, post_data.to_s, {'Content-Type'=>'text/xml','Connection'=>'close'})
+        response_xml = response
+      }
+  
+      # validate response, only an HTTP 200 will work, redirects are not followed
+      case response_xml
+      when Net::HTTPOK
+        return response_xml.body
+      else
+        raise("Error with http http_post_request, code:" + response_xml.header.code)
+      end
+    end
+  end
+end
+
+=begin
+ NOTES ON HTTP TIMEOUT
+
+  Litle & Co. optimizes our systems to ensure the return of responses as quickly as possible, some portions of the process are beyond our control.
+  The round-trip time of an Authorization can be broken down into three parts, as follows:
+    1.  Transmission time (across the internet) to Litle & Co. and back to the merchant
+    2.  Processing time by the authorization provider
+    3.  Processing time by Litle 
+  Under normal operating circumstances, the transmission time to and from Litle does not exceed 0.6 seconds 
+  and processing overhead by Litle occurs in 0.1 seconds. 
+  Typically, the processing time by the card association or authorization provider can take between 0.5 and 3 seconds,
+  but some percentage of transactions may take significantly longer.
+ 
+  Because the total processing time can vary due to a number of factors, Litle & Co. recommends using a minimum timeout setting of
+  60 seconds to accomodate Sale transactions and 30 seconds if you are not utilizing Sale tranactions.
+
+  These settings should ensure that you do not frequently disconnect prior to receiving a valid authorization causing dropped orders 
+  and/or re-auths and duplicate auths.
+=end

data/lib/Configuration.rb

@@ -0,0 +1,67 @@
+=begin
+Copyright (c) 2011 Litle & Co.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+=end
+
+require 'yaml'
+#
+# Loads the configuration from a file
+#
+module LitleOnline
+  class Configuration
+    class << self
+      # External logger, if specified
+      attr_accessor :logger
+    end
+
+    def config
+      begin
+        if !(ENV['LITLE_CONFIG_DIR'].nil?)
+          config_file = ENV['LITLE_CONFIG_DIR'] + "/.litle_SDK_config.yml"
+        else
+          config_file = ENV['HOME'] + "/.litle_SDK_config.yml"        
+        end
+        #if Env variable exist, then just override the data from config file
+         if (File.exists?(config_file))
+          datas=YAML.load_file(config_file)  
+         else         
+          environments = EnvironmentVariables.new   
+          datas={}
+          environments.instance_variables.each {|var| datas[var.to_s.delete("@")] = environments.instance_variable_get(var) }          
+         end
+          datas.each {|key,value| setENV(key,datas)}                      
+        return datas
+      rescue   
+        return {}
+      end
+  
+    end
+    def setENV(key,datas)
+      if !(ENV['litle_'+key].nil?)
+       datas[key]=ENV['litle_'+key]
+      end
+    end
+    
+  end
+
+end

data/lib/EnvironmentVariables.rb

@@ -0,0 +1,22 @@
+module LitleOnline
+  class EnvironmentVariables
+    def initialize
+      #load configuration data
+      @user = ''
+      @password = ''
+      @currency_merchant_map = ''
+      @default_report_group = 'Default Report Group'
+      @url = ''
+      @proxy_addr = ''
+      @proxy_port = ''
+      @sftp_username = ''
+      @sftp_password = ''
+      @sftp_url = ''
+      @fast_url = ''
+      @fast_port = ''
+      @printxml = false
+      @timeout = 65
+    end
+
+  end
+end

data/lib/LitleBatchRequest.rb

@@ -0,0 +1,562 @@
+=begin
+Copyright (c) 2011 Litle & Co.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+=end
+require_relative 'Configuration'
+
+#
+# This class creates a new batch to which Litle XML transactions are added.
+# The batch is stored in the local file system until it is ready to be sent
+# to Litle.
+#
+module LitleOnline
+  
+  class LitleBatchRequest
+    include XML::Mapping
+    def initialize
+      #load configuration data
+      @config_hash = Configuration.new.config
+      
+      @txn_counts = { :id=>nil,
+                      :merchantId=>nil,
+                      :auth=>{ :numAuths=>0, :authAmount=>0 },
+                      :sale=>{ :numSales=>0, :saleAmount=>0 },
+                      :credit=>{ :numCredits=>0, :creditAmount=>0 },
+                      :numTokenRegistrations=>0,
+                      :captureGivenAuth=>{ :numCaptureGivenAuths=>0, :captureGivenAuthAmount=>0 },
+                      :forceCapture=>{ :numForceCaptures=>0, :forceCaptureAmount=>0 },
+                      :authReversal=>{ :numAuthReversals=>0, :authReversalAmount=>0 },
+                      :capture=>{ :numCaptures=>0, :captureAmount=>0 },
+                      :echeckVerification=>{ :numEcheckVerification=>0, :echeckVerificationAmount=>0 },
+                      :echeckCredit=>{ :numEcheckCredit=>0, :echeckCreditAmount=>0 },
+                      :numEcheckRedeposit=>0,
+                      :echeckSale=>{ :numEcheckSales=>0, :echeckSalesAmount=>0 },
+                      :numUpdateCardValidationNumOnTokens=>0,
+                      :numAccountUpdates=>0,
+                      :total=>0,
+                      :numCancelSubscriptions=>0,
+                      :numUpdateSubscriptions=>0,
+                      :numCreatePlans=>0,
+                      :numUpdatePlans=>0,
+                      :activate=>{:numActivates=>0, :activateAmount=>0},
+                      :numDeactivates=>0,
+                      :load=>{:numLoads=>0, :loadAmount=>0},
+                      :unload=>{:numUnloads=>0, :unloadAmount=>0},
+                      :numBalanceInquirys=>0,
+                      :merchantSdk=>nil
+      }
+      @litle_txn = LitleTransaction.new
+      @path_to_batch = nil
+      @txn_file = nil
+      @MAX_TXNS_IN_BATCH = 100000
+      @au_batch = nil
+    end
+    
+    def create_new_batch(path)
+      ts = Time::now.to_i.to_s
+      begin
+        ts += Time::now.nsec.to_s
+      rescue NoMethodError # ruby 1.8.7 fix
+        ts += Time::now.usec.to_s
+      end 
+      if(File.file?(path)) then
+        raise ArgumentError, "Entered a file not a path."
+      end
+     
+      if(path[-1,1] != '/' && path[-1,1] != '\\') then
+        path = path + File::SEPARATOR
+      end
+      if(!File.directory?(path)) then
+        Dir.mkdir(path)
+      end 
+        
+      @path_to_batch = path + 'batch_' + ts      
+      @txn_file = @path_to_batch + '_txns'
+      if(File.file?(@path_to_batch)) then
+        create_new_batch(path)
+        return
+      end
+      File.open(@path_to_batch, 'a+') do |file|
+        file.write("")
+      end
+      File.open(@txn_file, 'a+') do |file|
+        file.write("")
+      end
+    end
+    
+    def has_transactions?
+      !@txn_counts[:total].eql?(0)
+    end
+    
+    def open_existing_batch(pathToBatchFile)
+      if(!File.file?(pathToBatchFile)) then
+        raise ArgumentError, "No batch file exists at the passed location!"
+      end 
+      
+      if((pathToBatchFile =~ /batch_\d+.closed-\d+\z/) != nil) then
+        raise ArgumentError, "The passed batch file is closed!"  
+      end   
+      
+      @txn_file = pathToBatchFile + '_txns'
+      @path_to_batch = pathToBatchFile
+      temp_counts = File.open(@path_to_batch, "rb") { |f| Marshal.load(f) }
+      # woops, they opened an AU batch
+      if(temp_counts[:numAccountUpdates] != 0) then
+        au_batch = LitleAUBatch.new
+        au_batch.open_existing_batch(pathToBatchFile)
+        initialize()
+        create_new_batch(File.dirname(pathToBatchFile))
+        @au_batch = au_batch
+      elsif
+        @txn_counts = temp_counts  
+      end 
+    end
+    
+    
+    def au_batch?
+      !@au_batch.nil?
+    end
+   
+    def close_batch(txn_location = @txn_file)
+      header = build_batch_header(@txn_counts)
+      File.rename(@path_to_batch, @path_to_batch + '.closed-' + @txn_counts[:total].to_s)
+      @path_to_batch = @path_to_batch + '.closed-' + @txn_counts[:total].to_s
+      File.open(@path_to_batch, 'w') do |fo|
+       # fo.puts header
+       put_header = !au_batch? || has_transactions? 
+       fo.puts header if put_header
+        File.foreach(txn_location) do |li|
+          fo.puts li
+        end
+       # fo.puts('</batchRequest>')  
+      fo.puts('</batchRequest>')   if put_header
+      end
+      File.delete(txn_location)
+      if(@au_batch != nil) then
+        @au_batch.close_batch
+      end 
+     
+    end
+    
+    def authorization(options)
+      transaction = @litle_txn.authorization(options)
+      @txn_counts[:auth][:numAuths] += 1
+      @txn_counts[:auth][:authAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :authorization, options)
+    end
+    
+    def sale(options)
+      transaction = @litle_txn.sale(options)
+      @txn_counts[:sale][:numSales] += 1
+      @txn_counts[:sale][:saleAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :sale, options)
+    end
+
+    def credit(options)
+      transaction = @litle_txn.credit(options)
+      @txn_counts[:credit][:numCredits] += 1
+      @txn_counts[:credit][:creditAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :credit, options)
+    end
+    
+    def auth_reversal(options)
+      transaction = @litle_txn.auth_reversal(options)
+      @txn_counts[:authReversal][:numAuthReversals] += 1     
+      @txn_counts[:authReversal][:authReversalAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :authReversal, options)
+    end
+
+    def cancel_subscription(options)
+      transaction = @litle_txn.cancel_subscription(options)
+      @txn_counts[:numCancelSubscriptions] += 1
+      
+      add_txn_to_batch(transaction, :cancelSubscription, options)
+    end
+
+    def update_subscription(options)
+      transaction = @litle_txn.update_subscription(options)
+      @txn_counts[:numUpdateSubscriptions] += 1
+      
+      add_txn_to_batch(transaction, :updateSubscription, options)
+    end
+
+    def create_plan(options)
+      transaction = @litle_txn.create_plan(options)  
+      @txn_counts[:numCreatePlans] += 1
+      
+      add_txn_to_batch(transaction, :createPlan, options)
+    end
+    
+    def update_plan(options)
+      transaction = @litle_txn.update_plan(options)  
+      @txn_counts[:numUpdatePlans] += 1
+      
+      add_txn_to_batch(transaction, :updatePlan, options)
+    end
+
+    def activate(options)
+      transaction = @litle_txn.activate(options)  
+      @txn_counts[:numActivates] += 1
+      
+      add_txn_to_batch(transaction, :activate, options)
+    end
+
+    def deactivate(options)
+      transaction = @litle_txn.deactivate(options)  
+      @txn_counts[:numDeactivates] += 1
+      
+      add_txn_to_batch(transaction, :deactivate, options)
+    end
+
+    def load_request(options)
+      transaction = @litle_txn.load_request(options)  
+      @txn_counts[:numLoads] += 1
+      
+      add_txn_to_batch(transaction, :load, options)
+    end
+
+    def unload_request(options)
+      transaction = @litle_txn.unload_request(options)  
+      @txn_counts[:numunLoads] += 1
+      
+      add_txn_to_batch(transaction, :unload, options)
+    end
+
+    def balance_inquiry(options)
+      transaction = @litle_txn.balance_inquiry(options)  
+      @txn_counts[:numBalanceInquirys] += 1
+      
+      add_txn_to_batch(transaction, :balanceInquirys, options)
+    end
+    def register_token_request(options)
+      transaction = @litle_txn.register_token_request(options)
+      @txn_counts[:numTokenRegistrations] += 1
+      
+      add_txn_to_batch(transaction, :numTokenRegistrations, options)
+    end
+    
+    def update_card_validation_num_on_token(options)
+      transaction = @litle_txn.update_card_validation_num_on_token(options)
+      @txn_counts[:numUpdateCardValidationNumOnTokens] += 1
+      
+      add_txn_to_batch(transaction, :numUpdateCardValidationNumOnTokens, options)
+    end
+    
+    def force_capture(options)
+      transaction = @litle_txn.force_capture(options)
+      @txn_counts[:forceCapture][:numForceCaptures] += 1
+      @txn_counts[:forceCapture][:forceCaptureAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :forceCapture, options)
+    end
+    
+    def capture(options)
+      transaction = @litle_txn.capture(options)
+      @txn_counts[:capture][:numCaptures] += 1
+      @txn_counts[:capture][:captureAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :capture, options)
+    end
+    
+    def capture_given_auth(options)
+      transaction = @litle_txn.capture_given_auth(options)
+      @txn_counts[:captureGivenAuth][:numCaptureGivenAuths] += 1
+      @txn_counts[:captureGivenAuth][:captureGivenAuthAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :captureGivenAuth, options)
+    end
+    
+    def echeck_verification(options)
+      transaction = @litle_txn.echeck_verification(options)
+      @txn_counts[:echeckVerification][:numEcheckVerification] += 1
+      @txn_counts[:echeckVerification][:echeckVerificationAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :echeckVerification, options)
+    end
+    
+    def echeck_credit(options)
+      transaction = @litle_txn.echeck_credit(options)
+      @txn_counts[:echeckCredit][:numEcheckCredit] += 1
+      @txn_counts[:echeckCredit][:echeckCreditAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :echeckCredit, options)
+    end
+    
+    def echeck_redeposit(options)
+      transaction = @litle_txn.echeck_redeposit(options)
+      @txn_counts[:numEcheckRedeposit] += 1
+      
+      add_txn_to_batch(transaction, :echeckRedeposit, options)
+    end
+    
+    def echeck_sale(options)
+      transaction = @litle_txn.echeck_sale(options)
+      @txn_counts[:echeckSale][:numEcheckSales] += 1
+      @txn_counts[:echeckSale][:echeckSalesAmount] += options['amount'].to_i
+      
+      add_txn_to_batch(transaction, :echeckSale, options)
+    end
+    
+    def account_update(options)
+       
+      if(@au_batch == nil) then
+        @au_batch = LitleAUBatch.new
+        @au_batch.create_new_batch(File.dirname(@path_to_batch))
+      end 
+      @au_batch.account_update(options)
+    end
+    
+    def get_counts_and_amounts
+      return @txn_counts
+    end
+    def get_batch_name
+      return @path_to_batch
+    end
+    def get_au_batch
+      return @au_batch
+    end
+    
+    
+    private
+    
+    def add_txn_to_batch(transaction, type, options)
+      @txn_counts[:total] += 1
+      xml = transaction.save_to_xml.to_s
+      File.open(@txn_file, 'a+') do |file|
+        file.write(xml)
+      end
+      # save counts and amounts to batch file
+      File.open(@path_to_batch, 'wb'){|f| Marshal.dump(@txn_counts, f)}
+      if(@txn_counts[:total] >= @MAX_TXNS_IN_BATCH) then
+        close_batch()
+        path = File.dirname(@path_to_batch)
+        initialize
+        create_new_batch(path)
+      end
+    end
+    
+    def build_batch_header(options)
+      request = BatchRequest.new
+      
+      request.numAuths                 = @txn_counts[:auth][:numAuths]
+      request.authAmount               = @txn_counts[:auth][:authAmount]
+      request.numSales                 = @txn_counts[:sale][:numSales]
+      request.saleAmount               = @txn_counts[:sale][:saleAmount]
+      request.numCredits               = @txn_counts[:credit][:numCredits]
+      request.creditAmount             = @txn_counts[:credit][:creditAmount]
+      request.numTokenRegistrations    = @txn_counts[:numTokenRegistrations]
+      request.numCaptureGivenAuths     = @txn_counts[:captureGivenAuth][:numCaptureGivenAuths]
+      request.captureGivenAuthAmount   = @txn_counts[:captureGivenAuth][:captureGivenAuthAmount]
+      request.numForceCaptures         = @txn_counts[:forceCapture][:numForceCaptures]
+      request.forceCaptureAmount       = @txn_counts[:forceCapture][:forceCaptureAmount]
+      request.numAuthReversals         = @txn_counts[:authReversal][:numAuthReversals]
+      request.authReversalAmount       = @txn_counts[:authReversal][:authReversalAmount]
+      request.numCaptures              = @txn_counts[:capture][:numCaptures]
+      request.captureAmount            = @txn_counts[:capture][:captureAmount]
+      request.numEcheckSales           = @txn_counts[:echeckSale][:numEcheckSales]
+      request.echeckSalesAmount        = @txn_counts[:echeckSale][:echeckSalesAmount]
+      request.numEcheckRedeposit       = @txn_counts[:numEcheckRedeposit]
+      request.numEcheckCredit          = @txn_counts[:echeckCredit][:numEcheckCredit]
+      request.echeckCreditAmount       = @txn_counts[:echeckCredit][:echeckCreditAmount]
+      request.numEcheckVerification    = @txn_counts[:echeckVerification][:numEcheckVerification]
+      request.echeckVerificationAmount = @txn_counts[:echeckVerification][:echeckVerificationAmount]
+      request.numAccountUpdates        = @txn_counts[:numAccountUpdates]
+      request.merchantId               = get_merchant_id(options)
+      request.id                       = @txn_counts[:id]
+      request.numUpdateCardValidationNumOnTokens = @txn_counts[:numUpdateCardValidationNumOnTokens]
+      request.numCancelSubscriptions =@txn_counts[:numCancelSubscriptions]
+      request.numUpdateSubscriptions =@txn_counts[:numUpdateSubscriptions]
+      request.numCreatePlans =@txn_counts[:numCreatePlans]
+      request.numUpdatePlans =@txn_counts[:numUpdatePlans]
+      request.numActivates =@txn_counts[:activate][:numActivates]
+      request.numDeactivates =@txn_counts[:numDeactivates]
+      request.activateAmount =@txn_counts[:activate][:activateAmount]
+      request.numLoads =@txn_counts[:load][:numLoads]
+      request.loadAmount =@txn_counts[:load][:loadAmount]
+      request.numUnloads =@txn_counts[:unload][:numLoads]
+      request.unloadAmount =@txn_counts[:unload][:unloadAmount]
+      request.numBalanceInquirys =@txn_counts[:numBalanceInquirys]
+      header = request.save_to_xml.to_s
+      header['/>']= '>' 
+
+      return header
+    end
+    
+    def get_config(field, options)
+      options[field.to_s] == nil ? @config_hash[field.to_s] : options[field.to_s]
+    end
+    
+    def get_merchant_id(options)
+      options['merchantId'] || @config_hash['currency_merchant_map']['DEFAULT']
+    end
+  end
+  
+  private
+  
+  # IF YOU ARE A MERCHANT, DON'T LOOK HERE. IT'S SCARY!
+  
+  class LitleAUBatch
+    include XML::Mapping
+    def initialize
+      #load configuration data
+      @config_hash = Configuration.new.config
+      
+      @txn_counts = { :id=>nil,
+                      :merchantId=>nil,
+                      :numAccountUpdates=>0,
+                      :total=>0
+      }
+      @litle_txn = LitleTransaction.new
+      @path_to_batch = nil
+      @txn_file = nil
+      @MAX_TXNS_IN_BATCH = 100000
+    end
+    
+    def create_new_batch(path)
+      ts = Time::now.to_i.to_s
+      begin
+        ts += Time::now.nsec.to_s
+      rescue NoMethodError # ruby 1.8.7 fix
+        ts += Time::now.usec.to_s
+      end 
+      
+      if(File.file?(path)) then
+        raise ArgumentError, "Entered a file not a path."
+      end
+     
+      if(path[-1,1] != '/' && path[-1,1] != '\\') then
+        path = path + File::SEPARATOR
+      end
+      if(!File.directory?(path)) then
+        Dir.mkdir(path)
+      end 
+        
+      @path_to_batch = path + 'batch_' + ts      
+      @txn_file = @path_to_batch + '_txns'
+      if(File.file?(@path_to_batch)) then
+        create_new_batch(path)
+        return
+      end
+      File.open(@path_to_batch, 'a+') do |file|
+        file.write("")
+      end
+      File.open(@txn_file, 'a+') do |file|
+        file.write("")
+      end
+    end
+    
+    def open_existing_batch(pathToBatchFile)
+      if(!File.file?(pathToBatchFile)) then
+        raise ArgumentError, "No batch file exists at the passed location!"
+      end 
+      
+      if((pathToBatchFile =~ /batch_\d+.closed-\d+\z/) != nil) then
+        raise ArgumentError, "The passed batch file is closed!"  
+      end   
+      
+      @txn_file = pathToBatchFile + '_txns'
+      @path_to_batch = pathToBatchFile
+      temp_counts = File.open(@path_to_batch, "rb") { |f| Marshal.load(f) }
+      if(temp_counts.keys.size > 4) then
+        raise RuntimeException, "Tried to open an AU batch with a non-AU batch file"
+      end 
+      
+      @txn_counts[:id] = temp_counts[:id]
+      @txn_counts[:merchantId] = temp_counts[:merchantId]
+      @txn_counts[:numAccountUpdates] = temp_counts[:numAccountUpdates]
+      @txn_counts[:total] = temp_counts[:total]
+    end
+    
+    def close_batch(txn_location = @txn_file)
+      header = build_batch_header(@txn_counts)
+      
+      File.rename(@path_to_batch, @path_to_batch + '.closed-' + @txn_counts[:total].to_s)
+      @path_to_batch = @path_to_batch + '.closed-' + @txn_counts[:total].to_s
+      File.open(@path_to_batch, 'w') do |fo|
+        fo.puts header
+        File.foreach(txn_location) do |li|
+          fo.puts li
+        end
+        fo.puts('</batchRequest>')
+      end
+      File.delete(txn_location)
+    end
+    
+    def account_update(options)
+      transaction = @litle_txn.account_update(options)
+      @txn_counts[:numAccountUpdates] += 1
+      
+      add_txn_to_batch(transaction, :authorization, options)
+    end
+    
+    def get_counts_and_amounts
+      return @txn_counts
+    end
+    def get_batch_name
+      return @path_to_batch
+    end
+    
+    private
+    
+    def add_txn_to_batch(transaction, type, options)
+      @txn_counts[:total] += 1
+      xml = transaction.save_to_xml.to_s
+      File.open(@txn_file, 'a+') do |file|
+        file.write(xml)
+      end
+      # save counts and amounts to batch file
+      File.open(@path_to_batch, 'wb'){|f| Marshal.dump(@txn_counts, f)}
+      if(@txn_counts[:total] >= @MAX_TXNS_IN_BATCH) then
+        close_batch()
+        path = File.dirname(@path_to_batch)
+        initialize
+        create_new_batch(path)
+      end
+    end
+    
+    def build_batch_header(options)
+      request = BatchRequest.new
+      
+      request.numAccountUpdates        = @txn_counts[:numAccountUpdates]
+      request.merchantId               = get_merchant_id(options)
+      request.id                       = @txn_counts[:id]
+      
+      header = request.save_to_xml.to_s
+      header['/>']= '>' 
+
+      return header
+    end
+    
+    def get_config(field, options)
+      options[field.to_s] == nil ? @config_hash[field.to_s] : options[field.to_s]
+    end
+    
+    def get_merchant_id(options)
+      options['merchantId'] || @config_hash['currency_merchant_map']['DEFAULT']
+    end
+  end
+end