{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Fraud Errors","type":"basic","slug":"fraud-errors-1","excerpt":"","body":"##Fraud rules errors\n\nWhen a transaction triggers fraud rules, BlueSnap returns the following error:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"15011\",\n    \"0-1\": \"FRAUD_DETECTED\",\n    \"0-2\": \"The fraud error message includes a `fraudEvents` object with the following information:\\n  * an ID for the fraud event\\n  * an indication of what fraud rule or configurable threshold was triggered and why\\n  * an indication of whether the transaction was declined or held for review\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]\nIf a transaction triggers multiple fraud rules, then multiple fraud events (one for each triggered fraud rule or threshold) may be sent within the `fraudEvents` object for that transaction. Refer to the **Multiple fraud events** example below.\n\nFor a complete description of the `fraudEvents` object, refer to [fraudEvents](doc:fraud-event).\n\nMerchants who enroll in the Kount Custom fraud prevention service receive additional fraud details if an order triggers one of the rules they have configured. For information about fraud prevention service levels supported by BlueSnap, refer to [Fraud prevention](/docs/fraud-prevention).\n\n###Sample fraud error messages\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\\"message\\\": [{\\n    \\\"errorName\\\": \\\"FRAUD_DETECTED\\\",\\n    \\\"code\\\": 15011,\\n    \\\"description\\\": \\\"The request cannot be fulfilled for the current shopper. Please contact BlueSnap support for further details.\\\",\\n    \\\"fraudEvents\\\": {\\n        \\\"fraudReferenceId\\\": 3565,\\n        \\\"fraudEvent\\\": [\\n            {\\n                \\\"fraudEventCode\\\": \\\"billShipAddressNotMatchDecline\\\",\\n                \\\"fraudEventDecision\\\": \\\"D\\\",\\n                \\\"fraudEventExpression\\\": \\\"billing_address != shipping_address\\\"\\n            },\\n            {\\n                \\\"fraudEventCode\\\": \\\"blacklistshippingcountrydecline\\\",\\n                \\\"fraudEventDecision\\\": \\\"D\\\",\\n                \\\"fraudEventExpression\\\": \\\"AD is in list\\\"\\n            }\\n        ]\\n    }\\n  }]\\n}  \",\n      \"language\": \"json\",\n      \"name\": \"Multiple fraud events\"\n    },\n    {\n      \"code\": \"{\\\"message\\\": [{\\n    \\\"errorName\\\": \\\"FRAUD_DETECTED\\\",\\n    \\\"code\\\": 15011,\\n    \\\"description\\\": \\\"The request cannot be fulfilled for the current shopper. Please contact BlueSnap support for further details.\\\",\\n    \\\"fraudEvents\\\": {\\\"fraudReferenceId\\\": 3565}\\n}]}\",\n      \"language\": \"json\",\n      \"name\": \"Single fraud event\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"In the multiple fraud events example above, the second fraud event was the triggering of the shipping country blacklist (the value of the `fraudEventCode` is **blacklistshippingcountrydecline**).  This `fraudEventExpression` property says that this rule was triggered because **AD is in list**.  That means that the shopper entered Andorra (country code AD) as the shipping country, and that Andorra is on the blacklist.\",\n  \"title\": \"Note regarding multiple fraud events\"\n}\n[/block]\n##Kount error messages\nThe following error messages may be returned by Kount.\n\nKount RIS Response Key | Kount Error | BlueSnap Error | BlueSnap Fraud Error description\n--- | --- | --- | ---\n323 | Bad Site | Invalid Site | Site ID in the API request does not match a website ID in the Agent Web Console\n399 | Bad Optn | Invalid UDF | UDF in the API request does not match a UDF in the Agent Web Console","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed0377101fdb400214deda2","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed0377101fdb400214ded00","5ed0377101fdb400214ded01","5ed0377101fdb400214ded02","5ed0377101fdb400214ded03","5ed0377101fdb400214ded04","5ed0377101fdb400214ded05","5ed0377101fdb400214ded06","5ed0377101fdb400214ded07","5ed0377101fdb400214ded08","5ed0377101fdb400214ded09","5ed0377101fdb400214ded0a","5ed0377101fdb400214ded0b","5ed0377101fdb400214ded0c","5ed0377101fdb400214ded0d","5ed0377101fdb400214ded0e","5ed0377101fdb400214ded0f","5ed0377101fdb400214ded10"],"_id":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3aa2dc4d35003d784d9d","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":12,"from_sync":false,"reference":false,"_id":"5ed0377101fdb400214ded0a","version":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2020-02-28T20:15:41.401Z","__v":0,"parentDoc":null}

Fraud rules errors

When a transaction triggers fraud rules, BlueSnap returns the following error:

Code
Name
Description

15011

FRAUD_DETECTED

The fraud error message includes a fraudEvents object with the following information:

  • an ID for the fraud event
  • an indication of what fraud rule or configurable threshold was triggered and why
  • an indication of whether the transaction was declined or held for review

If a transaction triggers multiple fraud rules, then multiple fraud events (one for each triggered fraud rule or threshold) may be sent within the fraudEvents object for that transaction. Refer to the Multiple fraud events example below.

For a complete description of the fraudEvents object, refer to fraudEvents.

Merchants who enroll in the Kount Custom fraud prevention service receive additional fraud details if an order triggers one of the rules they have configured. For information about fraud prevention service levels supported by BlueSnap, refer to Fraud prevention.

Sample fraud error messages

{"message": [{
    "errorName": "FRAUD_DETECTED",
    "code": 15011,
    "description": "The request cannot be fulfilled for the current shopper. Please contact BlueSnap support for further details.",
    "fraudEvents": {
        "fraudReferenceId": 3565,
        "fraudEvent": [
            {
                "fraudEventCode": "billShipAddressNotMatchDecline",
                "fraudEventDecision": "D",
                "fraudEventExpression": "billing_address != shipping_address"
            },
            {
                "fraudEventCode": "blacklistshippingcountrydecline",
                "fraudEventDecision": "D",
                "fraudEventExpression": "AD is in list"
            }
        ]
    }
  }]
}  
{"message": [{
    "errorName": "FRAUD_DETECTED",
    "code": 15011,
    "description": "The request cannot be fulfilled for the current shopper. Please contact BlueSnap support for further details.",
    "fraudEvents": {"fraudReferenceId": 3565}
}]}

Note regarding multiple fraud events

In the multiple fraud events example above, the second fraud event was the triggering of the shipping country blacklist (the value of the fraudEventCode is blacklistshippingcountrydecline). This fraudEventExpression property says that this rule was triggered because AD is in list. That means that the shopper entered Andorra (country code AD) as the shipping country, and that Andorra is on the blacklist.

Kount error messages

The following error messages may be returned by Kount.

Kount RIS Response Key Kount Error BlueSnap Error BlueSnap Fraud Error description
323 Bad Site Invalid Site Site ID in the API request does not match a website ID in the Agent Web Console
399 Bad Optn Invalid UDF UDF in the API request does not match a UDF in the Agent Web Console