bitfluent-activemerchant 1.5.1.1 → 1.15.1

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

@@ -0,0 +1,258 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    # For more information on the Iridium Gateway please download the
+    # documentation from their Merchant Management System.
+    #
+    # The login and password are not the username and password you use to 
+    # login to the Iridium Merchant Management System. Instead, you will 
+    # use the API username and password you were issued separately.
+    class IridiumGateway < Gateway
+      TEST_URL = 'https://gw1.iridiumcorp.net/'
+      LIVE_URL = 'https://gw1.iridiumcorp.net/'
+      
+      # The countries the gateway supports merchants from as 2 digit ISO country codes
+      self.supported_countries = ['GB', 'ES']
+      self.default_currency = 'EUR'
+      self.money_format = :cents
+      
+      # The card types supported by the payment gateway
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+      
+      # The homepage URL of the gateway
+      self.homepage_url = 'http://www.iridiumcorp.co.uk/'
+      
+      # The name of the gateway
+      self.display_name = 'Iridium'
+      
+      CURRENCY_CODES = { 
+        "AUD" => '036',
+        "CAD" => '124',
+        "EUR" => '978',
+        "GBP" => '826',
+        "MXN" => '484',
+        "NZD" => '554',
+        "USD" => '840',
+      }
+      
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+        super
+      end  
+      
+      def authorize(money, creditcard, options = {})
+        commit(build_purchase_request('PREAUTH', money, creditcard, options), options)
+      end
+      
+      def purchase(money, payment_source, options = {})
+        setup_address_hash(options)
+        
+        if payment_source.respond_to?(:number)
+          commit(build_purchase_request('SALE', money, payment_source, options), options)
+        else
+          commit(build_reference_request('SALE', money, payment_source, options), options)
+        end
+      end                       
+    
+      def capture(money, authorization, options = {})
+        commit(build_reference_request('COLLECTION', money, authorization, options), options)
+      end
+      
+      def credit(money, authorization, options={})
+        deprecated CREDIT_DEPRECATION_MESSAGE
+        refund(money, authorization, options)
+      end
+
+      def refund(money, authorization, options={})
+        commit(build_reference_request('REFUND', money, authorization, options), options)
+      end
+      
+      def void(authorization, options={})
+        commit(build_reference_request('VOID', nil, authorization, options), options)
+      end
+      
+      private                       
+
+      def build_purchase_request(type, money, creditcard, options)
+        options.merge!(:action => 'CardDetailsTransaction')
+        build_request(options) do |xml|
+          add_purchase_data(xml, type, money, options)
+          add_creditcard(xml, creditcard)
+          add_customerdetails(xml, creditcard, options[:billing_address], options)
+        end
+      end
+      
+      def build_reference_request(type, money, authorization, options)
+        options.merge!(:action => 'CrossReferenceTransaction')
+        order_id, cross_reference, auth_id = authorization.split(";")
+        build_request(options) do |xml|
+          if money
+            details = {'CurrencyCode' => currency_code(options[:currency] || default_currency), 'Amount' => amount(money)}
+          else
+            details = {'CurrencyCode' => currency_code(default_currency), 'Amount' => '0'}
+          end
+          xml.tag! 'TransactionDetails', details do
+            xml.tag! 'MessageDetails', {'TransactionType' => type, 'CrossReference' => cross_reference}
+            xml.tag! 'OrderID', (options[:order_id] || order_id)
+          end
+        end
+      end
+      
+      def build_request(options)
+        requires!(options, :action)
+        xml = Builder::XmlMarkup.new :indent => 2
+        xml.instruct!(:xml, :version => '1.0', :encoding => 'utf-8')
+        xml.tag! 'soap:Envelope', { 'xmlns:soap' => 'http://schemas.xmlsoap.org/soap/envelope/', 
+                                    'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance', 
+                                    'xmlns:xsd' => 'http://www.w3.org/2001/XMLSchema'} do
+          xml.tag! 'soap:Body' do
+            xml.tag! options[:action], {'xmlns' => "https://www.thepaymentgateway.net/"} do
+              xml.tag! 'PaymentMessage' do
+                add_merchant_data(xml, options)
+                yield(xml)
+              end
+            end
+          end
+        end
+        xml.target!
+      end
+
+      def setup_address_hash(options)
+        options[:billing_address] = options[:billing_address] || options[:address] || {}
+        options[:shipping_address] = options[:shipping_address] || {}
+      end
+      
+      def add_purchase_data(xml, type, money, options)
+        requires!(options, :order_id)
+        xml.tag! 'TransactionDetails', {'Amount' => amount(money), 'CurrencyCode' => currency_code(options[:currency] || currency(money))} do
+          xml.tag! 'MessageDetails', {'TransactionType' => type}
+          xml.tag! 'OrderID', options[:order_id]
+          xml.tag! 'TransactionControl' do
+            xml.tag! 'ThreeDSecureOverridePolicy', 'FALSE'
+            xml.tag! 'EchoAVSCheckResult', 'TRUE'
+            xml.tag! 'EchoCV2CheckResult', 'TRUE'
+          end
+        end
+      end
+
+      def add_customerdetails(xml, creditcard, address, options, shipTo = false)
+        xml.tag! 'CustomerDetails' do
+          if address
+            unless address[:country].blank?
+              country_code = Country.find(address[:country]).code(:numeric)
+            end
+            xml.tag! 'BillingAddress' do
+              xml.tag! 'Address1', address[:address1]
+              xml.tag! 'Address2', address[:address2]
+              xml.tag! 'City', address[:city]
+              xml.tag! 'State', address[:state]
+              xml.tag! 'PostCode', address[:zip]
+              xml.tag! 'CountryCode', country_code if country_code
+            end
+            xml.tag! 'PhoneNumber', address[:phone]
+          end
+          
+          xml.tag! 'EmailAddress', options[:email]
+          xml.tag! 'CustomerIPAddress', options[:ip] || "127.0.0.1"
+        end   
+      end
+
+      def add_creditcard(xml, creditcard)      
+        xml.tag! 'CardDetails' do
+          xml.tag! 'CardName', creditcard.name
+          xml.tag! 'CV2', creditcard.verification_value if creditcard.verification_value
+          xml.tag! 'CardNumber', creditcard.number
+          xml.tag! 'ExpiryDate', { 'Month' => creditcard.month.to_s.rjust(2, "0"), 'Year' => creditcard.year.to_s[/\d\d$/] }
+        end
+      end
+      
+      def add_merchant_data(xml, options)
+        xml.tag! 'MerchantAuthentication', {"MerchantID" => @options[:login], "Password" => @options[:password]}
+      end
+
+      def commit(request, options)
+        requires!(options, :action)
+        response = parse(ssl_post(test? ? TEST_URL : LIVE_URL, request,
+                              {"SOAPAction" => "https://www.thepaymentgateway.net/#{options[:action]}",
+                               "Content-Type" => "text/xml; charset=utf-8" }))
+  
+        success = response[:transaction_result][:status_code] == "0"
+        message = response[:transaction_result][:message]
+        authorization = success ? [ options[:order_id], response[:transaction_output_data][:cross_reference], response[:transaction_output_data][:auth_code] ].compact.join(";") : nil
+        
+        Response.new(success, message, response, 
+          :test => test?, 
+          :authorization => authorization)
+      end
+
+      def parse(xml)
+        reply = {}
+        xml = REXML::Document.new(xml)
+        if (root = REXML::XPath.first(xml, "//CardDetailsTransactionResponse")) or
+              (root = REXML::XPath.first(xml, "//CrossReferenceTransactionResponse"))
+          root.elements.to_a.each do |node|
+            case node.name  
+            when 'Message'
+              reply[:message] = reply(node.text)
+            else
+              parse_element(reply, node)
+            end
+          end
+        elsif root = REXML::XPath.first(xml, "//soap:Fault") 
+          parse_element(reply, root)
+          reply[:message] = "#{reply[:faultcode]}: #{reply[:faultstring]}"
+        end
+        reply
+      end     
+
+      def parse_element(reply, node)
+        case node.name
+        when "CrossReferenceTransactionResult"
+          reply[:transaction_result] = {}
+          node.attributes.each do |a,b|
+            reply[:transaction_result][a.underscore.to_sym] = b
+          end
+          node.elements.each{|e| parse_element(reply[:transaction_result], e) } if node.has_elements?
+
+        when "CardDetailsTransactionResult"
+          reply[:transaction_result] = {}
+          node.attributes.each do |a,b|
+            reply[:transaction_result][a.underscore.to_sym] = b
+          end
+          node.elements.each{|e| parse_element(reply[:transaction_result], e) } if node.has_elements?
+
+        when "TransactionOutputData"
+          reply[:transaction_output_data] = {}
+          node.attributes.each{|a,b| reply[:transaction_output_data][a.underscore.to_sym] = b }
+          node.elements.each{|e| parse_element(reply[:transaction_output_data], e) } if node.has_elements?
+        when "CustomVariables"
+          reply[:custom_variables] = {}
+          node.attributes.each{|a,b| reply[:custom_variables][a.underscore.to_sym] = b }
+          node.elements.each{|e| parse_element(reply[:custom_variables], e) } if node.has_elements?
+        when "GatewayEntryPoints"
+          reply[:gateway_entry_points] = {}
+          node.attributes.each{|a,b| reply[:gateway_entry_points][a.underscore.to_sym] = b }
+          node.elements.each{|e| parse_element(reply[:gateway_entry_points], e) } if node.has_elements?
+        else
+          k = node.name.underscore.to_sym
+          if node.has_elements?
+            reply[k] = {}
+            node.elements.each{|e| parse_element(reply[k], e) } 
+          else
+            if node.has_attributes?
+              reply[k] = {}
+              node.attributes.each{|a,b| reply[k][a.underscore.to_sym] = b }
+            else
+              reply[k] = node.text
+            end
+          end
+        end
+        reply
+      end
+      
+      def currency_code(currency)
+        CURRENCY_CODES[currency]
+      end
+    end
+  end
+end

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

