worldnet_tps 0.1.0

data/lib/worldnet_tps/request/base.rb

@@ -0,0 +1,107 @@
+require 'net/http'
+require 'net/https'
+require 'uri'
+require_relative '../response/success'
+require_relative '../response/error'
+require_relative '../response/invalid_hash'
+require_relative '../xsd'
+
+module WorldnetTps
+  module Request
+    class Base < WorldnetTps::WsObject
+
+      class_attribute :invoke_method, :response_keys, instance_writer: false
+      attr_reader :gateway, :request, :response, :date_time, :attributes
+
+      class_attribute :xsd_validation
+      self.xsd_validation = true
+
+      def process!(struct)
+        xml = build_xml(struct)
+        validate_xml!(xml) if xsd_validation?
+        uri = URI.parse(ws_url)
+        http = Net::HTTP.new(uri.host, 443)
+        http.use_ssl = true
+        @request = Net::HTTP::Post.new(uri.request_uri)
+        @request.body = xml
+        @response = http.request(@request)
+        build_response(@response)
+      end
+
+      def invoke!
+        _invoke! invoke_method
+      end
+
+      protected
+
+      def validate_xml!(xml)
+        WorldnetTps::XSD.validate!(xml)
+      end
+
+      def build_xml(struct)
+        root = struct.keys.first
+        data = Hash[struct[root].map { |k, v| [prepare_key(k), v.to_s] }]
+        data.to_xml(root: prepare_key(root))
+      end
+
+      def build_failed_response(code, message)
+        Response::Error.new(code, message)
+      end
+
+
+      def build_success_response(attributes)
+        Response::Success.new(attributes)
+      end
+
+      def build_response(http_response)
+        data = Hash.from_xml(http_response.body).values.first
+        if data.keys[0] =~ /error/i
+          build_failed_response(data['ERRORCODE'], data['ERRORSTRING'])
+        else
+          response_attributes = normalize_response_attributes(data)
+          begin
+            validate_hash!(response_attributes)
+          rescue WorldnetTps::WsObject::InvalidHashError => e
+            return Response::InvalidHash.new(response_attributes)
+          end
+          build_success_response(response_attributes)
+        end
+      end
+
+
+      def _invoke!(action)
+        add_check_sum!
+        verify_request_keys!(self.class.mandatory_attributes(self), self.attributes)
+        attrs = (request_attributes).inject({}) do |h, i|
+          h[i] = self.attributes[i]
+          h
+        end.reject { |_, v| v.nil? }
+        process!(action => attrs)
+      end
+
+      def request_attributes
+        self.class.mandatory_attributes(self) + self.class.optional_attributes(self)
+      end
+
+      def self.mandatory_attributes(_context)
+        []
+      end
+
+      def self.optional_attributes(_context)
+        []
+      end
+
+      def self.response_check_sum_keys(_context, _response)
+        []
+      end
+
+      def self.request_check_sum_keys(_context)
+        []
+      end
+
+      def ws_url
+        gateway.ws_url
+      end
+    end
+  end
+end

data/lib/worldnet_tps/request/payment.rb

@@ -0,0 +1,89 @@
+module WorldnetTps
+  module Request
+    #@see: https://docs.worldnettps.com/doku.php?id=developer:integrator_guide:5._xml_integration:5.1._request_types:5.1.1._xml_payments
+    class Payment < WorldnetTps::Request::Base
+
+      self.invoke_method = :payment
+
+      def self.response_check_sum_keys(_context, response)
+        unique_key =  response[:unique_ref].present? ? :unique_ref : :order_id
+        [
+          :terminal_id,
+          unique_key,
+          :amount,
+          :date_time,
+          :response_code,
+          :response_text,
+          :shared_secret
+        ]
+      end
+
+
+      def self.request_check_sum_keys(_context)
+        [
+          :terminal_id,
+          :order_id,
+          :amount,
+          :date_time,
+          :shared_secret
+        ]
+      end
+
+      self.response_keys = [:unique_ref, :response_code, :response_text, :approval_code, :date_time, :avs_response, :cvv_response, :hash]
+
+      def initialize(gateway, attrs)
+        super
+        #by default TERM_INTERNET = 2 # eCommerce
+        assign(:terminal_type, WorldnetTps::Const::TERM_INTERNET) if attributes[:terminal_type].blank?
+        #by default TRANS_INTERNET = 7 #eCommerce
+        assign(:transaction_type, WorldnetTps::Const::TRANS_INTERNET) if attributes[:transaction_type].blank?
+      end
+
+      def secured_card?
+        WorldnetTps::Const::SECURECARD == self[:card_type]
+      end
+
+
+      def self.mandatory_attributes(context)
+        keys = [
+          :order_id,
+          :terminal_id,
+          :amount,
+          :date_time,
+          :card_number,
+          :card_type
+        ]
+
+        keys += [:card_expiry, :card_holder_name] unless context.secured_card?
+        keys += [:hash, :currency, :terminal_type, :transaction_type]
+        keys
+      end
+
+      def self.optional_attributes(_context)
+        [
+          :auto_ready,
+          :email,
+          :cvv,
+          :issue_no,
+          :address1,
+          :address2,
+          :post_code,
+          :avs_only,
+          :description,
+          :xid,
+          :cavv,
+          :mpiref,
+          :mobile_number,
+          :device_id,
+          :phone,
+          :city,
+          :region,
+          :country,
+          :ip_address,
+          :signature
+        ]
+      end
+    end
+  end
+
+end

data/lib/worldnet_tps/request/refund.rb

