cardconnect 1.0.0

data/lib/cardconnect/configuration.rb

@@ -0,0 +1,13 @@
+module CardConnect
+  class Configuration
+
+    # Attributes that need to be passed in from the user
+    attr_accessor :merchant_id
+    attr_accessor :api_username
+    attr_accessor :api_password
+    attr_accessor :endpoint
+
+    def initialize
+    end
+  end
+end

data/lib/cardconnect/connection.rb

@@ -0,0 +1,35 @@
+require 'faraday'
+require 'faraday_middleware'
+
+module CardConnect
+  class Connection
+
+    def initialize
+      @config = CardConnect.configuration
+      @headers = {user_agent: "CardConnectRubyGem/#{CardConnect::VERSION}"}
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: @config.endpoint, headers: @headers, ssl: {verify: false}) do |faraday|
+        faraday.request :basic_auth, @config.api_username, @config.api_password
+        faraday.request :json
+
+        faraday.response :json, :content_type => /\bjson$/
+        faraday.response :raise_error
+
+        faraday.adapter Faraday.default_adapter
+      end
+    end
+
+    def ping_server
+      begin
+        connection.get('/cardconnect/rest/')
+      rescue Faraday::ResourceNotFound => e
+        return e
+      rescue Faraday::ClientError => e
+        return e
+      end
+    end
+
+  end
+end

data/lib/cardconnect/error.rb

@@ -0,0 +1,3 @@
+module CardConnect
+  class Error < StandardError; end
+end

data/lib/cardconnect/services/authorization/authorization.rb

@@ -0,0 +1,17 @@
+module CardConnect
+  module Service
+    class Authorization < ServiceEndpoint
+
+      # Initializes an Authorization Service
+      #
+      # @param connection [CardConnect::Connection]
+      # @return CardConnect::Service::Authorization
+      def initialize(connection = CardConnect.connection)
+        super(connection)
+        @resource_name = '/auth'
+        @rest_method = 'put'
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/authorization/authorization_request.rb

@@ -0,0 +1,51 @@
+module CardConnect
+  module Service
+    class AuthorizationRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :account, :expiry, :amount, :currency]
+
+      OPTIONAL_FIELDS = [:accttype, :name, :address, :city, :region, :country, :phone,
+                         :postal, :email, :ecomind, :cvv2, :orderid, :track, :bankaba,
+                         :tokenize, :termid, :capture, :ssnl4, :license, :profile, :userfields]
+
+      FIELDS = REQUIRED_FIELDS + OPTIONAL_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Authorization Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::AuthorizationRequest
+      def initialize(attrs = {})
+        @errors = []
+        set_attributes(attrs, FIELDS)
+        validate_required_fields
+      end
+
+      # Indicates that the request is valid once it is built.
+      def valid?
+        errors.empty?
+      end
+
+      # Builds the request payload
+      def payload
+        payload = {}
+        FIELDS.each do |field|
+          payload.merge!({field => send(field)})
+        end
+        payload
+      end
+
+      private
+
+      def validate_required_fields
+        REQUIRED_FIELDS.each do |field|
+          value = send(field)
+          value.nil? || value.empty? ? errors.push("#{field.capitalize} is missing") : next
+        end
+      end
+    end
+  end
+end

data/lib/cardconnect/services/authorization/authorization_response.rb

@@ -0,0 +1,41 @@
+module CardConnect
+  module Service
+    class AuthorizationResponse
+      include Utils
+
+      FIELDS = [:respstat, :retref, :account, :token, :amount, :merchid, :respcode,
+                :resptext, :respproc, :avsresp, :cvvresp, :authcode, :commcard]
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      STATUS_APPROVED = 'A'
+      STATUS_RETRY = 'B'
+      STATUS_DECLINED = 'C'
+
+      def initialize(response)
+        set_attributes(response, FIELDS)
+        @errors = []
+        process_errors
+      end
+
+      def success?
+        errors.empty?
+      end
+
+      def body
+        body = {}
+        FIELDS.each do |attr|
+          body.merge!({attr => send(attr)})
+        end
+        body
+      end
+
+      private
+
+      def process_errors
+        @errors << resptext if [STATUS_RETRY, STATUS_DECLINED].include?(respstat)
+      end
+    end
+  end
+end

data/lib/cardconnect/services/capture/capture.rb

@@ -0,0 +1,17 @@
+module CardConnect
+  module Service
+    class Capture < ServiceEndpoint
+
+      # Initializes a Capture Service
+      #
+      # @param connection [CardConnect::Connection]
+      # @return CardConnect::Service::Capture
+      def initialize(connection = CardConnect.connection)
+        super(connection)
+        @resource_name = '/capture'
+        @rest_method = 'put'
+      end
+      
+    end
+  end
+end

data/lib/cardconnect/services/capture/capture_request.rb

