activemerchant 1.29.1 → 1.34.0

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

@@ -89,7 +89,18 @@ module ActiveMerchant #:nodoc:
         commit("ProcessPayment", post)
       end
 
-      # TODO: eWay API also provides QueryCustomer
+      # Get customer's stored credit card details given by billing_id
+      #
+      # ==== Parameters
+      #
+      # * <tt>billing_id</tt> -- The eWay provided card/customer token to charge (managedCustomerID)
+      def retrieve(billing_id)
+        post = {}
+        post[:managedCustomerID] = billing_id.to_s
+
+        commit("QueryCustomer", post)
+      end
+
       # TODO: eWay API also provides QueryPayment
 
       private
@@ -146,25 +157,29 @@ module ActiveMerchant #:nodoc:
             # Successful payment
             reply=parse_purchase(root)
           else
-            if root = REXML::XPath.first(xml, '//CreateCustomerResult') then
-              reply[:message]='OK'
-              reply[:CreateCustomerResult]=root.text
-              reply[:success]=true
+            if root = REXML::XPath.first(xml, '//QueryCustomerResult') then
+              reply=parse_query_customer(root)
             else
-              if root = REXML::XPath.first(xml, '//UpdateCustomerResult') then
-                if root.text.downcase == 'true' then
-                  reply[:message]='OK'
-                  reply[:success]=true
+              if root = REXML::XPath.first(xml, '//CreateCustomerResult') then
+                reply[:message]='OK'
+                reply[:CreateCustomerResult]=root.text
+                reply[:success]=true
+              else
+                if root = REXML::XPath.first(xml, '//UpdateCustomerResult') then
+                  if root.text.downcase == 'true' then
+                    reply[:message]='OK'
+                    reply[:success]=true
+                  else
+                    # ERROR: This state should never occur. If there is a problem,
+                    #        a soap:Fault will be returned. The presence of this
+                    #        element always means a success.
+                    raise StandardError, "Unexpected \"false\" in UpdateCustomerResult"
+                  end
                 else
-                  # ERROR: This state should never occur. If there is a problem,
-                  #        a soap:Fault will be returned. The presence of this
-                  #        element always means a success.
-                  raise StandardError, "Unexpected \"false\" in UpdateCustomerResult"
+                  # ERROR: This state should never occur currently. We have handled
+                  #        responses for all the methods which we support.
+                  raise StandardError, "Unexpected response"
                 end
-              else
-                # ERROR: This state should never occur currently. We have handled
-                #        responses for all the methods which we support.
-                raise StandardError, "Unexpected response"
               end
             end
           end
@@ -188,6 +203,17 @@ module ActiveMerchant #:nodoc:
         reply
       end
 
+      def parse_query_customer(node)
+        reply={}
+        reply[:message]='OK'
+        reply[:success]=true
+        reply[:CCNumber]=REXML::XPath.first(node, '//CCNumber').text
+        reply[:CCName]=REXML::XPath.first(node, '//CCName').text
+        reply[:CCExpiryMonth]=REXML::XPath.first(node, '//CCExpiryMonth').text
+        reply[:CCExpiryYear]=REXML::XPath.first(node, '//CCExpiryYear').text
+        reply
+      end
+
       def commit(action, post)
         raw = begin
           ssl_post(test? ? self.test_url : self.live_url, soap_request(post, action), 'Content-Type' => 'application/soap+xml; charset=utf-8')
@@ -206,11 +232,15 @@ module ActiveMerchant #:nodoc:
       def soap_request(arguments, action)
         # eWay demands all fields be sent, but contain an empty string if blank
         post = case action
-        when 'ProcessPayment'
-          default_payment_fields.merge(arguments)
-        else
-          default_customer_fields.merge(arguments)
-        end
+                when 'QueryCustomer'
+                  arguments
+                when 'ProcessPayment'
+                  default_payment_fields.merge(arguments)
+                when 'CreateCustomer'
+                  default_customer_fields.merge(arguments)
+                when 'UpdateCustomer'
+                  default_customer_fields.merge(arguments)
+               end
 
         xml = Builder::XmlMarkup.new :indent => 2
           xml.instruct!

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

@@ -0,0 +1,22 @@
+require File.dirname(__FILE__) + '/cc5'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FinansbankGateway < CC5Gateway
+      self.live_url = self.test_url = 'https://www.fbwebpos.com/servlet/cc5ApiServer'
+
+      # The countries the gateway supports merchants from as 2 digit ISO country codes
+      self.supported_countries = ['US', 'TR']
+
+      # The card types supported by the payment gateway
+      self.supported_cardtypes = [:visa, :master]
+
+      # The homepage URL of the gateway
+      self.homepage_url = 'https://www.fbwebpos.com/'
+
+      # The name of the gateway
+      self.display_name = 'Finansbank WebPOS'
+    end
+  end
+end
+

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

