kount_complete 2.2.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e78ba40ade6af05b00f647e187aa66351ca6cd67472b5de0b84f39b2008326a9
-  data.tar.gz: 8a149dffc64cf06e1e00f96765ce004ab2df2c44465f51853e353882581bef7a
+  metadata.gz: f0594c812d04334112250610f423e7f3f1bcd57a08395df9ba2ce74a92c72a81
+  data.tar.gz: 829832f26be3fe70c4620920983abd2ee7f5b1f7ca3ef83cbc5df7fb01dcdbc7
 SHA512:
-  metadata.gz: fb98d21ba72460bcc18c5b7581110566969755c1bc476e6b6e834c34928b626b16a92fca128a36ac99d2de82928877ee55275650b91d698607fb843ed84c1b56
-  data.tar.gz: f7e0937dda76d2919e20487a34d8c51a337b79745c7b72d5ec5527e1bfd1a76e5ffbeabdc8e590693c9e935266305015507c6f9b93c1481c17e54167ca711f50
+  metadata.gz: b1c97349871d6aabef60e0598c8dad20d3a0888341302fbeb853457717eeed9b5ba8ee6143ccc3dc75f4b00cb8bccf8b8c88302a3c666487fe21f516738d1413
+  data.tar.gz: 938011bc69fa002935991fb6127f17e997fa7561040038474cbd6118afa6f296ad176c5f576b75a2e8d7d9b86c6feac56b12f3631ece08239d91dfff434fae82

data/lib/kount/Response.rb

@@ -10,287 +10,287 @@ module Response
 
     def get_mode
       modes = @paramlist['MODE'].to_s
-      return modes unless modes.empty?
+      modes unless modes.empty?
     end
 
     def get_version
       vers = @paramlist['VERS'].to_s
-      return vers unless vers.empty?
+      vers unless vers.empty?
     end
 
     def get_transaction_id
       tran = @paramlist['TRAN'].to_s
-      return tran unless tran.empty?
+      tran unless tran.empty?
     end
 
     def get_merchant_id
       merchantid = @paramlist['MERC'].to_s
-      return merchantid unless merchantid.empty?
+      merchantid unless merchantid.empty?
     end
 
     def get_session_id
       sessionid = @paramlist['SESS'].to_s
-      return sessionid unless sessionid.empty?
+      sessionid unless sessionid.empty?
     end
 
     def get_order_number
       orderno = @paramlist['ORDR'].to_s
-      return orderno unless orderno.empty?
+      orderno unless orderno.empty?
     end
 
     def get_site
       site = @paramlist['SITE'].to_s
-      return site unless site.empty?
+      site unless site.empty?
     end
 
     def get_auto
       auto = @paramlist['AUTO'].to_s
-      return auto unless auto.empty?
+      auto unless auto.empty?
     end
 
     def get_score
       score = @paramlist['SCOR'].to_s
-      return score unless score.empty?
+      score unless score.empty?
     end
 
     def get_omniscore
       omniscore = @paramlist['OMNISCORE'].to_s
-      return omniscore unless omniscore.empty?
+      omniscore unless omniscore.empty?
     end
 
     def get_geox
       geox = @paramlist['GEOX'].to_s
-      return geox unless geox.empty?
+      geox unless geox.empty?
     end
 
     def get_brand
       brand = @paramlist['BRND'].to_s
-      return brand unless brand.empty?
+      brand unless brand.empty?
     end
 
     def get_velo
       velo = @paramlist['VELO'].to_s
-      return velo unless velo.empty?
+      velo unless velo.empty?
     end
 
     def get_vmax
       vmax = @paramlist['VMAX'].to_s
-      return vmax unless vmax.empty?
+      vmax unless vmax.empty?
     end
 
     def get_network
       network = @paramlist['NETW'].to_s
-      return network unless network.empty?
+      network unless network.empty?
     end
 
     def get_region
       region = @paramlist['REGN'].to_s
-      return region unless region.empty?
+      region unless region.empty?
     end
 
     def get_kaptcha
       kapt = @paramlist['KAPT'].to_s
