aktivemerchant 2.0.0

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

@@ -0,0 +1,23 @@
+require File.dirname(__FILE__) + '/cc5'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FinansbankGateway < CC5Gateway
+      self.live_url =  'https://www.fbwebpos.com/servlet/cc5ApiServer'
+      self.test_url = 'https://entegrasyon.asseco-see.com.tr/fim/api'
+
+      # 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/first_giving.rb

@@ -0,0 +1,143 @@
+require 'nokogiri'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FirstGivingGateway < Gateway
+      self.test_url = 'http://usapisandbox.fgdev.net'
+      self.live_url = 'https://api.firstgiving.com'
+
+      self.supported_countries = ['US']
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+      self.homepage_url = 'http://www.firstgiving.com/'
+      self.default_currency = 'USD'
+      self.display_name = 'FirstGiving'
+
+      def initialize(options = {})
+        requires!(options, :application_key, :security_token, :charity_id)
+        super
+      end
+
+      def purchase(money, creditcard, options = {})
+        post = {}
+        add_invoice(post, options)
+        add_creditcard(post, creditcard)
+        add_address(post, options)
+        add_customer_data(post, options)
+        add_donation_data(post, money, options)
+        commit('/donation/creditcard', post)
+      end
+
+      def refund(money, identifier, options = {})
+        get = {}
+        get[:transactionId] = identifier
+        get[:tranType]     = 'REFUNDREQUEST'
+        commit("/transaction/refundrequest?" + encode(get))
+      end
+
+      private
+
+      def add_donation_data(post, money, options)
+        post[:amount] = amount(money)
+        post[:charityId] = @options[:charity_id]
+        post[:description] = (options[:description] || "Purchase")
+        post[:currencyCode] = (options[:currency] || currency(money))
+      end
+
+      def add_customer_data(post, options)
+        post[:billToEmail] = (options[:email] || "activemerchant@example.com")
+        post[:remoteAddr]  = (options[:ip] || "127.0.0.1")
+      end
+
+      def add_address(post, options)
+        if(billing_address = (options[:billing_address] || options[:address]))
+          post[:billToAddressLine1]  = billing_address[:address1]
+          post[:billToCity]          = billing_address[:city]
+          post[:billToState]         = billing_address[:state]
+          post[:billToZip]           = billing_address[:zip]
+          post[:billToCountry]       = billing_address[:country]
+        end
+      end
+
+      def add_invoice(post, options)
+        post[:orderId] = options[:order_id]
+      end
+
+      def add_creditcard(post, creditcard)
+        post[:billToFirstName]     = creditcard.first_name
+        post[:billToLastName]      = creditcard.last_name
+        post[:ccNumber]            = creditcard.number
+        post[:ccType]              = creditcard_brand(creditcard.brand)
+        post[:ccExpDateMonth]      = creditcard.month
+        post[:ccExpDateYear]       = creditcard.year
+        post[:ccCardValidationNum] = creditcard.verification_value
+      end
+
+      def parse(body)
+        response = {}
+
+        xml = Nokogiri::XML(body)
+        element = xml.xpath("//firstGivingDonationApi/firstGivingResponse").first
+
+        element.attributes.each do |name, attribute|
+          response[name] = attribute.content
+        end
+        element.children.each do |child|
+          next if child.text?
+          response[child.name] = child.text
+        end
+
+        response
+      end
+
+      def commit(action, post=nil)
+        url = (test? ? self.test_url : self.live_url) + action
+
+        begin
+          if post
+            response = parse(ssl_post(url, post_data(post), headers))
+          else
+            response = parse(ssl_get(url, headers))
+          end
+        rescue ResponseError => e
+          response = parse(e.response.body)
+        end
+
+        Response.new(
+          (response["acknowledgement"] == "Success"),
+          (response["friendlyErrorMessage"] || response["verboseErrorMessage"] || response["acknowledgement"]),
+          response,
+          authorization: response["transactionId"],
+          test: test?,
+        )
+      end
+
+      def post_data(post)
+        post.collect { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join("&")
+      end
+
+      def encode(hash)
+        hash.collect{|(k,v)| "#{CGI.escape(k.to_s)}=#{CGI.escape(v.to_s)}"}.join('&')
+      end
+
+      def creditcard_brand(brand)
+        case brand
+        when "visa" then "VI"
+        when "master" then "MC"
+        when "discover" then "DI"
+        when "american_express" then "AX"
+        else
+          raise "Unhandled credit card brand #{brand}"
+        end
+      end
+
+      def headers
+        {
+          "User-Agent"        => "ActiveMerchantBindings/#{ActiveMerchant::VERSION}",
+          "JG_APPLICATIONKEY" => "#{@options[:application_key]}",
+          "JG_SECURITYTOKEN"  => "#{@options[:security_token]}"
+        }
+      end
+    end
+  end
+end
+

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

@@ -0,0 +1,160 @@
+require 'nokogiri'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class FirstPayGateway < Gateway
+      self.live_url = 'https://secure.1stpaygateway.net/secure/gateway/xmlgateway.aspx'
+
+      self.supported_countries = ['US']
+      self.default_currency = 'USD'
+      self.money_format = :dollars
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+
+      self.homepage_url = 'http://1stpaygateway.net/'
+      self.display_name = '1stPayGateway.Net'
+
+      def initialize(options={})
+        requires!(options, :transaction_center_id, :gateway_id)
+        super
+      end
+
+      def purchase(money, payment, options={})
+        post = {}
+        add_invoice(post, money, options)
+        add_payment(post, payment)
+        add_address(post, payment, options)
+        add_customer_data(post, options)
+
+        commit('sale', post)
+      end
+
+      def authorize(money, payment, options={})
+        post = {}
+        add_invoice(post, money, options)
+        add_payment(post, payment)
+        add_address(post, payment, options)
+        add_customer_data(post, options)
+
+        commit('auth', post)
+      end
+
+      def capture(money, authorization, options={})
+        post = {}
+        add_reference(post, 'settle', money, authorization)
+        commit('settle', post)
+      end
+
+      def refund(money, authorization, options={})
+        post = {}
+        add_reference(post, 'credit', money, authorization)
+        commit('credit', post)
+      end
+
+      def void(authorization, options={})
+        post = {}
+        add_reference(post, 'void', nil, authorization)
+        commit('void', post)
+      end
+
+      private
+
+      def add_authentication(post, options)
+        post[:transaction_center_id] = options[:transaction_center_id]
+        post[:gateway_id] = options[:gateway_id]
+      end
+
+      def add_customer_data(post, options)
+        post[:owner_email] = options[:email] if options[:email]
+        post[:remote_ip_address] = options[:ip] if options[:ip]
+      end
+
+      def add_address(post, creditcard, options)
+        address = options[:billing_address] || options[:address]
+        post[:owner_name] = address[:name]
+        post[:owner_street] = address[:address1]
+        post[:owner_street2] = address[:address2] if address[:address2]
+        post[:owner_city] = address[:city]
+        post[:owner_state] = address[:state]
+        post[:owner_zip] = address[:zip]
+        post[:owner_country] = address[:country]
+        post[:owner_phone] = address[:phone] if address[:phone]
+      end
+
+      def add_invoice(post, money, options)
+        post[:order_id] = options[:order_id]
+        post[:total] = amount(money)
+      end
+
+      def add_payment(post, payment)
+        post[:card_name] = payment.brand # Unclear if need to map to known names or open text field??
+        post[:card_number] = payment.number
+        post[:card_exp] = expdate(payment)
+        post[:cvv2] = payment.verification_value
+      end
+
+      def add_reference(post, action, money, authorization)
+        post[:"#{action}_amount1"] = amount(money) if money
+        post[:total_number_transactions] = 1
+        post[:reference_number1] = authorization
+      end
+
+      def parse(xml)
+        response = {}
+
+        doc = Nokogiri::XML(xml)
+        doc.root.xpath("//RESPONSE/FIELDS/FIELD").each do |field|
+          response[field['KEY']] = field.text
+        end unless doc.root.nil?
+
+        response
+      end
+
+      def commit(action, parameters)
+        response = parse(ssl_post(live_url, post_data(action, parameters)))
+
+        Response.new(
+          success_from(response),
+          message_from(response),
+          response,
+          authorization: authorization_from(response),
+          test: test?
+        )
+      end
+
+      def success_from(response)
+        (
+          (response['status'] == '1') ||
+          (response['status1'] == '1')
+        )
+      end
+
+      def message_from(response)
+        # Silly inconsistent gateway. Always make capitalized (but not all caps)
+        msg = (response['auth_response'] || response['response1'])
+        msg.downcase.capitalize if msg
+      end
+
+      def authorization_from(response)
+        response['reference_number'] || response['reference_number1']
+      end
+
+      def post_data(action, parameters = {})
+        parameters[:transaction_center_id] = @options[:transaction_center_id]
+        parameters[:gateway_id] = @options[:gateway_id]
+
+        parameters[:operation_type] = action
+
+        xml = Builder::XmlMarkup.new
+        xml.instruct!
+        xml.tag! 'TRANSACTION' do
+          xml.tag! 'FIELDS' do
+            parameters.each do |key, value|
+              xml.tag! 'FIELD', value, { 'KEY' => key }
+            end
+          end
+        end
+        xml.target!
+      end
+    end
+  end
+end

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

@@ -0,0 +1,355 @@
+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",
+        verify:        "05",
+        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]
+
+      BRANDS = {
+        :visa => 'Visa',
+        :master => "Mastercard",
+        :american_express => "American Express",
+        :jcb => "JCB",
+        :discover => "Discover"
+      }
+
+      self.supported_cardtypes = BRANDS.keys
+      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
+
+      def verify(credit_card, options = {})
+        commit(:verify, build_sale_or_authorization_request(0, credit_card, 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, options)
+        end
+
+        add_customer_data(xml, options)
+        add_invoice(xml, options)
+        add_card_authentication_data(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)
+        add_card_authentication_data(xml, options)
+
+        xml.target!
+      end
+
+      def build_store_request(credit_card, options)
+        xml = Builder::XmlMarkup.new
+
+        add_credit_card(xml, credit_card, options)
+        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, options)
+
+        if credit_card.respond_to?(:track_data) && credit_card.track_data.present?
+          xml.tag! "Track1", credit_card.track_data
+        else
+          xml.tag! "Card_Number", credit_card.number
+          xml.tag! "Expiry_Date", expdate(credit_card)
+          xml.tag! "CardHoldersName", credit_card.name
+          xml.tag! "CardType", card_type(credit_card.brand)
+
+          add_credit_card_verification_strings(xml, credit_card, options)
+        end
+      end
+
+      def add_credit_card_verification_strings(xml, credit_card, options)
+        address = options[:billing_address] || options[:address]
+        if address
+          address_values = []
+          [:address1, :zip, :city, :state, :country].each { |part| address_values << address[part].to_s }
+          xml.tag! "VerificationStr1", address_values.join("|")
+        end
+
+        if credit_card.verification_value?
+          xml.tag! "CVD_Presence_Ind", "1"
+          xml.tag! "VerificationStr2", credit_card.verification_value
+        end
+      end
+
+      def add_card_authentication_data(xml, options)
+        xml.tag! "CAVV", options[:cavv]
+        xml.tag! "XID", options[:xid]
+        xml.tag! "Ecommerce_Flag", options[:eci]
+      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", card_type(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 card_type(credit_card_brand)
+        BRANDS[credit_card_brand.to_sym] if credit_card_brand
+      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
+