On This Page

4a: Multi-Party Commerce or OTA (Visa)

In this test case, a travel booking merchant creates a multi-party transaction for the cardholder. The merchants participating in the multi-party transaction are required to authorize on flights, hotels, and car rentals etc. This test case focuses on what the participating merchants are required to send for a successful transaction. Note that each participating merchant must send their own CAVV.

Refer to the network specific values section for this use case.

Card Type	Test Card Number
Visa Card Type = 001	4XXXXX XX XXXX 27X1

Endpoint

Production:

POST https://nabgateway-api.nab.com.au/risk/v1/authentication-setups

Test:

POST https://nabgateway-api-test.nab.com.au/risk/v1/authentication-setups

Required Fields for 3RI 4a: Multi-Party Commerce or OTA (Visa)

Required Fields

consumerAuthenticationInformation. deviceChannel: Set this field value to
3RI
.
consumerAuthenticationInformation. messageCategory: Set this field value to
01
.
consumerAuthenticationInformation. priorAuthenticationMethod: Set this field value to
02
.
consumerAuthenticationInformation. priorAuthenticationReferenceId
consumerAuthenticationInformation. priorAuthenticationTime
consumerAuthenticationInformation. requestorInitiatedAuthenticationIndicator: Set this field value to
11
.
consumerAuthenticationInformation. strongAuthentication.authenticationIndicator: Set this field value to
01
.

REST Example: Checking Enrollment for 3RI Multi-Party Commerce Transaction (Visa)

Request

{
     "orderInformation": {
    "amountDetails": {
      "currency": "eur",
      "totalAmount": "100.00"
    },
    "lineItems": [
      {
        "unitPrice": "120.00"
      }
    ],
    "billTo": {
      "address1": "201 S. Division St.",
      "administrativeArea": "MI",
      "country": "US",
      "locality": "Ann Arbor",
      "firstName": "RTS",
      "lastName": "VDP",
      "email": "[email protected]",
      "postalCode": "48104-2201"
    }
  },
  "paymentInformation": {
    "card": {
      "type": "001",
      "expirationMonth": "12",
      "expirationYear": "2027",
      "number": "4XXXXXXXXXXX27X1"
    }
  },
  "deviceInformation": {
    "httpAcceptContent": "all",
    "httpBrowserLanguage": "en",
    "httpBrowserJavaEnabled": "y",
    "httpBrowserColorDepth": 1,
    "httpBrowserScreenHeight": 1,
    "httpBrowserScreenWidth": 1,
    "httpBrowserTimeDifference": 5,
    "userAgentBrowserValue": "chrome"
  },
  "consumerAuthenticationInformation": {
    "strongAuthentication": {
      "authenticationIndicator": "01"
    },
    "deviceChannel": "3RI",
    "messageCategory": "01",
    "priorAuthenticationMethod": "02",
    "priorAuthenticationReferenceId": "74fd3b64-5abb-4ac2-b090-1fba79996123",
    "priorAuthenticationTime": "202408051124",
    "requestorInitiatedAuthenticationIndicator": "11",
    "referenceId": "CybsCruiseTester-ddb08174"
  }
}

Response to a Successful Request

{
    "clientReferenceInformation": {
        "code": "RTS-Auth"
    },
    "consumerAuthenticationInformation": {
        "eciRaw": "05",
        "authenticationTransactionId": "GLO987AF3GRfk4IAAO10",
        "strongAuthentication": {
            "OutageExemptionIndicator": "0"
        },
        "eci": "05",
        "token": "AxjzbwSTiS7hKm5H9W8jABEBT34jGnwr0h04ghLQyaSZV0ekj0yAcAAAtQax",
        "cavv": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
        "paresStatus": "Y",
        "acsReferenceNumber": "Cardinal ACS",
        "xid": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
        "directoryServerTransactionId": "5c1ee075-b8d7-43f0-9525-51de793125a0",
        "veresEnrolled": "Y",
        "threeDSServerTransactionId": "f7ddddc1-cd06-4fd1-b1e6-db37e0379451",
        "acsOperatorID": "MerchantACS",
        "ecommerceIndicator": "vbv",
        "specificationVersion": "2.2.0",
        "acsTransactionId": "1dd0c6ac-03fd-46dd-b6ea-54bb5d337db2"
    },
    "id": "7252948448816500404003",
    "paymentInformation": {
        "card": {
            "bin": "400000",
            "type": "VISA"
        }
    },
    "status": "AUTHENTICATION_SUCCESSFUL",
    "submitTimeUtc": "2024-09-02T16:34:05Z"
}