kount_complete 1.0.6 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b963bdc02a66ec3b820101bc421bd4b6e502f96d43f39dab880e362c7931d7df
-  data.tar.gz: f933cba709ab7e393e5f15b85a8f6fbc35ead29ddfe1530695273ea3a0e17259
+  metadata.gz: b4fb5f2ac5146df1e91864887f3a299676a6e3359998657ece5bdaa16a9a0981
+  data.tar.gz: 830538c8d4a58d49b035b5e4ecbf01e5a2566acedccd010cc88b45b2fef1df4a
 SHA512:
-  metadata.gz: c5ed272c1e1f1937c6581feed22d8b24d5c71d52f1a746a16a25c3058a3d3d301026417d1964fa62e0f304c59c5558e217e6e890c8db522d2cab77ed3fef5fba
-  data.tar.gz: ed4770af05c1a91155b6e07e81a56f50aabf4d00ef3afe375e4eee9264f43ed93802bacdf550c5c3dd1041bd4ead790093ae6588d0d78895212ab5a495305e1b
+  metadata.gz: 72f8a404eb61e3565b67ef39a2267fe1674c769674493150f7ee9543424ceb7c353664451a458e6e6d658638600a7257f9874238d38c18e5bbd26cfdd14c6d2c
+  data.tar.gz: c679e2d85a2bd53cc9420e5e09d3c5f39636018b0ac45f7a94e9100d73cd16551a3ba0087a2b176004386b1376f0a2ac6ddd80cfc58881a9c6b7603148eb9656

data/lib/kount.rb

@@ -1,28 +1,28 @@
-require 'kount/client'
-require 'kount/payment_types'
-
-##
-# This module is the main entry point to the service wrapper.
-# Its primary function is to collect the runtime options
-# and return a Client object, on which all of the runtime
-# integration takes place.
-module Kount
-  # Creates the client object
-  #
-  # Expected options include:
-  #   options = {
-  #     :merchant_id => "MERCHANT_ID" # required (6 digit number)
-  #     :ksalt => "KSALT" # required (provided by Kount)
-  #     :key => "RIS_KEY" # required (created in the AWC web app)
-  #     :endpoint => "RIS_ENDPOINT" # optional (default https://risk.kount.net)
-  #     :version => "RIS_VERSION" # optional (defaults "0630")
-  #     :is_test => "IS_TEST" # optional (defaults to false)
-  #    }
-  # @param options Hash
-  def new(options = {})
-    fail ArgumentError, 'Config options required' if options.empty?
-    Client.new(options)
-  end
-
-  module_function :new
-end
+require 'kount/client'
+require 'kount/payment_types'
+
+##
+# This module is the main entry point to the service wrapper.
+# Its primary function is to collect the runtime options
+# and return a Client object, on which all of the runtime
+# integration takes place.
+module Kount
+  # Creates the client object
+  #
+  # Expected options include:
+  #   options = {
+  #     :merchant_id => "MERCHANT_ID" # required (6 digit number)
+  #     :ksalt => "KSALT" # required (provided by Kount)
+  #     :key => "RIS_KEY" # required (created in the AWC web app)
+  #     :endpoint => "RIS_ENDPOINT" # optional (default https://risk.kount.net)
+  #     :version => "RIS_VERSION" # optional (defaults "0630")
+  #     :is_test => "IS_TEST" # optional (defaults to false)
+  #    }
+  # @param options Hash
+  def new(options = {})
+    fail ArgumentError, 'Config options required' if options.empty?
+    Client.new(options)
+  end
+
+  module_function :new
+end

data/lib/kount/cart.rb

