minfraud 2.8.0 → 2.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2abf19bed1e7f84df745ea0d6fb2564a57cbdb5047f4bf999bcb4812cb3a0c92
-  data.tar.gz: 8b6a0cf12fa4ff3f9cbb907fc6e85a67b9c83e49f0f40efd395b4fe8adf2219f
+  metadata.gz: 2e9a3d34fdcba8b336c22ccfb3088f42cf08e9debccc2a9f97e80cefe5f2c79d
+  data.tar.gz: 851ce59eec3a798f76821ddcd06e73840d5911735aa0f8be802c95caa340005f
 SHA512:
-  metadata.gz: 565e3a8117bba664ae7acdd4e8c8638b24a8bb6140b4239d4839ba431a5b19c27dcf4dd352e44902ba55624757bbbb8617abb26414c38321d2566548ad4164d6
-  data.tar.gz: 7425846de023014cbe8aaccde3dcd7d4dc0df494fc2f8b8e7370bb8eb5ed5ca80cddc40f7440c8a443feb83fc574b3a24ac0efc72040e302abf1838295fe239a
+  metadata.gz: 4d5832ed02bbfe75d68e1232629815a1fe18be611f62d01b04c361d99efdc6125970abde150bd8ff52be2725c177bd72ac4600fee9030cabb53913eb552c7131
+  data.tar.gz: 9a8e36fb6925f617296fc4d5c472f3fed5d73a95715aaf3f5c098987ffb74e6218e7509a24fb0b38c73458e149969fdbcf05052a8b9b86ef9d631d921b13b211

