geti 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,20 @@
+source :rubygems
+
+gem 'savon'
+gem 'httpi'
+gem 'httpclient'
+
+group :development do
+  gem 'rake', "< 0.9"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.8.4"
+  gem "rcov"
+end
+
+group :test do
+  gem 'rspec'
+  gem 'fuubar'
+  gem 'guard'
+  gem 'guard-rspec'
+  gem 'rb-fsevent', '~> 0.9.1'
+end

data/Gemfile.lock

@@ -0,0 +1,78 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    akami (1.2.0)
+      gyoku (>= 0.4.0)
+      nokogiri (>= 1.4.0)
+    builder (3.0.0)
+    diff-lcs (1.1.3)
+    fuubar (1.1.0)
+      rspec (~> 2.0)
+      rspec-instafail (~> 0.2.0)
+      ruby-progressbar (~> 1.0.0)
+    git (1.2.5)
+    guard (1.4.0)
+      listen (>= 0.4.2)
+      thor (>= 0.14.6)
+    guard-rspec (2.0.0)
+      guard (>= 1.1)
+      rspec (~> 2.11)
+    gyoku (0.4.6)
+      builder (>= 2.1.2)
+    httpclient (2.2.7)
+    httpi (1.1.1)
+      rack
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.4)
+    listen (0.5.3)
+    nokogiri (1.5.5)
+    nori (1.1.3)
+    rack (1.4.1)
+    rake (0.8.7)
+    rb-fsevent (0.9.2)
+    rcov (1.0.0)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.3)
+      diff-lcs (~> 1.1.3)
+    rspec-instafail (0.2.4)
+    rspec-mocks (2.11.3)
+    ruby-progressbar (1.0.1)
+    savon (1.1.0)
+      akami (~> 1.2.0)
+      builder (>= 2.1.2)
+      gyoku (~> 0.4.5)
+      httpi (~> 1.1.0)
+      nokogiri (>= 1.4.0)
+      nori (~> 1.1.0)
+      wasabi (~> 2.5.0)
+    thor (0.16.0)
+    wasabi (2.5.0)
+      httpi (~> 1.0)
+      nokogiri (>= 1.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  fuubar
+  guard
+  guard-rspec
+  httpclient
+  httpi
+  jeweler (~> 1.8.4)
+  rake (< 0.9)
+  rb-fsevent (~> 0.9.1)
+  rcov
+  rspec
+  savon

data/Guardfile

@@ -0,0 +1,4 @@
+guard 'rspec', :all_after_pass => false, :all_on_start => false do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1].gsub('/','_')}_spec.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 VersaPay Corp
+
+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.

data/README.rdoc

