/
5 minute read
August 30, 2023

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:

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:

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
Copied

Is this helpful?

Yes
No

Subscribe to our developer newsletter