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
Copy section link
The issuer_processor
object is part of the fraud
object in the /transactions
endpoint.
Fields | Description |
---|---|
score
integer
|
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 Allowable Values: 0 - 99 |
risk_level
string
|
The fraud rating, or level of risk for the transaction. Allowable Values:
|
rule_violations
array of strings
|
The rules violated by the transaction. Allowable Values: Valid array of one or more rule violations |
recommended_action
string
|
The action recommended based on the fraud score. Allowable Values:
|
riskcontrol_tags
array of objects
|
The RiskControl tags triggered by the transaction. Allowable Values: See the riskcontrol_tags object. |
fraud_score_reasons
array of strings
|
Reasons for the fraud score. Allowable Values: Valid array of one or more fraud score reasons |
triggered_rules
array of objects
|
Rules triggered by the event. Allowable Values: See the triggered_rules object. |
riskcontrol_tags object
Copy section link
Note
This object will be deprecated in the future. Instead, use thetriggered_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
|
Values associated with the tag. Allowable Values: Valid array of one or more tag values |
tag
string
|
Tag name defined in the rule definition in the Real-Time Decisioning dashboard. Allowable Values: 255 char max |
rule_name
string
|
Name of the rule as defined in the Real-Time Decisioning dashboard that was triggered. Allowable Values: 255 char max |
triggered_rules object
Copy section link
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
|
Name of the rule as defined in the Real-Time Decisioning dashboard that was triggered. Allowable Values: 255 char max |
tags
array of objects
|
All the tags defined in the triggered rule. Allowable Values: See the tags object. |
alert
boolean
|
Indicates if the rule triggered an alert. Allowable Values:
|
entity_type
string
|
The entity type where the triggered rule was defined. Allowable Values: Valid entity type |
suppress_alert
boolean
|
Indicates if the triggered rule has Allowable Values:
|
tags object
Copy section link
This object provides a list of tags along with the names and values defined in the triggered rules.
Fields | Description |
---|---|
name
string
|
Name of the tag. Allowable Values: 255 char max |
value
string
|
Value of the tag. Allowable Values: 255 char max |