activemerchant 1.1.0 → 1.2.0

data/lib/active_merchant/billing/gateways/eway.rb

@@ -1,38 +1,32 @@
-# Author::    Lucas Carlson  (mailto:lucas@rufy.com)
-# Copyright:: Copyright (c) 2005 Lucas Carlson
-# License::   Distributes under the same terms as Ruby
-
 require 'rexml/document'
 
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
-    # TO USE:
     # First, make sure you have everything setup correctly and all of your dependencies in place with:
     # 
     #   require 'rubygems'
-    #   require 'money'
     #   require 'active_merchant'
     #
-    # The second line is a require for the 'money' library. Make sure you have it installed with 'gem install money'
-    #
-    # Using the money library, create a money object. Pass the dollar value in cents. In this case, $10 US becomes 1000.
+    # ActiveMerchant expects the amounts to be given as an Integer in cents. In this case, $10 US becomes 1000.
     #
-    #   tendollar = Money.us_dollar(1000)
+    #   tendollar = 1000
     #
     # Next, create a credit card object using a TC approved test card.
     #
-    #   creditcard = ActiveMerchant::Billing::CreditCard.new({
+    #   creditcard = ActiveMerchant::Billing::CreditCard.new(
     #	    :number => '4111111111111111',
     #	    :month => 8,
     #	    :year => 2006,
     #	    :first_name => 'Longbob',
     #     :last_name => 'Longsen'
-    #   })
+    #   )
     #   options = {
-    #     :login => '87654321',
     #     :order_id => '1230123',
     #     :email => 'bob@testbob.com',
-    #     :address => { :address1 => '47 Bobway, Bobville, WA, Australia',
+    #     :address => { :address1 => '47 Bobway',
+    #                   :city => 'Bobville', 
+    #                   :state => 'WA',
+    #                   :country => 'Australia',
     #                   :zip => '2000'
     #                 }
     #     :description => 'purchased items'
@@ -41,7 +35,7 @@ module ActiveMerchant #:nodoc:
     # To finish setting up, create the active_merchant object you will be using, with the eWay gateway. If you have a
     # functional eWay account, replace :login with your account info. 
     #
-    #   gateway = ActiveMerchant::Billing::Base.gateway(:eway).new()
+    #   gateway = ActiveMerchant::Billing::Base.gateway(:eway).new(:login => '87654321')
     #
     # Now we are ready to process our transaction
     #
@@ -73,13 +67,66 @@ module ActiveMerchant #:nodoc:
       LIVE_CVN_URL = 'https://www.eway.com.au/gateway_cvn/xmlpayment.asp'
       
       MESSAGES = {
-        "00" => "Transaction was successfully processed",
-        "A8" => "Amount is invalid",
-        "A9" => "Card number is invalid",
-        "AA" => "Account is invalid",
-        "AB" => "Card expiry date is invalid",
-        "01" => "Card verification number didn't match",
-        "05" => "Card verification number didn't match"
+        "00" => "Transaction Approved",
+        "01" => "Refer to Issuer",
+        "02" => "Refer to Issuer, special",	
+        "03" => "No Merchant",
+        "04" => "Pick Up Card",	
+        "05" => "Do Not Honour",	
+        "06" => "Error",
+        "07" => "Pick Up Card, Special",	
+        "08" => "Honour With Identification",	
+        "09" => "Request In Progress",
+        "10" => "Approved For Partial Amount",	
+        "11" => "Approved, VIP",	
+        "12" => "Invalid Transaction",	
+        "13" => "Invalid Amount",
+        "14" => "Invalid Card Number",	
+        "15" => "No Issuer",	
+        "16" => "Approved, Update Track 3",	
+        "19" => "Re-enter Last Transaction",	
+        "21" => "No Action Taken",	
+        "22" => "Suspected Malfunction",	
+        "23" => "Unacceptable Transaction Fee",	
+        "25" => "Unable to Locate Record On File",	
+        "30" => "Format Error",	
+        "31" => "Bank Not Supported By Switch",	
+        "33" => "Expired Card, Capture",	
+        "34" => "Suspected Fraud, Retain Card",	
+        "35" => "Card Acceptor, Contact Acquirer, Retain Card",	
+        "36" => "Restricted Card, Retain Card",	
+        "37" => "Contact Acquirer Security Department, Retain Card",	
+        "38" => "PIN Tries Exceeded, Capture",	
+        "39" => "No Credit Account",	
+        "40" => "Function Not Supported",	
+        "41" => "Lost Card",	
+        "42" => "No Universal Account",	
+        "43" => "Stolen Card",	
+        "44" => "No Investment Account",	
+        "51" => "Insufficient Funds",	
+        "52" => "No Cheque Account",	
+        "53" => "No Savings Account",	
+        "54" => "Expired Card",	
+        "55" => "Incorrect PIN",	
+        "56" => "No Card Record",	
+        "57" => "Function Not Permitted to Cardholder",	
+        "58" => "Function Not Permitted to Terminal",	
+        "59" => "Suspected Fraud",	
+        "60" => "Acceptor Contact Acquirer",	
+        "61" => "Exceeds Withdrawal Limit",	
+        "62" => "Restricted Card",	
+        "63" => "Security Violation",	
+        "64" => "Original Amount Incorrect",	
+        "66" => "Acceptor Contact Acquirer, Security",	
+        "67" => "Capture Card",	
+        "75" => "PIN Tries Exceeded",	
+        "82" => "CVV Validation Error",	
+        "90" => "Cutoff In Progress",	
+        "91" => "Card Issuer Unavailable",	
+        "92" => "Unable To Route Transaction",	
+        "93" => "Cannot Complete, Violation Of The Law",	
+        "94" => "Duplicate Transaction",	
+        "96" => "System Error"
       }
       
       attr_reader :url 