-      return kapt unless kapt.empty?
+      kapt unless kapt.empty?
     end
 
     def get_proxy
       proxy = @paramlist['PROXY'].to_s
-      return proxy unless proxy.empty?
+      proxy unless proxy.empty?
     end
 
     def get_emails
       email = @paramlist['EMAILS'].to_s
-      return email unless email.empty?
+      email unless email.empty?
     end
 
     def get_http_country
       httmcountry = @paramlist['HTTP_COUNTRY'].to_s
-      return httmcountry unless httmcountry.empty?
+      httmcountry unless httmcountry.empty?
     end
 
     def get_timezone
       timezone = @paramlist['TIMEZONE'].to_s
-      return timezone unless timezone.empty?
+      timezone unless timezone.empty?
     end
 
     def get_cards
       cards = @paramlist['CARDS'].to_s
-      return cards unless cards.empty?
+      cards unless cards.empty?
     end
 
     def get_pc_remote
       pcremote = @paramlist['PC_REMOTE'].to_s
-      return pcremote unless pcremote.empty?
+      pcremote unless pcremote.empty?
     end
 
     def get_devices
       devices = @paramlist['DEVICES'].to_s
-      return devices unless devices.empty?
+      devices unless devices.empty?
     end
 
     def get_device_layers
       device_layers = @paramlist['DEVICE_LAYERS'].to_s
-      return device_layers unless device_layers.empty?
+      device_layers unless device_layers.empty?
     end
 
     def get_mobile_forwarder
       mobile_forwarder = @paramlist['MOBILE_FORWARDER'].to_s
-      return mobile_forwarder unless mobile_forwarder.empty?
+      mobile_forwarder unless mobile_forwarder.empty?
     end
 
     def get_voice_device
       voicedevice = @paramlist['VOICE_DEVICE'].to_s
-      return voicedevice unless voicedevice.empty?
+      voicedevice unless voicedevice.empty?
     end
 
     def get_local_time
       localtime = @paramlist['LOCALTIME'].to_s
-      return localtime unless localtime.empty?
+      localtime unless localtime.empty?
     end
 
     def get_mobile_type
       mobiletype = @paramlist['MOBILE_TYPE'].to_s
-      return mobiletype unless mobiletype.empty?
+      mobiletype unless mobiletype.empty?
     end
 
     def get_fingerprint
       fingerprint = @paramlist['FINGERPRINT'].to_s
-      return fingerprint unless fingerprint.empty?
+      fingerprint unless fingerprint.empty?
     end
 
     def get_flash
       flash = @paramlist['FLASH'].to_s
-      return flash unless flash.empty?
+      flash unless flash.empty?
     end
 
     def get_language
       language = @paramlist['LANGUAGE'].to_s
-      return language unless language.empty?
+      language unless language.empty?
     end
 
     def get_country
       country = @paramlist['COUNTRY'].to_s
-      return country unless country.empty?
+      country unless country.empty?
     end
 
     def get_javascript
       javascript = @paramlist['JAVASCRIPT'].to_s
-      return javascript unless javascript.empty?
+      javascript unless javascript.empty?
     end
 
     def get_cookies
       cookie = @paramlist['COOKIES'].to_s
-      return cookie unless cookie.empty?
+      cookie unless cookie.empty?
     end
 
     def get_mobile_device
       mobiledevice = @paramlist['MOBILE_DEVICE'].to_s
-      return mobiledevice unless mobiledevice.empty?
+      mobiledevice unless mobiledevice.empty?
     end
 
     def get_pierced_ipaddress
       pip_address = @paramlist['PIP_IPAD'].to_s
-      return pip_address unless pip_address.empty?
+      pip_address unless pip_address.empty?
     end
 
     def get_piercedipaddress_latitude
       pip_lat = @paramlist['PIP_LAT'].to_s
-      return pip_lat unless pip_lat.empty?
+      pip_lat unless pip_lat.empty?
     end
 
     def get_piercedipaddress_longitude
       pip_long = @paramlist['PIP_LON'].to_s
