Skip to content

Commit daa3f3a

Browse files
kevcentenokevcenteno
authored
Merge pull request #1253 from maxmind/andram/risk-reasons-dev-site-updates
edits to risk score reasons section are live
2 parents 19adda6 + 0f3f245 commit daa3f3a

File tree

1 file changed

+26
-48
lines changed

1 file changed

+26
-48
lines changed

‎content/minfraud/api-documentation/responses.md‎

Lines changed: 26 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -944,7 +944,12 @@ will not be present in the response.
944944
"reasons": [
945945
{
946946
"code": "ANONYMOUS_IP",
947-
"reason": "Risk due to IP being an Anonymous IP"
947+
"reason": "The Anonymous IP address raised the overall risk score"
948+
},
949+
{
950+
"code": "IP_ISSUER_ID_NUMBER_VELOCITY",
951+
"reason": "The number of distinct Issuer ID Numbers found in the
952+
velocity check on IP address raised the overall risk score"
948953
}
949954
]
950955
},
@@ -953,25 +958,28 @@ will not be present in the response.
953958
"reasons": [
954959
{
955960
"code": "TIME_OF_DAY",
956-
"reason": "Risk due to local time of day"
961+
"reason": "The local time of day of the request raised the overall
962+
risk score"
957963
}
958964
]
959965
},
960966
{
961967
"multiplier": 1.6,
962968
"reasons": [
963969
{
964-
"reason": "Riskiness of newly-sighted email domain",
965-
"code": "EMAIL_DOMAIN_NEW"
970+
"code": "EMAIL_DOMAIN_NEW",
971+
"reason": "The email domain being recently seen for the first time
972+
in the minFraud network raised the overall risk score"
966973
}
967974
]
968975
},
969976
{
970977
"multiplier": 0.34,
971978
"reasons": [
972979
{
973-
"code": "EMAIL_ADDRESS_NEW",
974-
"reason": "Riskiness of newly-sighted email address"
980+
"code": "PHONE_ACTIVITY",
981+
"reason": "minFraud network activity of the phone number lowered
982+
the overall risk score"
975983
}
976984
]
977985
}
@@ -988,51 +996,21 @@ will not be present in the response.
988996
{{</minfraud-schema-row>}}
989997

990998
{{< minfraud-schema-row key="code" type="response" valueType="string" valueTypeNote="format: enum, max length: 255" factors="true" >}}
991-
The machine-readable code for the risk reason. Although more codes may be added in the future, the current codes are:
992-
993-
| Code | Reason |
994-
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
995-
| BROWSER\_LANGUAGE | Riskiness of the browser user-agent and language associated with the request. |
996-
| BUSINESS\_ACTIVITY | Riskiness of business activity associated with the request. |
997-
| COUNTRY | Riskiness of the country associated with the request. |
998-
| CUSTOMER\_ID | Riskiness of a customer's activity. |
999-
| EMAIL\_DOMAIN | Riskiness of email domain. |
1000-
| EMAIL\_DOMAIN\_NEW | Riskiness of newly-sighted email domain. |
1001-
| EMAIL\_ADDRESS\_NEW | Riskiness of newly-sighted email address. |
1002-
| EMAIL\_LOCAL\_PART | Riskiness of the local part of the email address. |
1003-
| EMAIL\_VELOCITY | Velocity on email - many requests on same email over short period of time. |
1004-
| ISSUER\_ID\_NUMBER\_COUNTRY\_MISMATCH | Riskiness of the country mismatch between IP, billing, shipping and IIN country. |
1005-
| ISSUER\_ID\_NUMBER\_ON\_SHOP\_ID | Risk of Issuer ID Number for the shop ID. |
1006-
| ISSUER\_ID\_NUMBER\_LAST\_DIGITS\_ACTIVITY | Riskiness of many recent requests and previous high-risk requests on the IIN and last digits of the credit card. |
1007-
| ISSUER\_ID\_NUMBER\_SHOP\_ID\_VELOCITY | Risk of recent Issuer ID Number activity for the shop ID. |
1008-
| INTRACOUNTRY\_DISTANCE | Risk of distance between IP, billing, and shipping location. |
1009-
| ANONYMOUS\_IP | Risk due to IP being an Anonymous IP. |
1010-
| IP\_BILLING\_POSTAL\_VELOCITY | Velocity of distinct billing postal code on IP address. |
1011-
| IP\_EMAIL\_VELOCITY | Velocity of distinct email address on IP address. |
1012-
| IP\_HIGH\_RISK\_DEVICE | High-risk device sighted on IP address. |
1013-
| IP\_ISSUER\_ID\_NUMBER\_VELOCITY | Velocity of distinct IIN on IP address. |
1014-
| IP\_ACTIVITY | Riskiness of IP based on minFraud network activity. |
1015-
| LANGUAGE | Riskiness of browser language. |
1016-
| MAX\_RECENT\_EMAIL | Riskiness of email address based on past minFraud risk scores on email. |
1017-
| MAX\_RECENT\_PHONE | Riskiness of phone number based on past minFraud risk scores on phone. |
1018-
| MAX\_RECENT\_SHIP | Riskiness of email address based on past minFraud risk scores on ship address. |
1019-
| MULTIPLE\_CUSTOMER\_ID\_ON\_EMAIL | Riskiness of email address having many customer IDs. |
1020-
| ORDER\_AMOUNT | Riskiness of the order amount. |
1021-
| ORG\_DISTANCE\_RISK | Risk of ISP and distance between billing address and IP location. |
1022-
| PHONE | Riskiness of the phone number or related numbers. |
1023-
| CART | Riskiness of shopping cart contents. |
1024-
| TIME\_OF\_DAY | Risk due to local time of day. |
1025-
| TRANSACTION\_REPORT\_EMAIL | Risk due to transaction reports on the email address. |
1026-
| TRANSACTION\_REPORT\_IP | Risk due to transaction reports on the IP address. |
1027-
| TRANSACTION\_REPORT\_PHONE | Risk due to transaction reports on the phone number. |
1028-
| TRANSACTION\_REPORT\_SHIP | Risk due to transaction reports on the shipping address. |
1029-
| EMAIL\_ACTIVITY | Riskiness of the email address based on minFraud network activity. |
1030-
| PHONE\_ACTIVITY | Riskiness of the phone number based on minFraud network activity. |
1031-
| SHIP\_ACTIVITY | Riskiness of ship address based on minFraud network activity. |
999+
The machine-readable code for the risk reason. We have listed a few examples in the table below. A complete list of current codes may be provided on request.
1000+
| Code |
1001+
| --------------- |
1002+
| ANONYMOUS\_IP |
1003+
| COUNTRY |
1004+
| ORG\_DISTANCE\_RISK |
10321005
{{</minfraud-schema-row>}}
10331006

10341007
{{< minfraud-schema-row key="reason" type="response" valueType="string" factors="true" >}}
1035-
The human-readable description of the risk reason.
1008+
The human-readable description of the risk reason and its effect on the overall risk score.
1009+
| Code | Reason |
1010+
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
1011+
| ANONYMOUS\_IP | The Anonymous IP address raised the overall risk score |
1012+
| COUNTRY | The country associated with the request lowered the overall risk score |
1013+
| ORG\_DISTANCE\_RISK | The risk of the ISP combined with the distance between the billing address and IP address location raised the overall risk score |
10361014
{{</minfraud-schema-row>}}
10371015
{{</ schema-table >}}
10381016

0 commit comments

Comments
 (0)