@@ -1,36 +1,36 @@
-module Kount
-  ##
-  # This class handles cart data until the get_request is ready
-  # to push the data into the form fields
-  class Cart
-    attr_accessor :items
-
-    # Initialize cart object
-    def initialize
-      @items = []
-    end
-
-    # Add cart items
-    #
-    # @param item [String] Cart item name
-    # @param type [String] Cart type name
-    # @param desc [String] Cart item long description
-    # @param quant [String] Cart item quantity
-    # @param price [String] Cart item price in cents
-    def add_item(item, type, desc, quant, price)
-      @items << { TYPE: type,
-                  DESC: desc,
-                  ITEM: item,
-                  QUANT: quant,
-                  PRICE: price }
-    end
-
-    # Initialize an Inquiry object
-    #
-    # @param param [String] Param type: :TYPE, :DESC, :ITEM, :PRICE, or :QUANT
-    # @return [Array] Ordered array of the cart contents for each param type
-    def get_item(param)
-      @items.collect { |item| item[param] }
-    end
-  end
-end
+module Kount
+  ##
+  # This class handles cart data until the get_request is ready
+  # to push the data into the form fields
+  class Cart
+    attr_accessor :items
+
+    # Initialize cart object
+    def initialize
+      @items = []
+    end
+
+    # Add cart items
+    #
+    # @param item [String] Cart item name
+    # @param type [String] Cart type name
+    # @param desc [String] Cart item long description
+    # @param quant [String] Cart item quantity
+    # @param price [String] Cart item price in cents
+    def add_item(item, type, desc, quant, price)
+      @items << { TYPE: type,
+                  DESC: desc,
+                  ITEM: item,
+                  QUANT: quant,
+                  PRICE: price }
+    end
+
+    # Initialize an Inquiry object
+    #
+    # @param param [String] Param type: :TYPE, :DESC, :ITEM, :PRICE, or :QUANT
+    # @return [Array] Ordered array of the cart contents for each param type
+    def get_item(param)
+      @items.collect { |item| item[param] }
+    end
+  end
+end

data/lib/kount/client.rb

