minfraud 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e3c2e76357a683ceda7350bde7dc4c89cc6055d473b771ee74041d4371f05f7
-  data.tar.gz: 60aacbf2435a51f65c9d9702e209ddab469d21dd672ba8d5baf34dae807deb2f
+  metadata.gz: e2805f5d3d40b2d325926a4a5614b86248bba07f905ffb37ec7dfa9589e97103
+  data.tar.gz: 6d70e15b76a295c376232e6bf277e619ed783c23e46460e89e527458813b44ec
 SHA512:
-  metadata.gz: ebdccdbdb2d97665faabbf8486cdeb029e1a1d372a09a1ffeff226f5f900d99887e6e370e01515543983c46f86d4083fa347e557d82c5dde265b079e055adddc
-  data.tar.gz: 61f65f9cc64dd1e0c205c5c2f8df5acfb621dc1ae80b828d5df27e0616964ac0c0a1315b609a4a3228b1f9ecce78dd31411b66513c25eb4311532b3b9f71d775
+  metadata.gz: 7a4e77f3d92e6173426e5151b234badc9fbe2503e41178d104eeda51c016835c6459308eaaa810063666030369e89828f1919731add25be6b51e0bf50821704a
+  data.tar.gz: a07520d278d5191c2ac5dc9684d9d52ca670a494b088b56b4f8b920a0198ad53469e473d8114e9d33a891e4daa3f5ffa3573cf2190284dfb993b7e57742f9ca3

data/.github/workflows/rubocop.yml

@@ -7,6 +7,6 @@ jobs:
       - uses: actions/checkout@v2
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.0'
+          ruby-version: 3.1
       - run: bundle install
       - run: bundle exec rake -t rubocop

data/.github/workflows/test.yml

@@ -13,6 +13,7 @@ jobs:
             2.6,
             2.7,
             '3.0',
+            3.1,
             jruby,
           ]
         exclude:

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## v2.1.0 (2022-01-25)
+
+* Adds the following new processor to `Minfraud::Components::Payment`:
+  * `:windcave`
+* The `last_4_digits` input to `Minfraud::Components::CreditCard` has been
+  deprecated in favor of `last_digits` and will be removed in a future
+  release. `last_digits`/`last_4_digits` also now supports two digit values
+  in addition to the previous four digit values.
+* Eight digit `issuer_id_number` inputs are now supported by
+  `Minfraud::Components::CreditCard` in addition to the previously accepted
+  six digit `issuer_id_number`. In most cases, you should send the last four
+  digits for `last_digits`. If you send an `issuer_id_number` that contains
+  an eight digit IIN, and if the credit card brand is not one of the
+  following, you should send the last two digits for `last_digits`:
+  * `Discover`
+  * `JCB`
+  * `Mastercard`
+  * `UnionPay`
+  * `Visa`
+
 ## v2.0.0 (2021-12-06)
 
 * Breaking change from 1.x: Removed deprecated methods
@@ -60,7 +80,7 @@
 
 ## v1.5.0 (2021-02-02)
 
-* Add the `hash_address` attribute to `Minfraud::Components::Email`. If
+* Adds the `hash_address` attribute to `Minfraud::Components::Email`. If
   this is `true`, the MD5 hash of the `address` will be sent instead of the
   plain text `address`. Use this if you prefer to send the hash of the
   `address` rather than the plain text. Note that this normalizes the
@@ -70,7 +90,7 @@
   input is set but the `domain` is not.
 * Adds new payment processors `:apple_pay` and `:aps_payments` to
   `Minfraud::Components::Payment`.
-* Added support for the IP address risk reasons in the minFraud Insights
+* Adds support for the IP address risk reasons in the minFraud Insights
   and Factors responses. This is available at `.ip_address.risk_reasons`.
   It is an array of `IPRiskReason` objects.
 
@@ -84,7 +104,7 @@
 
 * IMPORTANT: Ruby 2.0 is no longer supported. If you're using Ruby 2.0,
   please use version 1.3.0.
-* Add handling for the `REQUEST_INVALID` error code.
+* Adds handling for the `REQUEST_INVALID` error code.
 * The IP address is no longer a required input.
 * Adds new payment processor `:tsys` to `Minfraud::Components::Payment`.
 

data/LICENSE.txt

@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
 Copyright (c) 2016-2020 kushnir.yb
