On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/intelligent-commerce/developer/all/rest/intelligent-commerce/intelligent-commerce-intro-requirements/intelligent-commerce-passkey-intro/tms-net-tkn-card-authenticate-intro.md)  
Filter  
FILTER BY TAG

Create Tokenized Card Authentication Options {#tms-net-tkn-card-authenticate-intro}
===================================================================================

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.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options`  
**Production:** `POST ``https://api.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options`  
**Production in India:** `POST ``https://api.in.cybersource.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 {#tms-net-tkn-card-authenticate-reqfields}
=============================================================================================================

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
:

Related Information
-------------------

* [API Field Reference for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "")
  {#tms-net-tkn-card-authenticate-reqfields_ul_kpc_xzz_sxb}

REST Example: Creating Tokenized Card Authentication Options {#tms-net-tkn-card-authenticate-ex-rest}
=====================================================================================================

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"
    }
}
```

{#tms-net-tkn-card-authenticate-ex-rest_codeblock_c51_vmt_gwb}  
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"
}

```

RELATED TO THIS PAGE