yetanothernguyen-activemerchant 1.16.0 → 1.21.0

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

@@ -0,0 +1,279 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class CertoDirectGateway < Gateway
+      class_attribute :gateway_url
+      self.gateway_url = "https://secure.certodirect.com/gateway/process/v2"
+
+      self.supported_countries = [
+        "BE", "BG", "CZ", "DK", "DE", "EE", "IE", "EL", "ES", "FR",
+        "IT", "CY", "LV", "LT", "LU", "HU", "MT", "NL", "AT", "PL",
+        "PT", "RO", "SI", "SK", "FI", "SE", "UK"
+      ]
+
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+      self.homepage_url = 'http://www.certodirect.com/'
+      self.display_name = 'CertoDirect'
+
+      # Creates a new CertoDirectGateway
+      #
+      # The gateway requires that a valid login and password be passed
+      # in the +options+ hash.
+      #
+      # ==== Options
+      #
+      # * <tt>:login</tt> -- The CertoDirect Shop ID (REQUIRED)
+      # * <tt>:password</tt> -- The CertoDirect Shop Password. (REQUIRED)
+      # * <tt>:test</tt> -- +true+ or +false+. If true, perform transactions against the test server.
+      #   Otherwise, perform transactions against the production server.
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+        super
+      end
+
+      # Perform a purchase, which is essentially an authorization and capture in a single operation.
+      #
+      # ==== Parameters
+      #
+      # * <tt>money</tt> -- The amount to be purchased as an Integer value in cents.
+      # * <tt>credit_card</tt> -- The CreditCard details for the transaction.
+      # * <tt>options</tt> -- A hash of optional parameters.
+      def purchase(money, credit_card, options = {})
+        requires!(options, :email, :currency, :ip, :description)
+
+        commit(build_sale_request(money, credit_card, options))
+      end
+
+      # Refund a transaction.
+      #
+      # This transaction indicates to the gateway that
+      # money should flow from the merchant to the customer.
+      #
+      # ==== Parameters
+      #
+      # * <tt>money</tt> -- The amount to be credited to the customer as an Integer value in cents.
+      # * <tt>identification</tt> -- The ID of the original order against which the refund is being issued.
+      # * <tt>options</tt> -- A hash of parameters.
+      def refund(money, identification, options = {})
+        requires!(options, :reason)
+
+        commit(build_refund_request(money, identification, options))
+      end
+
+      # Performs an authorization, which reserves the funds on the customer's credit card, but does not
+      # charge the card.
+      #
+      # ==== Parameters
+      #
+      # * <tt>money</tt> -- The amount to be authorized as an Integer value in cents.
+      # * <tt>credit_card</tt> -- The CreditCard details for the transaction.
+      # * <tt>options</tt> -- A hash of optional parameters.
+      def authorize(money, credit_card, options = {})
+        requires!(options, :email, :currency, :ip, :description)
+
+        commit(build_authorize_request(money, credit_card, options))
+      end
+
+      # Captures the funds from an authorized transaction.
+      #
+      # ==== Parameters
+      #
+      # * <tt>money</tt> -- The amount to be captured as an Integer value in cents.
+      # * <tt>identification</tt> -- The authorization returned from the previous authorize request.
+      def capture(money, identification, options = {})
+        commit(build_capture_request(money, identification))
+      end
+
+      # Void a previous transaction
+      #
+      # ==== Parameters
+      #
+      # * <tt>money</tt> -- The amount to be captured as an Integer value in cents.
+      # * <tt>identification</tt> - The authorization returned from the previous authorize request.
+      def void(money, identification, options = {})
+        commit(build_void_request(money, identification))
+      end
+
+      # Create a recurring payment.
+      #
+      # ==== Parameters
+      #
+      # * <tt>options</tt> -- A hash of parameters.
+      #
+      # ==== Options
+      #
+      def recurring(identification, options={})
+        commit(build_recurring_request(identification, options))
+      end
+
+
+      private
+
+      def commit(request_xml)
+        begin
+          response = Hash.from_xml(ssl_post(gateway_url, request_xml, headers))
+          Response.new(success?(response),
+                       message(response),
+                       response,
+                       :test          => test?,
+                       :authorization => authorization(response))
+        rescue ResponseError => e
+          raise e unless e.response.code == '403'
+          response = Hash.from_xml(e.response.body)['response']
+          Response.new(false, message(response), {}, :test => test?)
+        end
+      end
+
+      def build_sale_request(money, credit_card, options)
+        build_request_xml('Sale') do |xml|
+          add_order(xml, money, credit_card, options)
+        end
+      end
+
+      def build_authorize_request(money, credit_card, options)
+        build_request_xml('Authorize') do |xml|
+          add_order(xml, money, credit_card, options)
+        end
+      end
+
+      def build_refund_request(money, identification, options)
+        build_request_xml('Refund') do |xml|
+          add_reference_info(xml, money, identification, options)
+          xml.tag! 'reason', options[:reason]
+        end
+      end
+
+      def build_capture_request(money, identification)
+        build_request_xml('Capture') do |xml|
+          add_reference_info(xml, money, identification, options)
+        end
+      end
+
+      def build_void_request(money, identification)
+        build_request_xml('Void') do |xml|
+          add_reference_info(xml, money, identification, options)
+        end
+      end
+
+      def build_recurring_request(identification, options)
+        build_request_xml('Sale') do |xml|
+          xml.tag! 'order' do |xml|
+            xml.tag!('test', 'true') if test?
+            xml.tag! 'initial_order_id', identification, :type => 'integer'
+
+            add_order_details(xml, options[:amount], options) if has_any_order_details_key?(options)
+            add_address(xml, 'billing_address', options[:billing_address]) if options[:billing_address]
+            add_address(xml, 'shipping_address', options[:shipping_address]) if options[:shipping_address]
+          end
+        end
+      end
+
+      def build_request_xml(type, &block)
+        xml = Builder::XmlMarkup.new(:indent => 2)
+        xml.tag! 'transaction' do
+          xml.tag! 'type', type
+          yield(xml)
+        end
+        xml.target!
+      end
+
+      def add_order(xml, money, credit_card, options)
+        xml.tag! 'order' do
+          xml.tag!('test', 'true') if test?
+
+          xml.tag!('return_url', options[:return_url]) if options[:return_url]
+          xml.tag!('cancel_url', options[:cancel_url]) if options[:cancel_url]
+
+          xml.tag! 'payment_method_type', 'CreditCard'
+          xml.tag! 'payment_method' do
+            xml.tag! 'number', credit_card.number
+            xml.tag! 'exp_month', "%02i" % credit_card.month
+            xml.tag! 'exp_year', credit_card.year
+            xml.tag! 'holder', credit_card.name
+            xml.tag! 'verification_value', credit_card.verification_value
+          end
+
+          add_order_details(xml, money, options)
+          add_address(xml, 'billing_address', options[:billing_address]) if options[:billing_address]
+          add_address(xml, 'shipping_address', options[:shipping_address]) if options[:shipping_address]
+        end
+      end
+
+      def add_order_details(xml, money, options)
+        xml.tag! 'details' do
+          xml.tag!('amount', localized_amount(money, options[:currency]), :type => 'decimal') if money
+          xml.tag!('currency', options[:currency]) if options[:currency]
+          xml.tag!('email', options[:email]) if options[:email]
+          xml.tag!('ip', options[:ip]) if options[:ip]
+          xml.tag!('shipping', options[:shipping], :type => 'decimal') if options[:shipping]
+          xml.tag!('description', options[:description]) if options[:description]
+        end
+      end
+
+      def add_reference_info(xml, money, identification, options)
+        xml.tag! 'order_id', identification, :type => 'integer'
+        xml.tag! 'amount', localized_amount(money, options[:currency]), :type => 'decimal'
+      end
+
+      def add_address(xml, address_type, address)
+        xml.tag! address_type do
+          xml.tag! 'address', address[:address1]
+          xml.tag! 'city', address[:city]
+          xml.tag! 'country', address[:country]
+          xml.tag! 'first_name', address[:first_name]
+          xml.tag! 'last_name', address[:last_name]
+          xml.tag! 'state', address[:state]
+          xml.tag! 'phone', address[:phone]
+          xml.tag! 'zip', address[:zip]
+        end
+      end
+
+      def has_any_order_details_key?(options)
+        [ :currency, :amount, :email, :ip, :shipping, :description ].any? do |key|
+          options.has_key?(key)
+        end
+      end
+
+      def success?(response)
+        %w(completed forwarding).include?(state(response)) and
+          status(response) == 'success'
+      end
+
+      def error?(response)
+        response['errors']
+      end
+
+      def state(response)
+        response["transaction"].try(:[], "state")
+      end
+
+      def status(response)
+        response['transaction'].try(:[], 'response').try(:[], 'status')
+      end
+
+      def authorization(response)
+        error?(response) ? nil : response["transaction"]["order"]['id'].to_s
+      end
+
+      def message(response)
+        return response['errors'].join('; ') if error?(response)
+
+        if state(response) == 'completed'
+          response["transaction"]["response"]["message"]
+        else
+          response['transaction']['message']
+        end
+      end
+
+      def headers
+        { 'authorization' => basic_auth,
+          'Accept'        => 'application/xml',
+          'Content-Type'  => 'application/xml' }
+      end
+
+      def basic_auth
+        'Basic ' + ["#{@options[:login]}:#{@options[:password]}"].pack('m').delete("\r\n")
+      end
+    end
+  end
+end

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