-      return pip_long unless pip_long.empty?
+      pip_long unless pip_long.empty?
     end
 
     def get_piercedipaddress_country
       pip_country = @paramlist['PIP_COUNTRY'].to_s
-      return pip_country unless pip_country.empty?
+      pip_country unless pip_country.empty?
     end
 
     def get_piercedipaddress_region
       pip_region = @paramlist['PIP_REGION'].to_s
-      return pip_region unless pip_region.empty?
+      pip_region unless pip_region.empty?
     end
 
     def get_piercedipaddress_city
       pip_city = @paramlist['PIP_CITY'].to_s
-      return pip_city unless pip_city.empty?
+      pip_city unless pip_city.empty?
     end
 
     def get_piercedipaddress_organization
       pip_org = @paramlist['PIP_ORG'].to_s
-      return pip_org unless pip_org.empty?
+      pip_org unless pip_org.empty?
     end
 
     def get_ipaddress
       ip_ipad = @paramlist['IP_IPAD'].to_s
-      return ip_ipad unless ip_ipad.empty?
+      ip_ipad unless ip_ipad.empty?
     end
 
     def get_ipaddress_latitude
       ip_lat = @paramlist['IP_LAT'].to_s
-      return ip_lat unless ip_lat.empty?
+      ip_lat unless ip_lat.empty?
     end
 
     def get_previous_whitelisted
       whitelisted = @paramlist['PREVIOUSLY_WHITELISTED'].to_s
-      return whitelisted unless whitelisted.empty?
+      whitelisted unless whitelisted.empty?
     end
 
     def get_secure_merchant_response
       merchant_response = @paramlist['THREE_DS_MERCHANT_RESPONSE'].to_s
-      return merchant_response unless merchant_response.empty?
+      merchant_response unless merchant_response.empty?
     end
 
     def get_ipaddress_longitude
       ip_long = @paramlist['IP_LON'].to_s
-      return ip_long unless ip_long.empty?
+      ip_long unless ip_long.empty?
     end
 
     def get_ipaddress_country
       ip_country = @paramlist['IP_COUNTRY'].to_s
-      return ip_country unless ip_country.empty?
+      ip_country unless ip_country.empty?
     end
 
     def get_ipaddress_region
       ip_region = @paramlist['IP_REGION'].to_s
-      return ip_region unless ip_region.empty?
+      ip_region unless ip_region.empty?
     end
 
     def get_ipaddress_city
       ip_city = @paramlist['IP_CITY'].to_s
-      return ip_city unless ip_city.empty?
+      ip_city unless ip_city.empty?
     end
 
     def get_ipaddress_organization
       ip_org = @paramlist['IP_ORG'].to_s
-      return ip_org unless ip_org.empty?
+      ip_org unless ip_org.empty?
     end
 
     def get_date_device_firstseen
       ddfs = @paramlist['DDFS'].to_s
-      return ddfs unless ddfs.empty?
+      ddfs unless ddfs.empty?
     end
 
     def get_useragent_string
       user_agent = @paramlist['UAS'].to_s
-      return user_agent unless user_agent.empty?
+      user_agent unless user_agent.empty?
     end
 
     def get_devicescreen_resolution
       dsr = @paramlist['DSR'].to_s
-      return dsr unless dsr.empty?
+      dsr unless dsr.empty?
     end
 
     def get_os
       os = @paramlist['OS'].to_s
-      return os unless os.empty?
+      os unless os.empty?
     end
 
     def get_browser
       browser = @paramlist['BROWSER'].to_s
-      return browser unless browser.empty?
+      browser unless browser.empty?
     end
 
     def get_numberrules_triggered
@@ -327,14 +327,15 @@ module Response
       @paramlist['ERROR_COUNT'].to_s
     end
 
-    def geterrors
+    def get_errors
       errors = []
-      error_count = get_error_count
-      (0..error_count.to_i - 1).each do |i|
-        errors = @paramlist["ERROR_#{i}"]
+      error_count = get_error_count.to_i
+      (0..error_count - 1).each do |i|
+        errors << @paramlist["ERROR_#{i}"]
       end
       errors.compact
     end
