RiskResponse

Response to the Risk Request.

RiskRequest API Reference: Interactive request/response specification

RiskRequest Code Recipe: Pseudocode resource with code snippets

NameDescriptionTypeLengthRequired
ProcessorIdEchoed from Risk Request.String24 charactersRequired
IssuerIdEchoed from Risk Request.String24 charactersRequired
TransactionIdEchoed from Risk Request.StringUp to 36 charactersRequired
Status

Status of Risk Request. Possible values:

  • SUCCESS: Ends the transaction with a successful authentication status to the merchant

  • FAIL: Ends the transaction with a failed authentication status to the merchant

  • FAILWITHFEEDBACK: Returns a failed authentication status and a frictionless message to the merchant

  • CHALLENGE: Transaction initiated a Stepup challenge

  • REJECTED: Only supported for 2.x.x transactions. This status ends the transaction with a rejected authentication status to the merchant and indicates to them they should not proceed with authorization

  • ERROR: Returns an unavailable authentication status to the merchant
StringEnumRequired
TransStatusReasonProvides information on why the Transaction Status field has the specified value. Transaction Status Reason ValuesString2 charactersOptional
Language

Language to display the instructions and prompt to the cardholder. This value will decide which template is loaded, provided the language template is available. If not provided, the language is selected based on Issuer configuration and browser preference.

Examples:

  • en

  • en-US
StringUp to 50 charactersOptional
RiskIndicator

If returned, this value will be used in the creation of certain Authentication Values (AV) for EMV 3DS.

The value passed must conform to the current AV value the Issuer is using. This may also depend on the card brand of the transaction. For example, CAVV and IAV accept different values.

Note: This value will be converted to the hexadecimal equivalent. Please see the “VCAS Enhanced AV Support Guide” for more details on current AVs available and the corresponding values.

StringUp to 3 charactersOptional
RiskScoreRisk Score or value as determined by the client or VCAS Risk Engine.String2 charactersOptional
ExemptionResponse

Object containing any information related to the evaluation of the ExemptionInfo on the RiskRequest.

RiskResponse.ExemptionResponse (Object)

ObjectNAOptional
Reason

An object that can be used for sending a status code and description.

RiskResponse.Reason (Object)

ObjectNAOptional
Error

An object that can be used to convey an error message on the response.

RiskResponse.Error (Object)

ObjectNAOptional