cardconnect 1.0.0

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

@@ -0,0 +1,31 @@
+module CardConnect
+  module Service
+    class InquireResponse
+      include Utils
+
+      FIELDS = [:merchid, :account, :amount, :currency, :retref, :respcode,
+                :respproc, :respstat, :resptext, :setlstat]
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      def initialize(response)
+        set_attributes(response, FIELDS)
+        @errors = []
+      end
+
+      def success?
+        @errors.empty?
+      end
+
+      def body
+        body = {}
+        FIELDS.each do |attr|
+          body.merge!({attr => send(attr)})
+        end
+        body
+      end
+
+    end
+  end
+end

data/lib/cardconnect/services/refund/refund.rb

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

data/lib/cardconnect/services/refund/refund_request.rb

@@ -0,0 +1,50 @@
+module CardConnect
+  module Service
+    class RefundRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :retref]
+
+      OPTIONAL_FIELDS = [:amount]
+
+      FIELDS = REQUIRED_FIELDS + OPTIONAL_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Refund Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::RefundRequest
+      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/refund/refund_response.rb

@@ -0,0 +1,40 @@
+module CardConnect
+  module Service
+    class RefundResponse
+      include Utils
+
+      FIELDS = [:merchid, :amount, :retref, :authcode, :respcode, :respproc, :respstat, :resptext]
+
+      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/service_endpoint.rb

@@ -0,0 +1,69 @@
+module CardConnect
+  module Service
+    class ServiceEndpoint
+      include Utils
+
+      attr_reader :request, :response, :connection, :resource_name, :rest_method
+
+      # Parent for service endpoints (Authorization, Capture, etc.)
+      # This class shouldn't be called directly.  Rather call the end service directly.
+      #
+      # @param connection [CardConnect::Connection]
+      # @return CardConnect::ServiceEndpoint
+      def initialize(connection = CardConnect.connection)
+        @resource_name = '/'
+        @config = CardConnect.configuration
+        @connection = connection
+      end
+
+      def path
+        base_api_path + resource_name
+      end
+
+      def build_request(params = {})
+        req = symbolize_keys(params)
+        req = req.merge(merchid: @config.merchant_id) unless req.has_key?(:merchid)
+        @request = request_class.new(req)
+      end
+
+      def submit
+        raise CardConnect::Error, "Request has not been built" if request.nil?
+        @response = send(rest_method)
+      end
+
+      private
+
+      def base_api_path
+        '/cardconnect/rest'
+      end
+
+      def get
+        begin
+          response_class.new(connection.get(path + request.payload).body)
+        rescue Faraday::ResourceNotFound => e
+          puts e.message
+        end
+      end
+
+      def put
+        begin
+          response_class.new(connection.put(path, request.payload).body)
+        rescue Faraday::ResourceNotFound => e
+          puts e.message
+        end
+      end
+
+      def request_class
+        string_to_class("#{self.class}Request")
+      end
+
+      def response_class
+        string_to_class("#{self.class}Response")
+      end
+
+      def string_to_class(str)
+        str.split('::').inject(Object) { |mod, class_name| mod.const_get(class_name) }
+      end
+    end
+  end
+end

data/lib/cardconnect/services/settlement_status/settlement_status.rb

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

data/lib/cardconnect/services/settlement_status/settlement_status_request.rb

@@ -0,0 +1,64 @@
+require 'date'
+
+module CardConnect
+  module Service
+    class SettlementStatusRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :date]
+
+      FIELDS = REQUIRED_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Settlement Status Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::SettlementStatusRequest
+      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/settlement_status/settlement_status_response.rb

@@ -0,0 +1,39 @@
+module CardConnect
+  module Service
+    class SettlementStatusResponse
+      include Utils
+
+      FIELDS = [:merchid, :batchid, :hoststat, :hostbatch, :respproc, :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/void/void.rb

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

data/lib/cardconnect/services/void/void_request.rb

@@ -0,0 +1,50 @@
+module CardConnect
+  module Service
+    class VoidRequest
+      include Utils
+
+      REQUIRED_FIELDS = [:merchid, :retref]
+
+      OPTIONAL_FIELDS = [:amount]
+
+      FIELDS = REQUIRED_FIELDS + OPTIONAL_FIELDS
+
+      attr_accessor *FIELDS
+      attr_reader :errors
+
+      # Initializes a new Void Request
+      #
+      # @param attrs [Hash]
+      # @return CardConnect::VoidRequest
+      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/void/void_response.rb

@@ -0,0 +1,40 @@
+module CardConnect
+  module Service
+    class VoidResponse
+      include Utils
+
+      FIELDS = [:merchid, :amount, :currency, :retref, :authcode, :respcode, :respproc, :respstat, :resptext]
+
+      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