@@ -58,7 +58,8 @@ module ActiveMerchant #:nodoc:
         "025" =>  "Transaction Not Found.",
         "981" =>  "AVS Error.",
         "913" =>  "Invalid Card Type.",
-        "996" =>  "Terminal ID Not Found."
+        "996" =>  "Terminal ID Not Found.",
+        nil   =>  "No response returned (missing credentials?)."
       }
       
       def initialize(options = {})
@@ -85,17 +86,20 @@ module ActiveMerchant #:nodoc:
       end
 
       def credit(money, transaction_id_or_card, options = {})
-        
         if transaction_id_or_card.is_a?(String)
-          transaction_id = transaction_id_or_card.split(";").first
-          credit_card = options[:credit_card]
+          deprecated CREDIT_DEPRECATION_MESSAGE
+          refund(money, transaction_id_or_card, options)
         else
-          transaction_id = nil
-          credit_card = transaction_id_or_card
+          commit(money, build_credit_request('CREDIT', money, nil, transaction_id_or_card))
         end
+      end
 
+      def refund(money, reference, options = {})
+        transaction_id = reference.split(";").first
+        credit_card = options[:credit_card]
         commit(money, build_credit_request('CREDIT', money, transaction_id, credit_card))
       end
+
       
       private
       
@@ -177,6 +181,8 @@ module ActiveMerchant #:nodoc:
       end
       
       def parse(body)
