activemerchant 1.29.1 → 1.34.0

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

@@ -1,7 +1,10 @@
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
     class MerchantWareGateway < Gateway
+      class_attribute :v4_live_url
+
       self.live_url = self.test_url = 'https://ps1.merchantware.net/MerchantWARE/ws/RetailTransaction/TXRetail.asmx'
+      self.v4_live_url = 'https://ps1.merchantware.net/Merchantware/ws/RetailTransaction/v4/Credit.asmx'
 
       self.supported_countries = ['US']
       self.supported_cardtypes = [:visa, :master, :american_express, :discover]
@@ -12,13 +15,19 @@ module ActiveMerchant #:nodoc:
                          "xmlns:xsd"  => "http://www.w3.org/2001/XMLSchema",
                          "xmlns:env" => "http://schemas.xmlsoap.org/soap/envelope/"
                        }
+      ENV_NAMESPACES_V4 = { "xmlns:xsi"  => "http://www.w3.org/2001/XMLSchema-instance",
+                            "xmlns:xsd"  => "http://www.w3.org/2001/XMLSchema",
+                            "xmlns:soap" => "http://schemas.xmlsoap.org/soap/envelope/"
+                          }
+
       TX_NAMESPACE = "http://merchantwarehouse.com/MerchantWARE/Client/TransactionRetail"
+      TX_NAMESPACE_V4 = "http://schemas.merchantwarehouse.com/merchantware/40/Credit/"
 
       ACTIONS = {
         :purchase  => "IssueKeyedSale",
         :authorize => "IssueKeyedPreAuth",
         :capture   => "IssuePostAuth",
-        :void      => "IssueVoid",
+        :void      => "VoidPreAuthorization",
         :credit    => "IssueKeyedRefund",
         :reference_credit => "IssueRefundByReference"
       }
@@ -80,11 +89,10 @@ module ActiveMerchant #:nodoc:
       # * <tt>authorization</tt> - The authorization string returned from the initial authorization or purchase.
       def void(authorization, options = {})
         reference, options[:order_id] = split_reference(authorization)
-
-        request = soap_request(:void) do |xml|
-          add_reference(xml, reference)
+        request = v4_soap_request(:void) do |xml|
+          add_reference_token(xml, reference)
         end
-        commit(:void, request)
+        commit(:void, request, true)
       end
 
       # Refund an amount back a cardholder
@@ -108,7 +116,6 @@ module ActiveMerchant #:nodoc:
         perform_reference_credit(money, reference, options)
       end
 
-
       private
 
       def soap_request(action)
@@ -125,6 +132,22 @@ module ActiveMerchant #:nodoc:
         xml.target!
       end
 
+      def v4_soap_request(action)
+        xml = Builder::XmlMarkup.new :indent => 2
+        xml.instruct!
+        xml.tag! "soap:Envelope", ENV_NAMESPACES_V4 do
+          xml.tag! "soap:Body" do
+            xml.tag! ACTIONS[:void], "xmlns" => TX_NAMESPACE_V4 do
+              xml.tag! "merchantName", @options[:name]
+              xml.tag! "merchantSiteId", @options[:login]
+              xml.tag! "merchantKey", @options[:password]
+              yield xml
+            end
+          end
+        end
+        xml.target!
+      end
+
       def build_purchase_request(action, money, credit_card, options)
         requires!(options, :order_id)
 
@@ -195,6 +218,10 @@ module ActiveMerchant #:nodoc:
         xml.tag! "strReferenceCode", reference
       end
 
+      def add_reference_token(xml, reference)
+        xml.tag! "token", reference
+      end
+
       def add_address(xml, options)
         if address = options[:billing_address] || options[:address]
           xml.tag! "strAVSStreetAddress", address[:address1]
@@ -258,11 +285,19 @@ module ActiveMerchant #:nodoc:
         response
       end
 
-      def commit(action, request)
+      def soap_action(action, v4 = false)
+        v4 ? "#{TX_NAMESPACE_V4}#{ACTIONS[action]}" : "#{TX_NAMESPACE}/#{ACTIONS[action]}"
+      end
+
+      def url(v4 = false)
+        v4 ? v4_live_url : live_url
+      end
+
+      def commit(action, request, v4 = false)
         begin