+    alias geterrors get_errors
 
     def get_numbercounters_triggered
       # changed due to rubocop styling rules for ruby

data/lib/kount/client.rb

@@ -1,11 +1,11 @@
-require 'kount/security_mash'
+require 'date'
 require 'kount/cart'
 require 'kount/request'
 require 'kount/request/update'
 require 'kount/request/inquiry'
-require 'rest-client'
 require 'uri'
 require 'kount/utils/khash'
+require 'net/https'
 
 
 module Kount
@@ -26,9 +26,28 @@ module Kount
     # Default endpoint for test. Used by the TEST_DEFAULT_OPTIONS
     ENDPOINT_TEST = 'https://risk.test.kount.net'
 
+    # Default endpoint for Payments Fraud by Kount 360 production. Used by the DEFAULT_OPTIONS
+    PAYMENTS_FRAUD_API_ENDPOINT_PROD = 'https://api.kount.com/commerce/ris'
+
+    # Default endpoint for Payments Fraud by Kount 360 test. Used by the TEST_DEFAULT_OPTIONS
+    PAYMENTS_FRAUD_API_ENDPOINT_TEST = 'https://api-sandbox.kount.com/commerce/ris'
+
+    # Default endpoint for Payments Fraud by Kount 360 production. Used by the DEFAULT_OPTIONS
+    PAYMENTS_FRAUD_AUTH_ENDPOINT_PROD = 'https://login.kount.com/oauth2/ausdppksgrbyM0abp357/v1/token'
+
+    # Default endpoint for Payments Fraud by Kount 360 test. Used by the TEST_DEFAULT_OPTIONS
+    PAYMENTS_FRAUD_AUTH_ENDPOINT_TEST = 'https://login.kount.com/oauth2/ausdppkujzCPQuIrY357/v1/token'
+
+    # Migration mode enabled
+    @migration_mode_enabled = false
+    @access_token = ''
+    @token_expires_at = DateTime.now
+
     # Default params for production
     PROD_DEFAULT_OPTIONS = {
       endpoint: ENDPOINT_PROD,
+      pf_api_endpoint: PAYMENTS_FRAUD_API_ENDPOINT_PROD,
+      pf_auth_endpoint: PAYMENTS_FRAUD_AUTH_ENDPOINT_PROD,
       version: DEFAULT_VERSION,
       is_test: false,
       timeout: 10
@@ -37,6 +56,8 @@ module Kount
     # Default params for test if is_test is TRUE
     TEST_DEFAULT_OPTIONS = {
       endpoint: ENDPOINT_TEST,
+      pf_api_endpoint: PAYMENTS_FRAUD_API_ENDPOINT_TEST,
+      pf_auth_endpoint: PAYMENTS_FRAUD_AUTH_ENDPOINT_TEST,
       version: DEFAULT_VERSION,
       timeout: 10
     }
@@ -50,29 +71,53 @@ module Kount
     # other optional params
     def initialize(params = {})
       @options = {}
+      migration_mode = params[:migration_mode_enabled]
+      if migration_mode.nil?
+        @migration_mode_enabled = false
+      else
+        @migration_mode_enabled = migration_mode.to_s.downcase == 'true'
+      end
+
       if params[:is_test]
         @options.merge!(TEST_DEFAULT_OPTIONS)
       else
         @options.merge!(PROD_DEFAULT_OPTIONS)
       end
+
       @options.merge!(params)
+
+      if @migration_mode_enabled
+        @options[:version] = DEFAULT_VERSION # this is needed for the intg to work correctly
+      end
     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
+    # rubocop:disable Metrics/AbcSize
     def get_response(request)
-      params = prepare_request_params(request)
+      headers = {}
+      if @migration_mode_enabled
+        if @token_expires_at.nil? || DateTime.now >= @token_expires_at
+          refresh_pf_auth_token
+          if @access_token.nil? || @access_token == ''
+            raise RuntimeError, 'Access token could not be retrieved'
+          end
+          headers = pf_http_headers
+          headers.merge!({ 'Authorization': "Bearer #{@access_token}" })
+        end
+      else
+        headers = http_headers
+      end
+
+      payload = URI.encode_www_form(prepare_request_params(request))
       response = {}
       begin
-        response = RestClient::Resource.new(
-          endpoint,
-          verify_ssl: verify_ssl_option, timeout: timeout
-        ).post params, x_kount_api_key: key
-
-        JSON.parse(response)
-      rescue StandardError
+        resp = http.post(http_path, payload, headers)
+        response = JSON.parse(resp.body)
+      rescue StandardError => e
+        puts e
         # RIS errors do not come back as JSON, so just pass them along raw.
         response
       end
@@ -86,6 +131,9 @@ module Kount
 
     # Kount Merchant ID
     def merchant_id
+      if @migration_mode_enabled
+        return @options[:pf_client_id]
+      end
       @options[:merchant_id]
     end
 
@@ -96,6 +144,9 @@ module Kount
 
     # RIS Endpoint URL
     def endpoint
+      if @migration_mode_enabled
+        return @options[:pf_api_endpoint]
+      end
       @options[:endpoint]
     end
 
@@ -104,7 +155,7 @@ module Kount
       @options[:timeout]
     end
 
-    # Merchant API for RIS acess
+    # Merchant API for RIS access
     def key
       @options[:key]
     end
@@ -121,13 +172,65 @@ module Kount
 
     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
+    def endpoint_uri
+      @endpoint_uri ||= URI(endpoint)
+    end
+
+    # rubocop:disable Metrics/AbcSize
+    def http
+      if endpoint_uri.host.nil? || endpoint_uri.port.nil?
+        raise ArgumentError, 'Invalid endpoint or port'
+      end
+      net_http = Net::HTTP.new(endpoint_uri.host, endpoint_uri.port)
+      if endpoint_uri.scheme == 'https'
+        net_http.use_ssl = true
+        net_http.verify_mode = test? ? OpenSSL::SSL::VERIFY_NONE : OpenSSL::SSL::VERIFY_PEER
+        OpenSSL::SSL::SSLContext::DEFAULT_PARAMS[:options] |= OpenSSL::SSL::OP_IGNORE_UNEXPECTED_EOF
       end
+      net_http.open_timeout = timeout
+      net_http.read_timeout = timeout
+      net_http.ignore_eof = true
+      net_http
+    end
+
+    def http_headers
+      {
+        'Accept' => 'application/json',
+        'Content-Type' => 'application/x-www-form-urlencoded',
+        'User-Agent' => "SDK-RIS-Ruby/#{Config::SDK_VERSION}",
+        'X-Kount-Api-Key' => key
+      }
+    end
+
+    def pf_http_headers
+      {
+        'Accept' => 'application/json',
+        'Content-Type' => 'application/x-www-form-urlencoded',
+        'User-Agent' => "SDK-RIS-Ruby/#{Config::SDK_VERSION}",
+        'Authorization' => 'Bearer '
+      }
+    end
+
+    # rubocop:disable Metrics/AbcSize
+    def refresh_pf_auth_token
+      payload = URI.encode_www_form({ grant_type: 'client_credentials', scope: 'k1_integration_api' })
+      headers = { Authorization: "Basic #{@options[:pf_api_key]}", 'Content-Type': 'application/x-www-form-urlencoded' }
+      uri = URI(@options[:pf_auth_endpoint])
+      client = Net::HTTP.new(uri.host, uri.port)
+      client.ignore_eof = true
+      client.use_ssl = true
+      response = client.post(@options[:pf_auth_endpoint],  payload, headers)
+
+      return unless response.code == '200'
+
+      data = JSON.parse(response.body)
+      expires_in = data['expires_in'].to_i
+      @access_token = data['access_token']
+      @token_expires_at = DateTime.now.to_time + (expires_in - 60) # less 60 seconds for latency
+    end
+
+    def http_path
+      endpoint_uri.path.empty? ? '/' : endpoint_uri.path
     end
   end
 end

data/lib/kount/config.rb

@@ -8,7 +8,7 @@ module Kount
         # SDK release version
         # Set the sdk release version which will be used for git tagging in github
         # This will be set by the build process
-        SDK_VERSION = '2.2.0'
+        SDK_VERSION = '3.0.0'
 
     end
 end

data/lib/kount/payment_types.rb

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

data/lib/kount/request/inquiry.rb

@@ -38,23 +38,19 @@ module Kount
 
     # 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.hash_payment_token(ptok, ksalt)
+      when 'CARD'
+        return if params[:PENC] == 'MASK'
+        ptok = Kount::Khash.hash_payment_token(params[:PTOK], ksalt)
         params.merge!(PTOK: ptok, PENC: 'KHASH')
-      when 'GIFT', 'OTHER'
-        #ptok = Kount::SecurityMash.hash_gift_card(ptok, ksalt, merchant_id)
-        ptok = Kount::Khash.hash_gift_card(ptok, ksalt, merchant_id)
+      when 'CHEK', 'PYPL'
+        ptok = Kount::Khash.hash_payment_token(params[:PTOK], ksalt)
         params.merge!(PTOK: ptok, PENC: 'KHASH')
-      when 'CHEK', 'OTHER'
-        ptok = Kount::Khash.hash_check_payment(ptok, ksalt)
+      when 'GIFT' 
+        ptok = Kount::Khash.hash_gift_card(params[:PTOK], ksalt, merchant_id)
         params.merge!(PTOK: ptok, PENC: 'KHASH')
       when 'NONE'
-        params.merge!(PTOK: nil, PENC: nil)
-      else
-        params[:PENC] ||= 'NONE'
+        params.merge!(PTOK: nil)
       end
     end
 

data/lib/kount/request.rb

@@ -1,4 +1,3 @@
-require 'kount/security_mash'
 module Kount
   ##
   # This class acts as an abstract class for each type of request.
@@ -37,9 +36,11 @@ module Kount
     end
 
     # Add LBIN to request
+    # <b>DEPRECATED:</b> Please provide <tt>in the request constructor hash param</tt> instead.
     # Supports BIN lengths of 6 digits or greater
     # @param lbin [String] Long Bank Identification Number
     def add_lbin(lbin)
+      warn "[DEPRECATION] LBIN should be provided in the constructor hash instead"
       params.merge!(LBIN: lbin)
     end
   end

data/lib/kount/security_mash.rb

@@ -1,82 +1,27 @@
-require 'digest/sha1'
 module Kount
-  ##
-  # This class implements the Kount KHASH for cards and gift cards.
-  
   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
+
+    # <b>DEPRECATED:</b> This function should not be used. It duplicates the concerns of Kount::Inquiry.fixup_payment_params.
+    def self.hash_token(_plain_text, _ptyp, _ksalt, _merchant_id = '')
+        raise "do not use this function, prefer to use Kount::Inquiry.fixup_payment_params"
     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
+    # <b>DEPRECATED:</b> Use Kount::Khash.hash_payment_token instead.
     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}"
