cardflex-ruby 0.0.1

data/lib/cardflex/http.rb

@@ -0,0 +1,68 @@
+module Cardflex
+  class Http
+    attr_reader :config
+
+    def initialize(config)
+      @config = config
+    end
+
+    def post(params={})
+      params = _add_api_key(params)
+      response = _do_http(Net::HTTP::Post, Xml.hash_to_xml(params))
+      Xml.parse(response.body)
+    end
+
+    def _do_http(http_verb, body=nil)
+      connection = Net::HTTP.new(@config.server, @config.port)
+      connection.open_timeout = 60
+      connection.read_timeout = 60
+      if @config.ssl?
+        connection.use_ssl = true
+        connection.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        connection.ca_file = @config.ca_file
+        connection.verify_callback = proc { |preverify_ok, ssl_context| _verify_ssl_certificate(preverify_ok, ssl_context) }
+      end
+
+      connection.start do |http|
+        request = http_verb.new("#{@config.three_step_path}")
+        request['Accept'] = 'text/xml'
+        @config.logger.debug("[Cardflex] [#{_current_time}] #{request.method} as text/xml")
+        if body
+          request['Content-Type'] = 'text/xml'
+          request.body = body
+          @config.logger.debug _format_body_for_log(body)
+        end
+
+        response = http.request(request)
+        @config.logger.info "[Cardflex] [#{_current_time}] #{request.method} #{response.code}"
+        @config.logger.debug _format_body_for_log(response.body)
+        response
+      end
+    rescue OpenSSL::SSL::SSLError
+      raise Cardflex::SSLCertificateError
+    end
+
+    def _current_time
+      Time.now.utc.strftime("%d/%b/%Y %H:%M:%S %Z")
+    end
+
+    def _verify_ssl_certificate(preverify_ok, ssl_context)
+      if preverify_ok != true || ssl_context.error != 0
+        err_msg = "SSL Verification failed -- Preverify: #{preverify_ok}, Error: #{ssl_context.error_string} (#{ssl_context.error})"
+        @config.logger.error err_msg
+        false
+      else
+        true
+      end
+    end
+
+    def _add_api_key(params)
+      key = params.keys[0]
+      { key => params[key].merge(:api_key => @config.api_key) }
+    end
+
+    def _format_body_for_log(body)
+      body.gsub(/^/, "[Cardflex] ")
+    end
+  end
+end

data/lib/cardflex/plan.rb

@@ -0,0 +1,22 @@
+module Cardflex
+  class Plan
+    include BaseModule
+
+    module Type
+      Add = 'add_plan'
+    end
+
+    attr_reader :result, :result_text, :result_code, :action_type
+    attr_reader :plan
+
+    def initialize(gateway, attributes)
+      @gateway = gateway
+      @type = attributes[:action_type]
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def self.create(attributes)
+      Configuration.gateway.plan.request(:add_plan => attributes)
+    end
+  end
+end

data/lib/cardflex/plan_gateway.rb

@@ -0,0 +1,23 @@
+module Cardflex
+  class PlanGateway
+    attr_reader :config
+
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+    end
+
+    def request(attributes)
+       res = config.http.post(attributes)
+      _handle_response(res)
+    end
+
+    def _handle_response(res)
+      if res[:response][:result] == '1'
+        SuccessResponse.new(:plan => Plan.new(@gateway, res[:response]))
+      else
+        ErrorResponse.new(@gatway, res[:response])
+      end
+    end
+  end
+end

data/lib/cardflex/subscription.rb

@@ -0,0 +1,24 @@
+module Cardflex
+  class Subscription
+    include BaseModule
+
+    module Type
+      Delete = 'delete_subscription'
+    end
+
+    attr_reader :result, :result_text, :result_code, :action_type
+    attr_reader :subscription_id
+    attr_reader :type, :plan, :billing, :shipping
+
+    def initialize(gateway, attributes)
+      @gateway = gateway
+      @type = attributes[:action_type]
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def self.delete(subscription_id)
+      attributes = { :delete_subscription => { :subscription_id => subscription_id }}
+      Configuration.gateway.subscription.request(attributes)
+    end
+  end
+end

data/lib/cardflex/subscription_gateway.rb