-          data = ssl_post(self.live_url, request,
+          data = ssl_post(url(v4), request,
                    "Content-Type" => 'text/xml; charset=utf-8',
-                   "SOAPAction"   => "http://merchantwarehouse.com/MerchantWARE/Client/TransactionRetail/#{ACTIONS[action]}"
+                   "SOAPAction"   => soap_action(action, v4)
                  )
           response = parse(action, data)
         rescue ActiveMerchant::ResponseError => e

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

@@ -0,0 +1,190 @@
+require 'digest/md5'
+require 'rexml/document'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class MerchantWarriorGateway < Gateway
+      TOKEN_TEST_URL = 'https://base.merchantwarrior.com/token/'
+      TOKEN_LIVE_URL = 'https://api.merchantwarrior.com/token/'
+
+      POST_TEST_URL = 'https://base.merchantwarrior.com/post/'
+      POST_LIVE_URL = 'https://api.merchantwarrior.com/post/'
+
+      self.supported_countries = ['AU']
+      self.supported_cardtypes = [:visa, :master, :american_express,
+                                  :diners_club, :discover]
+      self.homepage_url = 'http://www.merchantwarrior.com/'
+      self.display_name = 'MerchantWarrior'
+
+      self.money_format = :dollars
+      self.default_currency = 'AUD'
+
+      def initialize(options = {})
+        requires!(options, :merchant_uuid, :api_key, :api_passphrase)
+        super
+      end
+
+      def authorize(money, payment_method, options = {})
+        post = {}
+        add_amount(post, money, options)
+        add_product(post, options)
+        add_address(post, options)
+        add_payment_method(post, payment_method)
+        commit('processAuth', post)
+      end
+
+      def purchase(money, payment_method, options = {})
+        post = {}
+        add_amount(post, money, options)
+        add_product(post, options)
+        add_address(post, options)
+        add_payment_method(post, payment_method)
+        commit('processCard', post)
+      end
+
+      def capture(money, identification)
+        post = {}
+        add_amount(post, money, options)
+        add_transaction(post, identification)
+        post.merge!('captureAmount' => money.to_s)
+        commit('processCapture', post)
+      end
+
+      def refund(money, identification)
+        post = {}
+        add_amount(post, money, options)
+        add_transaction(post, identification)
+        post['refundAmount'] = money
+        commit('refundCard', post)
+      end
+
+      def store(creditcard, options = {})
+        post = {
+          'cardName' => creditcard.name,
+          'cardNumber' => creditcard.number,
+          'cardExpiryMonth' => format(creditcard.month, :two_digits),
+          'cardExpiryYear'  => format(creditcard.year, :two_digits)
+        }
+        commit('addCard', post)
+      end
+
+      private
+
+      def add_transaction(post, identification)
+        post['transactionID'] = identification
+      end
+
+      def add_address(post, options)
+        return unless(address = options[:address])
+
+        post['customerName'] = address[:name]
+        post['customerCountry'] = address[:country]
+        post['customerState'] = address[:state]
+        post['customerCity'] = address[:city]
+        post['customerAddress'] = address[:address1]
+        post['customerPostCode'] = address[:zip]
+      end
+
+      def add_product(post, options)
+        post['transactionProduct'] = options[:transaction_product]
+      end
+
+      def add_payment_method(post, payment_method)
+        if payment_method.respond_to?(:number)
+          add_creditcard(post, payment_method)
+        else
+          add_token(post, payment_method)
+        end
+      end
+
+      def add_token(post, token)
+        post['cardID'] = token
+      end
+
+      def add_creditcard(post, creditcard)
+        post['paymentCardNumber'] = creditcard.number
+        post['paymentCardName'] = creditcard.name
+        post['paymentCardExpiry'] = creditcard.expiry_date.expiration.strftime("%m%y")
+      end
+
+      def add_amount(post, money, options)
+        currency = (options[:currency] || currency(money))
+
+        post['transactionAmount'] = money.to_s
+        post['transactionCurrency'] = currency
+        post['hash'] = verification_hash(money, currency)
+      end
+
+      def verification_hash(money, currency)
+        Digest::MD5.hexdigest(
+          (
+            @options[:api_passphrase].to_s +
+            @options[:merchant_uuid].to_s +
+            money.to_s +
+            currency
+          ).downcase
+        )
+      end
+
+      def parse(body)
+        xml = REXML::Document.new(body)
+
+        response = {}
+        xml.root.elements.to_a.each do |node|
+          parse_element(response, node)
+        end
+        response
+      end
+
+      def parse_element(response, node)
+        if node.has_elements?
+          node.elements.each{|element| parse_element(response, element)}
+        else
+          response[node.name.underscore.to_sym] = node.text
+        end
+      end
+
+      def commit(action, post)
+        add_auth(action, post)
+
+        response = parse(ssl_post(url_for(action, post), post_data(post)))
+
+        Response.new(
+          success?(response),
+          response[:response_message],
+          response,
+          :test => test?,
+          :authorization => (response[:card_id] || response[:transaction_id])
+        )
+      end
+
+      def add_auth(action, post)
+        post['merchantUUID'] = @options[:merchant_uuid]
+        post['apiKey'] = @options[:api_key]
+        unless token?(post)
+          post['method'] = action
+        end
+      end
+
+      def url_for(action, post)
+        if token?(post)
+          [(test? ? TOKEN_TEST_URL : TOKEN_LIVE_URL), action].join("/")
+        else
+          (test? ? POST_TEST_URL : POST_LIVE_URL)
+        end
+      end
+
+      def token?(post)
+        (post["cardID"] || post["cardName"])
+      end
+
+      def success?(response)
+        (response[:response_code] == '0')
+      end
+
+      def post_data(post)
+        post.collect{|k,v| "#{k}=#{CGI.escape(v.to_s)}" }.join("&")
+      end
+    end
+  end
+end

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

@@ -22,7 +22,7 @@ module ActiveMerchant #:nodoc:
       # password is your API Token
       def initialize(options = {})
         requires!(options, :login, :password)
-        @options = { :crypt_type => 7 }.update(options)
+        options = { :crypt_type => 7 }.merge(options)
         super
       end
 
@@ -70,15 +70,13 @@ module ActiveMerchant #:nodoc:
         commit 'completion', crediting_params(authorization, :comp_amount => amount(money))
       end
 
-      # Voiding requires the original transaction ID and order ID of some open
-      # transaction. Closed transactions must be refunded. Note that the only
-      # methods which may be voided are +capture+ and +purchase+.
+      # Voiding cancels an open authorization.
       #
       # Concatenate your transaction number and order_id by using a semicolon
       # (';'). This is to keep the Moneris interface consistent with other
       # gateways. (See +capture+ for details.)
       def void(authorization, options = {})
-        commit 'purchasecorrection', crediting_params(authorization)
+        capture(0, authorization, options)
       end
 
       # Performs a refund. This method requires that the original transaction
@@ -103,7 +101,7 @@ module ActiveMerchant #:nodoc:
         commit('res_add_cc', post)
       end
 
-      def unstore(data_key)
+      def unstore(data_key, options = {})
         post = {}
         post[:data_key] = data_key
         commit('res_delete', post)

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

@@ -22,7 +22,7 @@ module ActiveMerchant #:nodoc:
       # password is your API Token
       def initialize(options = {})
         requires!(options, :login, :password)
-        @options = { :crypt_type => 7 }.update(options)
+        options = { :crypt_type => 7 }.merge(options)
         super
       end
 

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

@@ -34,7 +34,7 @@ module ActiveMerchant #:nodoc:
       #Transactions currently accepted by NAB Transact XML API
       TRANSACTIONS = {
         :purchase => 0,         #Standard Payment
-        :credit => 4,           #Refund
+        :refund => 4,           #Refund
         :void => 6,             #Client Reversal (Void)
         :authorization => 10,   #Preauthorise
         :capture => 11          #Preauthorise Complete (Advice)
@@ -66,6 +66,10 @@ module ActiveMerchant #:nodoc:
         end
       end
 
+      def refund(money, authorization, options = {})
+        commit :refund, build_reference_request(money, authorization)
+      end
+
       def store(creditcard, options = {})
         requires!(options, :billing_id, :amount)
         commit_periodic(build_periodic_item(:addcrn, options[:amount], creditcard, options))
@@ -104,10 +108,23 @@ module ActiveMerchant #:nodoc:
         xml.target!
       end
 
+      def build_reference_request(money, reference)
+        xml = Builder::XmlMarkup.new
+
+        transaction_id, order_id, preauth_id, original_amount = reference.split('*')
+
+        xml.tag! 'amount', (money ? amount(money) : original_amount)
+        xml.tag! 'currency', options[:currency] || currency(money)
+        xml.tag! 'txnID', transaction_id
+        xml.tag! 'purchaseOrderNo', order_id
+        xml.tag! 'preauthID', preauth_id
+
+        xml.target!
+      end
+
       #Generate payment request XML
       # - API is set to allow multiple Txn's but currentlu only allows one
       # - txnSource = 23 - (XML)
-
       def build_request(action, body)
         xml = Builder::XmlMarkup.new
         xml.instruct!
@@ -210,7 +227,7 @@ module ActiveMerchant #:nodoc:
       end
 
       def authorization_from(response)
-        response[:txn_id]
+        [response[:txn_id], response[:purchase_order_no], response[:preauth_id], response[:amount]].join('*')
       end
 
       def message_from(response)

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

@@ -41,7 +41,7 @@ module ActiveMerchant
         :purchase => 'purchase',
         :capture => 'completion',
         :status => 'status',
-        :credit => 'refund'
+        :refund => 'refund'
       }
 
       # Create a new NetRegistry gateway.
@@ -94,13 +94,18 @@ module ActiveMerchant
         commit(:purchase, params)
       end
 
-      def credit(money, identification, options = {})
+      def refund(money, identification, options = {})
         params = {
           'AMOUNT'  => amount(money),
           'TXNREF'  => identification
         }
         add_request_details(params, options)
-        commit(:credit, params)
+        commit(:refund, params)
+      end
+
+      def credit(money, identification, options = {})
+        deprecated CREDIT_DEPRECATION_MESSAGE
+        refund(money, identification, options)
       end
 
       # Specific to NetRegistry.

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

@@ -30,56 +30,73 @@ module ActiveMerchant #:nodoc:
       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)
