RiskControl Objects

The following are objects in the /transactions endpoint related to the response from RiskControl Real-Time Decisioning:

issuer_processor
riskcontrol_tags
triggered_rules
tags

issuer_processor object

The issuer_processor object is part of the fraud object in the /transactions endpoint.

Fields	Description
score integer Conditionally returned	The risk score generated by RiskControl. This is either the Mastercard Decision Intelligence or Visa Advance Authorization transaction risk score, which is identical to the `network_transaction_risk_score` field. Allowable Values: 0 - 99
risk_level string Conditionally returned	The fraud rating, or level of risk for the transaction. Allowable Values: `high`, `low`
rule_violations array of strings Conditionally returned	The rules violated by the transaction. Allowable Values: Valid array of one or more rule violations
recommended_action string Conditionally returned	The action recommended based on the fraud score. Allowable Values: `APPROVE`, `DECLINE`, `NOT_PERFORMED`
riskcontrol_tags array of objects Conditionally returned	The RiskControl tags triggered by the transaction. Allowable Values: See the riskcontrol_tags object.
fraud_score_reasons array of strings Conditionally returned	Reasons for the fraud score. Allowable Values: Valid array of one or more fraud score reasons
triggered_rules array of objects Conditionally returned	Rules triggered by the event. Allowable Values: See the triggered_rules object.

riskcontrol_tags object

Note
This object will be deprecated in the future. Instead, use the triggered_rules object.

When a rule from your own custom-defined operational models is triggered, it generates a tag for your downstream actions. This information, including the tag, rule name, and associated multiple values, is contained in the riskcontrol_tags object as part of the fraud object in the /transactions endpoint.

Fields	Description
values array of strings Conditionally returned	Values associated with the tag. Allowable Values: Valid array of one or more tag values
tag string Conditionally returned	Tag name defined in the rule definition in the Real-Time Decisioning dashboard. Allowable Values: 255 char max
rule_name string Conditionally returned	Name of the rule as defined in the Real-Time Decisioning dashboard that was triggered. Allowable Values: 255 char max

triggered_rules object

This object provides a list of rules triggered by a fraud event along with the information on tags and rule characteristics.

Fields	Description
rule_name string Conditionally returned	Name of the rule as defined in the Real-Time Decisioning dashboard that was triggered. Allowable Values: 255 char max
tags array of objects Conditionally returned	All the tags defined in the triggered rule. Allowable Values: See the tags object.
alert boolean Conditionally returned	Indicates if the rule triggered an alert. Allowable Values: `true`, `false`
entity_type string Conditionally returned	The entity type where the triggered rule was defined. Allowable Values: Valid entity type
suppress_alert boolean Conditionally returned	Indicates if the triggered rule has `suppress_alert` in the definition. Allowable Values: `true`, `false`

tags object

This object provides a list of tags along with the names and values defined in the triggered rules.

Fields	Description
name string Conditionally returned	Name of the tag. Allowable Values: 255 char max
value string Conditionally returned	Value of the tag. Allowable Values: 255 char max

Example

JSON

"fraud": {
    "issuer_processor": {
        "score": 0,
        "risk_level": "low",
        "rule_violations": [
            "Three_Tag_Rule"
        ],
        "recommended_action": "APPROVE",
        "riskcontrol_tags": [
          {
            "values": [
                "false"
            ],
            "tag": "risk",
                "rule_name": "Three_Tag_Rule"
          },
          {
            "values": [
                "authorization",
                "testing webhook 2"
            ],
            "tag": "tag",
            "rule_name": "Three_Tag_Rule"
          }
        ],
        "fraud_score_reasons": [],
        "triggered_rules": [
          {
            "rule_name": "Three_Tag_Rule",
            "tags": [
              {
                "name": "tag",
                "value": "authorization"
              },
              {
                "name": "tag",
                "value": "testing webhook 2"
              },
              {
                "name": "risk",
                "value": "false"
              }
        ],
        "alert": true,
        "entity_type": "ACTING_USER",
        "suppress_alert": false
      }
    ]
  }
}

Guides

​issuer_processor object

​riskcontrol_tags object

​triggered_rules object

​tags object

​Example

issuer_processor object

riskcontrol_tags object

triggered_rules object

tags object

Example