@@ -1,124 +1,125 @@
-require 'kount/security_mash'
-require 'kount/cart'
-require 'kount/request'
-require 'kount/request/update'
-require 'kount/request/inquiry'
-require 'rest-client'
-require 'uri'
-
-# rubocop:disable Style/ClassVars
-module Kount
-  ##
-  # This class is where the primary interaction with
-  # the merchant integration will take place.
-  class Client
-    # Tells the RIS server to respond in JSON instead of key/value pairs
-    # This cannot be overridden.
-    RESPONSE_FORMAT = 'JSON'
-
-    # RIS Version. Can be overridden my merchant if required.
-    DEFAULT_VERSION = '0630'
-
-    # Default endpoint for production. Used by the DEFAULT_OPTIONS
-    ENDPOINT_PROD = 'https://risk.kount.net'
-
-    # Default endpoint for test. Used by the TEST_DEFAULT_OPTIONS
-    ENDPOINT_TEST = 'https://risk.test.kount.net'
-
-    # Default params for production
-    PROD_DEFAULT_OPTIONS = {
-      endpoint: ENDPOINT_PROD,
-      version: DEFAULT_VERSION,
-      is_test: false
-    }
-
-    # Default params for test if is_test is TRUE
-    TEST_DEFAULT_OPTIONS = {
-      endpoint: ENDPOINT_TEST,
-      version: DEFAULT_VERSION
-    }
-
-    # Initialize a client object
-    #
-    # Example usage
-    #    {:merchant_id => "123456", :key => "trhvihsrihsta7ftadk6edkre7y8..."}
-    #
-    # @param params [Hash] Hash with merchant_id, ksalt and key, plus any
-    # other optional params
-    def initialize(params = {})
-      @options = {}
-      if params[:is_test]
-        @options.merge!(TEST_DEFAULT_OPTIONS)
-      else
-        @options.merge!(PROD_DEFAULT_OPTIONS)
-      end
-      @options.merge!(params)
-    end
-
-    # Makes the call to the Kount RIS server
-    #
-    # @param request [Kount::Request] Kount inquiry or update object
-    # @return [Hash] RIS response formatted into a native hash
-    def get_response(request)
-      params = prepare_request_params(request)
-      response = {}
-      begin
-        response = RestClient::Resource.new(
-          endpoint,
-          verify_ssl: verify_ssl_option, timeout: 1).post params, x_kount_api_key: key
-        
-        JSON.parse(response)
-      rescue
-        # RIS errors do not come back as JSON, so just pass them along raw.
-        response
-      end
-    end
-
-    # Give the request object what it needs to know to process the params
-    # to send to RIS.
-    def prepare_request_params(request)
-      request.prepare_params(version, merchant_id, RESPONSE_FORMAT, ksalt)
-    end
-
-    # Kount Merchant ID
-    def merchant_id
-      @options[:merchant_id]
-    end
-
-    # RIS Interface Version
-    def version
-      @options[:version]
-    end
-
-    # RIS Endpoint URL
-    def endpoint
-      @options[:endpoint]
-    end
-
-    # Merchant API for RIS acess
-    def key
-      @options[:key]
-    end
-
-    # Secret Kount salt for KHASH
-    def ksalt
-      @options[:ksalt]
-    end
-
-    # Is test or production setting
-    def test?
-      @options[:is_test]
-    end
-
-    private
-
-    # Helper method to turn on/off the SSL cert verify based on is_test config
-    def verify_ssl_option
-      if test?
-        OpenSSL::SSL::VERIFY_NONE
-      else
-        OpenSSL::SSL::VERIFY_PEER
-      end
-    end
-  end
-end
+require 'kount/security_mash'
+require 'kount/cart'
+require 'kount/request'
+require 'kount/request/update'
+require 'kount/request/inquiry'
+require 'rest-client'
+require 'uri'
+require 'kount/utils/khash'
+
+# rubocop:disable Style/ClassVars
+module Kount
+  ##
+  # This class is where the primary interaction with
+  # the merchant integration will take place.
+  class Client
+    # Tells the RIS server to respond in JSON instead of key/value pairs
+    # This cannot be overridden.
+    RESPONSE_FORMAT = 'JSON'
+
+    # RIS Version. Can be overridden my merchant if required.
+    DEFAULT_VERSION = '0630'
+
+    # Default endpoint for production. Used by the DEFAULT_OPTIONS
+    ENDPOINT_PROD = 'https://risk.kount.net'
+
+    # Default endpoint for test. Used by the TEST_DEFAULT_OPTIONS
+    ENDPOINT_TEST = 'https://risk.test.kount.net'
+
+    # Default params for production
+    PROD_DEFAULT_OPTIONS = {
+      endpoint: ENDPOINT_PROD,
+      version: DEFAULT_VERSION,
+      is_test: false
+    }
+
+    # Default params for test if is_test is TRUE
+    TEST_DEFAULT_OPTIONS = {
+      endpoint: ENDPOINT_TEST,
+      version: DEFAULT_VERSION
+    }
+
+    # Initialize a client object
+    #
+    # Example usage
+    #    {:merchant_id => "123456", :key => "trhvihsrihsta7ftadk6edkre7y8..."}
+    #
+    # @param params [Hash] Hash with merchant_id, ksalt and key, plus any
+    # other optional params
+    def initialize(params = {})
+      @options = {}
+      if params[:is_test]
+        @options.merge!(TEST_DEFAULT_OPTIONS)
+      else
+        @options.merge!(PROD_DEFAULT_OPTIONS)
+      end
+      @options.merge!(params)
+    end
+
+    # Makes the call to the Kount RIS server
+    #
+    # @param request [Kount::Request] Kount inquiry or update object
+    # @return [Hash] RIS response formatted into a native hash
+    def get_response(request)
+      params = prepare_request_params(request)
+      response = {}
+      begin
+        response = RestClient::Resource.new(
+          endpoint,
+          verify_ssl: verify_ssl_option, timeout: 1).post params, x_kount_api_key: key
+        
+        JSON.parse(response)
+      rescue
+        # RIS errors do not come back as JSON, so just pass them along raw.
+        response
+      end
+    end
+
+    # Give the request object what it needs to know to process the params
+    # to send to RIS.
+    def prepare_request_params(request)
+      request.prepare_params(version, merchant_id, RESPONSE_FORMAT, ksalt)
+    end
+
+    # Kount Merchant ID
+    def merchant_id
+      @options[:merchant_id]
+    end
+
+    # RIS Interface Version
+    def version
+      @options[:version]
+    end
+
+    # RIS Endpoint URL
+    def endpoint
+      @options[:endpoint]
+    end
+
+    # Merchant API for RIS acess
+    def key
+      @options[:key]
+    end
+
+    # Secret Kount salt for KHASH
+    def ksalt
+      @options[:ksalt]
+    end
+
+    # Is test or production setting
+    def test?
+      @options[:is_test]
+    end
+
+    private
+
+    # Helper method to turn on/off the SSL cert verify based on is_test config
+    def verify_ssl_option
+      if test?
+        OpenSSL::SSL::VERIFY_NONE
+      else
+        OpenSSL::SSL::VERIFY_PEER
+      end
+    end
+  end
+end

data/lib/kount/payment_types.rb