+        return {} if body.blank?
+
         xml = REXML::Document.new(body)
         
         response = {}

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

@@ -233,13 +233,18 @@ module ActiveMerchant #:nodoc:
       # 
       # identification must be a valid order id previously submitted by SALE
       #
-      def credit(money, identification, options = {})
+      def refund(money, identification, options = {})
         options.update(
           :ordertype => "CREDIT",
           :order_id => identification
         )
         commit(money, nil, options)
       end
+
+      def credit(money, identification, options = {})
+        deprecated CREDIT_DEPRECATION_MESSAGE
+        refund(money, identification, options)
+      end
     
       def test?
         @options[:test] || super

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

@@ -56,20 +56,22 @@ module ActiveMerchant #:nodoc:
 				post[:card_id] = card_id
 				commit('X', nil, post)
 			end
-	
+
+			def refund(money, identification, options = {})
+				commit('U', money, options.merge(:transaction_id => identification))
+			end
+
 			def credit(money, creditcard_or_card_id, options = {})
-				post ={}
+				post = {}
 				add_payment_source(post, creditcard_or_card_id, options)
 				commit('C', money, post)
 			end
 
-			def void(transaction_id)
-				post = {}
-				post[:transaction_id] = transaction_id
-				commit('V', nil, post)
+			def void(transaction_id, options = {})
+				commit('V', nil, options.merge(:transaction_id => transaction_id))
 			end
-    
-			private                       
+
+			private
 
 			def add_address(post, options)
 				if address = options[:billing_address] || options[:address]

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

@@ -98,11 +98,17 @@ module ActiveMerchant #:nodoc:
       #   * <tt>:order_id</tt> - A unique reference for this order (required when performing a non-referenced credit)
       def credit(money, identification, options = {})
         if identification.is_a?(String)          