@@ -0,0 +1,22 @@
+module Cardflex
+  class SubscriptionGateway
+    attr_reader :config
+
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+    end
+
+    def request(attributes)
+      @config.http.post(attributes)
+    end
+
+    def _handle_response(res)
+      if res[:response][:result] == '1'
+        SuccessResponse.new(:subscription => Subscription.new(@gateway, res[:response]))
+      else
+        ErrorResponse.new(@gateway, res[:response])
+      end
+    end
+  end
+end

data/lib/cardflex/success_response.rb

@@ -0,0 +1,15 @@
+module Cardflex
+  class SuccessResponse
+    include BaseModule
+
+    attr_reader :transaction, :three_step, :plan, :subscription, :customer_vault
+
+    def initialize(hash={})
+      set_instance_variables_from_hash(hash)
+    end
+
+    def success?
+      true
+    end
+  end
+end

data/lib/cardflex/test/test_values.rb

@@ -0,0 +1,26 @@
+module Cardflex
+  module Test
+    module Cards
+      Visa = "4111111111111111"
+      MasterCard = "5431111111111111"
+      Discover = "6011601160116611"
+      AmEx = "341111111111111"
+      ACHAccount = "123123123"
+      ACHRouting = "123123123"
+
+      Expiration = "10/25"
+
+      # Failures
+      Declined = "100"
+      CVVMatch = "999"
+
+      AVSMatchAddress1 = "888"
+      AVSMatchZip = "77777"
+    end
+
+    module Charges
+      Accepted = "1.50"
+      Declined = "0.50"
+    end
+  end
+end

data/lib/cardflex/three_step.rb

@@ -0,0 +1,42 @@
+module Cardflex
+  class ThreeStep
+    include BaseModule
+
+    module Type
+      Sale = 'sale'
+      Auth = 'auth'
+      Credit = 'credit'
+      Validate = 'validate'
+      Offline = 'offline'
+      AddSubscription = 'add_subscription'
+      UpdateSubscription = 'update_subscription'
+      AddCustomer = 'add_customer'
+      UpdateCustomer = 'update_customer'
+      AddBilling = 'add_billing'
+      UpdateBilling = 'update_billing'
+    end
+
+    attr_reader :config
+    attr_reader :form_url
+    attr_reader :transaction_id
+    attr_reader :result, :result_text, :result_code
+
+    def initialize(gateway, attributes={})
+      @gateway = gateway
+      @config = gateway.config
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def self.get_form_url(attributes)
+      Configuration.gateway.three_step.get_form_url(attributes)
+    end
+
+    def self.complete(token_id)
+      Configuration.gateway.three_step.complete(token_id)
+    end
+
+    create_helper_methods(Type) do |attributes|
+      get_form_url(attributes)
+    end
+  end
+end

data/lib/cardflex/three_step_gateway.rb

@@ -0,0 +1,41 @@
+module Cardflex
+  class ThreeStepGateway
+    attr_reader :config
+
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+    end
+
+    def get_form_url(attributes)
+      root = attributes.keys[0]
+      raise ArgumentError, 'missing :redirect_url' unless attributes[root][:redirect_url]
+
+      res = @config.http.post(attributes)
+      _handle_intermediate_response(res)
+    end
+
+    def complete(token_id)
+      raise ArgumentError, 'you must provide a token_id' unless token_id
+
+      res = @config.http.post(:complete_action => { :token_id => token_id })
+      _handle_response(res)
+    end
+
+    def _handle_response(res)
+      if res[:response][:result] == '1'
+        SuccessResponse.new(:transaction => Transaction.new(@gateway, res[:response]))
+      else
+        ErrorResponse.new(@gateway, res[:response])
+      end
+    end
+
+    def _handle_intermediate_response(res)
+      if res[:response][:result] == '1'
+        SuccessResponse.new(:three_step => ThreeStep.new(@gateway, res[:response]))
+      else
+        ErrorResponse.new(@gateway, res[:response])
+      end
+    end
+  end
+end

data/lib/cardflex/transaction.rb

