paycertify 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 73394e0bc6f1d06f09f82d27c78190e885e02942
-  data.tar.gz: 1059912be2fe0e25f280d539c2e28a3a72781c2b
+  metadata.gz: e7d46ae5ef73791cdde93a470cf6021b0c56317c
+  data.tar.gz: b8ecdc243b35a74967e187817f8f4f177518b63e
 SHA512:
-  metadata.gz: a4723260c7476caac031a519c7dcdfd6b89ac6676a9303b820e4c97f51d53e27ce5881af5fcb98b77d8c46813f7af7408d698cea578620a042924def88db5630
-  data.tar.gz: 45dde778b7a4bd12f436932a878b14ae1ea077d83636ff58aead9ab984b5b736334dab3e11b4536c63cc9bdc44ab0b9df9820aeb19498d7134799c78c5f12831
+  metadata.gz: df5acf381b3a1f0a80eef90542f4ab79c00128383d5d43b0705c326c6c7deafa8ab9004c7ceec966bef0950963073f8dc1b6e3a104b41a0135c38de5df04228c
+  data.tar.gz: bf269069f26803f15a4d64de3607b7e285bf25dae42f3b17be4f431b582964a0d2276bfe6dd8f0e9d66f489ab15ab6f1d64da4a38e688645b54a43b3ec5dde3a

data/lib/paycertify.rb

@@ -2,5 +2,6 @@ require 'active_support/rails'
 require 'active_support/core_ext'
 
 require 'paycertify/three_ds'
+require 'paycertify/gateway'
 
 module PayCertify; end

data/lib/paycertify/gateway.rb

@@ -0,0 +1,35 @@
+require_relative './gateway/attribute_mapping'
+require_relative './gateway/client'
+require_relative './gateway/response'
+require_relative './gateway/transaction'
+require_relative './gateway/validation'
+
+require 'json'
+
+module PayCertify
+  class Gateway
+
+    attr_accessor :client, :attributes
+
+    delegate :api_key, :mode, to: :class
+
+    def initialize(attributes)
+      self.attributes = attributes
+      self.client = PayCertify::Gateway::Client.new(api_key: api_key, mode: mode)
+    end
+
+
+    def process_transaction!
+      transaction = PayCertify::Gateway::Transaction.new(client, attributes)
+      transaction.process
+    end
+
+    class << self
+      cattr_accessor :api_key, :mode
+
+      def configure(&block)
+        yield self if block_given?
+      end
+    end
+  end
+end

data/lib/paycertify/gateway/attribute_mapping.rb

@@ -0,0 +1,42 @@
+module PayCertify
+  class Gateway
+    module AttributeMapping
+      module_function
+        def wrapper_to_gateway
+          {
+            'Amount' => :amount,
+            'Currency' => :currency,
+            'CardNum' => :card_number,
+            'NameOnCard' => :name_on_card,
+            'CVNum' => :cvv,
+            'InvNum' => :transaction_id,
+            'PNRef' => :transaction_id,
+            'Street' => :billing_address,
+            'City' => :billing_city,
+            'State' => :billing_state,
+            'Zip' => :billing_zip,
+            'Country' => :billing_country,
+            'ShippingStreet' => :billing_address,
+            'ShippingCity' => :billing_city,
+            'ShippingState' => :billing_state,
+            'ShippingZip' => :billing_zip,
+            'ShippingCountry' => :billing_country,
+            'MobilePhone' => :phone,
+            'Email' => :email,
+            'Description' => :order_description,
+            'CustomerID' => :customer_id,
+            'ServerID' => :ip,
+            'ExtData' => :metadata
+          }
+        end
+
+        def expiration_date(transaction)
+          { 'ExpDate' => [transaction.expiration_month, transaction.expiration_year].join }
+        end
+
+        def transaction_type(transaction)
+          { 'TransType' => transaction.type.to_s.capitalize }
+        end
+    end
+  end
+end

data/lib/paycertify/gateway/client.rb

