LitleOnline 8.16.0 → 8.17.0

data/CHANGELOG

@@ -1,5 +1,12 @@
 = LitleOnline CHANGELOG
 
+== Version 8.17.0 (June 13, 2013)
+* Feature: Batch support - see https://gist.github.com/litleSDK/5687345, https://gist.github.com/litleSDK/5714803 and https://gist.github.com/litleSDK/5714847
+* Feature: Add support for surcharging credit card transactions
+* Feature: Add support for specifying the terminalId on a pos transaction
+* Feature: Add support for pos transactions on tied refunds
+* Cleanup: Drop support for 1.8.6
+
 == Version 8.16.0 (March 29, 2013)
 
 * Feature: Merged pull request #7 from pierre to add external logging support

data/DESCRIPTION

@@ -1,4 +1,4 @@
-Litle Online Ruby SDK created for version 8.16 of Litle XML online format, see the XSD schema for specific fields that are supported by this format.
+Litle Online Ruby SDK created for version 8.17 of Litle XML format, see the XSD schema for specific fields that are supported by this format.
 
 This gem contains an application interface in the Ruby programming language created by Litle & Co.
 

data/README.md

@@ -66,6 +66,6 @@ puts "Litle Transaction ID: "+ response.saleResponse.litleTxnId
     Message: Valid Format
     Litle Transaction ID: <your-numeric-litle-txn-id>
  
-More examples can be found here [Ruby Gists](https://gist.github.com/gists/search?q=Litle+Ruby+SDK&page=1)
+More examples (including batch processing with sFTP) can be found here [Ruby Gists](https://gist.github.com/litleSDK)
 
-Please contact Lilte & Co. with any further questions.   You can reach us at sdksupport@litle.com.
+Please contact Litle & Co. with any further questions. You can reach us at sdksupport@litle.com.

data/Rakefile

@@ -30,22 +30,25 @@ require 'rake/clean'
 spec = Gem::Specification.new do |s|
   FileUtils.rm_rf('pkg')
   s.name = "LitleOnline"
-  s.summary = "Ruby SDK produced by Litle & Co. for online transaction processing using Litle XML format v8.16"
+  s.summary = "Ruby SDK produced by Litle & Co. for transaction processing using Litle XML format v8.17"
   s.description = File.read(File.join(File.dirname(__FILE__), 'DESCRIPTION'))
   s.requirements =
   [ 'Contact sdksupport@litle.com for more information' ]
-  s.version = "8.16.0"
+  s.version = "8.17.0"
   s.author = "Litle & Co"
   s.email = "sdksupport@litle.com"
   s.homepage = "http://www.litle.com/developers"
   s.platform = Gem::Platform::RUBY
-  s.required_ruby_version = '>=1.8.6'
+  s.required_ruby_version = '>=1.8.7'
   s.files = Dir['**/**']
   s.executables = [ 'sample_driver.rb', 'Setup.rb' ]
   s.test_files = Dir["test/unit/ts_unit.rb"]
   s.has_rdoc = true
   s.add_dependency('xml-object')
   s.add_dependency('xml-mapping')
+  s.add_dependency('net-sftp')
+  s.add_dependency('libxml-ruby')
+  s.add_dependency('crack')
   s.add_development_dependency('mocha')
 end
 

data/bin/Setup.rb

@@ -41,17 +41,31 @@ class Setup
       puts "Please input your password:"
       f.puts	"password: " + gets
       puts "Please input your merchantId:"
+      
       f.puts "currency_merchant_map:"
       f.puts "  DEFAULT: " + gets
       f.puts "default_report_group: 'Default Report Group'"
+      
       puts "Please choose Litle url from the following list (example: 'cert') or directly input another URL: \nsandbox => https://www.testlitle.com/sandbox/communicator/online \ncert => https://cert.litle.com/vap/communicator/online \nprecert => https://precert.litle.com/vap/communicator/online \nproduction1 => https://payments.litle.com/vap/communicator/online \nproduction2 => https://payments2.litle.com/vap/communicator/online"
       f.puts "url: " + Setup.choice(gets)
       puts "Please input the proxy address, if no proxy hit enter key: "
       f.puts	"proxy_addr: " + gets
       puts "Please input the proxy port, if no proxy hit enter key: "
       f.puts	"proxy_port: " + gets
+      puts "Please input your sFTP username for batch processing; if no sFTP, hit enter key: "
+      f.puts "sftp_username: " + gets
+      puts "Please input your sFTP password for batch processing; if no sFTP, hit enter key: "
+      f.puts "sftp_password: " + gets
+      puts "Please input your sFTP url for batch processing; if no sFTP, hit enter key: "
+      f.puts "sftp_url: " + gets
+      puts "Please input your url for fast batch processing; if no fast batch, hit enter key: "
+      f.puts "fast_url: "  + gets
+      puts "Please input your port for fast batch processing; if no fast batch, hit enter key: "
+      f.puts "fast_port: "  + gets
+      
       f.puts "printxml: false"
       f.puts "timeout: 65"
+      
     end
   end
 

data/bin/sample_batch_driver.rb

@@ -0,0 +1,122 @@
+=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/lib/LitleBatchRequest.rb

@@ -0,0 +1,466 @@
+=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
+      }
+      @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 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 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)
+      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 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]
+      
+      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