@@ -60,7 +60,7 @@ module ActiveMerchant #:nodoc:
       def void(identification, options = {})
         requires!(options, :order_id)
         original_transaction_id, original_transaction_amount = identification.split(";")
-        commit(:void_transaction, {:reference_number => format_reference_number(options[:order_id]), :transaction_ID => original_transaction_id})
+        commit(:void_transaction, {:reference_number => format_reference_number(options[:order_id]), :transaction_id => original_transaction_id})
       end
       
       def voice_authorize(money, authorization_code, creditcard, options = {})
@@ -90,7 +90,7 @@ module ActiveMerchant #:nodoc:
           :reference_number => format_reference_number(options[:order_id]),
           :transaction_amount => amount(money),
           :original_transaction_amount => original_transaction_amount,
-          :original_transaction_ID => original_transaction_id,
+          :original_transaction_id => original_transaction_id,
           :client_ip_address => options[:ip]
         }
       end
@@ -191,7 +191,7 @@ module ActiveMerchant #:nodoc:
         transaction = root.add_element(action.to_s.camelize)
 
         actions[action].each do |key|
-          transaction.add_element(key.to_s.camelize).text = parameters[key] unless parameters[key].blank?
+          transaction.add_element(key).text = parameters[key.underscore.to_sym] unless parameters[key.underscore.to_sym].blank?
         end
 
         xml.to_s
