aktivemerchant 2.0.0

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

@@ -0,0 +1,117 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class AlfabankGateway < Gateway
+
+      self.display_name        = 'Alfabank'
+      self.homepage_url        = 'http://www.alfabank.ru'
+      self.live_url            = 'https://engine.paymentgate.ru/payment/rest'
+      self.money_format        = :cents
+      self.ssl_strict          = false
+      self.supported_cardtypes = [:visa, :master]
+      self.supported_countries = ['RU']
+      self.test_url            = 'https://test.paymentgate.ru/testpayment/rest'
+
+      STATUSES_HASH = {
+          '0' => 'Order registered but not paid',
+          '1' => 'Waits when order will be completed',
+          '2' => 'Run the full authorization amount of the order',
+          '3' => 'Authorization revoked',
+          '4' => 'The transaction had an operation return',
+          '5' => 'Initiated ACS authorization through the issuing bank',
+          '6' => 'Authorization rejected'
+      }
+
+      # Creates a new AlfabankGateway
+      #
+      # The gateway requires that valid credentials be passed in the +options+
+      # hash.
+      #
+      # ==== Options
+      #
+      # * <tt>:account</tt> -- The Alfabank API account (REQUIRED)
+      # * <tt>:secret</tt> -- The Alfabank API secret (REQUIRED)
+      def initialize(options = {})
+        requires!(options, :account, :secret)
+        super
+      end
+
+      def make_order(options = {})
+        post = {}
+        add_order_number(post, options)
+        add_return_url(post, options)
+        add_amount(post, options)
+        add_description(post, options)
+
+        commit('register', options[:amount], post)
+      end
+
+      def get_order_status(options = {})
+        post = {}
+        add_order_number(post, options)
+        add_order_id(post, options)
+
+        commit('getOrderStatusExtended', nil, post)
+      end
+
+      private
+
+      def add_order_number(post, options)
+        post[:orderNumber] = options[:order_number]
+      end
+
+      def add_order_id(post, options)
+        post[:orderId] = options[:order_id]
+      end
+
+      def add_return_url(post, options)
+        post[:returnUrl] = options[:return_url]
+      end
+
+      def add_amount(post, options)
+        post[:amount] = amount(options[:amount])
+      end
+
+      def add_description(post, options)
+        post[:description] = options[:description]
+      end
+
+      def commit(action, money, parameters)
+        base_url = (test? ? self.test_url : self.live_url)
+        response = parse(ssl_post("#{base_url}/#{action}.do", post_data(action, parameters)))
+
+        success = !has_error?(response)
+        message = raw_message(response) || parse_status(response) || response['orderId']
+        params  = convert_hash(response)
+
+        Response.new(success, message, params)
+      end
+
+      def post_data(action, parameters = {})
+        parameters.merge!({
+                              :userName => @options[:account],
+                              :password => @options[:secret]
+                          }).to_query
+      end
+
+      def parse(response)
+        ActiveSupport::JSON.decode(response)
+      end
+
+      def has_error?(response)
+        response.blank? || !response['errorCode'].to_i.zero?
+      end
+
+      def raw_message(response)
+        response['errorMessage']
+      end
+
+      def convert_hash(hash)
+        Hash[hash.map { |key, value| [key.underscore, value] }]
+      end
+
+      def parse_status(response)
+        STATUSES_HASH[response['orderStatus'].to_s]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,176 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class App55Gateway < Gateway
+      self.test_url = 'https://sandbox.app55.com/v1/'
+      self.live_url = 'https://api.app55.com/v1/'
+
+      self.supported_countries = ['AU', 'BR', 'CA', 'CH', 'CL', 'CN', 'CO', 'CZ', 'DK', 'GB', 'HK', 'HU', 'ID', 'IS', 'JP', 'KE', 'KR', 'MX', 'MY', 'NO', 'NZ', 'PH', 'PL', 'TH', 'TW', 'US', 'VN', 'ZA']
+      self.supported_cardtypes = [:visa, :master, :american_express, :jcb, :maestro, :solo]
+      self.default_currency = 'UKP'
+      self.money_format = :dollars
+      self.homepage_url = 'https://www.app55.com/'
+      self.display_name = 'App55'
+
+      # Create gateway
+      #
+      # options:
+      #       :api_key - merchants App55 API Key
+      #       :api_secret - merchants App55 Secret Key
+      def initialize(options = {})
+        requires!(options, :api_key, :api_secret)
+        @api_key = options[:api_key]
+        @api_secret = options[:api_secret]
+        super
+      end
+
+      # Make a purchase (authorize and commit)
+      #
+      # money          - The monetary amount of the transaction in cents.
+      # payment_method - The CreditCard or the App55 card token.
+      # options        - A standard ActiveMerchant options hash
+      def purchase(money, payment_method, options = {})
+        authorize(money, payment_method, options.merge(commit: true))
+      end
+
+      # Authorize a transaction.
+      #
+      # money          - The monetary amount of the transaction in cents.
+      # payment_method - The CreditCard or the App55 card token.
+      # options        - A standard ActiveMerchant options hash
+      def authorize(money, payment_method, options = {})
+        post = {}
+        add_creditcard(post, payment_method, options)
+        add_transaction(post, money, options)
+
+        commit(:post, 'transaction', post)
+      end
+
+      # Commit a pre-authorized transaction.
+      #
+      # money          - The monetary amount of the transaction in cents.
+      # authorization  - The App55 transaction id string.
+      # options        - A standard ActiveMerchant options hash
+      def capture(money, authorization, options = {})
+        commit(:post, "transaction/#{authorization}")
+      end
+
+      private
+
+      def add_customer_data(post, options)
+        metadata_options = [:description, :browser_ip, :user_agent, :referrer]
+        post.update(options.slice(*metadata_options))
+      end
+
+      def add_creditcard(post, creditcard, options)
+        card = {}
+        card[:number] = creditcard.number
+        card[:expiry] = ("%02d". % creditcard.month) +  '/' + creditcard.year.to_s
+        card[:security_code] = creditcard.verification_value if creditcard.verification_value?
+        card[:holder_name] = creditcard.name if creditcard.name
+        add_address(card, options)
+        post[:card] = card
+      end
+
+      def add_address(card, options)
+        return unless card && card.kind_of?(Hash)
+        address_hash = {}
+        if address = (options[:billing_address] || options[:address])
+          address_hash[:street] = address[:address1] if address[:address1]
+          address_hash[:street2] = address[:address2] if address[:address2]
+          address_hash[:country] = address[:country] if address[:country]
+          address_hash[:postal_code] = address[:zip] if address[:zip]
+          address_hash[:city] = address[:city] if address[:city]
+          card[:address] = address_hash
+        end
+      end
+
+      def add_transaction(post, money, options)
+        transaction = {}
+        add_amount(transaction, money, options)
+        transaction[:description] = (options[:description] || options[:email])
+        transaction[:commit] = options[:commit]
+        post[:transaction] = transaction
+      end
+
+      def add_amount(obj, money, options)
+        obj[:amount] = amount(money)
+        obj[:currency] = (options[:currency] || currency(money))
+      end
+
+      def parse(body)
+        JSON.parse(body)
+      rescue JSON::ParserError
+        json_error(raw_response)
+      end
+
+      def commit(method, resource, parameters=nil, meta={})
+        success = false
+        begin
+          raw_response = ssl_request(
+            method,
+            url(resource),
+            post_data(parameters),
+            headers
+          )
+          response = parse(raw_response)
+          success = response.key?("sig")
+        rescue ResponseError => e
+          response = parse(e.response.body)
+        end
+
+        Response.new(
+          success,
+          (success ? "OK" : response["error"]["message"]),
+          response,
+          test: test?,
+          authorization: authorization_from(response)
+        )
+      end
+
+      def authorization_from(response)
+        if response.key?("transaction")
+          response["transaction"]["id"]
+        elsif response.key?("card")
+          response["card"]["token"]
+        end
+      end
+
+      def json_error(raw_response)
+        msg = "Invalid response from app55 server: Received: #{raw_response.inspect})"
+        {
+          "error" => {
+            "message" => msg
+          }
+        }
+      end
+
+      def url(resource)
+        (test? ? self.test_url : self.live_url) + resource
+      end
+
+      def post_data(params)
+        return nil unless params
+
+        params.map do |key, value|
+          next if value.blank?
+          if value.is_a?(Hash)
+            h = {}
+            value.each do |k, v|
+              h["#{key}.#{k}"] = v unless v.blank?
+            end
+            post_data(h)
+          else
+            "#{key}=#{CGI.escape(value.to_s)}"
+          end
+        end.compact.join("&")
+      end
+
+      def headers
+        {
+          "Authorization" => "Basic " + Base64.strict_encode64(@options[:api_key].to_s + ":" + @options[:api_secret].to_s),
+          "User-Agent" => user_agent,
+        }
+      end
+    end
+  end
+end

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