@@ -0,0 +1,50 @@
+module CardConnect
+  module Service
+    class CaptureRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :retref]
+
+      OPTIONAL_FIELDS = [:authcode, :amount, :invoiceid, :ponumber, :taxamnt]
+
+      FIELDS = REQUIRED_FIELDS + OPTIONAL_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Capture Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::CaptureRequest
+      def initialize(attrs = {})
+        @errors = []
+        set_attributes(attrs, FIELDS)
+        validate_required_fields
+      end
+
+      # Indicates that the request is valid once it is built.
+      def valid?
+        errors.empty?
+      end
+
+      # Builds the request payload
+      def payload
+        payload = {}
+        FIELDS.each do |field|
+          payload.merge!({field => send(field)})
+        end
+        payload
+      end
+
+      private
+
+      def validate_required_fields
+        REQUIRED_FIELDS.each do |field|
+          value = send(field)
+          value.nil? || value.empty? ? errors.push("#{field.capitalize} is missing") : next
+        end
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/capture/capture_response.rb

@@ -0,0 +1,24 @@
+module CardConnect
+  module Service
+    class CaptureResponse
+      include Utils
+
+      FIELDS = [:merchid, :account, :amount, :retref, :setlstat]
+
+      attr_accessor *FIELDS
+
+      def initialize(response)
+        set_attributes(response, FIELDS)
+      end
+
+      def body
+        body = {}
+        FIELDS.each do |attr|
+          body.merge!({attr => send(attr)})
+        end
+        body
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/deposit/deposit.rb

@@ -0,0 +1,17 @@
+module CardConnect
+  module Service
+    class Deposit < ServiceEndpoint
+
+      # Initializes a Deposit Service
+      #
+      # @param connection [CardConnect::Connection]
+      # @return CardConnect::Service::Deposit
+      def initialize(connection = CardConnect.connection)
+        super(connection)
+        @resource_name = '/deposit'
+        @rest_method = 'get'
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/deposit/deposit_request.rb

@@ -0,0 +1,64 @@
+require 'date'
+
+module CardConnect
+  module Service
+    class DepositRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :date]
+
+      FIELDS = REQUIRED_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Deposit Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::DepositRequest
+      def initialize(attrs = {})
+        @errors = []
+        set_attributes(attrs, FIELDS)
+        validate_required_fields
+      end
+
+      # Indicates that the request is valid once it is built.
+      def valid?
+        errors.empty?
+      end
+
+      # Builds the request payload
+      def payload
+        payload = "?"
+        FIELDS.each do |field|
+          payload += "#{field}=#{send(field)}&"
+        end
+        payload
+      end
+
+      private
+
+      def validate_required_fields
+        validate_presence_of_required_fields
+        validate_date_format unless date.nil? || date.empty?
+      end
+
+      def validate_presence_of_required_fields
+        REQUIRED_FIELDS.each do |field|
+          value = send(field)
+          value.nil? || value.empty? ? errors.push("#{field.capitalize} is missing") : next
+        end
+      end
+
+      def validate_date_format
+        begin
+          raise if date.length != 4
+          Date.parse(date, '%m%d')
+        rescue => e
+          errors.push("Date format is invalid. Please use MMDD format")
+        end
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/deposit/deposit_response.rb

@@ -0,0 +1,40 @@
+module CardConnect
+  module Service
+    class DepositResponse
+      include Utils
+
+      FIELDS = [:depositid, :merchid, :respproc, :accttype, :action, :actdate,
+                :postdate, :currency, :amount, :feeamnt, :cbakamnt, :resptext, :txns]
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      def initialize(response)
+        response = response.empty? ? response : response.first
+        set_attributes(response, FIELDS)
+        parse_transactions
+        @errors = []
+      end
+
+      def success?
+        errors.empty?
+      end
+
+      def body
+        body = {}
+        FIELDS.each do |attr|
+          body.merge!({attr => send(attr)})
+        end
+        body
+      end
+
+      private
+
+      def parse_transactions
+        return if txns.nil?
+        txns.each_with_index { |txn, i| self.txns[i] = symbolize_keys(txn) }
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/inquire/inquire.rb

@@ -0,0 +1,17 @@
+module CardConnect
+  module Service
+    class Inquire < ServiceEndpoint
+
+      # Initializes a Inquire Service
+      #
+      # @param connection [CardConnect::Connection]
+      # @return CardConnect::Service::Inquire
+      def initialize(connection = CardConnect.connection)
+        super(connection)
+        @resource_name = '/inquire'
+        @rest_method = 'get'
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/inquire/inquire_request.rb

@@ -0,0 +1,44 @@
+module CardConnect
+  module Service
+    class InquireRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :retref]
+
+      FIELDS = REQUIRED_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Inquire Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::InquireRequest
+      def initialize(attrs = {})
+        @errors = []
+        set_attributes(attrs, FIELDS)
+        validate_required_fields
+      end
+
+      # Indicates that the request is valid once it is built.
+      def valid?
+        errors.empty?
+      end
+
+      # Builds the request payload
+      def payload
+        "/#{retref}/#{merchid}"
+      end
+
+      private
+
+      def validate_required_fields
+        REQUIRED_FIELDS.each do |field|
+          value = send(field)
+          value.nil? || value.empty? ? errors.push("#{field.capitalize} is missing") : next
+        end
+      end
+
+    end
+  end
+end