RDX Specification

RiskRequest

Risk is the first step in the RDX process and correlates transaction, merchant, consumer, and device information to determine the level of risk in a given transaction.

Suggest Edits

RiskRequest API Reference: Interactive request/response specification

RiskRequest Code Recipe: Pseudocode resource with code snippets

NameDescriptionTypeLengthRequired
ProcessorId VCAS provided identifier for the client.StringUp to 24 charactersRequired
IssuerId VCAS provided identifier for the client.StringUp to 24 charactersRequired
TransactionId VCAS generated transaction reference id; 36-character GUID valueStringUp to 36 charactersRequired
DSTransactionId Directory Server (DS) generated transaction reference id. GUID format.String36 charactersConditional
MerchantChallengeIndicator Indicates whether a challenge is requested from the merchant.

Merchant Challenge Indicator Values
Merchant Challenge Indicator Values (Mastercard Identity Check 2.1 Extensions)		String36 charactersRequired
3RIIndicator Indicates the type of 3RI request for EMV transactions. This data element provides additional information to the ACS to determine the best approach for handing a 3RI request

3RI Indicator Values		StringEnumOptional
NonPaymentAuthenticationIndicator Indicates the type of Non-Payment Authentication.

NPA Indicator Values		StringEnumOptional
MessageVersion Version of the message based on EMV 3DS spec. Example: 2.2.0StringUp to 8 charactersOptional
RDXMessageVersion The Message Version of the RDX protocol being used. This will be used to enable new features without breaking current integrations. Example: 2.2.3StringUp to 8 charactersOptional
MessageCategoryIdentifies the category of the message for a specific use case.

  • 01 = PA

  • 02 = NPA

  • 03-79 = Reserved for EMVCo future use

  • 80-99 = Reserved for DS use
    		• String2 charactersOptional
    RiskScore Risk score of the transaction as determined by VCAS.String2 charactersOptional
    RuleOutcome If the transaction is configured to evaluate risk rules, this will be the outcome of that evaluation.

  • 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: Presents a screen to the cardholder with instructions to get help and will send back a failed authentication status 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
    		• StringEnumOptional
    ExemptionInfo Object containing information related to EMV exemptions as related to the EEA PSD2 regulations.

    RiskRequest.ExemptionInfo (Object)    		ObjectNAOptional
    MerchantAuthInfo Object containing information related to any Merchant Authentication information on EMV requests.

    RiskRequest.MerchantAuthInfo (Object)    		ObjectNAOptional
    MerchantInfo Object containing the Merchant information
    RiskRequest.MerchantInfo (Object)    		ObjectNAOptional
    TransactionInfo Object containing the Transaction information.
    RiskRequest.TransactionInfo (Object)    		ObjectNAOptional
    ExtensionDataRiskRequest.ExtensionData.DAFExtension (Object)ObjectNAOptional

    Updated 3 months ago