@@ -0,0 +1,59 @@
+module WorldnetTps
+  module Request
+    class Refund < WorldnetTps::Request::Base
+
+      self.invoke_method = :refund
+
+      self.response_keys = [
+        :response_code,
+        :response_text,
+        :order_id,
+        :unique_ref,
+        :date_time,
+        :hash,
+        :processing_terminal
+      ]
+
+      def unique_key
+        self[:unique_ref].present? ? :unique_ref : :order_id
+      end
+
+      def self.request_check_sum_keys(context)
+        [
+          :terminal_id,
+          context.unique_key,
+          :amount,
+          :date_time,
+          :response_code,
+          :response_text,
+          :shared_secret
+        ]
+      end
+
+      def self.response_check_sum_keys(context, _response)
+        [
+          :terminal_id,
+          context.unique_key,
+          :amount,
+          :date_time,
+          :response_code,
+          :response_text,
+          :shared_secret
+        ]
+      end
+
+      def self.mandatory_attributes(context)
+        [
+          context.unique_key,
+          :terminal_id,
+          :amount,
+          :date_time,
+          :hash,
+          :operator,
+          :reason
+        ]
+      end
+
+    end
+  end
+end

data/lib/worldnet_tps/request/secure_card/registration.rb

@@ -0,0 +1,71 @@
+require_relative '../base'
+module WorldnetTps
+  module Request
+    module SecureCard
+      # Used for processing XML SecureCard Registrations
+      # through the WorldNet TPS XML Gateway.
+      class Registration < WorldnetTps::Request::Base
+
+        self.invoke_method = :secure_card_registration
+        self.response_keys = [
+          :merchant_ref,
+          :card_reference,
+          :date_time,
+          :hash
+        ]
+
+        def self.response_check_sum_keys(_context, _response)
+          [
+            :terminal_id,
+            :merchant_ref,
+            :card_reference,
+            :date_time,
+            :shared_secret
+          ]
+        end
+
+        def self.request_check_sum_keys(_context)
+          [
+            :terminal_id,
+            :merchant_ref,
+            :date_time,
+            :card_number,
+            :card_expiry,
+            :card_type,
+            :card_holder_name,
+            :shared_secret
+          ]
+        end
+
+        def self.optional_attributes(_context)
+          [
+            :dont_check_security,
+            :cvv,
+            :ussue_no
+          ]
+        end
+
+        alias :create! :invoke!
+        #alias_method :invoke!, :create!
+
+        def update!
+          _invoke! :secure_card_update
+        end
+
+        def self.mandatory_attributes(_context)
+          [
+            :merchant_ref,
+            :terminal_id,
+            :date_time,
+            :card_number,
+            :card_expiry,
+            :card_type,
+            :card_holder_name,
+            :hash
+          ]
+        end
+
+      end
+    end
+  end
+end

data/lib/worldnet_tps/request/secure_card/removal.rb

@@ -0,0 +1,46 @@
+module WorldnetTps
+  module Request
+    module SecureCard
+      class Removal < WorldnetTps::Request::Base
+
+        def initialize(gateway, merchant_ref, card_reference)
+          super(gateway, {merchant_ref: merchant_ref, card_reference: card_reference})
+        end
+
+        self.invoke_method =  :secure_card_removal
+        self.response_keys = [:merchant_ref, :date_time, :hash]
+
+        def self.request_check_sum_keys(_context)
+          [
+            :terminal_id,
+            :merchant_ref,
+            :date_time,
+            :card_reference,
+            :shared_secret
+          ]
+        end
+
+        def self.response_check_sum_keys(_context, _response)
+          [
+            :terminal_id,
+            :merchant_ref,
+            :date_time,
+            :shared_secret
+          ]
+        end
+
+
+        def self.mandatory_attributes(_context)
+          [
+            :merchant_ref,
+            :card_reference,
+            :terminal_id,
+            :date_time,
+            :hash
+          ]
+        end
+
+      end
+    end
+  end
+end

data/lib/worldnet_tps/request/secure_card/search.rb

@@ -0,0 +1,52 @@
+module WorldnetTps
+  module Request
+    module SecureCard
+      class Search < WorldnetTps::Request::Base
+
+        def initialize(gateway, merchant_ref)
+          super(gateway, { merchant_ref: merchant_ref })
+        end
+
+        self.invoke_method = :secure_card_search
+
+        self.response_keys = [:merchant_ref, :card_reference, :card_type,
+                              :card_expiry, :card_holder_name, :date_time, :hash]
+
+        def self.request_check_sum_keys(_context)
+          [
+            :terminal_id,
+            :merchant_ref,
+            :date_time,
+            :shared_secret
+          ]
+        end
+
+        def self.response_check_sum_keys(_context, _response)
+          [
+            :terminal_id,
+            :merchant_ref,
+            :card_reference,
+            :card_type,
+            :card_expiry,
+            :card_holder_name,
+            :date_time,
+            :shared_secret
+          ]
+        end
+
+
+
+        def self.mandatory_attributes(_context)
+          [
+            :merchant_ref,
+            :terminal_id,
+            :date_time,
+            :hash
+          ]
+        end
+
+
+      end
+    end
+  end
+end

data/lib/worldnet_tps/response/error.rb

@@ -0,0 +1,18 @@
+module WorldnetTps
+  module Response
+    class Error
+
+      attr_reader :code, :message
+
+      def initialize(code, message)
+        @code = code
+        @message = message
+      end
+
+      def success?
+        false
+      end
+    end
+  end
+end  
+