@@ -1,52 +1,52 @@
-module Kount
-  ##
-  # Convenience class to provide a list of PTYP values
-  class PaymentTypes
-    # Credit card (VISA, MasterCard, Amercian Express, etc)
-    CREDIT_CARD   = 'CARD'
-    #Generic Token
-    TOKEN   = 'TOKEN'
-    # PayPal
-    PAYPAL        = 'PYPL'
-    # Check
-    CHECK         = 'CHEK'
-    # Merchant issued gift card (not the ones with VISA/MC on them)
-    GIFT_CARD     = 'GIFT'
-    # Carte Bleue
-    CARTE_BLEUE   = 'CARTE_BLEUE'
-    # Sofort
-    SOFORT        = 'SOFORT'
-    # Elv
-    ELV           = 'ELV'
-    # Poli
-    POLI          = 'POLI'
-    # Neteller
-    NETELLER      = 'NETELLER'
-    # Giropay
-    GIROPAY       = 'GIROPAY'
-    # BPay
-    BPAY          = 'BPAY'
-    # Interac
-    INTERAC       = 'INTERAC'
-    # Apple Pay
-    APPLE_PAY     = 'APAY'
-    # Skrill
-    SKRILL        = 'SKRILL'
-    # Moneybooker (basically another name for Skrill)
-    MONEYBOOKERS  = 'SKRILL'
-    # Mercado Pago
-    MERCADO_PAGO  = 'MERCADE_PAGO'
-    # Bill Me Later
-    BILL_ME_LATER = 'BLML'
-    # Google Checkout
-    GOOGLE_CHECKOUT = 'GOOG'
-    # Green Dot Money Pack
-    GREEN_DOT_MONEY_PACK  =	'GDMP'
-    # Single Euro Payments Area
-    SINGLE_EURO_PAYMENTS_AREA	=	'SEPA'
-    # None
-    NONE          = 'NONE'
-    # Other
-    OTHER         = 'OTHER'
-  end
-end
+module Kount
+  ##
+  # Convenience class to provide a list of PTYP values
+  class PaymentTypes
+    # Credit card (VISA, MasterCard, Amercian Express, etc)
+    CREDIT_CARD   = 'CARD'
+    #Generic Token
+    TOKEN   = 'TOKEN'
+    # PayPal
+    PAYPAL        = 'PYPL'
+    # Check
+    CHECK         = 'CHEK'
+    # Merchant issued gift card (not the ones with VISA/MC on them)
+    GIFT_CARD     = 'GIFT'
+    # Carte Bleue
+    CARTE_BLEUE   = 'CARTE_BLEUE'
+    # Sofort
+    SOFORT        = 'SOFORT'
+    # Elv
+    ELV           = 'ELV'
+    # Poli
+    POLI          = 'POLI'
+    # Neteller
+    NETELLER      = 'NETELLER'
+    # Giropay
+    GIROPAY       = 'GIROPAY'
+    # BPay
+    BPAY          = 'BPAY'
+    # Interac
+    INTERAC       = 'INTERAC'
+    # Apple Pay
+    APPLE_PAY     = 'APAY'
+    # Skrill
+    SKRILL        = 'SKRILL'
+    # Moneybooker (basically another name for Skrill)
+    MONEYBOOKERS  = 'SKRILL'
+    # Mercado Pago
+    MERCADO_PAGO  = 'MERCADE_PAGO'
+    # Bill Me Later
+    BILL_ME_LATER = 'BLML'
+    # Google Checkout
+    GOOGLE_CHECKOUT = 'GOOG'
+    # Green Dot Money Pack
+    GREEN_DOT_MONEY_PACK  =	'GDMP'
+    # Single Euro Payments Area
+    SINGLE_EURO_PAYMENTS_AREA	=	'SEPA'
+    # None
+    NONE          = 'NONE'
+    # Other
+    OTHER         = 'OTHER'
+  end
+end

data/lib/kount/request.rb

@@ -1,41 +1,41 @@
-require 'kount/security_mash'
-module Kount
-  ##
-  # This class acts as an abstract class for each type of request.
-  class Request
-    attr_accessor :params
-
-    # Initialize a Request object
-    #
-    # Example usage
-    #    Not used directly. Use Inquiry or Update instead.
-    #
-    # @param initial_params [Hash] Initial params for request
-    def initialize(initial_params = {})
-      fail "Cannot directly instantiate a #{self.class}." if
-        self.class == Request
-      @params = initial_params
-    end
-
-    # Add params to the current request object
-    # @param hash [Hash] Hash of values to be added
-    def add_params(hash)
-      @params.merge!(hash)
-    end
-
-    # This method creates the final state of the params collection such that
-    # it can be sent to RIS. Items that are specific to either the Inquiry
-    # or Update calls are delegated to the prepare_params method in each
-    # respective class.
-    #
-    # @param version [String] RIS version
-    # @param merchant_id [String] Merchant ID
-    # @param response_format [String] Response format (JSON)
-    # @param _ksalt [String] Kount supplied secret salt for KHASH
-    def prepare_params(version, merchant_id, response_format, _ksalt = '')
-      # The KSALT is not used here, however, it is used in the corresponding
-      # subclass prepare_params methods.
-      params.merge!(VERS: version, MERC: merchant_id, FRMT: response_format)
-    end
-  end
-end
+require 'kount/security_mash'
+module Kount
+  ##
+  # This class acts as an abstract class for each type of request.
+  class Request
+    attr_accessor :params
+
+    # Initialize a Request object
+    #
+    # Example usage
+    #    Not used directly. Use Inquiry or Update instead.
+    #
+    # @param initial_params [Hash] Initial params for request
+    def initialize(initial_params = {})
+      fail "Cannot directly instantiate a #{self.class}." if
+        self.class == Request
+      @params = initial_params
+    end
+
+    # Add params to the current request object
+    # @param hash [Hash] Hash of values to be added
+    def add_params(hash)
+      @params.merge!(hash)
+    end
+
+    # This method creates the final state of the params collection such that
+    # it can be sent to RIS. Items that are specific to either the Inquiry
+    # or Update calls are delegated to the prepare_params method in each
+    # respective class.
+    #
+    # @param version [String] RIS version
+    # @param merchant_id [String] Merchant ID
+    # @param response_format [String] Response format (JSON)
+    # @param _ksalt [String] Kount supplied secret salt for KHASH
+    def prepare_params(version, merchant_id, response_format, _ksalt = '')
+      # The KSALT is not used here, however, it is used in the corresponding
+      # subclass prepare_params methods.
+      params.merge!(VERS: version, MERC: merchant_id, FRMT: response_format)
+    end
+  end
+end

