archetype2142_activemerchant 1.124.0

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

@@ -0,0 +1,256 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class CardprocessGateway < Gateway
+      self.test_url = 'https://test.vr-pay-ecommerce.de/v1/payments'
+      self.live_url = 'https://vr-pay-ecommerce.de/v1/payments'
+
+      self.supported_countries = %w[ BE BG CZ DK DE EE IE ES FR HR IT CY LV LT LU
+                                     MT HU NL AT PL PT RO SI SK FI SE GB IS LI NO
+                                     CH ME MK AL RS TR BA ]
+      self.default_currency = 'EUR'
+      self.supported_cardtypes = %i[visa master american_express diners_club jcb]
+
+      self.homepage_url = 'https://vr-pay-ecommerce.docs.oppwa.com/'
+      self.display_name = 'CardProcess VR-Pay'
+      self.money_format = :dollars
+
+      STANDARD_ERROR_CODE_MAPPING = {}
+
+      # Creates a new CardProcess Gateway
+      #
+      # The gateway requires a valid login, password, and entity ID
+      # to be passed in the +options+ hash.
+      #
+      # === Options
+      #
+      # * <tt>:user_id</tt> -- The CardProcess user ID
+      # * <tt>:password</tt> -- The CardProcess password
+      # * <tt>:entity_id</tt> -- The CardProcess channel or entity ID for any transactions
+      def initialize(options = {})
+        requires!(options, :user_id, :password, :entity_id)
+        super
+        # This variable exists purely to allow remote tests to force error codes;
+        # the lack of a setter despite its usage is intentional.
+        @test_options = {}
+      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('DB', 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('PA', post)
+      end
+
+      def capture(money, authorization, options = {})
+        post = {
+          id: authorization
+        }
+        add_invoice(post, money, options)
+        commit('CP', post)
+      end
+
+      def refund(money, authorization, options = {})
+        post = {
+          id: authorization
+        }
+        add_invoice(post, money, options)
+        commit('RF', post)
+      end
+
+      def credit(money, payment, options = {})
+        post = {}
+        add_invoice(post, money, options)
+        add_payment(post, payment)
+        add_address(post, payment, options)
+        add_customer_data(post, options)
+
+        commit('CD', post)
+      end
+
+      def void(authorization, _options = {})
+        post = {
+          id: authorization
+        }
+        commit('RV', post)
+      end
+
+      def verify(credit_card, options = {})
+        MultiResponse.run do |r|
+          r.process { authorize(100, credit_card, options) }
+          r.process { void(r.authorization, options) }
+        end
+      end
+
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r{(authentication\.[^=]+=)[^&]+}, '\1[FILTERED]').
+          gsub(%r{(card\.number=)\d+}, '\1[FILTERED]').
+          gsub(%r{(cvv=)\d{3,4}}, '\1[FILTERED]\2')
+      end
+
+      private
+
+      def add_customer_data(post, options)
+        post['customer.ip'] = options[:ip] if options[:ip]
+      end
+
+      def add_address(post, _card, options)
+        if (address = options[:billing_address] || options[:address])
+          post[:billing] = hashify_address(address)
+        end
+
+        if (shipping = options[:shipping_address])
+          post[:shipping] = hashify_address(shipping)
+        end
+      end
+
+      def add_invoice(post, money, options)
+        return if money.nil?
+
+        post[:amount] = amount(money)
+        post[:currency] = (options[:currency] || currency(money))
+        post[:merchantInvoiceId] = options[:merchant_invoice_id] if options[:merchant_invoice_id]
+        post[:merchantTransactionId] = options[:merchant_transaction_id] if options[:merchant_transaction_id]
+        post[:transactionCategory] = options[:transaction_category] if options[:transaction_category]
+      end
+
+      def add_payment(post, payment)
+        return if payment.is_a?(String)
+
+        post[:paymentBrand] = payment.brand.upcase if payment.brand
+        post[:card] ||= {}
+        post[:card][:number] = payment.number
+        post[:card][:holder] = payment.name
+        post[:card][:expiryMonth] = sprintf('%02d', payment.month)
+        post[:card][:expiryYear] = sprintf('%02d', payment.year)
+        post[:card][:cvv] = payment.verification_value
+      end
+
+      def parse(body)
+        JSON.parse(body)
+      end
+
+      def commit(action, parameters)
+        url = (test? ? test_url : live_url)
+        if (id = parameters.delete(:id))
+          url += "/#{id}"
+        end
+
+        begin
+          raw_response = ssl_post(url, post_data(action, parameters.merge(@test_options)))
+        rescue ResponseError => e
+          raw_response = e.response.body
+        end
+        response = parse(raw_response)
+
+        Response.new(
+          success_from(response),
+          message_from(response),
+          response,
+          authorization: authorization_from(response),
+          avs_result: AVSResult.new(code: response['result']['avsResponse']),
+          cvv_result: CVVResult.new(response['result']['cvvResponse']),
+          test: test?,
+          error_code: error_code_from(response)
+        )
+      end
+
+      def success_from(response)
+        !(response['result']['code'] =~ /^(000\.000\.|000\.100\.1|000\.[36])/).nil?
+      end
+
+      def message_from(response)
+        response['result']['description']
+      end
+
+      def authorization_from(response)
+        response['id']
+      end
+
+      def post_data(action, parameters = {})
+        post = parameters.clone
+        post[:authentication] ||= {}
+        post[:authentication][:userId] = @options[:user_id]
+        post[:authentication][:password] = @options[:password]
+        post[:authentication][:entityId] = @options[:entity_id]
+        post[:paymentType] = action
+        dot_flatten_hash(post).map { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join('&')
+      end
+
+      def error_code_from(response)
+        unless success_from(response)
+          case response['result']['code']
+          when '100.100.101'
+            STANDARD_ERROR_CODE[:incorrect_number]
+          when '100.100.303'
+            STANDARD_ERROR_CODE[:expired_card]
+          when /100\.100\.(201|301|305)/
+            STANDARD_ERROR_CODE[:invalid_expiry_date]
+          when /100.100.60[01]/
+            STANDARD_ERROR_CODE[:invalid_cvc]
+          when '800.100.151'
+            STANDARD_ERROR_CODE[:invalid_number]
+          when '800.100.153'
+            STANDARD_ERROR_CODE[:incorrect_cvc]
+          when /800.800.(102|302)/
+            STANDARD_ERROR_CODE[:incorrect_address]
+          when '800.800.202'
+            STANDARD_ERROR_CODE[:invalid_zip]
+          when '800.100.166'
+            STANDARD_ERROR_CODE[:incorrect_pin]
+          when '800.100.171'
+            STANDARD_ERROR_CODE[:pickup_card]
+          when /^(200|700)\./
+            STANDARD_ERROR_CODE[:config_error]
+          when /^(800\.[17]00|800\.800\.[123])/
+            STANDARD_ERROR_CODE[:card_declined]
+          when /^(900\.[1234]00)/
+            STANDARD_ERROR_CODE[:processing_error]
+          else
+            STANDARD_ERROR_CODE[:processing_error]
+          end
+        end
+      end
+
+      def hashify_address(address)
+        hash = {}
+        hash[:street1] = address[:address1] if address[:address1]
+        hash[:street2] = address[:address2] if address[:address2]
+        hash[:city] = address[:city] if address[:city]
+        hash[:state] = address[:state] if address[:state]
+        hash[:postcode] = address[:zip] if address[:zip]
+        hash[:country] = address[:country] if address[:country]
+        hash
+      end
+
+      def dot_flatten_hash(hash, prefix = '')
+        h = {}
+        hash.each_pair do |k, v|
+          if v.is_a?(Hash)
+            h.merge!(dot_flatten_hash(v, prefix + k.to_s + '.'))
+          else
+            h[prefix + k.to_s] = v
+          end
+        end
+        h
+      end
+    end
+  end
+end

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

@@ -0,0 +1,225 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class CashnetGateway < Gateway
+      include Empty
+
+      self.live_url = 'https://commerce.cashnet.com/'
+      self.test_url = 'https://train.cashnet.com/'
+
+      self.supported_countries = ['US']
+      self.supported_cardtypes = %i[visa master american_express discover diners_club jcb]
+      self.homepage_url        = 'https://transactcampus.com'
+      self.display_name        = 'Cashnet'
+      self.money_format        = :dollars
+      self.max_retries         = 0
+
+      # Creates a new CashnetGateway
+      #
+      # ==== Options
+      #
+      # * <tt>:merchant</tt> -- Gateway Merchant (REQUIRED)
+      # * <tt>:operator</tt> -- Operator (REQUIRED)
+      # * <tt>:password</tt> -- Password (REQUIRED)
+      # * <tt>:merchant_gateway_name</tt> -- Site name (REQUIRED)
+      # * <tt>:station</tt> -- Station (defaults to "WEB")
+      # * <tt>:custcode</tt> -- Customer code (defaults to
+      #   "ActiveMerchant/#{ActiveMerchant::VERSION}")
+      # * <tt>:default_item_code</tt> -- Default item code (defaults to "FEE",
+      #   can be overridden on a per-transaction basis with options[:item_code])
+      def initialize(options = {})
+        requires!(
+          options,
+          :merchant,
+          :operator,
+          :password,
+          :merchant_gateway_name
+        )
+        options[:default_item_code] ||= 'FEE'
+        super
+      end
+
+      def purchase(money, payment_object, options = {})
+        post = {}
+        add_creditcard(post, payment_object)
+        add_invoice(post, options)
+        add_address(post, options)
+        add_customer_data(post, options)
+        commit('SALE', money, post)
+      end
+
+      def refund(money, identification, options = {})
+        post = {}
+        post[:origtx] = identification
+        add_invoice(post, options)
+        add_customer_data(post, options)
+        commit('REFUND', money, post)
+      end
+
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r{(password=)[^&]+}, '\1[FILTERED]').
+          gsub(%r{(cardno=)[^&]+}, '\1[FILTERED]').
+          gsub(%r{(cid=)[^&]+}, '\1[FILTERED]')
+      end
+
+      private
+
+      def commit(action, money, fields)
+        fields[:amount] = amount(money)
+        url = (test? ? test_url : live_url) + CGI.escape(@options[:merchant_gateway_name])
+        raw_response = ssl_post(url, post_data(action, fields))
+        parsed_response = parse(raw_response)
+
+        return unparsable_response(raw_response) unless parsed_response
+
+        success = success?(parsed_response)
+        Response.new(
+          success,
+          CASHNET_CODES[parsed_response[:result]],
+          parsed_response,
+          test:          test?,
+          authorization: (success ? parsed_response[:tx] : '')
+        )
+      end
+
+      def success?(response)
+        response[:result] == '0'
+      end
+
+      def post_data(action, parameters = {})
+        post = {}
+        post[:command]        = action
+        post[:merchant]       = @options[:merchant]
+        post[:operator]       = @options[:operator]
+        post[:password]       = @options[:password]
+        post[:station]        = (@options[:station] || 'WEB')
+        post[:custcode]       = (@options[:custcode] || "ActiveMerchant/#{ActiveMerchant::VERSION}")
+        post.merge(parameters).collect { |key, value| "#{key}=#{CGI.escape(value.to_s)}" }.join('&')
+      end
+
+      def add_creditcard(post, creditcard)
+        post[:cardno]          = creditcard.number
+        post[:cid]             = creditcard.verification_value
+        post[:expdate]         = expdate(creditcard)
+        post[:card_name_g]     = creditcard.name
+        post[:fname]           = creditcard.first_name
+        post[:lname]           = creditcard.last_name
+      end
+
+      def add_invoice(post, options)
+        post[:order_number] = options[:order_id] if options[:order_id].present?
+        post[:itemcode] = (options[:item_code] || @options[:default_item_code])
+      end
+
+      def add_address(post, options)
+        if address = (options[:shipping_address] || options[:billing_address] || options[:address])
+          post[:addr_g]       = String(address[:address1]) + ',' + String(address[:address2])
+          post[:city_g]       = address[:city]
+          post[:state_g]      = address[:state]
+          post[:zip_g]        = address[:zip]
+        end
+      end
+
+      def add_customer_data(post, options)
+        post[:email_g] = options[:email]
+        post[:custcode] = options[:custcode] unless empty?(options[:custcode])
+      end
+
+      def expdate(creditcard)
+        year  = format(creditcard.year, :two_digits)
+        month = format(creditcard.month, :two_digits)
+
+        "#{month}#{year}"
+      end
+
+      def parse(body)
+        match = body.match(/<cngateway>(.*)<\/cngateway>/)
+        return nil unless match
+
+        Hash[CGI::parse(match[1]).map { |k, v| [k.to_sym, v.first] }]
+      end
+
+      def handle_response(response)
+        if (200...300).cover?(response.code.to_i)
+          return response.body
+        elsif response.code.to_i == 302
+          return ssl_get(URI.parse(response['location']))
+        end
+
+        raise ResponseError.new(response)
+      end
+
+      def unparsable_response(raw_response)
+        message = 'Unparsable response received from Cashnet. Please contact Cashnet if you continue to receive this message.'
+        message += " (The raw response returned by the API was #{raw_response.inspect})"
+        return Response.new(false, message)
+      end
+
+      CASHNET_CODES = {
+        '0' => 'Success',
+        '1' => 'Invalid customer code, no customer code specified',
+        '2' => 'Invalid operator code, no operator specified',
+        '3' => 'Invalid workstation code, no station specified',
+        '4' => 'Invalid item code, no code specified',
+        '5' => 'Negative amount is not allowed',
+        '6' => 'Invalid credit card number, no credit card number provided',
+        '7' => 'Invalid expiration date, no expiration date provided',
+        '8' => 'Please only provide either ACH or credit card information',
+        '9' => 'Invalid ACH account number, no account number provided',
+        '10' => 'Invalid routing/transit number, no routing/transit number provided',
+        '11' => 'Invalid account type, no account type provided',
+        '12' => 'Invalid check digit for routing/transit number',
+        '13' => 'No ACH merchant account set up for the location of the station being used',
+        '21' => 'Invalid merchant code, no merchant code provided',
+        '22' => 'Invalid client code, no client code provided',
+        '23' => 'Invalid password, no password provided',
+        '24' => 'Invalid transaction type, no transaction type provided',
+        '25' => 'Invalid amount, amount not provided',
+        '26' => 'Invalid payment code provided',
+        '27' => 'Invalid version number, version not found',
+        '31' => 'Application amount exceeds account balance',
+        '150' => 'Invalid payment information, no payment information provided',
+        '200' => 'Invalid command',
+        '201' => 'Customer not on file',
+        '205' => 'Invalid operator or password',
+        '206' => 'Operator is not authorized for this function',
+        '208' => 'Customer/PIN authentication unsuccessful',
+        '209' => 'Credit card error',
+        '211' => 'Credit card error',
+        '212' => 'Customer/PIN not on file',
+        '213' => 'Customer information not on file',
+        '215' => 'Old PIN does not validate ',
+        '221' => 'Invalid credit card processor type specified in location or payment code',
+        '222' => 'Credit card processor error',
+        '230' => 'Host Error (USE VOID OR REVERSAL TO REFUND UNSETTLED TRANSACTIONS)',
+        '280' => 'SmartPay transaction not posted',
+        '301' => 'Original transaction not found for this customer',
+        '302' => 'Amount to refund exceeds original payment amount or is missing',
+        '304' => 'Original credit card payment not found or corrupted',
+        '305' => 'Refund amounts should be expressed as positive amounts',
+        '306' => 'Original ACH payment not found',
+        '307' => 'Original electronic payment not found',
+        '308' => 'Invalid original transaction number, original transaction number not found',
+        '310' => 'Refund amount exceeds amount still available for a refund',
+        '321' => 'Store has not been implemented',
+        '501' => 'Unable to roll over batch',
+        '502' => 'Batch not found',
+        '503' => 'Batch information not available',
+        '650' => 'Invalid quick code',
+        '651' => 'Transaction amount does not match amount specified in quick code',
+        '652' => 'Invalid item code in the detail of the quick code',
+        '701' => 'This website has been disabled. Please contact the system administrator.',
+        '702' => 'Improper merchant code. Please contact the system administrator.',
+        '703' => 'This site is temporarily down for maintenance. We regret the inconvenience. Please try again later.',
+        '704' => 'Duplicate item violation. Please contact the system administrator.',
+        '705' => 'An invalid reference type has been passed into the system. Please contact the system administrator',
+        '706' => 'Items violating unique selection have been passed in. Please contact the system administrator.',
+        '999' => 'An unexpected error has occurred. Please consult the event log.'
+      }
+    end
+  end
+end

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