@@ -0,0 +1,52 @@
+module Cardflex
+  class Transaction
+    include BaseModule
+
+    module Type
+      Capture = 'capture'
+      Void = 'void'
+      Refund = 'refund'
+    end
+
+    attr_reader :result, :result_code, :result_text, :authorization_code
+    attr_reader :avs_result, :cvv_result, :avs_reject, :cvv_reject
+    attr_reader :amount, :currency
+    attr_reader :ip_address
+    attr_reader :industry
+    attr_reader :billing_method
+    attr_reader :processor_id
+    attr_reader :sec_code
+    attr_reader :descriptor, :descriptor_phone, :descriptor_address, :descriptor_city, :descriptor_state,
+      :descriptor_postal, :descriptor_country, :descriptor_mcc, :descriptor_merchant_id, :descriptor_url
+    attr_reader :order_description, :order_date
+    attr_reader :customer_id, :customer_vault_id
+    attr_reader :merchant_receipt_email
+    attr_reader :customer_receipt
+    attr_reader :tracking_number, :shipping_carrier, :shipping_amount, :ship_from_postal
+    attr_reader :po_number, :order_id
+    attr_reader :tax_amount, :duty_amount, :national_tax_amount, :alternate_tax_amount, :alternate_tax_id
+    attr_reader :vat_tax_amount, :vat_tax_rate, :vat_invoice_reference_number, :customer_vat_registration,
+      :merchant_vat_registration
+    attr_reader :summary_commodity_code
+    attr_reader :discount_amount
+    attr_reader :cardholder_auth
+    attr_reader :eci
+    attr_reader :cavv, :xid
+    attr_reader :dup_seconds
+    attr_reader :type, :action_type, :transaction_id, :billing, :plan, :shipping, :product
+
+    def initialize(gateway, attributes)
+      @gateway = gateway
+      @type = attributes[:action_type]
+      set_instance_variables_from_hash(attributes)
+    end
+
+    def self.request(attributes)
+      Configuration.gateway.transaction.request(attributes)
+    end
+
+    create_helper_methods(Type) do |attributes|
+      request(attributes)
+    end
+  end
+end

data/lib/cardflex/transaction_gateway.rb

@@ -0,0 +1,23 @@
+module Cardflex
+  class TransactionGateway
+    attr_reader :config
+
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+    end
+
+    def request(attributes)
+      res = @config.http.post(attributes)
+      _handle_response(res)
+    end
+
+    def _handle_response(res)
+      if res[:response][:result] == '1'
+        SuccessResponse.new(:transaction => Transaction.new(@gateway, res[:response]))
+      else
+        ErrorResponse.new(@gateway, res[:response])
+      end
+    end
+  end
+end

data/lib/cardflex/version.rb

@@ -0,0 +1,9 @@
+module Cardflex
+  module Version
+    Major = '0'
+    Minor = '0'
+    Tiny = '1'
+
+    Full = "#{Major}.#{Minor}.#{Tiny}"
+  end
+end

data/lib/cardflex/xml.rb

@@ -0,0 +1,11 @@
+module Cardflex
+  module Xml
+    def self.parse(xml)
+      Parser.xml_to_hash(xml)
+    end
+
+    def self.hash_to_xml(hash)
+      Serializer.hash_to_xml(hash)
+    end
+  end
+end

data/lib/cardflex/xml/parser.rb

@@ -0,0 +1,48 @@
+module Cardflex
+  module Xml
+    module Parser
+      require 'rexml/document' unless defined? REXML::Document
+
+      def self.xml_to_hash(xml)
+        return {} if xml.nil?
+
+        document = REXML::Document.new(xml)
+        { _snakecase(document.root.name) => _parse_children(document.root) }
+      end
+
+      def self._parse_children(elem)
+        if elem.has_elements?
+          children = {}
+          elem.each_element do |child|
+            children[_snakecase(child.name)] = _parse_children(child)
+          end
+          children
+        else
+          elem.text
+        end
+      end
+
+      def self._snakecase(key)
+        key.tr('-', '_').to_sym
+      end
+
+      def self.parse(string)
+        return {} if string.nil?
+
+        doc = REXML::Document.new(string)
+        { _snakecase(doc.root.name).to_sym => _to_hash({}, doc.root) }
+      end
+
+      def self._to_hash(hash, element)
+        if element.has_elements?
+          element.each_element do |child|
+            hash[_snakecase(child.name).to_sym] = child.text
+          end
+        end
+
+        hash
+      end
+
+    end
+  end
+end