@@ -0,0 +1,55 @@
+require 'faraday'
+
+module PayCertify
+  class Gateway
+    class Client
+
+      attr_accessor :api_key, :mode, :response
+
+      def initialize(api_key:, mode:)
+        self.api_key = api_key
+        self.mode = mode.to_s.to_sym
+      end
+
+      def live?
+        mode.to_sym == :live
+      end
+
+      def api_endpoint
+        @api_endpoint ||= 'https://'+ (live?? 'gateway' : 'demo') +'.paycertify.net'
+      end
+
+      def post(path:, data:)
+        body = data.merge('ApiToken' => api_key)
+
+        response = connection.post do |request|
+          request.url path
+          request.body = body
+        end
+
+        respond_with response
+      end
+
+      def success?
+        response.status < 400
+      end
+
+      def error?
+        !success?
+      end
+
+      private
+        def connection
+          @connection ||= Faraday.new(url: api_endpoint, ssl: {verify: false}) do |faraday|
+            faraday.request :url_encoded
+            faraday.response :logger
+            faraday.adapter  Faraday.default_adapter
+          end
+        end
+
+        def respond_with(response)
+          self.response = PayCertify::Gateway::Response.new(response)
+        end
+    end
+  end
+end

data/lib/paycertify/gateway/response.rb

@@ -0,0 +1,31 @@
+module PayCertify
+  class Gateway
+    class Response < HashWithIndifferentAccess
+
+      APPROVED = '0'.freeze
+
+      attr_accessor :status, :original_body
+      
+      def initialize(response)
+        self.status = response.status
+        self.original_body = Hash.from_xml(response.body)['Response']
+
+        super(
+          id: original_body['PNRef'],
+          status: response.status,
+          status_string: original_body['Result'] == APPROVED ? 'approved' : 'declined',
+          message: [original_body['Message'], original_body['Message1'], original_body['Message2']].compact.join(' / '),
+          amount: original_body['Amount'].to_d,
+          auth_code: original_body['AuthCode'],
+          payment_type: original_body['PaymentType'],
+          card_number: original_body['Account'],
+          created_at: DateTime.strptime([original_body['TransDate'], original_body['TransTime']].join, '%m%d%Y%H%M%s')
+        )
+      end
+
+      def success?
+        self['status_string'] == 'approved'
+      end
+    end
+  end
+end

data/lib/paycertify/gateway/transaction.rb

@@ -0,0 +1,54 @@
+module PayCertify
+  class Gateway
+    class Transaction
+
+      TRANSACTION_PATH = '/ws/encgateway2.asmx/ProcessCreditCard'
+
+      attr_accessor :client, :original_attributes
+
+      attr_accessor :type, :amount, :currency, :card_number, :expiration_month, :expiration_year, 
+        :name_on_card, :cvv, :transaction_id, :billing_address, :billing_city, :billing_state, :billing_country, :billing_zip,
+        :shipping_address, :shipping_city, :shipping_state, :shipping_country, 
+        :shipping_zip, :email, :phone, :ip, :order_description, :customer_id, :metadata
+
+      def initialize(client, attributes)
+        self.original_attributes = attributes
+        self.client = client
+
+        validation.attributes.each do |key, value|
+          self.send("#{key}=", value)
+        end
+      end
+
+      def validation
+        @validation ||= PayCertify::Gateway::Validation.new(original_attributes)
+      end
+
+      def process
+        client.post(
+          path: TRANSACTION_PATH,
+          data: attributes_to_gateway_format
+        )
+      end
+
+      private
+        def attributes_to_gateway_format
+          {}.tap do |formatted|
+            attribute_mapping = PayCertify::Gateway::AttributeMapping
+
+            attribute_mapping.wrapper_to_gateway.each do |key, value|
+              [value].flatten.tap do |method_chain|
+                new_value = method_chain.map { |method_name| self.send(method_name) }.join
+                formatted[key] = new_value
+              end
+            end
+
+            formatted.merge! attribute_mapping.expiration_date(self)
+            formatted.merge! attribute_mapping.transaction_type(self)
+
+            formatted
+          end
+        end
+    end
+  end
+end