-Copyright (c) 2020-2021 MaxMind, Inc.
+Copyright (c) 2020-2022 MaxMind, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -123,7 +123,7 @@ assessment = Minfraud::Assessments.new(
   },
   credit_card: {
     issuer_id_number:         '411111',
-    last_4_digits:            '7643',
+    last_digits:              '7643',
     bank_name:                'Bank of No Hope',
     bank_phone_country_code:  '1',
     bank_phone_number:        '123-456-1234',
@@ -283,7 +283,7 @@ This API uses [Semantic Versioning](https://semver.org/).
 
 Copyright (c) 2016-2020 kushnir.yb.
 
-Copyright (c) 2020-2021 MaxMind, Inc.
+Copyright (c) 2020-2022 MaxMind, Inc.
 
 The gem is available as open source under the terms of the [MIT
 License](https://opensource.org/licenses/MIT).

data/lib/minfraud/components/credit_card.rb

@@ -8,16 +8,18 @@ module Minfraud
     class CreditCard < Base
       include Minfraud::Validates
 
-      # The issuer ID number for the credit card. This is the first 6 digits of
-      # the credit card number. It identifies the issuing bank.
+      # The issuer ID number for the credit card. This is the first 6 or 8
+      # digits of the credit card number. It identifies the issuing bank.
       #
       # @return [String, nil]
       attr_accessor :issuer_id_number
 
-      # The last four digits of the credit card number.
+      # The last two or four digits of the credit card number.
+      #
+      # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--credit-card__last_digits
       #
       # @return [String, nil]
-      attr_accessor :last_4_digits
+      attr_accessor :last_digits
 
       # The name of the issuing bank as provided by the end user.
       #
@@ -72,12 +74,30 @@ module Minfraud
       # @return [Boolean, nil]
       attr_accessor :was_3d_secure_successful
 
+      # Get the last digits of the credit card number.
+      #
+      # @deprecated Use {::last_digits} instead.
+      #
+      # @return [String, nil]
+      def last_4_digits
+        @last_digits
+      end
+
+      # Set the last digits of the credit card number.
+      #
+      # @deprecated Use {::last_digits} instead.
+      #
+      # @return [String, nil]
+      def last_4_digits=(last4)
+        @last_digits = last4
+      end
+
       # @param params [Hash] Hash of parameters. Each key/value should
       #   correspond to one of the available attributes.
       def initialize(params = {})
         @bank_phone_country_code  = params[:bank_phone_country_code]
         @issuer_id_number         = params[:issuer_id_number]
-        @last_4_digits            = params[:last_4_digits]
+        @last_digits              = params[:last_digits] || params[:last_4_digits]
         @bank_name                = params[:bank_name]
         @bank_phone_number        = params[:bank_phone_number]
         @avs_result               = params[:avs_result]
@@ -94,8 +114,8 @@ module Minfraud
         return if !Minfraud.enable_validation
 
         validate_telephone_country_code('bank_phone_country_code', @bank_phone_country_code)
-        validate_regex('issuer_id_number', /\A[0-9]{6}\z/, @issuer_id_number)
-        validate_regex('last_4_digits', /\A[0-9]{4}\z/, @last_4_digits)
+        validate_regex('issuer_id_number', /\A(?:[0-9]{6}|[0-9]{8})\z/, @issuer_id_number)
+        validate_regex('last_digits', /\A(?:[0-9]{2}|[0-9]{4})\z/, @last_digits)
         validate_string('bank_name', 255, @bank_name)
         validate_string('bank_phone_number', 255, @bank_phone_number)
         validate_string('avs_result', 1, @avs_result)

data/lib/minfraud/components/payment.rb

@@ -164,6 +164,7 @@ module Minfraud
         virtual_card_services
         vme
         vpos
+        windcave
         wirecard
         worldpay
       ]

data/lib/minfraud/model/factors.rb

@@ -7,7 +7,7 @@ module Minfraud
   module Model
     # Model representing the Factors response.
     class Factors < Insights
-      # An object containing subscores for many of the individual components
+      # An object containing scores for many of the individual risk factors
       # that are used to calculate the overall risk score.
       #
       # @return [Minfraud::Model::Subscores]

data/lib/minfraud/model/subscores.rb

@@ -4,7 +4,7 @@ require 'minfraud/model/abstract'
 
 module Minfraud
   module Model
-    # Subscores for components that are used in calculating the riskScore.
+    # Score for risk factors that are used in calculating the riskScore.
     class Subscores < Abstract
       # The risk associated with the AVS result. If present, this is a value in
       # the range 0.01 to 99.

data/lib/minfraud/version.rb

@@ -2,5 +2,5 @@
 
 module Minfraud
   # The Gem version.
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

data/minfraud.gemspec

@@ -25,13 +25,13 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'connection_pool', '~> 2.2'
   spec.add_runtime_dependency 'http', '>= 4.3', '< 6.0'
   spec.add_runtime_dependency 'maxmind-geoip2', '~> 1.1'
-  spec.add_runtime_dependency 'simpleidn', '>= 0.1.1'
+  spec.add_runtime_dependency 'simpleidn', '~> 0.1', '>= 0.1.1'
 
-  spec.add_development_dependency 'bundler', '>= 1.16'
-  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'bundler', '~> 2.2'
+  spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop'
-  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'rubocop', '~> 1.23'
+  spec.add_development_dependency 'webmock', '~> 3.14'
   spec.metadata = {
     'rubygems_mfa_required' => 'true'
   }

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: minfraud
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - kushnir.yb
 - William Storey
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-12-06 00:00:00.000000000 Z
+date: 2022-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -63,6 +63,9 @@ dependencies:
   name: simpleidn
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.1
@@ -70,6 +73,9 @@ dependencies:
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.1
@@ -77,30 +83,30 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -119,31 +125,31 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.23'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.23'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: 
+        version: '3.14'
+description:
 email:
 - support@maxmind.com
 executables: []
@@ -216,7 +222,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -232,7 +238,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.2.22
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Ruby API for the minFraud Score, Insights, Factors, and Report Transactions
   services