@@ -0,0 +1,198 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    # CC5 API is used by many banks in Turkey. Extend this base class to provide
+    # concrete implementations.
+    class CC5Gateway < Gateway
+      self.default_currency = 'TRY'
+
+      CURRENCY_CODES = {
+        'TRY' => 949,
+        'YTL' => 949,
+        'TRL' => 949,
+        'TL'  => 949,
+        'USD' => 840,
+        'EUR' => 978,
+        'GBP' => 826,
+        'JPY' => 392
+      }
+
+      def initialize(options = {})
+        requires!(options, :login, :password, :client_id)
+        super
+      end
+
+      def purchase(money, creditcard, options = {})
+        commit(build_sale_request('Auth', money, creditcard, options))
+      end
+
+      def authorize(money, creditcard, options = {})
+        commit(build_sale_request('PreAuth', money, creditcard, options))
+      end
+
+      def capture(money, authorization, options = {})
+        commit(build_capture_request(money, authorization, options))
+      end
+
+      def void(authorization, options = {})
+        commit(build_void_request(authorization, options))
+      end
+
+      def refund(money, authorization, options = {})
+        commit(build_authorization_credit_request(money, authorization, options))
+      end
+
+      def credit(money, creditcard, options = {})
+        commit(build_creditcard_credit_request(money, creditcard, options))
+      end
+
+      protected
+
+      def build_sale_request(type, money, creditcard, options = {})
+        requires!(options, :order_id)
+
+        xml = Builder::XmlMarkup.new indent: 2
+
+        xml.tag! 'CC5Request' do
+          add_login_tags(xml)
+          xml.tag! 'OrderId', options[:order_id]
+          xml.tag! 'Type', type
+          xml.tag! 'Number', creditcard.number
+          xml.tag! 'Expires', [format(creditcard.month, :two_digits), format(creditcard.year, :two_digits)].join('/')
+          xml.tag! 'Cvv2Val', creditcard.verification_value
+          add_amount_tags(money, options, xml)
+          xml.tag! 'Email', options[:email] if options[:email]
+
+          if (address = (options[:billing_address] || options[:address]))
+            xml.tag! 'BillTo' do
+              add_address(xml, address)
+            end
+            xml.tag! 'ShipTo' do
+              add_address(xml, address)
+            end
+          end
+        end
+
+        xml.target!
+      end
+
+      def build_capture_request(money, authorization, options = {})
+        xml = Builder::XmlMarkup.new indent: 2
+
+        xml.tag! 'CC5Request' do
+          add_login_tags(xml)
+          xml.tag! 'OrderId', authorization
+          xml.tag! 'Type', 'PostAuth'
+          add_amount_tags(money, options, xml)
+        end
+      end
+
+      def build_void_request(authorization, options = {})
+        xml = Builder::XmlMarkup.new indent: 2
+
+        xml.tag! 'CC5Request' do
+          add_login_tags(xml)
+          xml.tag! 'OrderId', authorization
+          xml.tag! 'Type', 'Void'
+        end
+      end
+
+      def build_authorization_credit_request(money, authorization, options = {})
+        xml = Builder::XmlMarkup.new indent: 2
+
+        xml.tag! 'CC5Request' do
+          add_login_tags(xml)
+          xml.tag! 'OrderId', authorization
+          xml.tag! 'Type', 'Credit'
+          add_amount_tags(money, options, xml)
+        end
+      end
+
+      def build_creditcard_credit_request(money, creditcard, options = {})
+        xml = Builder::XmlMarkup.new indent: 2
+
+        xml.tag! 'CC5Request' do
+          add_login_tags(xml)
+          xml.tag! 'Type', 'Credit'
+          xml.tag! 'Number', creditcard.number
+
+          add_amount_tags(money, options, xml)
+        end
+      end
+
+      def add_address(xml, address)
+        xml.tag! 'Name', normalize(address[:name])
+        xml.tag! 'Street1', normalize(address[:address1])
+        xml.tag! 'Street2', normalize(address[:address2]) if address[:address2]
+        xml.tag! 'City', normalize(address[:city])
+        xml.tag! 'PostalCode', address[:zip]
+        xml.tag! 'Country', normalize(address[:country])
+        xml.tag! 'Company', normalize(address[:company])
+        xml.tag! 'TelVoice', address[:phone].to_s.gsub(/[^0-9]/, '') if address[:phone]
+      end
+
+      def add_login_tags(xml)
+        xml.tag! 'Name', @options[:login]
+        xml.tag! 'Password', @options[:password]
+        xml.tag! 'ClientId', @options[:client_id]
+        xml.tag! 'Mode', (test? ? 'T' : 'P')
+      end
+
+      def add_amount_tags(money, options, xml)
+        xml.tag! 'Total', amount(money)
+        xml.tag! 'Currency', currency_code(options[:currency] || currency(money))
+      end
+
+      def currency_code(currency)
+        (CURRENCY_CODES[currency] || CURRENCY_CODES[default_currency])
+      end
+
+      def commit(request)
+        raw_response = ssl_post((test? ? self.test_url : self.live_url), 'DATA=' + request)
+
+        response = parse(raw_response)
+
+        success = success?(response)
+
+        Response.new(
+          success,
+          (success ? 'Approved' : "Declined (Reason: #{response[:proc_return_code]} - #{response[:err_msg]})"),
+          response,
+          test: test?,
+          authorization: response[:order_id]
+        )
+      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
+
+      def success?(response)
+        (response[:response] == 'Approved')
+      end
+
+      def normalize(text)
+        return unless text
+
+        if ActiveSupport::Inflector.method(:transliterate).arity == -2
+          ActiveSupport::Inflector.transliterate(text, '')
+        else
+          text.gsub(/[^\x00-\x7F]+/, '')
+        end
+      end
+    end
+  end
+end