-          perform_reference_credit(money, identification, options)
+          deprecated CREDIT_DEPRECATION_MESSAGE
+          refund(money, identification, options)
         else
           perform_credit(money, identification, options)
         end
       end
+
+      def refund(money, reference, options = {})
+        perform_reference_credit(money, reference, options)
+      end
+
     
       private
       

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

@@ -14,7 +14,7 @@ module ActiveMerchant #:nodoc:
       LIVE_URL = 'https://www3.moneris.com/gateway2/servlet/MpgRequest'
       
       self.supported_countries = ['CA']
-      self.supported_cardtypes = [:visa, :master, :american_express]
+      self.supported_cardtypes = [:visa, :master, :american_express, :diners_club, :discover]
       self.homepage_url = 'http://www.moneris.com/'
       self.display_name = 'Moneris'
   
@@ -71,9 +71,13 @@ module ActiveMerchant #:nodoc:
       # Moneris interface consistent with other gateways. (See +capture+ for 
       # details.)
       def credit(money, authorization, options = {})
-        commit 'refund', crediting_params(authorization, :amount => amount(money))
+        deprecated CREDIT_DEPRECATION_MESSAGE
+        refund(money, authorization, options)
       end
    
+      def refund(money, authorization, options = {})
+        commit 'refund', crediting_params(authorization, :amount => amount(money))
+      end
     private # :nodoc: all
     
       def expdate(creditcard)

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