+        MultiResponse.run do |r|
+          r.process{authorize(money, creditcard, options)}
+          r.process{capture(money, r.authorization, options)}
+        end
       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)
+        MultiResponse.run do |r|
+          r.process{setup_transaction(money, options)}
+          r.process{add_and_auth_credit_card(r.authorization, creditcard, options)}
+          r.process{query_transaction(r.authorization, options)}
+        end
       end
 
       def capture(money, authorization, options = {})
         post = {}
         add_credentials(post, options)
         add_authorization(post, authorization, money)
-        commit('Capture', post, false)
+        post[:operation] = "Capture"
+        commit("Netaxept/process.aspx", post)
       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)
+        post[:operation] = "Credit"
+        commit("Netaxept/process.aspx", post)
       end
 
       def void(authorization, options = {})
         post = {}
         add_credentials(post, options)
         add_authorization(post, authorization)
-        commit('Annul', post, false)
+        post[:operation] = "Annul"
+        commit("Netaxept/process.aspx", post)
       end
 
       private
 
-      def add_credentials(post, options)
+      def setup_transaction(money, options)
+        post = {}
+        add_credentials(post, options)
+        add_order(post, money, options)
+        commit("Netaxept/Register.aspx", post)
+      end
+
+      def add_and_auth_credit_card(authorization, creditcard, options)
+        post = {}
+        add_credentials(post, options, false)
+        add_authorization(post, authorization)
+        add_creditcard(post, creditcard)
+        commit("terminal/default.aspx", post, false)
+      end
+
+      def query_transaction(authorization, options)
+        post = {}
+        add_credentials(post, options)
+        add_authorization(post, authorization)
+        commit("Netaxept/query.aspx", post)
+      end
+
+      def add_credentials(post, options, secure=true)
         post[:merchantId] = @options[:login]