@@ -87,6 +134,10 @@ module ActiveMerchant #:nodoc:
       attr_reader :options
 	
 	    self.money_format = :cents
+      self.supported_countries = ['AU']
+      self.supported_cardtypes = [:visa, :master]
+      self.homepage_url = 'http://www.eway.com.au/'
+      self.display_name = 'eWAY'
 	    
     	def initialize(options = {})
         requires!(options, :login)
@@ -109,10 +160,6 @@ module ActiveMerchant #:nodoc:
         commit(money, post)
       end
     
-      def self.supported_cardtypes
-        [:visa, :master]
-      end
-    
       private                       
       def add_creditcard(post, creditcard)
         post[:CardNumber]  = creditcard.number
@@ -127,7 +174,7 @@ module ActiveMerchant #:nodoc:
 
       def add_address(post, options)
         if address = options[:billing_address] || options[:address]
-          post[:CustomerAddress]    = address[:address1]
+          post[:CustomerAddress]    = [ address[:address1], address[:address2], address[:city], address[:state], address[:country] ].compact.join(', ')
           post[:CustomerPostcode]   = address[:zip]
         end
       end
@@ -162,9 +209,11 @@ module ActiveMerchant #:nodoc:
 
         success = (response[:ewaytrxnstatus] == "True")
         message = message_from(response[:ewaytrxnerror])
+        test = /\(Test( CVN)? Gateway\)/ === response[:ewaytrxnerror]
     
         Response.new(success, message, @response,
-          :authorization => response[:ewayauthcode]
+          :authorization => response[:ewayauthcode],
+          :test => test
         )      
       end
                                              
@@ -184,7 +233,6 @@ module ActiveMerchant #:nodoc:
         #  </ewayResponse>     
 
         response = {}
-
         xml = REXML::Document.new(xml)          
         xml.elements.each('//ewayResponse/*') do |node|
 

data/lib/active_merchant/billing/gateways/exact.rb