@@ -0,0 +1,239 @@
+require 'digest/md5'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class NetaxeptGateway < Gateway
+      TEST_URL = 'https://epayment-test.bbs.no/'
+      LIVE_URL = 'https://epayment.bbs.no/'
+      
+      # The countries the gateway supports merchants from as 2 digit ISO country codes
+      self.supported_countries = ['NO', 'DK', 'SE', 'FI']
+      
+      # The card types supported by the payment gateway
+      self.supported_cardtypes = [:visa, :master, :american_express]
+      
+      # The homepage URL of the gateway
+      self.homepage_url = 'http://www.betalingsterminal.no/Netthandel-forside/'
+      
+      # The name of the gateway
+      self.display_name = 'BBS Netaxept'
+      
+      self.money_format = :cents
+      
+      self.default_currency = 'NOK'
+      
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+        super
+      end  
+      
+      def purchase(money, creditcard, options = {})
+        requires!(options, :order_id)
+
+        post = {}
+        add_credentials(post, options)
+        add_transaction(post, options)
+        add_order(post, money, options)
+        add_creditcard(post, creditcard)
+        commit('Sale', post)
+      end                       
+
+      def authorize(money, creditcard, options = {})
+        requires!(options, :order_id)
+
+        post = {}
+        add_credentials(post, options)
+        add_transaction(post, options)
+        add_order(post, money, options)
+        add_creditcard(post, creditcard)
+        commit('Auth', post)
+      end
+
+      def capture(money, authorization, options = {})
+        post = {}
+        add_credentials(post, options)
+        add_authorization(post, authorization, money)
+        commit('Capture', post, false)
+      end
+
+      def refund(money, authorization, options = {})
+        post = {}
+        add_credentials(post, options)
+        add_authorization(post, authorization, money)
+        commit('Credit', post, false)
+      end
+
+      def credit(money, authorization, options = {})
+        deprecated CREDIT_DEPRECATION_MESSAGE
+        refund(money, authorization, options)
+      end
+
+      def void(authorization, options = {})
+        post = {}
+        add_credentials(post, options)
+        add_authorization(post, authorization)
+        commit('Annul', post, false)
+      end
+
+      def test?
+        @options[:test] || Base.gateway_mode == :test
+      end
+
+    
+      private
+      
+      def add_credentials(post, options)
+        post[:merchantId] = @options[:login]
+        post[:token] = @options[:password]
+      end
+      
+      def add_authorization(post, authorization, money=nil)
+        post[:transactionId] = authorization
+        post[:transactionAmount] = amount(money) if money
+      end
+      
+      def add_transaction(post, options)
+        post[:transactionId] = generate_transaction_id(options)
+        post[:serviceType] = 'M'
+        post[:redirectUrl] = 'http://example.com'
+      end
+      
+      def add_order(post, money, options)
+        post[:orderNumber] = options[:order_id]
+        post[:amount] = amount(money)
+        post[:currencyCode] = (options[:currency] || currency(money))
+      end
+      
+      CARD_TYPE_PREFIXES = {
+        'visa' => 'v',
+        'master' => 'm',
+        'american_express' => 'a',
+      }
+      def add_creditcard(post, creditcard)
+        brand = Gateway.card_brand(creditcard)
+        prefix = CARD_TYPE_PREFIXES[brand]
+        unless prefix
+          raise ArgumentError.new("Card type #{brand} not supported.")
+        end
+
+        post[:creditcard] = {}
+        post[:creditcard][:"#{prefix}a"] = creditcard.number
+        post[:creditcard][:"#{prefix}m"] = format(creditcard.month, :two_digits)
+        post[:creditcard][:"#{prefix}y"] = format(creditcard.year, :two_digits)
+        post[:creditcard][:"#{prefix}c"] = creditcard.verification_value
+      end
+      
+      def commit(action, parameters, setup=true)
+        parameters[:action] = action
+
+        response = {:success => false}
+
+        catch(:exception) do
+          if setup
+            commit_transaction_setup(response, parameters)
+            commit_payment_details(response, parameters)
+            commit_process_setup(response, parameters)
+          end
+          commit_transaction(response, parameters)
+          response[:success] = true
+        end
+        
+        Response.new(response[:success], response[:message], response, :test => test?, :authorization => response[:authorization])
+      end
+      
+      def commit_transaction_setup(response, parameters)
+        response[:setup] = parse(ssl_get(build_url("REST/Setup.aspx", pick(parameters, :merchantId, :token, :serviceType, :amount, :currencyCode, :redirectUrl, :orderNumber, :transactionId))))
+        process(response, :setup)
+      end
+      
+      def commit_payment_details(response, parameters)
+        data = encode(parameters[:creditcard].merge(:BBSePay_transaction => response[:setup]['SetupString']))
+        response[:paymentDetails] = parse(ssl_post(build_url("terminal/default.aspx"), data), false)
+        process(response, :paymentDetails)
+      end
+      
+      def commit_process_setup(response, parameters)
+        result = ssl_get(build_url("REST/ProcessSetup.aspx", pick(parameters, :merchantId, :token, :transactionId).merge(:transactionString => response[:paymentDetails][:result])))
+        response[:processSetup] = parse(result)
+        process(response, :processSetup)
+      end
+      
+      def commit_transaction(response, parameters)
+        result = ssl_get(build_url("REST/#{parameters[:action]}.aspx", pick(parameters, :merchantId, :token, :transactionId, :transactionAmount)))
+        response[:action] = parse(result)
+        process(response, :action)
+      end
+
+      def process(response, step)
+        if response[step][:container] =~ /Exception|Error/
+          response[:message] = response[step]['Message']
+          throw :exception
+        else
+          message = (response[step]['ResponseText'] || response[step]['ResponseCode'])
+          response[:message] = (message || response[:message])
+          
+          response[:authorization] = response[step]['TransactionId']
+        end
+      end
+      
+      def parse(result, expects_xml=true)
+        if expects_xml || /^</ =~ result
+          doc = REXML::Document.new(result)
+          extract_xml(doc.root).merge(:container => doc.root.name)
+        else
+          {:result => result}
+        end
+      end
+      
+      def extract_xml(element)
+        if element.has_elements?
+          hash = {}
+          element.elements.each do |e|
+            hash[e.name] = extract_xml(e)
+          end
+          hash
+        else
+          element.text
+        end
+      end
+      
+      def url
+        (test? ? TEST_URL : LIVE_URL)
+      end
+      
+      def generate_transaction_id(options)
+        Digest::MD5.hexdigest("#{options.inspect}+#{Time.now}+#{rand}")
+      end
+      
+      def pick(hash, *keys)
+        keys.inject({}){|h,key| h[key] = hash[key] if hash[key]; h}
+      end
+      
+      def build_url(base, parameters=nil)
+        url = "#{test? ? TEST_URL : LIVE_URL}"
+        url << base
+        if parameters
+          url << '?'
+          url << encode(parameters)
+        end
+        url
+      end
+      
+      def encode(hash)
+        hash.collect{|(k,v)| "#{CGI.escape(k.to_s)}=#{CGI.escape(v.to_s)}"}.join('&')
+      end
+      
+      class Response < Billing::Response
+        attr_reader :error_detail
+        def initialize(success, message, raw, options)
+          super
+          unless success
+            @error_detail = raw[:processSetup]['Result']['ResponseText'] if raw[:processSetup] && raw[:processSetup]['Result']
+          end
+        end
+      end
+    end
+  end
+end
+