data/lib/kount/request/inquiry.rb

@@ -1,85 +1,90 @@
-module Kount
-  ##
-  # This class extends the Request class.
-  class Inquiry < Request
-    attr_accessor :cart
-
-    # Initialize an Inquiry object
-    #
-    # Example usage
-    #    {:MACK => "Y", :AUTH => "A"}
-    #
-    # @param initial_params [Hash] Initial params for request
-    def initialize(initial_params = {})
-      super(initial_params)
-      @cart = Cart.new
-      # We want Request to default to MODE Q unless a different mode has
-      # been passed.
-      add_params(MODE: 'Q') unless initial_params.key?(:MODE)
-    end
-
-    # @param version [String] RIS version
-    # @param merchant_id [String] Merchant ID
-    # @param response_format [String] Response format (JSON)
-    # @param ksalt [String] Kount supplied secret salt for KHASH
-    def prepare_params(version, merchant_id, response_format, ksalt)
-      super(version, merchant_id, response_format, ksalt)
-      begin
-        params.merge! collect_cart_items
-        # The Kount::Request has no knowledge of the KSALT or merchant_id, both
-        # of which are needed for KHASH. Request form params have everything we
-        # need at this point to do the KHASH if needed.
-        fixup_payment_params(ksalt, merchant_id)
-      end
-      params
-    end
-
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-    def fixup_payment_params(ksalt, merchant_id)
-      ptok = params[:PTOK]
-      case params[:PTYP]
-      when 'CARD', 'TOKEN'
-        ptok = Kount::SecurityMash.hash_credit_card(ptok, ksalt)
-        params.merge!(PTOK: ptok, PENC: 'KHASH')
-      when 'GIFT', 'OTHER'
-        ptok = Kount::SecurityMash.hash_gift_card(ptok, ksalt, merchant_id)
-        params.merge!(PTOK: ptok, PENC: 'KHASH')
-      when 'NONE'
-        params.merge!(PTOK: nil, PENC: nil)
-      else
-        params[:PENC] ||= 'NONE'
-      end
-    end
-
-    # Pulls the cart data into the request params hash
-    def collect_cart_items
-      {
-        PROD_TYPE: cart.get_item(:TYPE),
-        PROD_DESC: cart.get_item(:DESC),
-        PROD_ITEM: cart.get_item(:ITEM),
-        PROD_PRICE: cart.get_item(:PRICE),
-        PROD_QUANT: cart.get_item(:QUANT)
-      }
-    end
-
-    # Puts the cart object into the request for processing
-    # @param cart [Kount::Cart] Cart object
-    def add_cart(cart)
-      @cart = cart
-    end
-
-    # Add UDF to request
-    # @param name [String] UDF label name
-    # @param value [String] UDF value
-    def add_udf(name, value)
-      @params.merge!("UDF[#{name}]" => value)
-    end
-
-    # Convenience method to create the payment params
-    # @param type [String] Payment type
-    # @param token [String] Payment token
-    def add_payment(type, token = '')
-      add_params(PTYP: type, PTOK: token)
-    end
-  end
-end
+module Kount
+  ##
+  # This class extends the Request class.
+  class Inquiry < Request
+    attr_accessor :cart
+
+    # Initialize an Inquiry object
+    #
+    # Example usage
+    #    {:MACK => "Y", :AUTH => "A"}
+    #
+    # @param initial_params [Hash] Initial params for request
+    def initialize(initial_params = {})
+      super(initial_params)
+      @cart = Cart.new
+      # We want Request to default to MODE Q unless a different mode has
+      # been passed.
+      add_params(MODE: 'Q') unless initial_params.key?(:MODE)
+    end
+
+    # @param version [String] RIS version
+    # @param merchant_id [String] Merchant ID
+    # @param response_format [String] Response format (JSON)
+    # @param ksalt [String] Kount supplied secret salt for KHASH
+    def prepare_params(version, merchant_id, response_format, ksalt)
+      super(version, merchant_id, response_format, ksalt)
+      begin
+        params.merge! collect_cart_items
+        # The Kount::Request has no knowledge of the KSALT or merchant_id, both
+        # of which are needed for KHASH. Request form params have everything we
+        # need at this point to do the KHASH if needed.
+        fixup_payment_params(ksalt, merchant_id)
+      end
+      params
+    end
+
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+    def fixup_payment_params(ksalt, merchant_id)
+      ptok = params[:PTOK]
+      case params[:PTYP]
+      when 'CARD', 'TOKEN'
+        #ptok = Kount::SecurityMash.hash_credit_card(ptok, ksalt)
+        ptok = Kount::Khash.HashPaymentToken(ptok, ksalt)
+        params.merge!(PTOK: ptok, PENC: 'KHASH')
+      when 'GIFT', 'OTHER'
+        #ptok = Kount::SecurityMash.hash_gift_card(ptok, ksalt, merchant_id)
+        ptok = Kount::Khash.HashGiftCard(ptok, ksalt, merchant_id)
+        params.merge!(PTOK: ptok, PENC: 'KHASH')
+      when 'CHEK', 'OTHER'
+        ptok = Kount::Khash.HashCheckPayment(ptok, ksalt)
+        params.merge!(PTOK: ptok, PENC: 'KHASH')
+      when 'NONE'
+        params.merge!(PTOK: nil, PENC: nil)
+      else
+        params[:PENC] ||= 'NONE'
+      end
+    end
+
+    # Pulls the cart data into the request params hash
+    def collect_cart_items
+      {
+        PROD_TYPE: cart.get_item(:TYPE),
+        PROD_DESC: cart.get_item(:DESC),
+        PROD_ITEM: cart.get_item(:ITEM),
+        PROD_PRICE: cart.get_item(:PRICE),
+        PROD_QUANT: cart.get_item(:QUANT)
+      }
+    end
+
+    # Puts the cart object into the request for processing
+    # @param cart [Kount::Cart] Cart object
+    def add_cart(cart)
+      @cart = cart
+    end
+
+    # Add UDF to request
+    # @param name [String] UDF label name
+    # @param value [String] UDF value
+    def add_udf(name, value)
+      @params.merge!("UDF[#{name}]" => value)
+    end
+
+    # Convenience method to create the payment params
+    # @param type [String] Payment type
+    # @param token [String] Payment token
+    def add_payment(type, token = '')
+      add_params(PTYP: type, PTOK: token)
+    end
+  end
+end