data/lib/paycertify/gateway/validation.rb

@@ -0,0 +1,174 @@
+require 'ipaddr'
+
+module PayCertify
+  class Gateway
+    class Validation
+
+      ATTRIBUTES = [
+        # Mandatory fields
+        { name: :type, validation: :type_validation, required: true },
+        { name: :amount, validation: :amount_validation, required: true },
+        { name: :currency, validation: :currency_validation, required: true },
+        { name: :card_number, validation: :card_number_validation, required: true },
+        { name: :expiration_month, validation: :expiration_month_validation, required: true },
+        { name: :expiration_year, validation: :expiration_year_validation, required: true },
+        { name: :name_on_card, validation: :no_validation, required: true },
+        { name: :cvv, validation: :no_validation, required: true },
+        { name: :transaction_id, validation: :no_validation, required: true },
+        { name: :billing_city, validation: :no_validation, required: true },
+        { name: :billing_state, validation: :no_validation, required: true },
+        { name: :billing_country, validation: :no_validation, required: true },
+        { name: :billing_zip, validation: :zip_validation, required: true },
+        
+        # Optional fields
+        { name: :billing_address, validation: :no_validation, required: false },
+        { name: :shipping_address, validation: :no_validation, required: false },
+        { name: :shipping_city, validation: :no_validation, required: false },
+        { name: :shipping_state, validation: :no_validation, required: false },
+        { name: :shipping_country, validation: :no_validation, required: false },
+        { name: :shipping_zip, validation: :zip_validation, required: false },
+        { name: :email, validation: :email_validation, required: false },
+        { name: :phone, validation: :no_validation, required: false },
+        { name: :ip, validation: :ip_validation, required: false },
+        { name: :order_description, validation: :no_validation, required: false },
+        { name: :customer_id, validation: :no_validation, required: false },
+        { name: :metadata, validation: :no_validation, required: false }
+      ]
+
+      ALLOWED_TYPES = %w(sale auth refund void force recurring)
+      ALLOWED_CURRENCIES = %w(USD EUR)
+      CREDIT_CARD_REGEX = /^(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|6(?:011|5[0-9][0-9])[0-9]{12}|3[47][0-9]{13}|3(?:0[0-5]|[68][0-9])[0-9]{11}|(?:2131|1800|35\d{3})\d{11})$/i
+      EMAIL_REGEX = /\A([\w+\-].?)+@[a-z\d\-]+(\.[a-z]+)*\.[a-z]+\z/i
+
+      class ValidationError < StandardError; end
+
+      attr_accessor :attributes, :errors
+
+      def initialize(attributes={})
+        self.attributes = attributes
+
+        ATTRIBUTES.each do |attribute|
+          presence_validation(attribute) if attribute[:required]
+          send(attribute[:validation], attribute) if value_for(attribute).present?
+        end
+      end
+
+      protected
+        def presence_validation(attribute)
+          if value_for(attribute).blank?
+            raise ValidationError, "Required attribute not present: #{attribute[:name]}."
+          end
+        end
+
+        def no_validation(_); end
+
+        def type_validation(attribute)
+          unless value_for(attribute).try(:to_s).in?(ALLOWED_TYPES)
+            raise ValidationError, error_message(attribute, "Must be one of #{ALLOWED_TYPES.join(', ')}")
+          end
+        end
+
+        def amount_validation(attribute)
+          set_attribute(attribute, Float(value_for(attribute)))
+        rescue ArgumentError
+          raise ValidationError, error_message(attribute, "Must be a float, integer or decimal")
+        end
+
+        def currency_validation(attribute)
+          set_attribute(attribute, value_for(attribute).upcase)
+
+          unless value_for(attribute).try(:to_s).in?(ALLOWED_CURRENCIES)
+            raise ValidationError, error_message(attribute, "Must be one of #{ALLOWED_CURRENCIES.join(', ')}")
+          end
+        end
+
+        def card_number_validation(attribute)
+          # Non decimal numbers should be stripped to match.
+          set_attribute(attribute, value_for(attribute).gsub(/\D/, ''))
+
+          unless value_for(attribute) =~ CREDIT_CARD_REGEX
+            raise ValidationError, error_message(attribute, "Doesn't validate as a credit card.")
+          end
+        end
+
+        def zip_validation
+          # Check if it's a number
+          set_attribute(attribute, Integer(value_for(attribute)).to_s)
+
+          if value_for(attribute).length > 5
+            # Raise validation error
+          end
+        end
+
+        def expiration_month_validation(attribute)
+          # if a string, check if length = 2 and smaller than int 12
+          # if int, transform into string with zero pad and check if smaller than int 12
+          integer = Integer(value_for(attribute))
+
+          if integer > 12
+            raise ValidationError, error_message(attribute, "Must be smaller than 12.")
+          end
+
+          set_attribute(attribute, integer.to_s.rjust(2, '0'))
+          
+        rescue ArgumentError
+          raise ValidationError, error_message(attribute, "Must be an integer.")
+        end
+
+        def expiration_year_validation(attribute)
+          # if length = 4, strip to 2;
+          # if a string, check if length = 2 and smaller than int 12
+          # if int, transform into string with zero pad and check if smaller than int 12
+
+
+          is_four_digit = if value_for(attribute).is_a?(String)
+            value_for(attribute).length == 4
+          else
+            value_for(attribute) > 999
+          end
+
+          integer_value = Integer(value_for(attribute))
+
+          set_attribute(attribute, integer_value.to_s.last(2))
+        rescue
+          raise ValidationError, error_message(attribute, "Must be a 2 to 4-digit string.")
+        end
+
+        def zip_validation(attribute)
+          set_attribute(attribute, Integer(value_for(attribute)).to_s)
+
+          unless value_for(attribute).length == 5
+            raise ValidationError, error_message(attribute, "Must be a 5-digit string that can evaluate to a number.")
+          end
+
+        rescue
+          raise ValidationError, error_message(attribute, "Must be a 5-digit string that can evaluate to a number.")
+        end
+
+        def email_validation(attribute)
+          unless value_for(attribute) =~ EMAIL_REGEX
+            raise ValidationError, error_message(attribute, "Doesn't validate as an email.")
+          end
+        end
+
+        def ip_validation(attribute)
+          IPAddr.new(value_for(attribute))
+        rescue IPAddr::InvalidAddressError
+          raise ValidationError, error_message(attribute, "Doesn't validate as an IP.")
+        end
+
+      private
+        def value_for(attribute)
+          attributes[attribute[:name]]
+        end
+
+        def set_attribute(attribute, value)
+          self.attributes[attribute[:name]] = value
+        end
+
+        def error_message(attribute, message)
+          "Attribute #{attribute[:name]} passed as: #{value_for(attribute)}. #{message}"
+        end
+    end
+  end
+end

data/lib/paycertify/three_ds/callback.rb

@@ -1,5 +1,3 @@
-require 'faraday'
-
 module PayCertify
   class ThreeDS
     class Callback < HashWithIndifferentAccess

data/lib/paycertify/three_ds/client.rb

@@ -66,10 +66,6 @@ module PayCertify
         end
 
         def respond_with(response)
-          3.times{puts}
-          puts 'Response -----'
-          p response.body
-          10.times{puts}
           self.response = response
           JSON.parse(response.body)
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paycertify
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - PayCertify Engineering Team
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.11.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.11.0
 description: Interact with the Gateway, 3DS, Kount, and FraudPortal
 email: engineering@paycertify.com
 executables: []
@@ -45,6 +45,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/paycertify.rb
+- lib/paycertify/gateway.rb
+- lib/paycertify/gateway/attribute_mapping.rb
+- lib/paycertify/gateway/client.rb
+- lib/paycertify/gateway/response.rb
+- lib/paycertify/gateway/transaction.rb
+- lib/paycertify/gateway/validation.rb
 - lib/paycertify/three_ds.rb
 - lib/paycertify/three_ds/callback.rb
 - lib/paycertify/three_ds/client.rb