RDX Specification

RiskResponse

Response to the Risk Request.

Suggest Edits

RiskRequest API Reference: Interactive request/response specification

RiskRequest Code Recipe: Pseudocode resource with code snippets

NameDescriptionTypeLengthRequired
ProcessorId Echoed from Risk Request.StringUp to 24 charactersRequired
IssuerId Echoed from Risk Request.StringUp to 24 charactersRequired
TransactionId Echoed 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
  • STEPUP: Continues with the challenge flow
  • FAILURE: Ends the transaction with a failed authentication status to the merchant
  • FAILWITHFEEDBACK: Presents a screen to the cardholder with instructions to get help and will send back a failed authentication status to the merchant
  • ERROR: Returns an unavailable authentication status to the merchant
  • BLOCKED: Blocks the card and returns a failed authentication status to the merchant, future authentication attempts are failed until unblocked
  • 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
    		• 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
    RiskScore Risk 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

    Updated 7 months ago