@@ -0,0 +1,314 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FirstdataE4Gateway < Gateway
+      # TransArmor support requires v11 or lower
+      self.test_url = "https://api.demo.globalgatewaye4.firstdata.com/transaction/v11"
+      self.live_url = "https://api.globalgatewaye4.firstdata.com/transaction/v11"
+
+      TRANSACTIONS = {
+        :sale          => "00",
+        :authorization => "01",
+        :capture       => "32",
+        :void          => "33",
+        :credit        => "34",
+        :store         => "05"
+      }
+
+      POST_HEADERS = {
+        "Accepts" => "application/xml",
+        "Content-Type" => "application/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.default_currency = "USD"
+      self.homepage_url = "http://www.firstdata.com"
+      self.display_name = "FirstData Global Gateway e4"
+
+      # Create a new FirstdataE4Gateway
+      #
+      # The gateway requires that a valid login and password be passed
+      # in the +options+ hash.
+      #
+      # ==== Options
+      #
+      # * <tt>:login</tt> --    The EXACT ID.  Also known as the Gateway ID.
+      #                         (Found in your administration terminal settings)
+      # * <tt>:password</tt> -- The terminal password (not your account password)
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+
+        super
+      end
+
+      def authorize(money, credit_card_or_store_authorization, options = {})
+        commit(:authorization, build_sale_or_authorization_request(money, credit_card_or_store_authorization, options))
+      end
+
+      def purchase(money, credit_card_or_store_authorization, options = {})
+        commit(:sale, build_sale_or_authorization_request(money, credit_card_or_store_authorization, options))
+      end
+
+      def capture(money, authorization, options = {})
+        commit(:capture, build_capture_or_credit_request(money, authorization, options))
+      end
+
+      def void(authorization, options = {})
+        commit(:void, build_capture_or_credit_request(money_from_authorization(authorization), authorization, options))
+      end
+
+      def refund(money, authorization, options = {})
+        commit(:credit, build_capture_or_credit_request(money, authorization, options))
+      end
+
+      # Tokenize a credit card with TransArmor
+      #
+      # The TransArmor token and other card data necessary for subsequent
+      # transactions is stored in the response's +authorization+ attribute.
+      # The authorization string may be passed to +authorize+ and +purchase+
+      # instead of a +ActiveMerchant::Billing::CreditCard+ instance.
+      #
+      # TransArmor support must be explicitly activated on your gateway
+      # account by FirstData. If your authorization string is empty, contact
+      # FirstData support for account setup assistance.
+      #
+      # === Example
+      #
+      #   # Generate token
+      #   result = gateway.store(credit_card)
+      #   if result.success?
+      #     my_record.update_attributes(:authorization => result.authorization)
+      #   end
+      #
+      #   # Use token
+      #   result = gateway.purchase(1000, my_record.authorization)
+      #
+      # https://firstdata.zendesk.com/entries/21303361-transarmor-tokenization
+      def store(credit_card, options = {})
+        commit(:store, build_store_request(credit_card, options), credit_card)
+      end
+
+      private
+
+      def build_request(action, body)
+        xml = Builder::XmlMarkup.new
+
+        xml.instruct!
+        xml.tag! "Transaction" do
+          add_credentials(xml)
+          add_transaction_type(xml, action)
+          xml << body
+        end
+
+        xml.target!
+      end
+
+      def build_sale_or_authorization_request(money, credit_card_or_store_authorization, options)
+        xml = Builder::XmlMarkup.new
+
+        add_amount(xml, money)
+
+        if credit_card_or_store_authorization.is_a? String
+          add_credit_card_token(xml, credit_card_or_store_authorization)
+        else
+          add_credit_card(xml, credit_card_or_store_authorization)
+        end
+
+        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 build_store_request(credit_card, options)
+        xml = Builder::XmlMarkup.new
+
+        add_credit_card(xml, credit_card)
+        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
+        xml.tag! "CardType", credit_card.brand
+
+        if credit_card.verification_value?
+          xml.tag! "CVD_Presence_Ind", "1"
+          xml.tag! "VerificationStr2", credit_card.verification_value
+        end
+      end
+
+      def add_credit_card_token(xml, store_authorization)
+        params = store_authorization.split(";")
+        credit_card = CreditCard.new(
+          :brand      => params[1],
+          :first_name => params[2],
+          :last_name  => params[3],
+          :month      => params[4],
+          :year       => params[5])
+
+        xml.tag! "TransarmorToken", params[0]
+        xml.tag! "Expiry_Date", expdate(credit_card)
+        xml.tag! "CardHoldersName", credit_card.name
+        xml.tag! "CardType", credit_card.brand
+      end
+
+      def add_customer_data(xml, options)
+        xml.tag! "Customer_Ref", options[:customer] if options[:customer]
+        xml.tag! "Client_IP", options[:ip] if options[:ip]
+        xml.tag! "Client_Email", options[:email] if 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] if options[:description]
+      end
+
+      def expdate(credit_card)
+        "#{format(credit_card.month, :two_digits)}#{format(credit_card.year, :two_digits)}"
+      end
+
+      def commit(action, request, credit_card = nil)
+        url = (test? ? self.test_url : self.live_url)
+        begin
+          response = parse(ssl_post(url, build_request(action, request), POST_HEADERS))
+        rescue ResponseError => e
+          response = parse_error(e.response)
+        end
+
+        Response.new(successful?(response), message_from(response), response,
+          :test => test?,
+          :authorization => response_authorization(action, response, credit_card),
+          :avs_result => {:code => response[:avs]},
+          :cvv_result => response[:cvv2]
+        )
+      end
+
+      def successful?(response)
+        response[:transaction_approved] == SUCCESS
+      end
+
+      def response_authorization(action, response, credit_card)
+        if action == :store
+          store_authorization_from(response, credit_card)
+        else
+          authorization_from(response)
+        end
+      end
+
+      def authorization_from(response)
+        if response[:authorization_num] && response[:transaction_tag]
+          [
+            response[:authorization_num],
+            response[:transaction_tag],
+            (response[:dollar_amount].to_f * 100).to_i
+          ].join(";")
+        else
+          ""
+        end
+      end
+
+      def store_authorization_from(response, credit_card)
+        if response[:transarmor_token].present?
+          [
+            response[:transarmor_token],
+            credit_card.brand,
+            credit_card.first_name,
+            credit_card.last_name,
+            credit_card.month,
+            credit_card.year
+            ].map { |value| value.to_s.gsub(/;/, "") }.join(";")
+        else
+          raise StandardError, "TransArmor support is not enabled on your #{display_name} account"
+        end
+      end
+
+      def money_from_authorization(auth)
+        _, _, amount = auth.split(/;/, 3)
+        amount.to_i # return the # of cents, no need to divide
+      end
+
+      def message_from(response)
+        if(response[:faultcode] && response[:faultstring])
+          response[:faultstring]
+        elsif(response[:error_number] && response[:error_number] != "0")
+          response[:error_description]
+        else
+          result = (response[:exact_message] || "")
+          result << " - #{response[:bank_message]}" if response[:bank_message].present?
+          result
+        end
+      end
+
+      def parse_error(error)
+        {
+          :transaction_approved => "false",
+          :error_number => error.code,
+          :error_description => error.body
+        }
+      end
+
+      def parse(xml)
+        response = {}
+        xml = REXML::Document.new(xml)
+
+        if root = REXML::XPath.first(xml, "//TransactionResult")
+          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/garanti.rb

