Changelog
Back to All
improved

Authentication Data Exchange (ADX) Changelog

over 1 year ago

Updates to the VCAS ADX API

DateVersionUpdates
06/20171.0Initial Release
08/20171.0.1
1.0.2		Changed SendAuthenticationResultDetailExtended to SendAuthenticationResultDetail
Added AuthenticationType to SendAuthenticationResult and SendAuthenticationResultDetail
Added 3RIIndicator to SendAuthenticationResultDetail
Added MerchantChallengeIndicator to SendAuthenticationResultDetail
Added NonPaymentAuthenticationIndicator to SendAuthenticationResultDetail
Added TransactionExponent to SendAuthenticationResultDetail.TransactionInfo
Added CardType and CardholderName to SendAuthenticationResultDetail.TransactionInfo.PaymentInfo
Added MerchantAdditionalData to SendAuthenticationResultDetail.TransactionInfo
Added AddressMatch to SendAuthenticationResultDetail.TransactionInfo
Added ReasonCodes to SendAuthenticationResultDetail
Added RuleTriggered to SendAuthenticationResultDetail
Updated RequestId character length to 36
10/20171.0.3Added PaymentInfo to SendAuthenticationResultRequest
01/20181.0.4Updated description for RequestId
02/20181.0.5Updated descriptions for CAVV and ECI.
Added MessageVersion to SendAuthenticationResult and SendAuthenticationResultDetail
05/20181.0.6SendAuthenticationRequestDetail Request,
updated TransactionTimeStamp from 14 characters to 24 characters
Updated MerchantCountryCode from 3 characters to 2
Updated Billing and Shipping Country Code description and characters
06/20181.0.7Updated Channel Value 3RI to ThreeRI
07/20181.0.8Added R as a response value for AuthenticationResponse
09/20181.0.9Updated DeviceExtendedData description, type, and character length
01/20191.0.10Removed reference to ISO 8601 from PreOrderDate
02/20191.1.0TransactionExponent updated type to number from string
TransactionType values corrected; Purchase, CardAdd
Added note to Overview related to unavailable transaction data
Added RiskProviderInfo Object for TransactionInfo
09/20191.1.1Updated lengths for Reason properties
Updated length of ReasonCode properties to 32 characters
Updated length of ReasonDescription properties to 256 characters
09/20191.2.0Added new fields to SendAuthenticationResultRequest:

  • DSTransactionId
  • CAVVHex
    Added new fields to SendAuthenticationResultDetail:
  • DSTransactionId
  • CAVVHex
  • AdditionalRiskResultInfo
    - RiskIndicator
    - DeviceIDVelocity
    - IPVelocity
    • 10/20191.2.1Corrected Required indicator to “Optional” in SendAuthenticationResultDetail.TransactionInfo.BillingAddress (Object)
    09/20201.2.2Added “Authentication Responses” section to describe new use cases for ADX
    Corrected the AuthenticationType possible values
    Corrected the Device Locale length to 2028 characters max.
    Corrected Required indicator to “Optional” in SendAuthenticationResultDetail.TransactionInfo.ShippingAddress (Object)
    New value for AuthenticationResponse > “I” for “Information Only”
    New Field > MerchantInfo:

  • AcquirerCountryCode
    New Field > TransactionInfo
  • MandatedRegion
  • DeviceInfo
    New Field: BrowserJavascriptEnabled (New EMV3DS 2.2 Value)
    Updates to SendAuthenticationResultDetail.ExemptionInfo (Object):
  • MerchantFraudRate
  • SecureCorporatePaymentResultDetail > Updated MerchantChallengeIndicator valuesRemoved fields:

  • 3RIIndicator
  • NonPaymentAuthenticationIndicator
    • 08/20211.2.3Clarification made to AuthenticationType field
    “Authentication Statuses” table header changed to “Authentication Responses” for consistency with ADX data fields.
    Added additional values to Authentication Responses table:

  • I - Information Only
    Clarification and footnote added to AuthenticationResponse field:
  • Type of authentication credential used for the given transaction.
    Note: The "AuthenticationType" field is referred to as “CredentialType” in other Cardinal services. This is not the same as authentication type in reports. This field will be NULL in the case where no credentials were used, as in the case of a non-challenge transaction.
    • 09/20211.2.4SendAuthenticationResultDetail.TransactionInfo.RiskProviderInfo (Object):

  • AuthenticationType ProviderID and DeviceID element types changed from numeric to alphanumeric.
  • MerchantCountryCode; length modified to “up to 3 characters”.
  • DSTransactionId; Required status modified to “Conditional”; required for EMV 3DS 2.x transactions only.
    Updates to the Authentication Responses table to clarify when the ADX Request is sent.
    Updates to description to include “Sent from RDX”:
  • SendAuthenticationResultDetail.TransactionInfo.ReasonCodes.Risk (Reason Code)
  • SendAuthenticationResult.Error (description)
    Addition of “blank” as possible values for AuthenticationType in:
  • SendAuthenticationResult Request
  • SendAuthenticationResultDetail Request
    • 05/20221.2.5Removal of Authentication Types from SendAuthenticationResultDetailRequest and SendAuthenticationResultRequest:

  • BIOMETRIC_IDENTITY_CHECK
  • KBAMULTI
    Addition of new data point in ADX Transaction Example:
  • AuthenticationType; OTPSMS
    Inclusion of Mandated Region Values table
    • 06/20221.2.6Update to SendAuthenticationResultDetail.TransactionInfo.MerchantAdditionalData (Object):

  • GiftCardAmount and GiftCardCount; Type changed to String
    • 06/20221.2.7Updates to Authentication Responses table. To include EMV 3DS 2.X.X.X responses.
    Note regarding the deprecation of the SendAuthenticationResultDetail.TransactionInfo.ShoppingCart.CartItem