start_activemerchant 1.50.0

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

@@ -0,0 +1,262 @@
+require "nokogiri"
+
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class CenposGateway < Gateway
+      self.display_name = "CenPOS"
+      self.homepage_url = "https://www.cenpos.com/"
+
+      self.live_url = "https://ww3.cenpos.net/6/transact.asmx"
+
+      self.supported_countries = %w(AD AI AG AR AU AT BS BB BE BZ BM BR BN BG CA HR CY CZ DK DM EE FI FR DE GR GD GY HK HU IS IN IL IT JP LV LI LT LU MY MT MX MC MS NL PA PL PT KN LC MF VC SM SG SK SI ZA ES SR SE CH TR GB US UY)
+      self.default_currency = "USD"
+      self.money_format = :dollars
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+
+      def initialize(options={})
+        requires!(options, :merchant_id, :password, :user_id)
+        super
+      end
+
+      def purchase(amount, payment_method, options={})
+        post = {}
+        add_invoice(post, amount, options)
+        add_payment_method(post, payment_method)
+        add_customer_data(post, options)
+
+        commit("Sale", post)
+      end
+
+      def authorize(amount, payment_method, options={})
+        post = {}
+        add_invoice(post, amount, options)
+        add_payment_method(post, payment_method)
+        add_customer_data(post, options)
+
+        commit("Auth", post)
+      end
+
+      def capture(amount, authorization, options={})
+        post = {}
+        add_invoice(post, amount, options)
+        add_reference(post, authorization)
+        add_customer_data(post, options)
+
+        commit("SpecialForce", post)
+      end
+
+      def void(authorization, options={})
+        post = {}
+        add_void_required_elements(post)
+        add_reference(post, authorization)
+        add_remembered_amount(post, authorization)
+        add_tax(post, options)
+
+        commit("Void", post)
+      end
+
+      def refund(amount, authorization, options={})
+        post = {}
+        add_invoice(post, amount, options)
+        add_reference(post, authorization)
+        add_customer_data(post, options)
+
+        commit("SpecialReturn", post)
+      end
+
+      def credit(amount, payment_method, options={})
+        post = {}
+        add_invoice(post, amount, options)
+        add_payment_method(post, payment_method)
+
+        commit("Credit", post)
+      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
+
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r((<acr1:CardNumber>)[^<]+(<))i, '\1[FILTERED]\2').
+          gsub(%r((<acr1:CardVerificationNumber>)[^<]+(<))i, '\1[FILTERED]\2').
+          gsub(%r((<acr:Password>)[^<]+(<))i, '\1[FILTERED]\2')
+      end
+
+      private
+
+      def add_invoice(post, money, options)
+        post[:Amount] = amount(money)
+        post[:CurrencyCode] = options[:currency] || currency(money)
+        post[:InvoiceNumber] = options[:order_id]
+        post[:InvoiceDetail] = options[:invoice_detail] if options[:invoice_detail]
+        post[:CustomerCode] = options[:customer_code] if options[:customer_code]
+        add_tax(post, options)
+      end
+
+      def add_payment_method(post, payment_method)
+        post[:NameOnCard] = payment_method.name
+        post[:CardNumber] = payment_method.number
+        post[:CardVerificationNumber] = payment_method.verification_value
+        post[:CardExpirationDate] = format(payment_method.month, :two_digits) + format(payment_method.year, :two_digits)
+        post[:CardLastFourDigits] = payment_method.last_digits
+        post[:MagneticData] = payment_method.track_data if payment_method.track_data
+      end
+
+      def add_customer_data(post, options)
+        if(billing_address = (options[:billing_address] || options[:address]))
+          post[:CustomerEmailAddress] = billing_address[:email]
+          post[:CustomerPhone] = billing_address[:phone]
+          post[:CustomerBillingAddress] = billing_address[:address1]
+          post[:CustomerCity] = billing_address[:city]
+          post[:CustomerState] = billing_address[:state]
+          post[:CustomerZipCode] = billing_address[:zip]
+        end
+      end
+
+      def add_void_required_elements(post)
+        post[:GeoLocationInformation] = nil
+        post[:IMEI] = nil
+      end
+
+      def add_tax(post, options)
+        post[:TaxAmount] = amount(options[:tax] || 0)
+      end
+
+      def add_reference(post, authorization)
+        reference_number, last_four_digits = split_authorization(authorization)
+        post[:ReferenceNumber] = reference_number
+        post[:CardLastFourDigits] = last_four_digits
+      end
+
+      def add_remembered_amount(post, authorization)
+        post[:Amount] = split_authorization(authorization).last
+      end
+
+      def commit(action, post)
+        post[:MerchantId] = @options[:merchant_id]
+        post[:Password] = @options[:password]
+        post[:UserId] = @options[:user_id]
+        post[:TransactionType] = action
+
+        data = build_request(post)
+        begin
+          raw = parse(ssl_post(self.live_url, data, headers))
+        rescue ActiveMerchant::ResponseError => e
+          if(e.response.code == "500" && e.response.body.start_with?("<s:Envelope"))
+            raw = {
+              message: "See transcript for detailed error description."
+            }
+          else
+            raise
+          end
+        end
+
+        succeeded = success_from(raw[:result])
+        Response.new(
+          succeeded,
+          message_from(succeeded, raw),
+          raw,
+          authorization: authorization_from(post, raw),
+          error_code: error_code_from(succeeded, raw),
+          test: test?
+        )
+      end
+
+      def headers
+        {
+          "Accept-Encoding" => "gzip,deflate",
+          "Content-Type"  => "text/xml;charset=UTF-8",
+          "SOAPAction"  => "http://tempuri.org/Transactional/ProcessCreditCard"
+        }
+      end
+
+      def build_request(post)
+        xml = Builder::XmlMarkup.new :indent => 8
+        xml.tag!("acr:MerchantId", post.delete(:MerchantId))
+        xml.tag!("acr:Password", post.delete(:Password))
+        xml.tag!("acr:UserId", post.delete(:UserId))
+        post.sort.each do |field, value|
+          xml.tag!("acr1:#{field}", value)
+        end
+        envelope(xml.target!)
+      end
+
+      def envelope(body)
+        <<-EOS
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:acr="http://schemas.datacontract.org/2004/07/Acriter.ABI.CenPOS.EPayment.VirtualTerminal.Common" xmlns:acr1="http://schemas.datacontract.org/2004/07/Acriter.ABI.CenPOS.EPayment.VirtualTerminal.v6.Common" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<soapenv:Header/>
+   <soapenv:Body>
+      <tem:ProcessCreditCard>
+         <tem:request>
+           #{body}
+         </tem:request>
+      </tem:ProcessCreditCard>
+   </soapenv:Body>
+</soapenv:Envelope>
+        EOS
+      end
+
+      def parse(xml)
+        response = {}
+
+        doc = Nokogiri::XML(xml)
+        doc.remove_namespaces!
+        body = doc.xpath("//ProcessCreditCardResult")
+        body.children.each do |node|
+          if (node.elements.size == 0)
+            response[node.name.underscore.to_sym] = node.text
+          else
+            node.elements.each do |childnode|
+              name = "#{node.name.underscore}_#{childnode.name.underscore}"
+              response[name.to_sym] = childnode.text
+            end
+          end
+        end unless doc.root.nil?
+
+        response
+      end
+
+      def success_from(response)
+        response == "0"
+      end
+
+      def message_from(succeeded, response)
+        if succeeded
+          "Succeeded"
+        else
+          response[:message] || "Unable to read error message"
+        end
+      end
+
+      STANDARD_ERROR_CODE_MAPPING = {
+        "211" => STANDARD_ERROR_CODE[:invalid_number],
+        "252" => STANDARD_ERROR_CODE[:invalid_expiry_date],
+        "257" => STANDARD_ERROR_CODE[:invalid_cvc],
+        "333" => STANDARD_ERROR_CODE[:expired_card],
+        "1" => STANDARD_ERROR_CODE[:card_declined],
+        "99" => STANDARD_ERROR_CODE[:processing_error],
+      }
+
+      def authorization_from(request, response)
+        [ response[:reference_number], request[:CardLastFourDigits], request[:Amount] ].join("|")
+      end
+
+      def split_authorization(authorization)
+        reference_number, last_four_digits, original_amount = authorization.split("|")
+        [reference_number, last_four_digits, original_amount]
+      end
+
+      def error_code_from(succeeded, response)
+        succeeded ? nil : STANDARD_ERROR_CODE_MAPPING[response[:result]]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,278 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class CertoDirectGateway < Gateway
+      self.live_url = self.test_url = "https://secure.certodirect.com/gateway/process/v2"
+
+      self.supported_countries = [
+        "BE", "BG", "CZ", "DK", "DE", "EE", "IE", "ES", "FR",
+        "IT", "CY", "LV", "LT", "LU", "HU", "MT", "NL", "AT", "PL",
+        "PT", "RO", "SI", "SK", "FI", "SE", "GB"
+      ]
+
+      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)
+        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={})
+        ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE
+
+        commit(build_recurring_request(identification, options))
+      end
+
+      private
+
+      def commit(request_xml)
+        begin
+          response = Hash.from_xml(ssl_post(self.live_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.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