activemerchant 1.20.4 → 1.21.0

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

@@ -11,6 +11,10 @@ module ActiveMerchant #:nodoc:
       def api_url
         'https://secure.braintreepaymentgateway.com/api/transact.php'
       end
+
+      def add_processor(post, options)
+        post[:processor_id] = options[:processor] unless options[:processor].nil?
+      end
     end
   end
 end

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/epay.rb

@@ -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
@@ -181,7 +181,7 @@ module ActiveMerchant #:nodoc:
 
       def do_authorize(params)
         headers = {}
-        headers['Referer'] = options[:password] if options[:password]
+        headers['Referer'] = (options[:password] || "activemerchant.org")
 
         response = raw_ssl_request(:post, 'https://' + API_HOST + '/auth/default.aspx', authorize_post_data(params), headers)
 

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

@@ -188,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
       

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

@@ -90,6 +90,7 @@ module ActiveMerchant #:nodoc:
 				if creditcard_or_card_id.is_a?(String)  
 					# using stored card
 					post[:card_id] = creditcard_or_card_id
+					post[:card_exp_date] = options[:expiration_date] if options[:expiration_date]
 				else
 					# card info is provided
 					add_creditcard(post, creditcard_or_card_id, options)

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

@@ -0,0 +1,244 @@
+require 'rexml/document'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    # The National Australia Bank provide a payment gateway that seems to
+    # be a rebadged Securepay Australia service, though some differences exist.
+    class NabTransactGateway < Gateway
+      API_VERSION = 'xml-4.2'
+      PERIODIC_API_VERSION = "spxml-4.2"
+
+      TEST_URL = 'https://transact.nab.com.au/test/xmlapi/payment'
+      LIVE_URL = 'https://transact.nab.com.au/live/xmlapi/payment'
+      TEST_PERIODIC_URL = "https://transact.nab.com.au/xmlapidemo/periodic"
+      LIVE_PERIODIC_URL = "https://transact.nab.com.au/xmlapi/periodic"
+
+      self.supported_countries = ['AU']
+
+      # The card types supported by the payment gateway
+      # Note that support for Diners, Amex, and JCB require extra
+      # steps in setting up your account, as detailed in the NAB Transact API
+      self.supported_cardtypes = [:visa, :master, :american_express, :diners_club, :jcb]
+
+      self.homepage_url = 'http://transact.nab.com.au'
+      self.display_name = 'NAB Transact'
+
+      cattr_accessor :request_timeout
+      self.request_timeout = 60
+
+      self.money_format = :cents
+      self.default_currency = 'AUD'
+
+      #Transactions currently accepted by NAB Transact XML API
+      TRANSACTIONS = {
+        :purchase => 0,         #Standard Payment
+        :credit => 4,           #Refund
+        :void => 6,             #Client Reversal (Void)
+        :authorization => 10,   #Preauthorise
+        :capture => 11          #Preauthorise Complete (Advice)
+      }
+
+      PERIODIC_TYPES = {
+        :addcrn    => 5,
+        :editcrn   => 5,
+        :deletecrn => 5,
+        :trigger   => 8
+      }
+
+      SUCCESS_CODES = [ '00', '08', '11', '16', '77' ]
+
+
+      def initialize(options = {})
+        requires!(options, :login, :password)
+        @options = options
+        super
+      end
+
+      def test?
+        @options[:test] || super
+      end
+
+      def purchase(money, credit_card_or_stored_id, options = {})
+        if credit_card_or_stored_id.is_a?(ActiveMerchant::Billing::CreditCard)
+          #Credit card for instant payment
+          commit :purchase, build_purchase_request(money, credit_card_or_stored_id, options)
+        else
+          #Triggered payment for an existing stored credit card
+          options[:billing_id] = credit_card_or_stored_id.to_s
+          commit_periodic build_periodic_item(:trigger, money, nil, options)
+        end
+      end
+
+      def store(creditcard, options = {})
+        requires!(options, :billing_id, :amount)
+        commit_periodic(build_periodic_item(:addcrn, options[:amount], creditcard, options))
+      end
+
+      def unstore(identification, options = {})
+        options[:billing_id] = identification
+        commit_periodic(build_periodic_item(:deletecrn, options[:amount], nil, options))
+      end
+
+      private
+
+      def build_purchase_request(money, credit_card, options)
+        xml = Builder::XmlMarkup.new
+        xml.tag! 'amount', amount(money)
+        xml.tag! 'currency', options[:currency] || currency(money)
+        xml.tag! 'purchaseOrderNo', options[:order_id].to_s.gsub(/[ ']/, '')
+
+        xml.tag! 'CreditCardInfo' do
+          xml.tag! 'cardNumber', credit_card.number
+          xml.tag! 'expiryDate', expdate(credit_card)
+          xml.tag! 'cvv', credit_card.verification_value if credit_card.verification_value?
+        end
+
+        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!
+        xml.tag! 'NABTransactMessage' do
+          xml.tag! 'MessageInfo' do
+            xml.tag! 'messageID', Utils.generate_unique_id.slice(0, 30)
+            xml.tag! 'messageTimestamp', generate_timestamp
+            xml.tag! 'timeoutValue', request_timeout
+            xml.tag! 'apiVersion', API_VERSION
+          end
+
+          xml.tag! 'MerchantInfo' do
+            xml.tag! 'merchantID', @options[:login]
+            xml.tag! 'password', @options[:password]
+          end
+
+          xml.tag! 'RequestType', 'Payment'
+          xml.tag! 'Payment' do
+            xml.tag! 'TxnList', "count" => 1 do
+              xml.tag! 'Txn', "ID" => 1 do
+                xml.tag! 'txnType', TRANSACTIONS[action]
+                xml.tag! 'txnSource', 23
+                xml << body
+              end
+            end
+          end
+        end
+
+        xml.target!
+      end
+
+      def build_periodic_item(action, money, credit_card, options)
+        xml = Builder::XmlMarkup.new
+
+        xml.tag! 'actionType', action.to_s
+        xml.tag! 'periodicType', PERIODIC_TYPES[action] if PERIODIC_TYPES[action]
+        xml.tag! 'currency', options[:currency] || currency(money)
+        xml.tag! 'crn', options[:billing_id]
+
+        if credit_card
+          xml.tag! 'CreditCardInfo' do
+            xml.tag! 'cardNumber', credit_card.number
+            xml.tag! 'expiryDate', expdate(credit_card)
+            xml.tag! 'cvv', credit_card.verification_value if credit_card.verification_value?
+          end
+        end
+        xml.tag! 'amount', amount(money)
+
+        xml.target!
+      end
+
+      def build_periodic_request(body)
+        xml = Builder::XmlMarkup.new
+        xml.instruct!
+        xml.tag! 'NABTransactMessage' do
+          xml.tag! 'MessageInfo' do
+            xml.tag! 'messageID', ActiveMerchant::Utils.generate_unique_id.slice(0, 30)
+            xml.tag! 'messageTimestamp', generate_timestamp
+            xml.tag! 'timeoutValue', request_timeout
+            xml.tag! 'apiVersion', PERIODIC_API_VERSION
+          end
+
+          xml.tag! 'MerchantInfo' do
+            xml.tag! 'merchantID', @options[:login]
+            xml.tag! 'password', @options[:password]
+          end
+
+          xml.tag! 'RequestType', 'Periodic'
+          xml.tag! 'Periodic' do
+            xml.tag! 'PeriodicList', "count" => 1 do
+              xml.tag! 'PeriodicItem', "ID" => 1 do
+                xml << body
+              end
+            end
+          end
+        end
+
+        xml.target!
+      end
+
+      def commit(action, request)
+        response = parse(ssl_post(test? ? TEST_URL : LIVE_URL, build_request(action, request)))
+
+        Response.new(success?(response), message_from(response), response,
+          :test => test?,
+          :authorization => authorization_from(response)
+        )
+      end
+
+      def commit_periodic(request)
+        response = parse(ssl_post(test? ? TEST_PERIODIC_URL : LIVE_PERIODIC_URL, build_periodic_request(request)))
+        Response.new(success?(response), message_from(response), response,
+          :test => test?,
+          :authorization => authorization_from(response)
+        )
+      end
+
+      def success?(response)
+        SUCCESS_CODES.include?(response[:response_code])
+      end
+
+      def authorization_from(response)
+        response[:txn_id]
+      end
+
+      def message_from(response)
+        response[:response_text] || response[:status_description]
+      end
+
+      def expdate(credit_card)
+        "#{format(credit_card.month, :two_digits)}/#{format(credit_card.year, :two_digits)}"
+      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
+
+      # YYYYDDMMHHNNSSKKK000sOOO
+      def generate_timestamp
+        time = Time.now.utc
+        time.strftime("%Y%d%m%H%M%S#{time.usec}+000")
+      end
+
+    end
+  end
+end