data/lib/kount/request/update.rb

@@ -1,28 +1,28 @@
-module Kount
-  ##
-  # This class extends the Request class and is used in the
-  # process of sending updates to an existing transaction
-  # generated by a previous Inquiry request.
-  class Update < Request
-    # Initialize an Update object
-    #
-    # Example usage
-    #    {:MACK => "Y", :AUTH => "A"}
-    #
-    # @param initial_params [Hash] Initial params for request
-    def initialize(initial_params = {})
-      super(initial_params)
-      # Default to mode U unless mode X is explicitly set
-      add_params(MODE: 'U') unless initial_params[:MODE] == 'X'
-    end
-
-    # @param version [String] RIS version
-    # @param merchant_id [String] Merchant ID
-    # @param response_format [String] Response format (JSON)
-    # @param ksalt [String] Kount supplied secret salt for KHASH
-    def prepare_params(version, merchant_id, response_format, ksalt)
-      super(version, merchant_id, response_format, ksalt)
-      params
-    end
-  end
-end
+module Kount
+  ##
+  # This class extends the Request class and is used in the
+  # process of sending updates to an existing transaction
+  # generated by a previous Inquiry request.
+  class Update < Request
+    # Initialize an Update object
+    #
+    # Example usage
+    #    {:MACK => "Y", :AUTH => "A"}
+    #
+    # @param initial_params [Hash] Initial params for request
+    def initialize(initial_params = {})
+      super(initial_params)
+      # Default to mode U unless mode X is explicitly set
+      add_params(MODE: 'U') unless initial_params[:MODE] == 'X'
+    end
+
+    # @param version [String] RIS version
+    # @param merchant_id [String] Merchant ID
+    # @param response_format [String] Response format (JSON)
+    # @param ksalt [String] Kount supplied secret salt for KHASH
+    def prepare_params(version, merchant_id, response_format, ksalt)
+      super(version, merchant_id, response_format, ksalt)
+      params
+    end
+  end
+end