@@ -1,7 +1,3 @@
-if RUBY_VERSION < '1.9' && $KCODE == "NONE"
-  $KCODE = 'u'
-end
-
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
     class GarantiGateway < Gateway

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

@@ -9,12 +9,23 @@ module ActiveMerchant #:nodoc:
     #
     # ActiveMerchant expects the amounts to be given as an Integer in cents. In this case, 10 EUR becomes 1000.
     #
+    # Create certificates for authentication:
+    #
+    # The PEM file expected should contain both the certificate and the generated PEM file.
+    # Some sample shell commands to generate the certificates:
+    #
+    #    openssl genrsa -aes128 -out priv.pem -passout pass:[YOUR PASSWORD] 1024
+    #    openssl req -x509 -new -key priv.pem -passin pass:[YOUR PASSWORD] -days 3000 -out cert.cer
+    #    cat cert.cer priv.pem > ideal.pem
+    #
+    # Following the steps above, upload cert.cer to the ideal web interface and pass the path of ideal.pem to the :pem option.
+    #
     # Configure the gateway using your iDEAL bank account info and security settings:
     #
     # Create gateway:
     #    gateway = ActiveMerchant::Billing::IdealRabobankGateway.new(
-    #      :login    => '123456789', # merchant number
-    #      :pem      => File.read(RAILS_ROOT + '/config/ideal.pem'), # put certificate and PEM in this file
+    #      :login    => '123456789', # 9 digit merchant number
+    #      :pem      => File.read(Rails.root + 'config/ideal.pem'),
     #      :password => 'password' # password for the PEM key
     #    )
     #

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

@@ -38,8 +38,14 @@ module ActiveMerchant #:nodoc:
         super
       end
 
-      def authorize(money, creditcard, options = {})
-        commit(build_purchase_request('PREAUTH', money, creditcard, options), options)
+      def authorize(money, payment_source, options = {})
+        setup_address_hash(options)
+
+        if payment_source.respond_to?(:number)
+          commit(build_purchase_request('PREAUTH', money, payment_source, options), options)
+        else
+          commit(build_reference_request('PREAUTH', money, payment_source, options), options)
+        end
       end
 
       def purchase(money, payment_source, options = {})