+      warn "[DEPRECATION] use Kount::Khash.hash_payment_token instead"
+      Kount::Khash.hash_payment_token(plain_text, ksalt)
     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
+  
+    # <b>DEPRECATED:</b> Use Kount::Khash.hash_gift_card instead.
     def self.hash_gift_card(plain_text, ksalt, merchant_id)
-      mashed = mash(plain_text, 14, ksalt)
-      "#{merchant_id}#{mashed}"
+      warn "[DEPRECATION] use Kount::Khash.has_gift_card instead"
+      Kount::Khash.hash_gift_card(plain_text, ksalt, merchant_id)
     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
+    # <b>DEPRECATED:</b> Use Kount::Khash.hash_gift_card instead.
     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})/
+      warn "[DEPRECATION] use Kount::Khash.getkhash instead"
+      Kount::Khash.getkhash(data, len, m)
     end
-  end # end KountSecurityMash
+  end
 end

data/lib/kount/utils/khash.rb

@@ -1,21 +1,58 @@
 module Kount 
-  class Khash
+  module Khash
+    # Hash a PAN.
+    #
+    # Preserves first six characters of the input so that hashed cards can be
+    # categorized by Bank Identification Number (BIN).
+    #
+    # Example usage:
+    #   hashed = Kount::Khash.hash_payment_token("4111111111111111", ksalt)
+    #     Expect: 411111WMS5YA6FUZA1KC
+    #
     # @param plain_text [String] String to be hashed