data/lib/kount/security_mash.rb

@@ -1,82 +1,82 @@
-require 'digest/sha1'
-module Kount
-  ##
-  # This class implements the Kount KHASH for cards and gift cards.
-  # rubocop:disable Style/Documentation
-  class SecurityMash
-    # @param plain_text [String] String to be hashed
-    # @param ptyp [String] Payment type code: CARD, GIFT, or OTHER
-    # @return [String] KHASH version of string
-    def self.hash_token(plain_text, ptyp, ksalt, merchant_id = '')
-      if ptyp == 'CARD'
-        hash_credit_card(plain_text, ksalt)
-      else
-        hash_gift_card(plain_text, ksalt, merchant_id)
-      end
-    end
-
-    # Hash a credit card number.
-    # Preserves first six characters of the input so that hashed cards can be
-    # categorized by Bank Identification Number (BIN).
-    #
-    # Example usage:
-    #   hashed = Kount::SecurityMash.hash_credit_card("4111111111111111")
-    #     Expect: 411111WMS5YA6FUZA1KC
-    #   hashed = Kount::SecurityMash.hash_credit_card("5199185454061655")
-    #     Expect: 5199182NOQRXNKTTFL11
-    #   hashed = Kount::SecurityMash.hash_credit_card("4259344583883")
-    #     Expect: 425934FEXQI1QS6TH2O5
-    #
-    # @param plain_text [String] String to be hashed
-    # @return [String] KHASH version of string
-    def self.hash_credit_card(plain_text, ksalt)
-      return plain_text if khashed?(plain_text)
-      first_six = plain_text[0..5]
-      mashed = mash(plain_text, 14, ksalt)
-      "#{first_six}#{mashed}"
-    end
-
-    # Hash a gift card number.
-    # Use the six characters of the merchant id so that hashed cards can be
-    # unique across the entire domain.
-    #
-    # Example usage:
-    #   hashed = Kount::SecurityMash.hash_gift_card("123456", "3245876")
-    #     Expect: 1234569HXH32Y5NNJCGB
-
-    # @param plain_text [String] String to be hashed
-    # @return [String] KHASH version of string
-    def self.hash_gift_card(plain_text, ksalt, merchant_id)
-      mashed = mash(plain_text, 14, ksalt)
-      "#{merchant_id}#{mashed}"
-    end
-
-    # Compute a base64 hash of the provided data.
-    #
-    # @param data [String] Data to hash
-    # @param len [int] Length of hash to retain
-    # @return [String] Hashed data
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-    def self.mash(data, len, m)
-      a = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
-      r = Digest::SHA1.hexdigest("#{data}.#{m}")
-      c = ''
-      len = 17 if len > 17
-      limit = 2 * len
-      i = 0
-      while i < limit
-        c << a[r[i..i + 6].to_i(16) % 36]
-        i += 2
-      end
-      c
-    end
-
-    # end mash
-
-    # @param val [String] Token that may or may not be khashed
-    # @return [Boolean] True if token is already khashed
-    def self.khashed?(val)
-      true if val =~ /(\d{6}[A-Z0-9]{14})/
-    end
-  end # end KountSecurityMash
-end
+require 'digest/sha1'
+module Kount
+  ##
+  # This class implements the Kount KHASH for cards and gift cards.
+  # rubocop:disable Style/Documentation
+  class SecurityMash
+    # @param plain_text [String] String to be hashed
+    # @param ptyp [String] Payment type code: CARD, GIFT, or OTHER
+    # @return [String] KHASH version of string
+    def self.hash_token(plain_text, ptyp, ksalt, merchant_id = '')
+      if ptyp == 'CARD'
+        hash_credit_card(plain_text, ksalt)
+      else
+        hash_gift_card(plain_text, ksalt, merchant_id)
+      end
+    end
+
+    # Hash a credit card number.
+    # Preserves first six characters of the input so that hashed cards can be
+    # categorized by Bank Identification Number (BIN).
+    #
+    # Example usage:
+    #   hashed = Kount::SecurityMash.hash_credit_card("4111111111111111")
+    #     Expect: 411111WMS5YA6FUZA1KC
+    #   hashed = Kount::SecurityMash.hash_credit_card("5199185454061655")
+    #     Expect: 5199182NOQRXNKTTFL11
+    #   hashed = Kount::SecurityMash.hash_credit_card("4259344583883")
+    #     Expect: 425934FEXQI1QS6TH2O5
+    #
+    # @param plain_text [String] String to be hashed
+    # @return [String] KHASH version of string
+    def self.hash_credit_card(plain_text, ksalt)
+      return plain_text if khashed?(plain_text)
+      first_six = plain_text[0..5]
+      mashed = mash(plain_text, 14, ksalt)
+      "#{first_six}#{mashed}"
+    end
+
+    # Hash a gift card number.
+    # Use the six characters of the merchant id so that hashed cards can be
+    # unique across the entire domain.
+    #
+    # Example usage:
+    #   hashed = Kount::SecurityMash.hash_gift_card("123456", "3245876")
+    #     Expect: 1234569HXH32Y5NNJCGB
+
+    # @param plain_text [String] String to be hashed
+    # @return [String] KHASH version of string
+    def self.hash_gift_card(plain_text, ksalt, merchant_id)
+      mashed = mash(plain_text, 14, ksalt)
+      "#{merchant_id}#{mashed}"
+    end
+
+    # Compute a base64 hash of the provided data.
+    #
+    # @param data [String] Data to hash
+    # @param len [int] Length of hash to retain
+    # @return [String] Hashed data
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+    def self.mash(data, len, m)
+      a = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+      r = Digest::SHA1.hexdigest("#{data}.#{m}")
+      c = ''
+      len = 17 if len > 17
+      limit = 2 * len
+      i = 0
+      while i < limit
+        c << a[r[i..i + 6].to_i(16) % 36]
+        i += 2
+      end
+      c
+    end
+
+    # end mash
+
+    # @param val [String] Token that may or may not be khashed
+    # @return [Boolean] True if token is already khashed
+    def self.khashed?(val)
+      true if val =~ /(\d{6}[A-Z0-9]{14})/
+    end
+  end # end KountSecurityMash
+end