-        post[:token] = @options[:password]
+        post[:token] = @options[:password] if secure
       end
 
       def add_authorization(post, authorization, money=nil)
@@ -87,92 +104,45 @@ module ActiveMerchant #:nodoc:
         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[:serviceType] = 'M'
         post[:orderNumber] = options[:order_id]
         post[:amount] = amount(money)
         post[:currencyCode] = (options[:currency] || currency(money))
+        post[:autoAuth] = "true"
       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
+      def add_creditcard(post, options)
+        post[:pan] = options.number
+        post[:expiryDate] = format(options.month, :two_digits) + format(options.year, :two_digits)
+        post[:securityCode] = options.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(path, parameters, xml=true)
+        raw = parse(ssl_get(build_url(path, parameters)), xml)
 
-      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
+        success = false
+        authorization = (raw["TransactionId"] || parameters[:transactionId])
+        if raw[:container] =~ /Exception|Error/
+          message = (raw["Message"] || raw["Error"]["Message"])
+        elsif raw["Error"] && !raw["Error"].empty?
+          message = (raw["Error"]["ResponseText"] || raw["Error"]["ResponseCode"])
         else
-          message = (response[step]['ResponseText'] || response[step]['ResponseCode'])
-          response[:message] = (message || response[:message])
-
-          response[:authorization] = response[step]['TransactionId']
+          message = (raw["ResponseText"] || raw["ResponseCode"] || "OK")
+          success = true
         end
+
+        Response.new(
+          success,
+          message,
+          raw,
+          :test => test?,
+          :authorization => authorization
+        )
       end
 
       def parse(result, expects_xml=true)
-        if expects_xml || /^</ =~ result
+        if expects_xml
           doc = REXML::Document.new(result)
           extract_xml(doc.root).merge(:container => doc.root.name)
         else
@@ -192,20 +162,8 @@ module ActiveMerchant #:nodoc:
         end
       end
 
-      def url
-        (test? ? self.test_url : self.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? ? self.test_url : self.live_url}"
+        url = (test? ? self.test_url : self.live_url).dup
         url << base
         if parameters
           url << '?'
@@ -217,16 +175,6 @@ module ActiveMerchant #:nodoc:
       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