@@ -0,0 +1,22 @@
+= geti
+
+Description goes here.
+
+== Running Specs
+
+Just run `rspec`. If you want to run the specs in the remote dir, you'll need to provide `config/test_credentials.yml` (an example file is present).
+
+== Contributing to geti
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2012 VersaPay Corp. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "geti"
+  gem.homepage = "http://github.com/jamie/geti"
+  gem.license = "MIT"
+  gem.summary = %Q{API wrapper for GETI, an ACH provider}
+  gem.description = %Q{API wrapper for GETI, an ACH provider}
+  gem.email = "jamie@tracefunc.com"
+  gem.authors = ["Jamie Macey"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "geti #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/config/test_credentials.yml.example

@@ -0,0 +1,2 @@
+user: SomeUser
+pass: password

data/doc/implementation_notes.md

@@ -0,0 +1,29 @@
+Notes received from Brooklynne Rukse <brukse@globaletelecom.com> (our
+technical contact) while planning for realtime integration.
+
+> > 14 Aug, "RE: GETI Authorization Gateway Integration & Documentation"
+> 
+> The SEC code is not determined by the type of services you offer, it is determined by how you receive payment.  Please let me know which of the following applies to your business.
+> 
+> ·         PPD - Authorization is made in person and Merchant initiates transaction at a later time.  A check is not present. 
+> ·         CCD - Authorization is made between two companies to transfer funds. 
+> ·         POP - Payment is made in person at the point of sale.
+> ·         TEL - Payment is made by phone or fax.  A check is not present. 
+> ·         WEB - Payment is made through the internet.  A check is not present. 
+>  
+> The DL Requirement, Check Verification and Identity Verification are turned on or off for each merchant based on their risk.  This is decided during merchant underwriting and is not determined by the gateway.  For this reason you want to test against all terminal ids related to the transaction types you are processing. 
+
+We're all online, so we'll be doing WEB. But, we should be handling all
+verification cases as that determination is not in Geti's hands.
+
+> > > 17 Aug, "RE: Certification Credentials for VersaPay"
+> > 
+> > The api gives real time responses (Approved/Declined) immediately however the transactions are not processed until the next business day.  Any file transactions that is submitted before Noon CST are processed the same day. 
+> 
+> [Jamie] Oh. So a transaction submitted Monday 8am via FTP goes through same day, but one submitted at the same time over SOAP isn't processed until Tuesday?
+> 
+> > That is correct
+
+So doing batch file uploads will process (before noon) a day sooner or
+(after noon) at the same time. We don't have any expectations regarding
+realtime approval currently, so giving up on the realtime aspect makes sense.

data/doc/readme.txt

@@ -0,0 +1,28 @@
+# This is incomplete software
+
+Done:
+
+- SOAP requests are all hooked up (authentication, xml format, etc)
+- Can make debug/info and authorize calls
+- Handles success/failure and exception responses
+
+
+To Do:
+
+- Parse response to decode bitfields
+- Make response wrapper useful to users of this library
+- Limit Exceeded/Manager Needed overrides
+- Confirm decline behaviour
+- Re-presented checks
+- Voids
+- Certification
+- Bundle into a gem
+
+
+
+
+### Application Processing
+
+New Merchant Application XSD is https://demo.eftchecks.com/webservices/Schemas/App/NewMerchApp_ACH.xsd
+
+Sample data is https://demo.eftchecks.com/webservices/Schemas/App/Example/NewMerchAppSample_ACH.xml

data/lib/geti.rb

@@ -0,0 +1,7 @@
+module Geti; end
+
+require 'geti/client'
+require 'geti/auth_client'
+require 'geti/app_client'
+require 'geti/response'
+require 'geti/terminal_settings'

data/lib/geti/app_client.rb

@@ -0,0 +1,277 @@
+class Geti::AppClient < Geti::Client
+  MERCHANT_OWNERSHIP = {
+    "1" => "Corporation",
+    "2" => "Partnership",
+    "3" => "Sole Proprietorship"
+  }
+  MERCHANT_SERVICE_TYPES = {
+    "GOLD" => "Service_Level_Used_For_Guaranteed_ACHed_Transaction_Processing",
+    "SILVER" => "Service_Level_Used_For_Non-Guaranteed_ACHed_Transaction_Processing",
+    "BRONZE" => "Service_Level_Used_For_Non-Guaranteed_Verification-Only_Processing",
+    "TRADITIONAL" => "Service_Level_Used_For_Guaranteed_Verification-Only_Processing",
+  }
+  MERCHANT_TYPES = {
+    "1" => "Antique_Shops",
+    "2" => "Applicances_Electrical_Repair",
+    "3" => "Art_Dealers_Art_Galleries",
+    "4" => "Artists_Supplies",
+    "5" => "Auto_Dealers_New_All_Depts",
+    "6" => "Auto_And_Home_Supplies",
+    "7" => "Auto_Parking_Lots_Garages",
+    "8" => "Auto_Parts_Stores",
+    "9" => "Auto_Rentals_And_Leasing",
+    "10" => "Auto_Paint_Top_Body",
+    "11" => "Auto_Repair",
+    "12" => "Auto_Sales_Used_Only",
+    "13" => "Automotive_Glass",
+    "14" => "Automotive_Tire_Stores",
+    "16" => "Bakeries",
+    "17" => "Barber_Beauty_Shops",
+    "18" => "Bicycle_Sales_Service",
+    "19" => "Billiards_Tables_And_Supplies",
+    "20" => "Boats_Dealers_All",
+    "21" => "Boats_Dealers_Parts_Service",
+    "22" => "Book_Stores",
+    "23" => "Bridal_Shops_And_Accessories",
+    "24" => "Building_Materials",
+    "25" => "Camera_And_Photo_Supplies",
+    "26" => "Car_Stero_Cellular_Phones_And_Pagers",
+    "27" => "Car_Washes",
+    "28" => "Card_Gift_Shops",
+    "29" => "Cigar_Stores",
+    "30" => "Clothing",
+    "31" => "Computers_And_Software_Retail_Only",
+    "32" => "Contractors",
+    "33" => "Convenience_Stores",
+    "34" => "Cosmetic_Beauty_Supplies",
+    "35" => "Department_Stores",
+    "36" => "Drug_Stores_And_Pharmacies",
+    "37" => "Dry_Cleaners",
+    "38" => "Electrical_Contractors",
+    "39" => "Eyeglass_Stores",
+    "40" => "Fabric_Stores",
+    "41" => "Floor_Covering",
+    "42" => "Florists",
+    "43" => "Funeral_Homes_Crematories",
+    "44" => "Furniture_Stores",
+    "45" => "Garden_Lawn_Supply",
+    "46" => "Gas_Stations",
+    "47" => "Glass_Stores",
+    "48" => "Golf_Course_Pro_Shop",
+    "49" => "Grocery_Supermarket",
+    "50" => "Hardware_Stores",
+    "51" => "Health_Food_Stores",
+    "52" => "Heating_Air",
+    "53" => "Heavy_Equipment_Truck_Repair",
+    "54" => "Heavy_Equipment_Rentals",
+    "55" => "Heavy_Equipment_Sales",
+    "56" => "Hospitals_Clinics",
+    "57" => "Hotels_Motels",
+    "58" => "Housewares",
+    "59" => "Jewelry_Sales",
+    "60" => "Liquor_Stores",
+    "61" => "Locksmiths",
+    "62" => "Maintenance_Cleaning_Service",
+    "63" => "Motorcycle_Dealers_All",
+    "64" => "Motorhome_Dealers",
+    "65" => "Moving_Storage_Delivery",
+    "66" => "Muffler_Shops",
+    "67" => "Music_Stores_Instruments",
+    "68" => "Office_Supply",
+    "69" => "Oil_Change_Shop",
+    "70" => "Optometrists",
+    "71" => "Pet_Shops",
+    "72" => "Physicians",
+    "73" => "Pizza_Parlors",
+    "74" => "Postal_Shipping_Services",
+    "75" => "Print_Shops",
+    "76" => "Record_Shops",
+    "77" => "Rental_Trucks_And_Trailers",
+    "78" => "Restaurants",
+    "79" => "Salvage_And_Wrecking",
+    "80" => "Secondhand_Stores",
+    "81" => "Sporting_Goods_Stores",
+    "82" => "Stereo_Sales_Radio_Sales",
+    "83" => "Swimming_Pool_Sales",
+    "84" => "Tack_Shop_Equestrian_Supplies",
+    "85" => "Towing_Services",
+    "87" => "Transmission_Repair",
+    "88" => "Vacuum_Cleaner_Sales",
+    "89" => "Veterinary_Clinics_Hospitals",
+    "90" => "Video_Stores",
+    "91" => "Childcare_Daycare_Preschool",
+    "92" => "Meat_And_Seafood",
+    "93" => "Dental",
+    "94" => "Plumbing_Contractors",
+    "95" => "Employment_Agency",
+    "96" => "Sign_Shops",
+    "97" => "Carpentry",
+    "98" => "Physical_Therapy",
+    "99" => "Motorcycle_Repair",
+    "100" => "Nail_Products_Manicures",
+    "101" => "Meetings_Events_Banquets_Parties",
+    "102" => "Accounting_Firms",
+    "103" => "Uniforms",
+    "104" => "Bar_Lounge",
+    "105" => "Tanning_Salons",
+    "106" => "Hospital_Equipment_Supplies",
+    "107" => "Metal_Fabricators",
+    "108" => "Transportation_Services",
+    "109" => "Fitness_Spa_Gym",
+    "110" => "Pawn_Shop",
+    "111" => "Bowling_Alley",
+    "112" => "Legal_Services",
+    "113" => "Religious_Organizations",
+    "115" => "School",
+    "116" => "Pet_Grooming",
+    "117" => "Electronics_Electronic_Repair",
+    "118" => "Travel_Agency",
+    "119" => "Tatto_Body_Piercing_Parlor",
+    "120" => "Insurance_Agency",
+    "121" => "Recreational",
+    "122" => "Real_Estate",
+    "123" => "Trailer_Sales",
+    "124" => "Exterminators",
+    "125" => "Party_Supply_Store",
+    "126" => "Entertainment",
+    "127" => "Bail_Bonds",
+    "128" => "Hobbie_Shop",
+    "129" => "Craft_Shop",
+    "130" => "Photo_Studio",
+    "131" => "Marina",
+    "132" => "Security_And_Alarms",
+    "133" => "Auto_Detailing",
+    "134" => "Furniture_Rental",
+    "135" => "General_Merchandise",
+    "136" => "Leather_Goods_Lugguage",
+    "137" => "Waste_Removal",
+    "138" => "Tool_Rentals",
+    "139" => "Other",
+    "140" => "Casino_Gambling"
+  }
+
+  def board_merchant_ach(application)
+    response = soap_request("BoardCertificationMerchant_ACH", "board_certification_merchant_ach") do |xml|
+      data_packet(xml, application)
+    end
+    annotate_board_merchant_ach_response(response[:response])
+  end
+
+  def data_packet(xml, opts)
+    xml.Envelope do
+      xml.Body :FileName => "261407_28_May_2009_12_05_00_590.xml", :FileDate => Time.now.iso8601 do
+        xml.NewMerchant({
+          :isoID              => "9999",
+          :merchCrossRefID    => opts[:id],
+          :merchName          => opts[:name], # Legal Name
+          :merchTypeID        => MERCHANT_TYPES.index(opts[:industry]), # "Type of goods sold"
+          :merchServiceType   => "GOLD",
+          # TODO: Tax ID
+          :merchAddress1      => opts[:address], # TODO: Is this mailing or DBA address?
+          :merchCity          => opts[:city],
+          :merchState         => opts[:state],
+          :merchZip           => opts[:zip],
+          :merchPhone         => opts[:phone],
+          # TODO: Fax number
+          :merchAchFlatFee    => "",
+          :merchNonAchFlatFee => "",
+          :merchPercentFee    => "",
+          :merchComments      => taxpayer_info(opts),
+          :merchReturnFee     => "",
+          # TODO: Web Address
+          # TODO: Email address
+        }) do
+          xml.BusinessInfo({
+            :merchOwnership => MERCHANT_OWNERSHIP.index(opts[:business_type]),
+            :merchAvgCheckAmount => opts[:average_amount],
+            :merchMaxCheckAmount => opts[:max_amount],
+            :merchTotalTimeInBusiness => opts[:days_in_business],
+          })
+          xml.NewLocation({
+            :locName           => opts[:name], # DBA name?
+            :locCrossRefID     => opts[:id],
+            :locAddress1       => opts[:physical_address], # TODO: Is this mailing or DBA address?
+            :locCity           => opts[:physical_city],
+            :locState          => opts[:physical_state],
+            :locZip            => opts[:physical_zip],
+            :locPhone          => opts[:physical_phone],
+            :locStatementFee   => "0",
+            :locMinimumFee     => "0",
+            :locFeesRoutingNum => opts[:routing_number],
+            :locFeesAccountNum => opts[:account_number],
+            # TODO: Days in operation at this location?
+          }) do
+            xml.Statement({
+              :locStatementAttn     => opts[:contact_name], # TODO: Where does title/alternate go?
+              :locStatementAddress1 => opts[:physical_address], # TODO: Is this mailing or DBA address?
+              :locStatementCity     => opts[:physical_city],
+              :locStatementState    => opts[:physical_state],
+              :locStatementZip      => opts[:physical_zip],
+            })
+            xml.NewPOC({
+              :pocFirstName => opts[:principal_first_name],
+              :pocLastName  => opts[:principal_last_name],
+              :pocTitle     => opts[:principal_title],
+              # TODO: % Ownership
+              :pocAddress   => opts[:principal_address], # TODO: Is this mailing or DBA address?
+              :pocCity      => opts[:principal_city],
+              :pocState     => opts[:principal_state],
+              :pocZip       => opts[:principal_zip],
+              :pocDOB       => opts[:principal_dob], # Y-M-D
+              :pocSSN       => opts[:principal_ssn], # 9-digits?
+              # TODO: Driver's License
+
+              :pocPrimary => "1",
+              :pocComments => "",
+            })
+            xml.NewTerminal({
+              :termCrossRefID       => opts[:id],
+              :termCheckLimit       => "500.00",
+              :termPeripheral       => "63",
+              :termTypeID           => "16",
+              :termVerificationOnly => "0",
+            })
+            # More NewTerminal entries
+          end
+        end
+      end
+    end
+  end
+
+  def service_address
+    "https://demo.eftchecks.com/webservices/AppGateway.asmx?WSDL"
+  end
+
+  def soap_header
+    { "RemoteAccessHeader" => {
+        "UserName" => @user,
+        "Password" => @pass
+      },
+      :attributes! => { "RemoteAccessHeader" => {"xmlns"=>"http://tempuri.org/GETI.eMagnus.WebServices/AppGateway"}}
+    }
+  end
+
+  def taxpayer_info(opts)
+    "Tax Info: %s - %d" % [opts[:taxpayer_name], opts[:taxpayer_id]]
+  end
+
+private
+  def annotate_board_merchant_ach_response(response)
+    response[:success] = response[:validation_message][:result] == "Passed"
+    response.delete(:"@xmlns:xsd")
+    response.delete(:"@xmlns:xsi")
+    remove_key_at_signs!(response)
+    response
+  end
+
+  def remove_key_at_signs!(hash)
+    hash.keys.each do |key|
+      if hash[key].kind_of? Hash
+        remove_key_at_signs!(hash[key])
+      end
+      if key.to_s[0..0] == '@'
+        hash[key.to_s.sub('@','').to_sym] = hash.delete(key)
+      end
+    end
+  end
+end