@@ -217,18 +217,18 @@ module ActiveMerchant #:nodoc:
         ACTIONS
       end
 
-      CREDIT_CARD_FIELDS =  [:authorization_number, :client_ip_address, :billing_address, :billing_city, :billing_state, :billing_postal_code, :billing_country, :billing_name, :card_verification_value, :expiration_month, :expiration_year, :reference_number, :transaction_amount, :account_number ]
+      CREDIT_CARD_FIELDS =  %w(AuthorizationNumber ClientIpAddress BillingAddress BillingCity BillingState BillingPostalCode BillingCountry BillingName CardVerificationValue ExpirationMonth ExpirationYear ReferenceNumber TransactionAmount AccountNumber )
 
       ACTIONS = {
            :credit_card_authorize		=> CREDIT_CARD_FIELDS,
            :credit_card_charge			=> CREDIT_CARD_FIELDS,
            :credit_card_voice_authorize		=> CREDIT_CARD_FIELDS,
            :credit_card_capture			=> CREDIT_CARD_FIELDS,
-           :credit_card_credit			=> CREDIT_CARD_FIELDS << :original_transaction_amount,
-           :credit_card_refund			=> [:reference_number, :transaction_amount, :original_transaction_amount, :original_transaction_ID, :client_ip_address],
-           :void_transaction			=> [:reference_number, :transaction_ID],
-           :credit_card_settle			=> [:reference_number, :transaction_amount, :original_transaction_amount, :original_transaction_ID, :client_ip_address],
-           :system_check			=> [:system_check],
+           :credit_card_credit			=> CREDIT_CARD_FIELDS + ["OriginalTransactionAmount"],
+           :credit_card_refund			=> %w(ReferenceNumber TransactionAmount OriginalTransactionAmount OriginalTransactionID ClientIpAddress),
+           :void_transaction			=> %w(ReferenceNumber TransactionID),
+           :credit_card_settle			=> %w(ReferenceNumber TransactionAmount OriginalTransactionAmount OriginalTransactionID ClientIpAddress),
+           :system_check			=> %w(SystemCheck),
       }    
     end
   end

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

