On This Page

{#jumplink-list}  
[Markdown](/docs/vas/en-us/tms/developer/all/rest/tms/tms-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.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 {#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
:

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