On This Page

4c: Multi-Party Commerce or OTA (MasterCard)

The merchant initiates a (3RI) recurring transaction of a fixed amount for a specified number of transactions or with no set number of transactions such as occurs with subscription purchases. For more information, see Requester Initiated Payments.

Card Type	Test Card Number
Mastercard Card Type = 002	52XXXX XX XXXX 2235

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 4c: Multi-Party Commerce or OTA (MasterCard)

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
85
.
consumerAuthenticationInformation. strongAuthentication.authenticationIndicator: Set this field value to
85
.

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

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": "002",
      "expirationMonth": "12",
      "expirationYear": "2027",
      "number": "52XXXXXXXXXX2235"
    }
  },
  "deviceInformation": {
    "httpAcceptContent": "all",
    "httpBrowserLanguage": "en",
    "httpBrowserJavaEnabled": "y",
    "httpBrowserColorDepth": 1,
    "httpBrowserScreenHeight": 1,
    "httpBrowserScreenWidth": 1,
    "httpBrowserTimeDifference": 5,
    "userAgentBrowserValue": "chrome"
  },
  "consumerAuthenticationInformation": {
    "strongAuthentication": {
      "authenticationIndicator": "85"
    },
    "deviceChannel": "3RI",
    "messageCategory": "01",
    "priorAuthenticationMethod": "02",
    "priorAuthenticationReferenceId": "74fd3b64-5abb-4ac2-b090-1fba79996123",
    "priorAuthenticationTime": "202408051124",
    "requestorInitiatedAuthenticationIndicator": "85",
    "referenceId": "CybsCruiseTester-8e9d566d"
  }
}

Response

{
    "clientReferenceInformation": {
        "code": "RTS-Auth"
    },
    "consumerAuthenticationInformation": {
        "eciRaw": "02",
        "authenticationTransactionId": "teQ1a9eI9B6hf96QMHJ0",
        "strongAuthentication": {
            "OutageExemptionIndicator": "0"
        },
        "token": "AxjzbwSTiUMNwN7oizBEABECT34jdm670h04ghMQyaSZV0ekj0yAmAAAzwTp",
        "paresStatus": "Y",
        "acsReferenceNumber": "Cardinal ACS",
        "ucafCollectionIndicator": "2",
        "ucafAuthenticationData": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
        "directoryServerTransactionId": "208c54bd-a067-4a45-a285-af22f02a5e07",
        "veresEnrolled": "Y",
        "threeDSServerTransactionId": "2a6f6351-58a8-4e7b-acbc-8fd3d5ab85f3",
        "acsOperatorID": "MerchantACS",
        "ecommerceIndicator": "spa",
        "specificationVersion": "2.2.0",
        "acsTransactionId": "932bc2de-6e7a-4b16-adfa-f6c8c1ce9628"
    },
    "id": "7254402151006708904004",
    "paymentInformation": {
        "card": {
            "bin": "520000",
            "type": "MASTERCARD"
        }
    },
    "status": "AUTHENTICATION_SUCCESSFUL",
    "submitTimeUtc": "2024-09-04T08:56:55Z"
}