Authentication Results

Used to Inform Forter of authentication results after an MFA was required by a previous account API request, using the provided correlation ID. While no decision is provided on this request, it is required in order to ensure optimal customer experience as well as continuously improving the decision model.

Authentication Result Integration

Key Fields:

accountId: Customer's account UID in merchant's site

eventTime: The time that the trigger event occurred in MILLISECONDS

additionalAuthenticationMethod.correlationId: A forter unique identifier that was provided as part of a Forter API response recommending additional authentication measures. Used to correlate between the user action which triggered the recommendation and the authentication attempt result. Required when the additional authentication was triggered by Forter's recommendation.

additionalAuthenticationMethod.verificationOutcome: may take various forms depending on verification outcome. for example additionalAuthenticationMethod.verificationOutcome is a general authentication result enumerated field with 3 possible values: ["SUCCESS"; "FAILURE"; NONE_ATTEMPTED]

Please see the Customer Authentication Result API Reference section for more details.

{
  "accountId": "e520-ba9a-367-60b",
  "eventTime": 1415287568000,
  "connectionInformation": {
    "customerIP": "10.0.0.127",
    "userAgent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36",
    "forterTokenCookie": "2315688945984"
  },
  "channelType": "WEB",
  "additionalAuthenticationMethod": {  
      "verificationOutcome": "SUCCESS",
      "correlationId": "87363864834",
    },
}

Authentication Result API Response
As this API is only used to provide Forter's model's additional information, the decision returned will always be "NOT_REVIEWED". Supplementary parameters like correlationId and accountId are also returned in the API response.