On This Page

Create Tokenized Card Authentication Options

This section describes how to determine what Passkey Service authentication options are available for a tokenized card.

Passkey Service Authentication Response Indicators

After you send this request, the response includes one of these indicators in the

action

field. These are the possible values that indicate the Passkey Service authentication status:

AUTHENTICATE

: The device and network token combination is registered with Passkey Service.

STEP_UP_AUTHENTICATE

: The device and network token combination is not registered with Passkey Service and the issuer has challenged the device binding.

AUTHENTICATION_REGISTRATION

: The device and network token combination is not registered with Passkey Service and the issuer has approved the device binding.

Endpoint

Test:

POST https://apitest.visaacceptance.com/tms/v2/tokenized-cards/{tokenId}
/authentication-options

Production:

POST https://api.visaacceptance.com/tms/v2/tokenized-cards/{tokenId}
/authentication-options

The {tokenId}
is the identifier of the tokenized card.

Required Fields for Creating Tokenized Card Authentication Options

authenticatorRenderMethod
clientCorrelationId
deviceInformation.httpAcceptContent
deviceInformation.httpBrowserColorDepth
deviceInformation.httpBrowserJavaEnabled
deviceInformation.httpBrowserJavaScriptEnabled
deviceInformation.httpBrowserLanguage
deviceInformation.httpBrowserScreenHeight
deviceInformation.httpBrowserScreenWidth
deviceInformation.httpBrowserTimeDifference
deviceInformation.ipAddress
deviceInformation.platformType
deviceInformation.userAgentBrowserValue
merchantInformation.merchantDescriptor.name
merchantInformation.merchantDescriptor.url
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
sessionInformation.secureToken

REST Example: Creating Tokenized Card Authentication Options

Request

{
    "clientCorrelationId": "4cba8c5a-5b21-4812-8783-f91be68aa72a",
    "sessionInformation": {
        "secureToken": "ezAwMX06AAM1NUHl3Gq8..."
    },
    "authenticatorRenderMethod": "IFRAME",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "1765.95",
            "currency": "978"
        }
    },
    "merchantInformation": {
        "merchantDescriptor": {
            "name": "TWVyY2hhbnQgVlphRjVYQmo",
            "url": "aHR0cHM6Ly93d3cuTWVyY2hhbnQtVlphRjVYQmouY29t"
        }
    },
    "deviceInformation": {
        "platformType": "WEB",
        "ipAddress": "104.28.3.217",
        "httpAcceptContent": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
        "httpBrowserLanguage": "en-US",
        "httpBrowserJavaEnabled": false,
        "httpBrowserJavaScriptEnabled": true,
        "httpBrowserColorDepth": "24",
        "httpBrowserScreenHeight": "1080",
        "httpBrowserScreenWidth": "1920",
        "httpBrowserTimeDifference": "420",
        "userAgentBrowserValue": "Mozilla/5.0(WindowsNT10.0;Win64;x64)AppleWebKit/537.36(KHTML,likeGecko)Chrome/134.0.0.0Safari/537.36Edg/134.0.0.0"
    }
}

Response to a Successful Request

{
  "action": "AUTHENTICATE",
  "authenticationContext": {
    "id": "de5ecf36-2a5c-4f66-b01f-15d6e5b73715",
    "endpoint": "/vts-auth/authenticate",
    "payload": "aGVsbG8",
    "platformType": "WEB"
  }
}

Response to a Successful Request

{
  "action": "STEP_UP_AUTHENTICATE",
  "stepUpOptions": [
    {
      "method": "OTP_SMS",
      "value": "415****000",
      "source": "1-800-847-291",
      "id": "YWEwMjFhZmFkZDU4ZWI0NDJjYTM0MzY4OTY1YjdhMDE="
    },
    {
      "method": "OTP_EMAIL",
      "value": ip****@email.com,
      "source": email@issuer.com,
      "id": "ZTk1OGUyODM4ZjAzN2MzMmQzZGMyMjZjNGQwZTcyMDE="
    },
    {
      "method": "OTP_ONLINE_BANKING",
      "value": "Mobile Banking",
      "source": "br.com.bradesco.next|a2a",
      "id": "NzNkOWI0ZTVjNzA3MzA4OGQ4YmFjYjYwMDg0ZjRjMDE="
    },
    {
      "method": "APP_TO_APP",
      "value": "Verify with Bank",
      "source": https://usa.visa.com/app/af801b935f19ae03a718d40,
      "id": "MGZlY2YwOWQ3MDZmYWZjZGMwN2Y0YjllZWFkODZkMDI=",
      "requestPayload": "cDkwMjFhZmFkZDVmZ2hqMzQyY2EzNTM2ODk2NWI3YTAy"
    },
    {
      "method": "APP_TO_APP",
      "value": "Verify with Bank",
      "source": https://usa.visa.com/app/af801b935f19ae03a718d40,
      "id": "ZWY2NTkyZDFiNjZlZTMwZGQyNjg1ZDY3NDY0YTc1MDE=",
      "requestPayload": "cDkwMjFhZmFkZDVmZ2hqMzQyY2EzNTM2ODk2NWI3YTAy",
      "platformType": "WEB",
      "subMethod": "3DS"
    },
    {
      "method": "CUSTOMER_SERVICE",
      "value": "1-800-847-2911",
      "id": "ODk3Zjk1ODhhMzI1YTllOTY1ZGU0NjhhMDY4OGE3MDE="
    },
    {
      "method": "OUTBOUND_CALL",
      "value": "415****000",
      "id": "YmIwMjFhZmFkZDU5ZWI0NDJjYTM1MzY4OTY1YjdhMDI="
    }
  ]
}

Response to a Successful Request

{
  "action": "AUTHENTICATION_REGISTRATION"
}