@@ -30,7 +30,8 @@ module ActiveMerchant #:nodoc:
     #   puts response.authorization # Retrieve the unique transaction ID returned by Elavon
     #
     class ElavonGateway < ViaklixGateway
-      self.test_url = self.live_url = 'https://www.myvirtualmerchant.com/VirtualMerchant/process.do'
+      self.test_url = 'https://demo.myvirtualmerchant.com/VirtualMerchantDemo/process.do'
+      self.live_url = 'https://www.myvirtualmerchant.com/VirtualMerchant/process.do'
 
       self.display_name = 'Elavon MyVirtualMerchant'
       self.supported_countries = ['US', 'CA']

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

@@ -8,7 +8,7 @@ module ActiveMerchant #:nodoc:
       self.money_format = :cents
       self.supported_cardtypes = [:dankort, :forbrugsforeningen, :visa, :master,
                                   :american_express, :diners_club, :jcb, :maestro]
-      self.supported_countries = ['DK']
+      self.supported_countries = ['DK', 'SE', 'NO']
       self.homepage_url = 'http://epay.dk/'
       self.display_name = 'ePay'
 
@@ -53,7 +53,7 @@ module ActiveMerchant #:nodoc:
       # login: merchant number
       # password: referrer url (for authorize authentication)
       def initialize(options = {})
-        requires!(options, :login, :password)
+        requires!(options, :login)
         @options = options
         super
       end
@@ -180,15 +180,21 @@ module ActiveMerchant #:nodoc:
       end
 
       def do_authorize(params)
-        headers = {
-          'Referer' => options[:password]
-        }
+        headers = {}
+        headers['Referer'] = (options[:password] || "activemerchant.org")
 
         response = raw_ssl_request(:post, 'https://' + API_HOST + '/auth/default.aspx', authorize_post_data(params), headers)
 
         # Authorize gives the response back by redirecting with the values in
         # the URL query
-        query = CGI::parse(URI.parse(response['Location'].gsub(' ', '%20')).query)
+        if location = response['Location']
+          query = CGI::parse(URI.parse(location.gsub(' ', '%20')).query)
+        else
+          return {
+            'accept' => '0',
+            'errortext' => 'No Location header returned.'
+          }
+        end
 
         result = {}
         query.each_pair do |k,v|

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

@@ -45,7 +45,7 @@ module ActiveMerchant #:nodoc:
         
         add_creditcard(post, creditcard)
         add_address(post, billing_address)
-        add_misc_fields(post, billing_address)
+        add_misc_fields(post, options)
              
         commit("CreateCustomer", post)
       end
@@ -63,17 +63,30 @@ module ActiveMerchant #:nodoc:
         post[:managedCustomerID]=billing_id
         add_creditcard(post, creditcard)
         add_address(post, billing_address)
-        add_misc_fields(post, billing_address)
+        add_misc_fields(post, options)
              
         commit("UpdateCustomer", post)
       end
       
-      #process payment for given amount from stored CC "ManagedCustomerID = billing_id"
+      # Process a payment in the given amount against the stored credit card given by billing_id
+      #
+      # ==== Parameters
+      #
+      # * <tt>money</tt> -- The amount to be purchased as an Integer value in cents.
+      # * <tt>billing_id</tt> -- The eWay provided card/customer token to charge (managedCustomerID)
+      # * <tt>options</tt> -- A hash of optional parameters.
+      #
+      # ==== Options
+      #
+      # * <tt>:order_id</tt> -- The order number, passed to eWay as the "Invoice Reference"
+      # * <tt>:invoice</tt> -- The invoice number, passed to eWay as the "Invoice Reference" unless :order_id is also given
+      # * <tt>:description</tt> -- A description of the payment, passed to eWay as the "Invoice Description"
       def purchase(money, billing_id, options={})        
         post = {}  
         post[:managedCustomerID] = billing_id.to_s
         post[:amount]=money
-             
+        add_invoice(post, options)
+        
         commit("ProcessPayment", post)
       end
       
@@ -102,14 +115,21 @@ private
       end
       
       def add_misc_fields(post, options)
