ENS Risk Change Event Code Samples

Risk Change Events

Each of the events in this section correspond to a column in the Risk Evaluation Table on the Transaction Detail page for any transaction. RISK_CHANGE events only occur when the Reevaluate Risk button is clicked on that page. When an Agent clicks the button, the system looks at the risk factors in the table to see if any change can be detected. If the system detects a change in score, the event is sent.

The clicking of the button itself is considered an event, even if the score has not changed in any of the Risk Evaluation Table columns. The button click event is recorded as a WORKFLOW_REEVALUATE event.

All RISK_CHANGE events are considered to be triggered by the System since Kount, in the process of evaluating the risk of suspect orders, detects the actual changes that occur. For that reason, the email address system@company.com appears in the agent tag rather than the email address of a person or the “API agent”. To determine the email address of the person initiating the Reevaluate Risk button click, review the WORKFLOW_REEVALUATE event.

For RISK_CHANGE_REAS events, if more than one reason is recorded as having changed, the reasons appear in the new value tag as a comma-delimited list, such as NETW, SCOR.

RISK_CHANGE_GEOX

<event>
  <name>RISK_CHANGE_GEOX</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Value </old_value>
  <new_value>New Value </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>

RISK_CHANGE_NETW

<event>
  <name>RISK_CHANGE_NETW</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Value </old_value>
  <new_value>New Value </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>

RISK_CHANGE_REAS

<event>
  <name>RISK_CHANGE_REAS</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Reason </old_value>
  <new_value>New Reason </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>

RISK_CHANGE_REPLY

<event>
  <name>RISK_CHANGE_REPLY</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Status </old_value>
  <new_value>New Status </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>

RISK_CHANGE_SCOR

<event>
  <name>RISK_CHANGE_SCOR</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Score </old_value>
  <new_value>New Score </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>

RISK_CHANGE_VELO

<event>
  <name>RISK_CHANGE_VELO</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Score </old_value>
  <new_value>New Score </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>

RISK_CHANGE_VMAX

<event>
  <name>RISK_CHANGE_VMAX</name>
  <key order_number="?" site="?">Transaction ID </key>
  <old_value>Old Score </old_value>
  <new_value>New Score </new_value>
  <agent>system@company.com </agent>
  <occurred>2019-09-05 13:19:24 </occurred>
</event>