RDX Specification
Start typing to search…

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.

RiskRequest API Reference: Interactive request/response specification

RiskRequest Code Recipe: Pseudocode resource with code snippets

NameDescriptionTypeLengthRequired
ProcessorIdVCAS provided identifier for the client.String24 charactersRequired
IssuerIdVCAS provided identifier for the client.String24 charactersRequired
TransactionIdVCAS generated transaction reference id; 36-character GUID valueStringUp to 36 charactersRequired
DSTransactionIdDirectory 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
MessageVersionVersion of the message based on EMV 3DS spec. Example: 2.2.0StringUp to 8 charactersOptional
RDXMessageVersionThe Message Version of the RDX protocol being used. This will be used to enable new features without breaking current integrations. Example: 2.2.4StringUp to 8 charactersOptional
MessageCategory

Identifies 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
RiskScoreRisk 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: 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
StringEnumOptional
CardBrandName

Name of the card network for a specific transaction. Values include:

  • DISCOVER

  • VISA

  • MASTERCARD

  • JCB

  • AMEX

  • DINERS

  • ELO

  • UPI

  • EFTPOS

  • MADA

  • MYDEBIT

  • TAKAPAY

  • ITMX

  • JAYWAN
StringEnumRequired
MerchantAuthInfo

Object containing information related to any Merchant Authentication information on EMV requests.

RiskRequest.MerchantAuthInfo (Object)

ObjectNAOptional
MerchantInfoObject containing the Merchant information
RiskRequest.MerchantInfo (Object)		ObjectNAOptional
TransactionInfoObject containing the Transaction information.
RiskRequest.TransactionInfo (Object)		ObjectNAOptional
ExtensionDataObject defining data extension information related to the transaction.RiskRequest.ExtensionData (Object)ObjectNAOptional

Updated about 1 month ago