data/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## v2.10.0 (2026-07-21)
+
+* Added the `residential` attribute to the `anonymizer` object on
+  `Minfraud::Model::IPAddress`. This object contains residential proxy
+  data for the network, including a confidence score, the network last
+  seen date, and the provider name. It may be populated even when no
+  other anonymizer attributes are set. This is only available from the
+  minFraud Insights and Factors web services.
+* Added the `tracking_token` attribute to `Minfraud::Components::Device`.
+  This is the token generated by the
+  [Device Tracking Add-on](https://dev.maxmind.com/minfraud/track-devices)
+  for explicit device linking.
+* Added the processors `:banquest`, `:fat_zebra`, `:summit_payments`, and
+  `:yaadpay` to `Minfraud::Components::Payment`.
+* Added `:clear` to the valid values for the `tag` attribute on
+  `Minfraud::Components::Report::Transaction`.
+* Unnecessary files were removed from the published .gem.
+
+## v2.9.0 (2025-11-20)
+
+* Added the processor `:securepay` to `Minfraud::Components::Payment`.
+* Ruby 3.2+ is now required. If you're using Ruby 3.0 or 3.1, please use
+  version 2.8.0 of this gem.
+* Added `/event/type` values `:credit_application` and `:fund_transfer` to
+  `Minfraud::Components::Event`.
+* Added the `/event/type` value `:sim_swap` to
+  `Minfraud::Components::Event`.
+* Added the input `/event/party`. This is the party submitting the
+  transaction. You may provide this using the `party` attribute on
+  `Minfraud::Components::Event`.
+* Added the input `/payment/method`. This is the payment method associated
+  with the transaction. You may provide this using the `method` attribute
+  on `Minfraud::Components::Payment`.
+* Added support for new email domain outputs on `Minfraud::Model::EmailDomain`:
+  * `/email/domain/classification` - The domain type (e.g., business,
+    education, government, isp_email). Available as the `classification`
+    attribute.
+  * `/email/domain/risk` - A risk score from 0.01 to 99 for the domain.
+    Available as the `risk` attribute.
+  * `/email/domain/volume` - Activity across the minFraud network expressed
+    as sightings per million. Available as the `volume` attribute.
+  * `/email/domain/visit` - Information from an automated visit to the
+    domain. Available as the `visit` attribute, which returns a
+    `Minfraud::Model::EmailDomainVisit` object.
+* Added support for email domain visit outputs on
+  `Minfraud::Model::EmailDomainVisit`:
+  * `/email/domain/visit/has_redirect` - Whether the domain redirects to
+    another URL. Available as the `has_redirect` attribute.
+  * `/email/domain/visit/last_visited_on` - The date the automated visit
+    was completed. Available as the `last_visited_on` attribute.
+  * `/email/domain/visit/status` - The status of the domain (e.g., live,
+    dns_error, parked). Available as the `status` attribute.
+* Updated `maxmind-geoip2` to 1.4, which includes new anonymizer and IP
+  risk outputs.
+
 ## v2.8.0 (2025-05-23)
 
 * Added support for the `/billing_phone/matches_postal` and

data/LICENSE.txt

@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
 Copyright (c) 2016-2020 kushnir.yb
-Copyright (c) 2020-2025 MaxMind, Inc.
+Copyright (c) 2020-2026 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

@@ -3,9 +3,9 @@
 ## Description
 
 This package provides an API for the [MaxMind minFraud web
-services](https://dev.maxmind.com/minfraud?lang=en). This includes minFraud Score,
+services](https://dev.maxmind.com/minfraud/?lang=en). This includes minFraud Score,
 Insights, and Factors. It also includes our [minFraud Report Transaction
-API](https://dev.maxmind.com/minfraud/report-a-transaction?lang=en).
+API](https://dev.maxmind.com/minfraud/report-a-transaction/?lang=en).
 
 The legacy minFraud Standard and Premium services are not supported by this
 API.
@@ -48,7 +48,7 @@ Minfraud.configure do |c|
   c.license_key = 'your_license_key'
   c.enable_validation = true
 end
-````
+```
 
 To use the Sandbox web service instead of the production web service, you can provide the host:
 
@@ -69,8 +69,8 @@ creating the object.
 
 After populating the object, call the method for the minFraud endpoint you
 want to use: `#score`, `#insights`, or `#factors`. The returned value is a
-`MinFraud::Response` object. You can access the response model through its
-`#body` attribute.
+`Minfraud::HTTPService::Response` object. You can access the response model
+through its `#body` attribute.
 
 An exception will be thrown for critical errors. You should check for
 `warnings` related to your inputs after a request.
@@ -83,9 +83,11 @@ assessment = Minfraud::Assessments.new(
     accept_language: 'en-US,en;q=0.8',
     session_age:     3600.5,
     session_id:      'foo',
+    tracking_token:  'abc123',
     user_agent:      'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.89 Safari/537.36',
   },
   event: {
+    party:          :customer,
     transaction_id: 'txn3134133',
     shop_id:        's2123',
     time:           '2012-04-12T23:20:50+00:00',
@@ -127,6 +129,7 @@ assessment = Minfraud::Assessments.new(
     delivery_speed:     :same_day,
   },
   payment: {
+    method:         :card,
     processor:      :stripe,
     was_authorized: false,
     decline_code:   'invalid number',
@@ -243,6 +246,8 @@ this functionality.
 
 The gem supplies several distinct exception-types:
 
+* `InvalidInputError` - Raised if an input value is invalid when client-side
+  validation is enabled
 * `RequestFormatError` - Raised if an unknown key is provided to the
   `Minfraud::Assessments` constructor
 * `ClientError` - Raised if the IP address is absent, reserved, or the JSON
@@ -271,11 +276,11 @@ Please report all issues with this code using the
 
 If you are having an issue with the minFraud service that is not specific
 to the client API, please see
-[our support page](https://www.maxmind.com/en/support).
+[our support page](https://support.maxmind.com/knowledge-base).
 
 ## Requirements
 
-This gem works with Ruby 3.0 and above.
+This gem works with Ruby 3.2 and above.
 
 ## Contributing
 
@@ -283,7 +288,7 @@ Bug reports and pull requests are welcome on
 [GitHub](https://github.com/maxmind/minfraud-api-ruby). This project is
 intended to be a safe, welcoming space for collaboration, and contributors
 are expected to adhere to the [Contributor
-Covenant](https://contributor-covenant.org) code of conduct.
+Covenant](https://www.contributor-covenant.org/) code of conduct.
 
 ## Versioning
 
@@ -293,10 +298,10 @@ This API uses [Semantic Versioning](https://semver.org/).
 
 Copyright (c) 2016-2020 kushnir.yb.
 
-Copyright (c) 2020-2025 MaxMind, Inc.
+Copyright (c) 2020-2026 MaxMind, Inc.
 
 The gem is available as open source under the terms of the [MIT
-License](https://opensource.org/licenses/MIT).
+License](https://opensource.org/license/MIT).
 
 ## Thank You
 

data/lib/minfraud/assessments.rb

@@ -4,7 +4,7 @@ module Minfraud
   # Assessments is used to perform minFraud Score, Insights, and Factors
   # requests.
   #
-  # @see https://dev.maxmind.com/minfraud?lang=en
+  # @see https://dev.maxmind.com/minfraud/?lang=en
   class Assessments
     include ::Minfraud::Resolver
 

data/lib/minfraud/components/account.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Account corresponds to the account object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--account
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--account
     class Account < Base
       include Minfraud::Validates
 

data/lib/minfraud/components/base.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 module Minfraud
+  # Components are used to build the request to the minFraud services.
+  # Each component represents a part of the transaction being analyzed,
+  # such as the device, account, email, or billing address.
   module Components
     # This is a parent class for all components. It defines a method which is
     # used for basic JSON representation of the component objects.

data/lib/minfraud/components/billing.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Billing corresponds to the billing object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--billing
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--billing
     class Billing < Addressable; end
   end
 end

data/lib/minfraud/components/credit_card.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # CreditCard corresponds to the credit_card object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--credit-card
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--credit-card
     class CreditCard < Base
       include Minfraud::Validates
 
@@ -14,9 +14,10 @@ module Minfraud
       # @return [String, nil]
       attr_accessor :issuer_id_number
 
-      # The last two or four digits of the credit card number.
+      # The last two or four digits of the credit card number. In most cases,
+      # you should send the last four digits for +last_digits+.
       #
-      # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--credit-card__last_digits
+      # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--credit-card__last_digits
       #
       # @return [String, nil]
       attr_accessor :last_digits
@@ -42,7 +43,7 @@ module Minfraud
       attr_accessor :bank_phone_number
 
       # The two character ISO 3166-1 alpha-2 country code where the issuer of
-      # the card is located. This may be passed instead of {::issuer_id_number}
+      # the card is located. This may be passed instead of {#issuer_id_number}
       # if you do not wish to pass partial account numbers, or if your payment
       # processor does not provide them.
       #
@@ -74,7 +75,7 @@ module Minfraud
       # @return [String, nil]
       attr_accessor :cvv_result
 
-      # Whether the outcome of 3-D Secure verification (e.g. Safekey,
+      # Whether the outcome of 3-D Secure verification (e.g. SafeKey,
       # SecureCode, Verified by Visa) was successful. +true+ if customer
       # verification was successful, or +false+ if the customer failed
       # verification. If 3-D Secure verification was not used, was unavailable,
@@ -86,7 +87,7 @@ module Minfraud
 
       # Get the last digits of the credit card number.
       #
-      # @deprecated Use {::last_digits} instead.
+      # @deprecated Use {#last_digits} instead.
       #
       # @return [String, nil]
       def last_4_digits
@@ -95,7 +96,7 @@ module Minfraud
 
       # Set the last digits of the credit card number.
       #
-      # @deprecated Use {::last_digits} instead.
+      # @deprecated Use {#last_digits} instead.
       #
       # @return [String, nil]
       def last_4_digits=(last4)

data/lib/minfraud/components/custom_inputs.rb

@@ -5,7 +5,7 @@ module Minfraud
     # CustomInputs corresponds to the custom_inputs object of a minFraud
     # request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--custom-inputs
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--custom-inputs
     class CustomInputs < Base
       include Minfraud::Validates
 

data/lib/minfraud/components/device.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Device corresponds to the device object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--device
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--device
     class Device < Base
       include Minfraud::Validates
 
@@ -40,6 +40,12 @@ module Minfraud
       # @return [String, nil]
       attr_accessor :session_id
 
+      # The token generated by the Device Tracking Add-on for explicit
+      # device linking.
+      #
+      # @return [String, nil]
+      attr_accessor :tracking_token
+
       # @param params [Hash] Hash of parameters. Each key/value should
       #   correspond to one of the available attributes.
       def initialize(params = {})
@@ -48,6 +54,7 @@ module Minfraud
         @accept_language = params[:accept_language]
         @session_age     = params[:session_age]
         @session_id      = params[:session_id]
+        @tracking_token  = params[:tracking_token]
 
         validate
       end

data/lib/minfraud/components/email.rb

@@ -7,7 +7,7 @@ module Minfraud
   module Components
     # Email corresponds to the email object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--email
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#email
     class Email < Base
       include Minfraud::Validates
 
@@ -99,7 +99,7 @@ module Minfraud
         end
 
         if domain == 'gmail.com'
-          local_part.gsub!('.', '')
+          local_part.delete!('.')
         end
 
         domain_parts = domain.split('.')
@@ -384,7 +384,7 @@ module Minfraud
 
         idx = domain.rindex('.')
         if !idx.nil?
-          tld = domain[idx + 1..]
+          tld = domain[(idx + 1)..]
           if TYPO_TLDS.key?(tld)
             domain = "#{domain[0, idx]}.#{TYPO_TLDS[tld]}"
           end

data/lib/minfraud/components/event.rb

@@ -4,11 +4,23 @@ module Minfraud
   module Components
     # Event corresponds to the event object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--event
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--event
     class Event < Base
       include ::Minfraud::Enum
       include Minfraud::Validates
 
+      # The party submitting the transaction. This must be one of +:agent+ or
+      # +:customer+.
+      #
+      # @!attribute party
+      #
+      # @return [Symbol, nil]
+      enum_accessor :party,
+                    %i[
+                      agent
+                      customer
+                    ]
+
       # Your internal ID for the transaction. MaxMind can use this to locate a
       # specific transaction in logs, and it will also show up in email alerts
       # and notifications from MaxMind to you. No specific format is required.
@@ -26,18 +38,19 @@ module Minfraud
 
       # The date and time the event occurred. The string must be in the RFC
       # 3339 date-time format, e.g., "2012-04-12T23:20:50.52Z". The time must
-      # be within the past 10 years. If this field is not in the request, the
+      # be within the past year. If this field is not in the request, the
       # current time will be used.
       #
-      # @see https://tools.ietf.org/html/rfc3339
+      # @see https://datatracker.ietf.org/doc/html/rfc3339
       #
       # @return [String, nil]
       attr_accessor :time
 
       # The type of event being scored. This must be one of
-      # +:account_creation+, +:account_login+, +:email_change+,
-      # +:password_reset+, +:payout_change+, +:purchase+,
-      # +:recurring_purchase+, +:referral+, or +:survey+.
+      # +:account_creation+, +:account_login+, +:credit_application+,
+      # +:email_change+, +:fund_transfer+, +:password_reset+,
+      # +:payout_change+, +:purchase+, +:recurring_purchase+, +:referral+,
+      # +:sim_swap+, or +:survey+.
       #
       # @!attribute type
       #
@@ -46,18 +59,22 @@ module Minfraud
                     %i[
                       account_creation
                       account_login
+                      credit_application
                       email_change
+                      fund_transfer
                       password_reset
                       payout_change
                       purchase
                       recurring_purchase
                       referral
+                      sim_swap
                       survey
                     ]
 
       # @param params [Hash] Hash of parameters. Each key/value should
       #   correspond to one of the available attributes.
       def initialize(params = {})
+        self.party      = params[:party]
         @transaction_id = params[:transaction_id]
         @shop_id        = params[:shop_id]
         @time           = params[:time]

data/lib/minfraud/components/order.rb

@@ -4,12 +4,12 @@ module Minfraud
   module Components
     # Order corresponds to the order object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--order
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--order
     class Order < Base
       include Minfraud::Validates
 
       # The total order amount for the transaction before taxes and discounts.
-      # The value must be at least 0 and at most 1e14 - 1.
+      # The value must be at least 0 and at most 1e13 - 1.
       #
       # @return [Float, nil]
       attr_accessor :amount

data/lib/minfraud/components/payment.rb

@@ -4,11 +4,33 @@ module Minfraud
   module Components
     # Payment corresponds to the payment object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--payment
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--payment
     class Payment < Base
       include ::Minfraud::Enum
       include Minfraud::Validates
 
+      # The payment method associated with the transaction. This must be one of
+      # +:bank_debit+, +:bank_redirect+, +:bank_transfer+, +:buy_now_pay_later+,
+      # +:card+, +:crypto+, +:digital_wallet+, +:gift_card+,
+      # +:real_time_payment+, or +:rewards+.
+      #
+      # @!attribute method
+      #
+      # @return [Symbol, nil]
+      enum_accessor :method,
+                    %i[
+                      bank_debit
+                      bank_redirect
+                      bank_transfer
+                      buy_now_pay_later
+                      card
+                      crypto
+                      digital_wallet
+                      gift_card
+                      real_time_payment
+                      rewards
+                    ]
+
       # The payment processor used for the transaction. The value is one
       # listed as a valid value, as a symbol.
       #
@@ -26,6 +48,7 @@ module Minfraud
         aps_payments
         authorizenet
         balanced
+        banquest
         beanstream
         bluepay
         bluesnap
@@ -74,6 +97,7 @@ module Minfraud
         epx
         eway
         exact
+        fat_zebra
         first_atlantic_commerce
         first_data
         fiserv
@@ -147,6 +171,7 @@ module Minfraud
         rewardspay
         safecharge
         sagepay
+        securepay
         securetrading
         shopify_payments
         simplify_commerce
@@ -156,6 +181,7 @@ module Minfraud
         solidtrust_pay
         sps_decidir
         stripe
+        summit_payments
         synapsefi
         systempay
         telerecargas
@@ -175,6 +201,7 @@ module Minfraud
         windcave
         wirecard
         worldpay
+        yaadpay
       ]
 
       # The authorization outcome from the payment processor. If the
@@ -195,6 +222,7 @@ module Minfraud
       def initialize(params = {})
         @was_authorized = params[:was_authorized]
         @decline_code   = params[:decline_code]
+        self.method     = params[:method]
         self.processor  = params[:processor]
 
         validate

data/lib/minfraud/components/report/transaction.rb

@@ -2,10 +2,11 @@
 
 module Minfraud
   module Components
+    # Components for the Report Transaction API.
     module Report
       # Contains the fields used in the Report Transaction API.
       #
-      # @see https://dev.maxmind.com/minfraud/report-a-transaction?lang=en
+      # @see https://dev.maxmind.com/minfraud/report-a-transaction/?lang=en
       class Transaction < Base
         include ::Minfraud::Enum
         include ::Minfraud::Validates
@@ -22,13 +23,13 @@ module Minfraud
         # A symbol indicating the likelihood that a transaction may be
         # fraudulent.
         #
-        # This may be one of +:chargeback+, +:not_fraud+, +:spam_or_abuse+, or
-        # +:suspected_fraud+.
+        # This may be one of +:chargeback+, +:clear+ (to retract a previous
+        # report), +:not_fraud+, +:spam_or_abuse+, or +:suspected_fraud+.
         #
         # @!attribute tag
         #
         # @return [Symbol, nil]
-        enum_accessor :tag, %i[chargeback not_fraud spam_or_abuse suspected_fraud]
+        enum_accessor :tag, %i[chargeback clear not_fraud spam_or_abuse suspected_fraud]
 
         # A string which is provided by your payment processor indicating the
         # reason for the chargeback.
@@ -95,15 +96,15 @@ module Minfraud
           validate_uuid('minfraud_id', @minfraud_id)
 
           if ip_address.nil? &&
-             (minfraud_id.nil? || empty_uuid(minfraud_id)) &&
+             (minfraud_id.nil? || empty_uuid?(minfraud_id)) &&
              (maxmind_id.nil? || maxmind_id.empty?) &&
              (transaction_id.nil? || transaction_id.empty?)
             raise ArgumentError, 'At least one of the following is required: ip_address, minfraud_id, maxmind_id, transaction_id.'
           end
         end
 
-        def empty_uuid(value)
-          stripped_value = value.to_s.gsub('-', '')
+        def empty_uuid?(value)
+          stripped_value = value.to_s.delete('-')
           stripped_value == '0' * 32
         end
       end

data/lib/minfraud/components/shipping.rb

@@ -4,7 +4,7 @@ module Minfraud
   module Components
     # Shipping corresponds to the shipping object of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--shipping
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--shipping
     class Shipping < Addressable
       include ::Minfraud::Enum
 

data/lib/minfraud/components/shopping_cart.rb

@@ -5,7 +5,7 @@ module Minfraud
     # ShoppingCart corresponds to the shopping_cart object of a minFraud
     # request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--shopping-cart
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--shopping-cart
     class ShoppingCart < Base
       # An array of Minfraud::Components::ShoppingCartItem instances.
       #
@@ -17,7 +17,7 @@ module Minfraud
       #   to an item's field, or as a Minfraud:::Components::ShoppingCartItem
       #   object.
       def initialize(params = [])
-        @items = params.map(&method(:resolve))
+        @items = params.map { |param| resolve(param) }
       end
 
       # A JSON representation of Minfraud::Components::ShoppingCart items.

data/lib/minfraud/components/shopping_cart_item.rb

@@ -5,20 +5,20 @@ module Minfraud
     # ShoppingCartItem corresponds to objects in the shopping_cart object
     # of a minFraud request.
     #
-    # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--shopping-cart--item
+    # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--shopping-cart
     class ShoppingCartItem < Base
       include Minfraud::Validates
 
       # The category of the item. This can also be a hashed value; see link.
       #
-      # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--shopping-cart--item__category
+      # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--shopping-cart__category
       #
       # @return [String, nil]
       attr_accessor :category
 
       # The internal ID of the item. This can also be a hashed value; see link.
       #
-      # @see https://dev.maxmind.com/minfraud/api-documentation/requests?lang=en#schema--request--shopping-cart--item__item_id
+      # @see https://dev.maxmind.com/minfraud/api-documentation/requests/?lang=en#schema--request--shopping-cart__item_id
       #
       # @return [String, nil]
       attr_accessor :item_id
@@ -31,7 +31,7 @@ module Minfraud
 
       # The per-unit price of this item in the shopping cart. This should use
       # the same currency as the order currency. The value must be at least 0
-      # and at most 1e14 - 1.
+      # and at most 1e13 - 1.
       #
       # @return [Float, nil]
       attr_accessor :price

data/lib/minfraud/enum.rb

@@ -3,6 +3,12 @@
 module Minfraud
   # Enum provides helpers for working with attributes with enumerated types.
   module Enum
+    # Hook method called when the module is included into a class.
+    # Extends the class with ClassMethods.
+    #
+    # @param base [Class] The class including this module.
+    #
+    # @return [Class] The base class.
     def self.included(base)
       base.extend(ClassMethods)
     end
@@ -15,7 +21,10 @@ module Minfraud
       #
       # @return [Hash]
       def mapping
+        # rubocop:disable ThreadSafety/ClassInstanceVariable
+        # This is a false positive - this is set during class definition and then only read
         @mapping ||= {}
+        # rubocop:enable ThreadSafety/ClassInstanceVariable
       end
 
       # Create a set of methods for enum-like behavior of the attribute.