minfraud 2.5.0 → 2.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/README.md +3 -3
- data/lib/minfraud/components/payment.rb +1 -0
- data/lib/minfraud/components/report/transaction.rb +40 -8
- data/lib/minfraud/model/address.rb +1 -1
- data/lib/minfraud/model/credit_card.rb +1 -1
- data/lib/minfraud/model/device.rb +1 -1
- data/lib/minfraud/model/disposition.rb +1 -1
- data/lib/minfraud/model/email.rb +1 -1
- data/lib/minfraud/model/email_domain.rb +1 -1
- data/lib/minfraud/model/error.rb +1 -1
- data/lib/minfraud/model/factors.rb +1 -1
- data/lib/minfraud/model/geoip2_location.rb +1 -1
- data/lib/minfraud/model/insights.rb +16 -1
- data/lib/minfraud/model/ip_address.rb +1 -1
- data/lib/minfraud/model/ip_risk_reason.rb +1 -1
- data/lib/minfraud/model/issuer.rb +1 -1
- data/lib/minfraud/model/phone.rb +49 -0
- data/lib/minfraud/model/score_ip_address.rb +1 -1
- data/lib/minfraud/model/shipping_address.rb +1 -1
- data/lib/minfraud/model/subscores.rb +1 -1
- data/lib/minfraud/model/warning.rb +1 -1
- data/lib/minfraud/validates.rb +13 -0
- data/lib/minfraud/version.rb +1 -1
- metadata +4 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3d7569d3a79d640e8ecd0a2fe83996701e2d378bac780a2e0ee7e40ea0651136
|
4
|
+
data.tar.gz: 799568df38549e698099950480c8f88e8a395df2214cfd47beb830c9f1c42a85
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f49ac7777a332043c94e1c73d5cfb34e1caa27477eeebc23ebb31b97929d3012378f40ebd78ca6662982d2ef3fc1f5f6f40862169e381ceb6f710e79c8e5a411
|
7
|
+
data.tar.gz: 40b65dd1c1eba11d44bb0fc82e0df0e67b943ed43b521198d5c4c4bc81fe2aa79077cc6d4ca86cf873e25f0930e0f7f77b49e4ff68b1b49919cc0d5e92da8b05
|
data/CHANGELOG.md
CHANGED
@@ -1,5 +1,20 @@
|
|
1
1
|
# Changelog
|
2
2
|
|
3
|
+
## v2.6.0 (2024-07-08)
|
4
|
+
|
5
|
+
* Updated the validation for the Report Transactions API to make the
|
6
|
+
`ip_address` parameter optional. Now the `tag` and at least one of the
|
7
|
+
following parameters must be supplied: `ip_address`, `maxmind_id`,
|
8
|
+
`minfraud_id`, `transaction_id`.
|
9
|
+
* Updated the validation for the Report Transactions API to check that
|
10
|
+
`ip_address`, `maxmind_id`, and `minfraud_id` contain valid values.
|
11
|
+
* Added `billing_phone` and `shipping_phone` attributes to the minFraud
|
12
|
+
Insights and Factors response models. These contain objects with
|
13
|
+
information about the respective phone numbers. Please see [our developer
|
14
|
+
site](https://dev.maxmind.com/minfraud/api-documentation/responses/) for
|
15
|
+
more information.
|
16
|
+
* Added the processor `:payconex` to `Minfraud::Components::Payment`.
|
17
|
+
|
3
18
|
## v2.5.0 (2024-04-16)
|
4
19
|
|
5
20
|
* Equivalent domain names are now normalized when `hash_address` is used.
|
data/README.md
CHANGED
@@ -208,9 +208,9 @@ channel is used to improve the accuracy of their fraud detection
|
|
208
208
|
algorithms.
|
209
209
|
|
210
210
|
To use the Report Transaction API, create a
|
211
|
-
`Minfraud::Components::Report::Transaction` object.
|
212
|
-
|
213
|
-
set, as shown below.
|
211
|
+
`Minfraud::Components::Report::Transaction` object. A valid tag and at least
|
212
|
+
one of the following are required parameters: ip_address, maxmind_id,
|
213
|
+
minfraud_id, transaction_id. Additional parameters may be set, as shown below.
|
214
214
|
|
215
215
|
If the report is successful, nothing is returned. If the report fails, an
|
216
216
|
exception will be thrown.
|
@@ -8,9 +8,13 @@ module Minfraud
|
|
8
8
|
# @see https://dev.maxmind.com/minfraud/report-a-transaction?lang=en
|
9
9
|
class Transaction < Base
|
10
10
|
include ::Minfraud::Enum
|
11
|
+
include ::Minfraud::Validates
|
11
12
|
|
12
13
|
# The IP address of the customer placing the order. This should be
|
13
|
-
# passed as a string like "152.216.7.110".
|
14
|
+
# passed as a string like "152.216.7.110". This field is not required
|
15
|
+
# if you provide at least one of the transaction's minfraud_id,
|
16
|
+
# maxmind_id, or transaction_id. You are encouraged to provide it, if
|
17
|
+
# possible.
|
14
18
|
#
|
15
19
|
# @return [String, nil]
|
16
20
|
attr_accessor :ip_address
|
@@ -34,16 +38,19 @@ module Minfraud
|
|
34
38
|
|
35
39
|
# A unique eight character string identifying a minFraud Standard or
|
36
40
|
# Premium request. These IDs are returned in the maxmindID field of a
|
37
|
-
# response for a successful minFraud request. This field is not
|
38
|
-
#
|
41
|
+
# response for a successful minFraud request. This field is not required
|
42
|
+
# if you provide at least one of the transaction's ip_address,
|
43
|
+
# minfraud_id, or transaction_id. You are encouraged to provide it, if
|
44
|
+
# possible.
|
39
45
|
#
|
40
46
|
# @return [String, nil]
|
41
47
|
attr_accessor :maxmind_id
|
42
48
|
|
43
49
|
# A UUID that identifies a minFraud Score, minFraud Insights, or
|
44
50
|
# minFraud Factors request. This ID is returned at /id in the response.
|
45
|
-
# This field is not required
|
46
|
-
#
|
51
|
+
# This field is not required if you provide at least one of the
|
52
|
+
# transaction's ip_address, maxmind_id, or transaction_id. You are
|
53
|
+
# encouraged to provide it, if possible.
|
47
54
|
#
|
48
55
|
# @return [String, nil]
|
49
56
|
attr_accessor :minfraud_id
|
@@ -56,9 +63,10 @@ module Minfraud
|
|
56
63
|
# @return [String, nil]
|
57
64
|
attr_accessor :notes
|
58
65
|
|
59
|
-
# The transaction ID you originally passed to minFraud. This field
|
60
|
-
# not required
|
61
|
-
#
|
66
|
+
# The transaction ID you originally passed to minFraud. This field
|
67
|
+
# is not required if you provide at least one of the transaction's
|
68
|
+
# ip_address, maxmind_id, or minfraud_id. You are encouraged to
|
69
|
+
# provide it, if possible.
|
62
70
|
#
|
63
71
|
# @return [String, nil]
|
64
72
|
attr_accessor :transaction_id
|
@@ -73,6 +81,30 @@ module Minfraud
|
|
73
81
|
@notes = params[:notes]
|
74
82
|
@transaction_id = params[:transaction_id]
|
75
83
|
self.tag = params[:tag]
|
84
|
+
|
85
|
+
validate
|
86
|
+
end
|
87
|
+
|
88
|
+
private
|
89
|
+
|
90
|
+
def validate
|
91
|
+
return if !Minfraud.enable_validation
|
92
|
+
|
93
|
+
validate_ip('ip_address', @ip_address)
|
94
|
+
validate_string('maxmind_id', 8, @maxmind_id)
|
95
|
+
validate_uuid('minfraud_id', @minfraud_id)
|
96
|
+
|
97
|
+
if ip_address.nil? &&
|
98
|
+
(minfraud_id.nil? || empty_uuid(minfraud_id)) &&
|
99
|
+
(maxmind_id.nil? || maxmind_id.empty?) &&
|
100
|
+
(transaction_id.nil? || transaction_id.empty?)
|
101
|
+
raise ArgumentError, 'At least one of the following is required: ip_address, minfraud_id, maxmind_id, transaction_id.'
|
102
|
+
end
|
103
|
+
end
|
104
|
+
|
105
|
+
def empty_uuid(value)
|
106
|
+
stripped_value = value.to_s.gsub('-', '')
|
107
|
+
stripped_value == '0' * 32
|
76
108
|
end
|
77
109
|
end
|
78
110
|
end
|
data/lib/minfraud/model/email.rb
CHANGED
data/lib/minfraud/model/error.rb
CHANGED
@@ -5,6 +5,7 @@ require 'minfraud/model/credit_card'
|
|
5
5
|
require 'minfraud/model/device'
|
6
6
|
require 'minfraud/model/email'
|
7
7
|
require 'minfraud/model/ip_address'
|
8
|
+
require 'minfraud/model/phone'
|
8
9
|
require 'minfraud/model/score'
|
9
10
|
require 'minfraud/model/shipping_address'
|
10
11
|
|
@@ -18,6 +19,12 @@ module Minfraud
|
|
18
19
|
# @return [Minfraud::Model::BillingAddress]
|
19
20
|
attr_reader :billing_address
|
20
21
|
|
22
|
+
# An object containing minFraud data related to the billing phone
|
23
|
+
# number used in the transaction.
|
24
|
+
#
|
25
|
+
# @return [Minfraud::Model::Phone]
|
26
|
+
attr_reader :billing_phone
|
27
|
+
|
21
28
|
# An object containing minFraud data about the credit card used in the
|
22
29
|
# transaction.
|
23
30
|
#
|
@@ -48,13 +55,20 @@ module Minfraud
|
|
48
55
|
# @return [Minfraud::Model::ShippingAddress]
|
49
56
|
attr_reader :shipping_address
|
50
57
|
|
58
|
+
# An object containing minFraud data related to the shipping phone
|
59
|
+
# number used in the transaction.
|
60
|
+
#
|
61
|
+
# @return [Minfraud::Model::Phone]
|
62
|
+
attr_reader :shipping_phone
|
63
|
+
|
51
64
|
# @!visibility private
|
52
65
|
def initialize(record, locales)
|
53
|
-
super
|
66
|
+
super
|
54
67
|
|
55
68
|
@billing_address = Minfraud::Model::BillingAddress.new(
|
56
69
|
get('billing_address')
|
57
70
|
)
|
71
|
+
@billing_phone = Minfraud::Model::Phone.new(get('billing_phone'))
|
58
72
|
@credit_card = Minfraud::Model::CreditCard.new(get('credit_card'))
|
59
73
|
@device = Minfraud::Model::Device.new(get('device'))
|
60
74
|
@email = Minfraud::Model::Email.new(get('email'))
|
@@ -62,6 +76,7 @@ module Minfraud
|
|
62
76
|
@shipping_address = Minfraud::Model::ShippingAddress.new(
|
63
77
|
get('shipping_address')
|
64
78
|
)
|
79
|
+
@shipping_phone = Minfraud::Model::Phone.new(get('shipping_phone'))
|
65
80
|
end
|
66
81
|
end
|
67
82
|
end
|
@@ -0,0 +1,49 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
require 'minfraud/model/abstract'
|
4
|
+
|
5
|
+
module Minfraud
|
6
|
+
module Model
|
7
|
+
# Model with information about the billing or shipping phone number.
|
8
|
+
class Phone < Abstract
|
9
|
+
# The two-character ISO 3166-1 country code for the country associated
|
10
|
+
# with the phone number.
|
11
|
+
#
|
12
|
+
# @return [String, nil]
|
13
|
+
attr_reader :country
|
14
|
+
|
15
|
+
# This is true if the phone number is a Voice over Internet Protocol
|
16
|
+
# (VoIP) number allocated by a regulator. It is false if the phone
|
17
|
+
# number is not a VoIP number allocated by a regulator. The attribute
|
18
|
+
# is nil when a valid phone number has not been provided or we do not
|
19
|
+
# have data for the phone number.
|
20
|
+
#
|
21
|
+
# @return [Boolean, nil]
|
22
|
+
attr_reader :is_voip
|
23
|
+
|
24
|
+
# The name of the original network operator associated with the phone
|
25
|
+
# number. This attribute does not reflect phone numbers that have been
|
26
|
+
# ported from the original operator to another, nor does it identify
|
27
|
+
# mobile virtual network operators.
|
28
|
+
#
|
29
|
+
# @return [String, nil]
|
30
|
+
attr_reader :network_operator
|
31
|
+
|
32
|
+
# One of the following values: fixed or mobile. Additional values may
|
33
|
+
# be added in the future.
|
34
|
+
#
|
35
|
+
# @return [String, nil]
|
36
|
+
attr_reader :number_type
|
37
|
+
|
38
|
+
# @!visibility private
|
39
|
+
def initialize(record)
|
40
|
+
super
|
41
|
+
|
42
|
+
@country = get('country')
|
43
|
+
@is_voip = get('is_voip')
|
44
|
+
@network_operator = get('network_operator')
|
45
|
+
@number_type = get('number_type')
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
data/lib/minfraud/validates.rb
CHANGED
@@ -24,6 +24,19 @@ module Minfraud
|
|
24
24
|
end
|
25
25
|
end
|
26
26
|
|
27
|
+
def validate_uuid(field, value)
|
28
|
+
return if !value
|
29
|
+
|
30
|
+
stripped_value = value.to_s.gsub('-', '')
|
31
|
+
|
32
|
+
# Define a regex pattern for a valid UUID without dashes
|
33
|
+
uuid_regex = /\A[0-9a-f]{32}\z/i
|
34
|
+
|
35
|
+
unless uuid_regex.match(stripped_value)
|
36
|
+
raise InvalidInputError, "The #{field} value is not valid. It must be a UUID string."
|
37
|
+
end
|
38
|
+
end
|
39
|
+
|
27
40
|
def validate_subdivision_code(field, value)
|
28
41
|
return if !value
|
29
42
|
|
data/lib/minfraud/version.rb
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: minfraud
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 2.
|
4
|
+
version: 2.6.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- kushnir.yb
|
@@ -9,7 +9,7 @@ authors:
|
|
9
9
|
autorequire:
|
10
10
|
bindir: exe
|
11
11
|
cert_chain: []
|
12
|
-
date: 2024-
|
12
|
+
date: 2024-07-08 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: connection_pool
|
@@ -203,6 +203,7 @@ files:
|
|
203
203
|
- lib/minfraud/model/ip_address.rb
|
204
204
|
- lib/minfraud/model/ip_risk_reason.rb
|
205
205
|
- lib/minfraud/model/issuer.rb
|
206
|
+
- lib/minfraud/model/phone.rb
|
206
207
|
- lib/minfraud/model/score.rb
|
207
208
|
- lib/minfraud/model/score_ip_address.rb
|
208
209
|
- lib/minfraud/model/shipping_address.rb
|
@@ -233,7 +234,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
233
234
|
- !ruby/object:Gem::Version
|
234
235
|
version: '0'
|
235
236
|
requirements: []
|
236
|
-
rubygems_version: 3.5.
|
237
|
+
rubygems_version: 3.5.11
|
237
238
|
signing_key:
|
238
239
|
specification_version: 4
|
239
240
|
summary: Ruby API for the minFraud Score, Insights, Factors, and Report Transactions
|