Fixed

ADX Version 2.x

DateVersion No.Updates
05/20242.0

Addition of Objects and Fields on the SendAuthenticationResultDetailRequest:

SendAuthenticationResultDetail.Extension Data (Object):

ACSRBA (Object):
  • Satus
  • Score
  • Decision
  • ReasonCode1
  • ReasonCode2
EMVPaymentToken (Object):
  • tokenRequestorId
  • tokenStatusIndicator
  • tokenAdditionalData (Object):
    • tokenAdditionalDataVersion
    • tokenCharacteristics
  • Version
DAFExtension (Object):
  • authPayCredStatus
  • authPayProcessReqInd
  • dafAdvice
  • Version
threeDSRequestorPriorAuthenticationInfo (Object):
  • threeDSReqPriorAuthData
  • threeDSReqPriorAuthMethod
  • threeDSReqPriorAuthTimestamp
  • threeDSReqPriorRef
New Fields Added:
  • threeRIInd on SendAuthenticationResultDetailRequest
  • TransStatusReason on SendAuthenticationResultDetailRequest
  • IssuerOrgId on SendAuthenticationResultRequest and SendAuthenticationResultDetailRequest
New fields added to SendAuthenticationResultDetail.TransactionInfo (Object):
  • ChallengeCancel
  • FlowStatus
  • TransactionAmountUSD
  • VCASPanStatus
Addition of Values tables (see Appendix):
  • Challenge Cancel Values
  • Transaction Status Reason Values
08/20242.1

Updates to Confidentiality and Disclaimers language related to products and/or services made available by third parties.

Inclusion of available values on the following fields:
  • FlowStatus field on SendAuthenticationResultDetail.TransactionInfo (Object)
  • TokenStatusIndicator field on SendAuthenticationResultDetail.EMVPaymentToken (Object)
  • TokenCharacteristics field on SendAuthenticationResultDetail.EMVPaymentToken.TokenAdditionalData (Object)
Definition of RequestID field updated to include: “This field is named “TransactionId” in the VCAS RDX API” in both the SendAuthenticationResultRequest and SendAuthenticationResultDetailRequest

Note added to the SendAuthenticationResultDetail.ACSRBA object: “The ADX request needs to include ACSRBA object fields in order for an issuer to receive the Mastercard risk-based extension data. Refer to the Mastercard program guide for more information.”

02/20252.2
  • Removal of “Payphone” from SendAuthenticationResultDetail.TransactionInfo.RiskProviderInfo (Object)
  • Removal of SendAuthenticationResultDetail.TransactionInfo.ShoppingCart.CartItem (Object)(List)
06/20252.3
  • Addition of VisaPaymentToken (Object) to SendAuthenticationResultDetail.ExtensionData
  • Update to DeviceName field to “up to 256 characters” in SendAuthenticationResultDetail.TransactionInfo.DeviceInfo (Object)
  • “Merchant Cancelled” value has been removed from the FlowStatus field in SendAuthenticationResultDetail.TransactionInfo (Object)
07/20252.4
  • MerchantAppRedirectURL field has been added to SendAuthenticationResultDetail.MerchantInfo (Object)
  • “Merchant Cancelled” value has been added to the FlowStatus field in SendAuthenticationResultDetail.TransactionInfo (Object)
08/20262.5
  • Change value of SendAuthenticationResultDetail.TransactionInfo.RiskProviderInfo.Name value to “TM” (ThreatMetrix).
  • Update WhitelistStatus enum from (Y/N/E/P/R/U) to MerchantWhitelisted and MerchantNotWhitelisted values.
  • Update field names to camelCase (lowercase ‘t’) and remove spaces from SendAuthenticationResultDetail.VisaPaymentToken (Object) property names (tokenAssuranceMethod, tokenCryptogram, tokenCryptogramValidityIndicator)
  • Update references to camelCase in TokenAdditionalData (Object) in VisaPaymentToken (Object).
  • Add Challenge Timeout value to FlowStatus field
  • Add 3 fields to SendAuthenticationResultDetail.Exemption.Info (MCRiskScore, WhitelistStatus, WhitelistStatusSource
  • Update RiskScore field maxLength = 2; minLength
  • Add ChAccReqId field to SendAuthenticationResultDetail.DAFExtension (Object)
  • Update property names to PascalCase (AuthPayCredStatus, AuthPayProcessReqInd, DafAdvice, Version) in DAFExtension (Object)
  • Update MessageVersion field; minLength = 5; maxLength; SendAuthenticationResultDetailRequest and SendAuthenticationResultRequest
  • Update CardExpiryYear: field updated from 4-digit YYYY (maxLength: 4, example "2028") to 2-digit YY (maxLength/minLength)
  • Update enum value to M_WEB in SendAuthenticationResultDetail.TransactionInfo.Channel
  • Update values in AuthenticationType field in both SendAuthenticationResultRequest and DetailRequest
  • Update MerchantChallengeIndicator values and document the field as Mastercard only
  • Remove table for Merchant Challenge Indicator Values (Mastercard Identity Check 2.1 Extensions)
  • Update description and values of VcasPanStatus field; maxLength from 11 to 16 characters
  • Add ‘D’ and ‘C’ responses to AuthenticationResponse field.
  • Update EmailAddress maxLength to 128 characters
  • Update TransactionType description to state it is an open string not enforced by the type system.
  • Update AdditionalRiskResultInfo fields to clarify that DeviceIDVelocity and IPVelocity fields are always present and that 0 may mean "not measured" rather than a genuine zero.