@@ -0,0 +1,230 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class ExactGateway < Gateway
+      URL = 'https://secure2.e-xact.com/vplug-in/transaction/rpc-enc/service.asmx'
+      
+      API_VERSION = "8.5"
+      
+      TEST_LOGINS = [ {:login => "A00049-01", :password => "test1"},
+                      {:login => "A00427-01", :password => "testus"} ]
+      
+      TRANSACTIONS = { :sale          => "00",
+                       :authorization => "01",
+                       :capture       => "32",
+                       :credit        => "34" }
+      
+
+      ENVELOPE_NAMESPACES = { 'xmlns:xsd' => 'http://www.w3.org/2001/XMLSchema',
+                              'xmlns:env' => 'http://schemas.xmlsoap.org/soap/envelope/',
+                              'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance'
+                            }
+                            
+      SEND_AND_COMMIT_ATTRIBUTES = { 'xmlns:n1' => "http://secure2.e-xact.com/vplug-in/transaction/rpc-enc/Request",
+                                     'env:encodingStyle' => 'http://schemas.xmlsoap.org/soap/encoding/'
+                                   }
+                                   
+      SEND_AND_COMMIT_SOURCE_ATTRIBUTES = { 'xmlns:n2' => 'http://secure2.e-xact.com/vplug-in/transaction/rpc-enc/encodedTypes',
+                                            'xsi:type' => 'n2:Transaction'
+                                          }
+      
+      POST_HEADERS = { 'soapAction' => "http://secure2.e-xact.com/vplug-in/transaction/rpc-enc/SendAndCommit",
+                       'Content-Type' => 'text/xml' 
+                     }
+                     
+      SUCCESS = "true"
+      
+      SENSITIVE_FIELDS = [ :verification_str2, :expiry_date, :card_number ]
+      
+      self.supported_cardtypes = [:visa, :master, :american_express, :jcb, :discover]
+      self.supported_countries = ['CA', 'US']
+      self.homepage_url = 'http://www.e-xact.com'
+      self.display_name = 'E-xact'
+      
+      attr_reader :url
+      attr_reader :response
+      attr_reader :options
+
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+        
+        if TEST_LOGINS.include?( { :login => options[:login], :password => options[:password] } )
+          @test_mode = true
+        end
+      
+        super
+      end
+      
+      def test?
+        @test_mode || Base.gateway_mode == :test
+      end
+      
+      def authorize(money, credit_card, options = {})
+        if result = test_result_from_cc_number(credit_card.number)
+          return result
+        end
+        
+        commit(:authorization, build_sale_or_authorization_request(money, credit_card, options))
+      end
+      
+      def purchase(money, credit_card, options = {})
+        if result = test_result_from_cc_number(credit_card.number)
+          return result
+        end
+        
+        commit(:sale, build_sale_or_authorization_request(money, credit_card, options))
+      end
+    
+      def capture(money, authorization, options = {})
+        commit(:capture, build_capture_or_credit_request(money, authorization, options))
+      end
+
+      def credit(money, authorization, options = {})
+        commit(:credit, build_capture_or_credit_request(money, authorization, options))
+      end
+         
+      private                       
+      def build_request(action, body)
+        xml = Builder::XmlMarkup.new
+        
+        xml.instruct!
+        xml.tag! 'env:Envelope', ENVELOPE_NAMESPACES do
+          xml.tag! 'env:Body' do
+            xml.tag! 'n1:SendAndCommit', SEND_AND_COMMIT_ATTRIBUTES do
+              xml.tag! 'SendAndCommitSource', SEND_AND_COMMIT_SOURCE_ATTRIBUTES do
+                add_credentials(xml)
+                add_transaction_type(xml, action)
+                xml << body
+              end
+            end
+          end
+        end
+        xml.target!
+      end
+                
+      def build_sale_or_authorization_request(money, credit_card, options)
+        xml = Builder::XmlMarkup.new
+ 
+        add_amount(xml, money)
+        add_credit_card(xml, credit_card)
+        add_customer_data(xml, options)
+        add_invoice(xml, options)
+        
+        xml.target!        
+      end
+      
+      def build_capture_or_credit_request(money, identification, options)
+        xml = Builder::XmlMarkup.new
+  
+        add_identification(xml, identification)
+        add_amount(xml, money)
+        add_customer_data(xml, options)
+    
+        xml.target!
+      end
+      
+      def add_credentials(xml)
+        xml.tag! 'ExactID', @options[:login]
+        xml.tag! 'Password', @options[:password]
+      end
+      
+      def add_transaction_type(xml, action)
+        xml.tag! 'Transaction_Type', TRANSACTIONS[action]
+      end
+      
+      def add_identification(xml, identification)
+        authorization_num, transaction_tag = identification.split(';')
+ 
+        xml.tag! 'Authorization_Num', authorization_num
+        xml.tag! 'Transaction_Tag', transaction_tag
+      end
+      
+      def add_amount(xml, money)
+        xml.tag! 'DollarAmount', amount(money)
+      end
+      
+      def add_credit_card(xml, credit_card)
+        xml.tag! 'Card_Number', credit_card.number
+        xml.tag! 'Expiry_Date', expdate(credit_card)
+        xml.tag! 'CardHoldersName', credit_card.name
+        
+        if credit_card.verification_value?
+          xml.tag! 'CVD_Presence_Ind', '1'
+          xml.tag! 'VerificationStr2', credit_card.verification_value
+        end
+      end
+      
+      def add_customer_data(xml, options)
+        xml.tag! 'Customer_Ref', options[:customer]
+        xml.tag! 'Client_IP', options[:ip]
+        xml.tag! 'Client_Email', options[:email]
+      end
+
+      def add_address(xml, options)
+        if address = options[:billing_address] || options[:address]
+          xml.tag! 'ZipCode', address[:zip]       
+        end    
+      end
+
+      def add_invoice(xml, options)
+        xml.tag! 'Reference_No', options[:order_id]
+        xml.tag! 'Reference_3',  options[:description]
+      end
+      
+      def expdate(credit_card)
+        "#{format(credit_card.month, :two_digits)}#{format(credit_card.year, :two_digits)}"
+      end
+      
+      def commit(action, request)
+         data = ssl_post(URL, build_request(action, request), POST_HEADERS)
+      
+         @response = parse(data)
+      
+         success = @response[:transaction_approved] == SUCCESS
+         
+         authorization = if @response[:authorization_num] && @response[:transaction_tag]
+           "#{response[:authorization_num]};#{response[:transaction_tag]}"        
+         else
+           ''
+         end
+         
+         Response.new(success, message_from(@response), @response,
+           :test => test?,
+           :authorization => authorization
+         )
+      end
+      
+      def message_from(response)
+        if response[:faultcode] && response[:faultstring]
+          response[:faultstring]
+        elsif response[:error_number] != '0'
+          response[:error_description]
+        else
+          result = response[:exact_message] || ''
+          result << " - #{response[:bank_message]}" unless response[:bank_message].blank?
+          result
+        end
+      end
+      
+      def parse(xml)
+        response = {}
+        xml = REXML::Document.new(xml)
+        
+        if root = REXML::XPath.first(xml, "//types:TransactionResult")
+          parse_elements(response, root)
+        elsif root = REXML::XPath.first(xml, "//soap:Fault")
+          parse_elements(response, root)
+        end
+
+        response.delete_if{ |k,v| SENSITIVE_FIELDS.include?(k) }
+      end
+
+      def parse_elements(response, root)
+        root.elements.to_a.each do |node|
+          response[node.name.gsub(/EXact/, 'Exact').underscore.to_sym] = (node.text || '').strip
+        end
+      end
+    end
+  end
+end
+

data/lib/active_merchant/billing/gateways/linkpoint.rb

@@ -1,27 +1,3 @@
-# Portions of the LinkPoint Gateway by Ryan Heneise
-#--
-# Copyright (c) 2005 Tobias Luetke
-#
-# 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.
-#++
-
 require 'rexml/document'
 
 module ActiveMerchant #:nodoc:
@@ -130,11 +106,12 @@ module ActiveMerchant #:nodoc:
       
       # We don't have the certificate to verify LinkPoint
       self.ssl_strict = false
+      
+      self.supported_countries = ['US']
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+      self.homepage_url = 'http://www.linkpoint.com/'
+      self.display_name = 'LinkPoint'
            
-      # @options = {
-      #  :store_number => options[:login],
-      #  :result => test? ? "GOOD" : "LIVE"
-      # }.update(options)
       def initialize(options = {})
         requires!(options, :login)
         
@@ -237,11 +214,7 @@ module ActiveMerchant #:nodoc:
         )
         commit(money, nil, options)
       end
-      
-      def self.supported_cardtypes
-        [:visa, :master, :discover, :american_express]
-      end
-      
+    
       def test?
         @options[:test] || Base.gateway_mode == :test
       end