-        post[:CustomerRef]=options[:customer_ref].to_s
-        post[:Title]=options[:title]
-        post[:Company]=options[:company]
-        post[:JobDesc]=options[:job_desc]
-        post[:Email]=options[:email]
-        post[:URL]=options[:url]
+        post[:CustomerRef]=options[:billing_address][:customer_ref] || options[:customer]
+        post[:Title]=options[:billing_address][:title]
+        post[:Company]=options[:billing_address][:company]
+        post[:JobDesc]=options[:billing_address][:job_desc]
+        post[:Email]=options[:billing_address][:email] || options[:email]
+        post[:URL]=options[:billing_address][:url]
+        post[:Comments]=options[:description]
+      end
+      
+      def add_invoice(post, options)
+        post[:invoiceReference] = options[:order_id] || options[:invoice]
+        post[:invoiceDescription] = options[:description]
       end
       
+      
       # add credit card details to be stored by eway. NOTE eway requires "title" field
       def add_creditcard(post, creditcard)
         post[:CCNumber]  = creditcard.number
@@ -168,6 +188,7 @@ private
         reply[:message]=REXML::XPath.first(node, '//ewayTrxnError').text
         reply[:success]=(REXML::XPath.first(node, '//ewayTrxnStatus').text == 'True')
         reply[:auth_code]=REXML::XPath.first(node, '//ewayAuthCode').text
+        reply[:transaction_number]=REXML::XPath.first(node, '//ewayTrxnNumber').text        
         reply
       end
       
@@ -188,7 +209,12 @@ private
       # Where we build the full SOAP 1.2 request using builder
       def soap_request(arguments, action)
         # eWay demands all fields be sent, but contain an empty string if blank
-        post=default_fields.merge(arguments)
+        post = case action
+        when 'ProcessPayment'
+          default_payment_fields.merge(arguments)
+        else    
+          default_customer_fields.merge(arguments)
+        end
         
         xml = Builder::XmlMarkup.new :indent => 2
           xml.instruct!
@@ -211,7 +237,7 @@ private
         xml.target!
       end
       
-      def default_fields
+      def default_customer_fields
         hash={}
         %w( CustomerRef Title FirstName LastName Company JobDesc Email Address Suburb State PostCode Country Phone Mobile Fax URL Comments CCNumber CCNameOnCard CCExpiryMonth CCExpiryYear ).each do |field|
           hash[field.to_sym]=''
@@ -219,6 +245,14 @@ private
         return hash
       end
       
+      def default_payment_fields
+        hash={}
+        %w( managedCustomerID amount invoiceReference invoiceDescription ).each do |field|
+          hash[field.to_sym]=''
+        end
+        return hash
+      end
+      
       class EwayResponse < Response
         # add a method to response so we can easily get the eway token "ManagedCustomerID"
         def token

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

@@ -68,6 +68,11 @@ module ActiveMerchant #:nodoc:
       end
 
       def credit(money, authorization, options = {})
+        deprecated CREDIT_DEPRECATION_MESSAGE
+        refund(money, authorization, options)
+      end
+
+      def refund(money, authorization, options = {})
         commit(:credit, build_capture_or_credit_request(money, authorization, options))
       end
          

data/lib/active_merchant/billing/gateways/ideal/ideal_base.rb

@@ -219,7 +219,7 @@ module ActiveMerchant #:nodoc:
         cert_data   = OpenSSL::X509::Certificate.new(cert_file).to_s
         cert_data   = cert_data.sub(/-----BEGIN CERTIFICATE-----/, '')
         cert_data   = cert_data.sub(/-----END CERTIFICATE-----/, '')
-        fingerprint = ActiveSupport::Base64.decode64(cert_data)
+        fingerprint = Base64.decode64(cert_data)
         fingerprint = Digest::SHA1.hexdigest(fingerprint)
         return fingerprint.upcase
       end
@@ -227,12 +227,12 @@ module ActiveMerchant #:nodoc:
       def sign_message(private_key_data, password, data)
         private_key  = OpenSSL::PKey::RSA.new(private_key_data, password)
         signature = private_key.sign(OpenSSL::Digest::SHA1.new, data.gsub('\s', ''))
-        return ActiveSupport::Base64.encode64(signature).gsub(/\n/, '')
+        return Base64.encode64(signature).gsub(/\n/, '')
       end
 
       def verify_message(cert_file, data, signature)
         public_key = OpenSSL::X509::Certificate.new(cert_file).public_key
-        return public_key.verify(OpenSSL::Digest::SHA1.new, ActiveSupport::Base64.decode64(signature), data)
+        return public_key.verify(OpenSSL::Digest::SHA1.new, Base64.decode64(signature), data)
       end
 
       def status_response_verified?(response)