@@ -0,0 +1,419 @@
+require 'nokogiri'
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class AuthorizeNetGateway < Gateway
+      include Empty
+
+      self.test_url = 'https://apitest.authorize.net/xml/v1/request.api'
+      self.live_url = 'https://api.authorize.net/xml/v1/request.api'
+
+      self.supported_countries = %w(AD AT AU BE BG CA CH CY CZ DE DK ES FI FR GB GB GI GR HU IE IT LI LU MC MT NL NO PL PT RO SE SI SK SM TR US VA)
+      self.default_currency = 'USD'
+      self.money_format = :dollars
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover, :diners_club, :jcb, :maestro]
+
+      self.homepage_url = 'http://www.authorize.net/'
+      self.display_name = 'Authorize.Net'
+
+      class_attribute :duplicate_window
+
+      APPROVED, DECLINED, ERROR, FRAUD_REVIEW = 1, 2, 3, 4
+      TRANSACTION_ALREADY_ACTIONED = %w(310 311)
+
+      CARD_CODE_ERRORS = %w(N S)
+      AVS_ERRORS = %w(A E N R W Z)
+      AVS_REASON_CODES = %w(27 45)
+
+      TRACKS = {
+          1 => /^%(?<format_code>.)(?<pan>[\d]{1,19}+)\^(?<name>.{2,26})\^(?<expiration>[\d]{0,4}|\^)(?<service_code>[\d]{0,3}|\^)(?<discretionary_data>.*)\?\Z/,
+          2 => /\A;(?<pan>[\d]{1,19}+)=(?<expiration>[\d]{0,4}|=)(?<service_code>[\d]{0,3}|=)(?<discretionary_data>.*)\?\Z/
+      }.freeze
+
+      APPLE_PAY_DATA_DESCRIPTOR = "COMMON.APPLE.INAPP.PAYMENT"
+
+      def initialize(options={})
+        requires!(options, :login, :password)
+        super
+      end
+
+      def purchase(amount, payment, options = {})
+        commit("AUTH_CAPTURE") do |xml|
+          add_order_id(xml, options)
+          xml.transactionRequest do
+            xml.transactionType 'authCaptureTransaction'
+            xml.amount amount(amount)
+            add_payment_source(xml, payment)
+            add_invoice(xml, options)
+            add_customer_data(xml, payment, options)
+            add_retail_data(xml, payment)
+            add_settings(xml, payment, options)
+            add_user_fields(xml, amount, options)
+          end
+        end
+      end
+
+      def authorize(amount, payment, options={})
+        commit("AUTH_ONLY") do |xml|
+          add_order_id(xml, options)
+          xml.transactionRequest do
+            xml.transactionType 'authOnlyTransaction'
+            xml.amount amount(amount)
+            add_payment_source(xml, payment)
+            add_invoice(xml, options)
+            add_customer_data(xml, payment, options)
+            add_settings(xml, payment, options)
+            add_user_fields(xml, amount, options)
+          end
+        end
+      end
+
+      def capture(amount, authorization, options={})
+        commit("PRIOR_AUTH_CAPTURE") do |xml|
+          add_order_id(xml, options)
+          xml.transactionRequest do
+            xml.transactionType 'priorAuthCaptureTransaction'
+            xml.amount amount(amount)
+            xml.refTransId split_authorization(authorization)[0]
+            add_invoice(xml, options)
+            add_user_fields(xml, amount, options)
+          end
+        end
+      end
+
+      def refund(amount, authorization, options={})
+        transaction_id, card_number = split_authorization(authorization)
+        commit("CREDIT") do |xml|
+          xml.transactionRequest do
+            xml.transactionType 'refundTransaction'
+            xml.amount (amount.nil? ? 0 : amount(amount))
+            xml.payment do
+              xml.creditCard do
+                xml.cardNumber(card_number || options[:card_number])
+                xml.expirationDate 'XXXX'
+              end
+            end
+            xml.refTransId transaction_id
+            add_customer_data(xml, nil, options)
+            add_user_fields(xml, amount, options)
+          end
+        end
+      end
+
+      def void(authorization, options={})
+        commit("VOID") do |xml|
+          add_order_id(xml, options)
+          xml.transactionRequest do
+            xml.transactionType 'voidTransaction'
+            xml.refTransId split_authorization(authorization)[0]
+            add_user_fields(xml, nil, options)
+          end
+        end
+      end
+
+      def verify(credit_card, options = {})
+        MultiResponse.run(:use_first_response) do |r|
+          r.process { authorize(100, credit_card, options) }
+          r.process(:ignore_result) { void(r.authorization, options) }
+        end
+      end
+
+      private
+
+      def add_payment_source(xml, source)
+        return unless source
+        if card_brand(source) == 'check'
+          add_check(xml, source)
+        elsif card_brand(source) == 'apple_pay'
+          add_apple_pay_payment_token(xml, source)
+        else
+          add_credit_card(xml, source)
+        end
+      end
+
+      def add_settings(xml, source, options)
+        xml.transactionSettings do
+          if(card_brand(source) == "check" && options[:recurring])
+            xml.setting do
+              xml.settingName "recurringBilling"
+              xml.settingValue "true"
+            end
+          end
+          if(self.class.duplicate_window)
+            xml.setting do
+              xml.settingName "duplicateWindow"
+              xml.settingValue self.class.duplicate_window
+            end
+          end
+        end
+      end
+
+      def add_user_fields(xml, amount, options)
+        xml.userFields do
+          if(currency = (options[:currency] || currency(amount)))
+            xml.userField do
+              xml.name "x_currency_code"
+              xml.value currency
+            end
+          end
+          if(application_id.present? && application_id != "ActiveMerchant")
+            xml.userField do
+              xml.name "x_solution_id"
+              xml.value application_id
+            end
+          end
+        end
+      end
+
+      def add_credit_card(xml, credit_card)
+        if credit_card.track_data
+          add_swipe_data(xml, credit_card)
+        else
+          xml.payment do
+            xml.creditCard do
+              xml.cardNumber credit_card.number
+              xml.expirationDate (format(credit_card.month, :two_digits) + '/' + format(credit_card.year, :four_digits))
+              unless empty?(credit_card.verification_value)
+                xml.cardCode credit_card.verification_value
+              end
+            end
+          end
+        end
+      end
+
+      def add_swipe_data(xml, credit_card)
+        TRACKS.each do |key, regex|
+          if regex.match(credit_card.track_data)
+            @valid_track_data = true
+            xml.payment do
+              xml.trackData do
+                xml.public_send(:"track#{key}", credit_card.track_data)
+              end
+            end
+          end
+        end
+      end
+
+      # http://developer.authorize.net/api/reference/#apple-pay-transactions
+      def add_apple_pay_payment_token(xml, apple_pay_payment_token)
+        xml.payment do
+          xml.opaqueData do
+            xml.dataDescriptor APPLE_PAY_DATA_DESCRIPTOR
+            xml.dataValue Base64.strict_encode64(apple_pay_payment_token.payment_data.to_json)
+          end
+        end
+      end
+
+      def add_retail_data(xml, payment)
+        return unless valid_track_data
+        xml.retail do
+          # As per http://www.authorize.net/support/CP_guide.pdf, '2' is for Retail, the only current market_type
+          xml.marketType 2
+        end
+      end
+
+      def valid_track_data
+        @valid_track_data ||= false
+      end
+
+      def add_check(xml, check)
+        xml.payment do
+          xml.bankAccount do
+            xml.routingNumber check.routing_number
+            xml.accountNumber check.account_number
+            xml.nameOnAccount check.name
+            xml.echeckType "WEB"
+            xml.bankName check.bank_name
+            xml.checkNumber check.number
+          end
+        end
+      end
+
+      def add_customer_data(xml, payment_source, options)
+        billing_address = options[:billing_address] || options[:address] || {}
+        shipping_address = options[:shipping_address] || options[:address] || {}
+
+        xml.customer do
+          xml.id(options[:customer]) unless empty?(options[:customer]) || options[:customer] !~ /^\d+$/
+          xml.email(options[:email]) unless empty?(options[:email])
+        end
+
+        xml.billTo do
+          first_name, last_name = names_from(payment_source, billing_address, options)
+          xml.firstName(truncate(first_name, 50)) unless empty?(first_name)
+          xml.lastName(truncate(last_name, 50)) unless empty?(last_name)
+
+          xml.company(truncate(billing_address[:company], 50)) unless empty?(billing_address[:company])
+          xml.address(truncate(billing_address[:address1], 60))
+          xml.city(truncate(billing_address[:city], 40))
+          xml.state(empty?(billing_address[:state]) ? 'n/a' : truncate(billing_address[:state], 40))
+          xml.zip(truncate((billing_address[:zip] || options[:zip]), 20))
+          xml.country(truncate(billing_address[:country], 60))
+          xml.phoneNumber(truncate(billing_address[:phone], 25)) unless empty?(billing_address[:phone])
+          xml.faxNumber(truncate(billing_address[:fax], 25)) unless empty?(billing_address[:fax])
+        end
+
+        unless shipping_address.blank?
+          xml.shipTo do
+            first_name, last_name = names_from(payment_source, shipping_address, options)
+            xml.firstName(truncate(first_name, 50)) unless empty?(first_name)
+            xml.lastName(truncate(last_name, 50)) unless empty?(last_name)
+
+            xml.company(truncate(shipping_address[:company], 50)) unless empty?(shipping_address[:company])
+            xml.address(truncate(shipping_address[:address1], 60))
+            xml.city(truncate(shipping_address[:city], 40))
+            xml.state(truncate(shipping_address[:state], 40))
+            xml.zip(truncate(shipping_address[:zip], 20))
+            xml.country(truncate(shipping_address[:country], 60))
+          end
+        end
+
+        xml.customerIP(options[:ip]) unless empty?(options[:ip])
+
+        xml.cardholderAuthentication do
+          xml.authenticationIndicator options[:authentication_indicator]
+          xml.cardholderAuthenticationValue options[:cardholder_authentication_value]
+        end
+      end
+
+      def add_order_id(xml, options)
+        xml.refId truncate(options[:order_id], 20)
+      end
+
+      def add_invoice(xml, options)
+        xml.order do
+          xml.invoiceNumber truncate(options[:order_id], 20)
+          xml.description truncate(options[:description], 255)
+        end
+      end
+
+      def names_from(payment_source, address, options)
+        if payment_source && !payment_source.is_a?(PaymentToken)
+          first_name, last_name = (address[:name] || "").split
+          [(payment_source.first_name || first_name), (payment_source.last_name || last_name)]
+        else
+          [options[:first_name], options[:last_name]]
+        end
+      end
+
+      def commit(action, &payload)
+        url = (test? ? test_url : live_url)
+        response = parse(action, ssl_post(url, post_data(&payload), 'Content-Type' => 'text/xml'))
+
+        avs_result = AVSResult.new(code: response[:avs_result_code])
+        cvv_result = CVVResult.new(response[:card_code])
+        Response.new(
+          success_from(response),
+          message_from(response, avs_result, cvv_result),
+          response,
+          authorization: authorization_from(response),
+          test: test?,
+          avs_result: avs_result,
+          cvv_result: cvv_result,
+          fraud_review: fraud_review?(response)
+        )
+      end
+
+      def post_data
+        Nokogiri::XML::Builder.new do |xml|
+          xml.createTransactionRequest('xmlns' => 'AnetApi/xml/v1/schema/AnetApiSchema.xsd') do
+            xml.merchantAuthentication do
+              xml.name @options[:login]
+              xml.transactionKey @options[:password]
+            end
+            yield(xml)
+          end
+        end.to_xml(indent: 0)
+      end
+
+      def parse(action, body)
+        doc = Nokogiri::XML(body)
+        doc.remove_namespaces!
+
+        response = {action: action}
+
+        response[:response_code] = if(element = doc.at_xpath("//transactionResponse/responseCode"))
+          (empty?(element.content) ? nil : element.content.to_i)
+        end
+
+        if(element = doc.at_xpath("//errors/error"))
+          response[:response_reason_code] = element.at_xpath("errorCode").content[/0*(\d+)$/, 1]
+          response[:response_reason_text] = element.at_xpath("errorText").content.chomp('.')
+        elsif(element = doc.at_xpath("//transactionResponse/messages/message"))
+          response[:response_reason_code] = element.at_xpath("code").content[/0*(\d+)$/, 1]
+          response[:response_reason_text] = element.at_xpath("description").content.chomp('.')
+        elsif(element = doc.at_xpath("//messages/message"))
+          response[:response_reason_code] = element.at_xpath("code").content[/0*(\d+)$/, 1]
+          response[:response_reason_text] = element.at_xpath("text").content.chomp('.')
+        else
+          response[:response_reason_code] = nil
+          response[:response_reason_text] = ""
+        end
+
+        response[:avs_result_code] = if(element = doc.at_xpath("//avsResultCode"))
+          (empty?(element.content) ? nil : element.content)
+        end
+
+        response[:transaction_id] = if(element = doc.at_xpath("//transId"))
+          (empty?(element.content) ? nil : element.content)
+        end
+
+        response[:card_code] = if(element = doc.at_xpath("//cvvResultCode"))
+          (empty?(element.content) ? nil : element.content)
+        end
+
+        response[:authorization_code] = if(element = doc.at_xpath("//authCode"))
+          (empty?(element.content) ? nil : element.content)
+        end
+
+        response[:cardholder_authentication_code] = if(element = doc.at_xpath("//cavvResultCode"))
+          (empty?(element.content) ? nil : element.content)
+        end
+
+        response[:account_number] = if(element = doc.at_xpath("//accountNumber"))
+          (empty?(element.content) ? nil : element.content[-4..-1])
+        end
+
+        response
+      end
+
+      def success_from(response)
+        (
+          response[:response_code] == APPROVED &&
+          TRANSACTION_ALREADY_ACTIONED.exclude?(response[:response_reason_code])
+        )
+      end
+
+      def message_from(response, avs_result, cvv_result)
+        if response[:response_code] == DECLINED
+          if CARD_CODE_ERRORS.include?(cvv_result.code)
+            return cvv_result.message
+          elsif(AVS_REASON_CODES.include?(response[:response_reason_code]) && AVS_ERRORS.include?(avs_result.code))
+            return avs_result.message
+          end
+        end
+
+        response[:response_reason_text]
+      end
+
+      def authorization_from(response)
+        [response[:transaction_id], response[:account_number]].join("#")
+      end
+
+      def split_authorization(authorization)
+        transaction_id, card_number = authorization.split("#")
+        [transaction_id, card_number]
+      end
+
+      def fraud_review?(response)
+        (response[:response_code] == FRAUD_REVIEW)
+      end
+
+      def truncate(value, max_size)
+        return nil unless value
+        value.to_s[0, max_size]
+      end
+
+    end
+  end
+end