- The minFraud Factors subscores have been deprecated. They will be removed in March 2025. Please see our release notes for more information.
- Added support for the new risk reasons outputs in minFraud Factors. The risk reasons output codes and reasons are currently in beta and are subject to change. We recommend that you use these beta outputs with caution and avoid relying on them for critical applications.
- Breaking Updated
TransactionReport
to make theipAddress
parameter optional. Now thetag
and at least one of the following parameters must be supplied:ipAddress
,maxmindId
,minfraudId
,transactionId
. - Added
billingPhone
andshippingPhone
properties to the minFraud Insights and Factors response models. These contain objects with information about the respective phone numbers. Please see our developer site for more information. - Added
Payconex
to theProcessor
enum.
- Added
PxpFinancial
andTrustpay
to theProcessor
enum. - Equivalent domain names are now normalized when
hashAddress
is used. For example,googlemail.com
will becomegmail.com
. - Periods are now removed from
gmail.com
email address local parts whenhashAddress
is used. For example,[email protected]
will become[email protected]
. - Fastmail alias subdomain email addresses are now normalized when
hashAddress
is used. For example,[email protected]
will become[email protected]
. - Additional
yahoo.com
email addresses now have aliases removed from their local part whenhashAddress
is used. For example,[email protected]
will become[email protected]
for additionalyahoo.com
domains. - Duplicate
.com
s are now removed from email domain names whenhashAddress
is used. For example,example.com.com
will becomeexample.com
. - Certain TLD typos are now normalized when
hashAddress
is used. For example,example.comcom
will becomeexample.com
. - Additional
gmail.com
domain names with leading digits are now normalized whenhashAddress
is used. For example,100gmail.com
will becomegmail.com
. - Additional
gmail.com
typos are now normalized whenhashAddress
is used. For example,gmali.com
will becomegmail.com
. - When
hashAddress
is used, the domain part of an email address is now normalized to NFC. - When
hashAddress
is used, the local part of an email address is now normalized to NFC.
- Breaking Drop Node 16 support
- Add
host
parameter toClient
constructor to allow for use of the Sandbox environment. - Updated
@maxmind/geoip2-node
to version that includes theisAnycast
attribute onresponse.ipAddress.traits
. This attribute istrue
if the IP address belongs to an anycast network. This is available in minFraud Insights and Factors.
- Drop Node 14 support
- Added
GooglePay
to theProcessor
enum. - Added
Placetopay
to theProcessor
enum. - Set minimum version of GeoIP2-node to v3.5.0.
- Remove camelcase-keys dependency.
- Added
ShopifyPayments
to theProcessor
enum. - Fix
creditCard.was3DSecureSuccessful
snakecase conversion.
- Added the input
/credit_card/country
. This is the country where the issuer of the card is located. This may be passed instead of the/credit_card/issuer_id_number
if you do not wish to pass partial account numbers or if your payment processor does not provide them. You may provide this by providingcountry
toCreditCard
.
- Added the following new values to the
Processor
enum:Boacompra
Boku
Coregateway
Fiserv
Neopay
Neosurf
Openbucks
Paysera
Payvision
Trustly
Windcave
- Updated dependencies.
- Added mobile country code (MCC) and mobile network code (MNC) to minFraud
Insights and Factors responses. These are available at
response.ipAddress.traits.mobileCountryCode
andresponse.ipAddress.traits.mobileNetworkCode
. We expect this data to be available by late January, 2022. creditCard.last4digits
has been deprecated in favor ofcreditCard.lastDigits
and will be removed in a future release.lastDigits
/last4digits
also now supports two digit values in addition to the previous four digit values.- Eight digit
creditCard.issuerIdNumber
inputs are now supported in addition to the previously accepted six digitissuerIdNumber
. In most cases, you should send the last four digits forcreditCard.lastDigits
. If you send aissuerIdNumber
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 forlastDigits
:Discover
JCB
Mastercard
UnionPay
Visa
- Added support for the new
test
disposition action. - Added support for the
/disposition/rule_label
output in Score, Insights and Factors. This is available atresponse.disposition.ruleLabel()
, and is the label of the custom rule that was triggered by the transaction. - Added support for the
/credit_card/was_3d_secure_successful
input in Score, Insights and Factors. The input should indicate whether or not the outcome of 3D-Secure verification (e.g. Safekey, SecureCode, Verified by Visa) was successful.true
if customer verification was successful, orfalse
if the customer failed verification. If 3-D Secure verification was not used, was unavailable, or resulted in another outcome other than success or failure, do not include this field. Use thewas3DSecureSuccessful
property in a call tonew minFraud.CreditCard()
to set it.
- Upgrade yarn modules
- Add
Datacap
to theProcessor
enum. - Upgrade yarn modules
- Fix: IP address response is optional. Issue 515
- Breaking Drop Node 10 support
- Upgrade yarn dependencies
- Add the following new values to the
Processor
enum:Cardknox
Creditguard
Credorax
Dlocal
Onpay
Safecharge
- Upgrade yarn dependencies
- Update
@maxmind/geoip2-node
. ThestaticIpScore
property was incorrectly spelledstaticIPScore
. This is now fixed.
- Upgrade yarn dependencies
- Upgrade yarn dependencies
- Added support for the IP address risk reasons in the minFraud Insights and
Factors responses. This is available at
response.ipAddress.riskReasons
. - Upgraded yarn dependencies
- Added
ApplePay
andApsPayments
to theProcessor
enum. - Added additional normalizing of the email address when it is sent as an MD5 hash instead of plain text.
- Upgrade yarn dependencies
The email address field is now sent to the web service in plain text unless
you enable the new hashAddress
option on EmailProps
. Enabling this
option sends the MD5 hash of the address to the web service instead.
Previously the address was always sent as an MD5 hash. The new default
behavior matches that of other official minFraud API clients. Note the
email domain is always sent in plain text.
- Upgrade yarn dependencies
country
and location
insights values return undefined instead of {} when empty.
- Added
Tsys
to theProcessor
enum. - The device IP address is no longer a required input.
- Update
@maxmind/geoip2-node
to a version that supportsresponse.ipAddress.traits.isResidentialProxy
.
- Add the following new values to the
Processor
enum:Cashfree
FirstAtlanticCommerce
Komoju
Paytm
Razorpay
Systempay
- Add
device
,emailLocalPart
, andshippingAddress
to subscores
- Added support for the Report Transaction API.
- Added documentation to response and request parameters
- Added support for the new credit card output
/credit_card/is_business
. This indicates whether the card is a business card. It may be accessed viaresponse.creditCard.isBusiness
on the minFraud Insights and Factors response objects.
- Add support for the
/email/domain/first_seen
output. This may be accessed viaresponse.email.domain.firstSeen
on the minFraud Insights and Factors objects. - Add the following new values to the
Processor
enum:Cardpay
Epx
- Add support for the
/email/is_disposable
output. - Upgrade yarn dependencies
- Drop support for Node 8.
- Add the following new values to the
Processor
enum:Cetelem
Ecommpay
G2aPay
Mercanet
- Upgrade yarn dependencies
- Add the following new values to the
Processor
enum:Affirm
Interac
- Point package.json's main to dist/src/index.js
- Add the following new values to the
Processor
enum:Afterpay
Dotpay
Klarna
Paysafecard
- Fix user-agent header in request
- Fix Insights and Factors response
- Initial release.