-    # @param ptyp [String] Payment type code: CARD, GIFT, or OTHER
+    # @param ksalt      [String] The kount khash salt provided by Kount
+    #
     # @return [String] KHASH version of string
-    def self.hash_token(plain_text, ptyp, ksalt, merchant_id = '')
-      # changed if-else to case-when to follow ruby coding standard
+    def self.hash_payment_token(plain_text, ksalt)
+      return plain_text if khashed?(plain_text)
+      mashed = getkhash(plain_text, 14, ksalt)
+      "#{plain_text[0..5]}#{mashed}"
+    end
 
-      case ptyp
-      when 'CARD'
-        HashPaymentToken(plain_text, ksalt)
-      when 'CHEK'
-        HashCheckPayment(plain_text, ksalt)
-      else
-        HashGiftCard(plain_text, ksalt, merchant_id)
-      end
+    # <b>DEPRECATED:</b> Use Kount::Khash.hash_payment_token instead.
+    def self.hash_check_payment(plain_text, ksalt)
+      warn "[DEPRECATION] use Kount::Khash.hash_payment_token instead"
+      hash_payment_token(plain_text, ksalt)
     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("3245876", salt, "123456")
+    #     Expect: 1234569HXH32Y5NNJCGB
+    #
+    # @param plain_text  [String] String to be hashed
+    # @param ksalt       [String] The kount khash salt provided by Kount
+    # @param merchant_id [String] The merchant id that will serve as the common domain of all gift
+    #        cards
+    #
+    # @return [String] KHASH version of string
+    def self.hash_gift_card(plain_text, ksalt, merchant_id)
+      return plain_text if khashed?(plain_text)
+      mashed = getkhash(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
+    # @param m    [String] The kount khash salt
+    #
+    # @return [String] Hashed data
     def self.getkhash(data, len, m)
       a = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
       r = Digest::SHA1.hexdigest("#{data}.#{m}")
@@ -30,30 +67,10 @@ module Kount
       c
     end
 
-    def self.hash_payment_token(plain_text, ksalt)
-      return plain_text if khashed?(plain_text)
-      first_six = plain_text[0..5]
-      mashed = getkhash(plain_text, 14, ksalt)
-      "#{first_six}#{mashed}"
-    end
-
-    def self.hash_check_payment(plain_text, ksalt)
-      return plain_text if khashed?(plain_text)
-      first_six = plain_text[0..5]
-      mashed = getkhash(plain_text, 14, ksalt)
-      "#{first_six}#{mashed}"
-    end
-
-    def self.hash_gift_card(plain_text, ksalt, merchant_id)
-      mashed = getkhash(plain_text, 14, ksalt)
-      "#{merchant_id}#{mashed}"
-    end
-
     # @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

metadata

@@ -1,49 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kount_complete
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Kount
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-08 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rest-client
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.8.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.8.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0'
+date: 2025-02-24 00:00:00.000000000 Z
+dependencies: []
 description: A wrapper to facilitate making Kount RIS calls
 email: ruby@kount.com
 executables: []
@@ -65,7 +30,6 @@ homepage: http://rubygems.org/gems/kount_complete
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -73,15 +37,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: 3.2.7
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.5
+      version: 3.6.2
 requirements: []
-rubygems_version: 3.2.32
-signing_key: 
+rubygems_version: 3.6.5
 specification_version: 4
 summary: Kount Complete Services Wrapper
 test_files: []