3RI Authentication - Sample Request and Response

error_outline
note

The content on 3RI transactions is still under development. If you have identified any errors or gaps in the content, please contact: #SEDevPortalSupport@elavon.com

Title: Send a 3RI request authentication data to the 3DS server and get authentication response

 POST     /3ds2/authenticate  

Sample URL

https://uat.gw.fraud.eu.elavonaws.com/3ds2/authenticate

Headers

Header name Description Required Values
Content-Type The MIME type of the request body. Required application/json
Authorization

Authorization type (Basic) and the Base64 encoded username and password.

or

or Bearer followed by token

Required

Basic <encoded_auth_data>

or

Bearer <token_value>

error_outline
note

The sample request and response on this page assumes that the acctNumber supported 3DS 2.1 authentication and the issuer authenticated the transaction i.e. transStatus = Y.

Sample authentication request 

{

  "deviceChannel" : "03",
  "messageCategory" : "02",
  "threeRIInd" : "04",
  "acctNumber" : "7654310438700849",
  "acctType" : "02",
  "acctInfo" : 
      {
         "chAccAgeInd" : "05",
         "chAccDate" : "20170101",
         "chAccChangeInd" : "04",
         "chAccChange" : "20170101",
         "chAccPwChangeInd" : "05",
         "chAccPwChange" : "20170101",
         "shipAddressUsageInd" : "04",
         "shipAddressUsage" : "20170101",
         "txnActivityDay" : "1",
         "txnActivityYear" : "1",
         "provisionAttemptsDay" : "0",
         "nbPurchaseAccount" : "1",
         "suspiciousAccActivity" : "01",
         "shipNameIndicator" : "01",
         "paymentAccInd" : "05",
         "paymentAccAge" : "20170101"
      },
  "acctID" : "personal account",
  "merchantRiskIndicator" : 
      {
         "shipIndicator" : "01",
         "deliveryTimeframe" : "02",
         "deliveryEmailAddress" : "<example@example.com>",
         "reorderItemsInd" : "01",
         "preOrderPurchaseInd" : "02",
         "preOrderDate" : "20300101",
         "giftCardAmount" : "1",
         "giftCardCurr" : "840",
         "giftCardCount" : "01"
      },
  "cardExpiryDate" : "2212",
  "cardholderName" : "Frictionless One",
  "email" : "<example@example.com>",
  "billAddrLine1" : "Billing Address Line 1",
  "billAddrLine2" : "Billing Address Line 2",
  "billAddrLine3" : "Billing Address Line 3",
  "billAddrCity" : "Atlanta",
  "billAddrState" : "GA",
  "billAddrPostCode" : "30303",
  "billAddrCountry" : "840",
  "shipAddrLine1" : "Shipping Address Line 1",
  "shipAddrLine2" : "Shipping Address Line 2",
  "shipAddrLine3" : "Shipping Address Line 3",
  "shipAddrCity" : "Athens",
  "shipAddrState" : "GA",
  "shipAddrPostCode" : "30603",
  "shipAddrCountry" : "840",
  "mobilePhone" : 
     {
        "cc" : "123",
        "subscriber" : "123456789"
     },
  "homePhone" : 
     {
        "cc" : "123",
        "subscriber" : "123456789"
     },
  "workPhone" :
     {
         "cc" : "123",
         "subscriber" : "123456789"
     },
  "clientStartProtocolVersion": "2.1.0",
  "clientEndProtocolVersion" : "2.1.0"
 }

error_outline
note

A. If you do not provide the value of following fields in the cardholder authentication data you send to the 3DS Server, it auto populates the value for these fields in the authentication request it sends to the issuer.

  • notificationURL 
  • threeDSServerTransID

B. If you set the value of clientStartProtocolVersion field to 1.0.2 to enable 3DS 1 fallback, the 3DS Server will return an error message. It is not a supported scenario for 3RI transactions.

Sample authentication response

  {
    "messageType" : "ares",
    "messageVersion" : "2.1.0",
    "threeDSServerTransID" : "02316635-4588-424f-93de-65d0515300e4",
    "dsTransID" : "0f91325b-71a2-41d5-81e0-61110fbb2251",
    "acsTransID" : "da49dc91-2f94-4c4a-bcaa-9700b9d7b205",
    "acsReferenceNumber" : "3DS_LOA_ACS_PPFU_020100_00009",
    "acsOperatorID" : "ELAVON_ACS_EMULATOR_OPERATOR_ID1",
    "dsReferenceNumber" : "3DS_LOA_DIS_PPFU_020100_00010",
    "transStatus" : "Y",
    "transStatusReason" : "01",
    "authenticationValue" : "AABBCCDDEEFFAABBCCDDEEFFAAA=",
    "eci" : "00"
 }

Related topics