data/lib/kount/utils/khash.rb

@@ -0,0 +1,47 @@
+module Kount 
+  class Khash
+    # @param plain_text [String] String to be hashed
+    # @param ptyp [String] Payment type code: CARD, GIFT, or OTHER
+    # @return [String] KHASH version of string
+    def self.hash_token(plain_text, ptyp, ksalt, merchant_id = '')
+      if ptyp == 'CARD'
+        HashPaymentToken(plain_text, ksalt)
+      elsif ptyp == 'CHEK'
+        HashCheckPayment(plain_text, ksalt)
+      else
+        HashGiftCard(plain_text, ksalt, merchant_id)
+      end
+    end
+
+    def self.getKhash(data, len, m)
+      a = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+      r = Digest::SHA1.hexdigest("#{data}.#{m}")
+      c = ''
+      len = 17 if len > 17
+      limit = 2 * len
+      i = 0
+      while i < limit
+        c << a[r[i..i + 6].to_i(16) % 36]
+        i += 2
+      end
+      c
+    end
+
+    def self.HashPaymentToken(plain_text, ksalt)
+      first_six = plain_text[0..5]
+      mashed = getKhash(plain_text, 14, ksalt)
+      "#{first_six}#{mashed}"
+    end
+
+    def self.HashCheckPayment(plain_text, ksalt)
+      first_six = plain_text[0..5]
+      mashed = getKhash(plain_text, 14, ksalt)
+      "#{first_six}#{mashed}"
+    end
+
+    def self.HashGiftCard(plain_text, ksalt, merchant_id)
+      mashed = getKhash(plain_text, 14, ksalt)
+      "#{merchant_id}#{mashed}"
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kount_complete
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.7
 platform: ruby
 authors:
 - Kount
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-09 00:00:00.000000000 Z
+date: 2019-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -45,7 +45,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: A wrapper to facilitate making Kount RIS calls
-email: Ruby@kount.com
+email: ruby@kount.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -58,6 +58,7 @@ files:
 - lib/kount/request/inquiry.rb
 - lib/kount/request/update.rb
 - lib/kount/security_mash.rb
+- lib/kount/utils/khash.rb
 homepage: http://rubygems.org/gems/kount_complete
 licenses:
 - MIT
@@ -78,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.5
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: Kount Complete Services Wrapper